Saltar al contenido
Facturador

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:

  • 500 si falta email o 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.