Enviar reporte general de ventas por correo
POST /api/reports/email
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Envía por correo el reporte general de ventas del periodo indicado.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success.
Cuerpo (JSON):
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
email |
string | Sí | Correo destino. |
period |
string | Sí | month, between_months, date o between_dates. |
month_start |
string | Con month / between_months |
Mes inicial YYYY-MM. |
month_end |
string | Con between_months |
Mes final YYYY-MM. |
date_start |
date | Con date / between_dates |
Fecha inicial YYYY-MM-DD. |
date_end |
date | Con between_dates |
Fecha final YYYY-MM-DD. |
establishment_id |
integer | No | Establecimiento. Por defecto el del usuario autenticado. |
Errores:
500si faltaemailo el periodo es inválido.
Cuerpo
Content-Type: application/json
{
"email": "gerencia@empresa.com",
"period": "month",
"month_start": "2026-11",
"month_end": null,
"date_start": null,
"date_end": null,
"establishment_id": "1"
}
Respuestas
200 — Enviado
{
"success": true,
"message": "Email enviado correctamente."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.