Cómo consultar el informe de facturación
Consulta la facturación de una ubicación para revisar ingresos, desglose financiero, caja, facturas de referencia, estadísticas y pagos por método en los periodos seleccionados.
En este artículo
El informe de facturación reúne en una sola página la lectura económica del local: evolución diaria del dinero ganado, desglose de ventas, movimientos de caja, primeras y últimas facturas y pagos por método.
En el entorno demo, la guía está pensada para Grupo Marea Demo y la ubicación Marea Gran Via, usando el periodo `2026-06-01_2026-06-07` cuando se preparen capturas o revisiones documentales.
Antes de empezar
- Usuario autenticado en la organización Grupo Marea Demo y con Marea Gran Via como ubicación activa.
- Permiso de acceso a reportes o alguno de los permisos aceptados por la pantalla: `reports:view`, `tpv:view`, `tpv:use`, `catalog:view`, `reservation:view` o `staff:view`.
- Datos de TPV, pagos o facturas dentro del periodo que se quiere analizar para evitar una vista vacía.
- Ruta de reporting disponible en `/:orgId/:locationId/reporting/sales/billing` o desde el menú `Reporting > Ventas > Facturación`.
Instrucciones
- 1.
Abrir Facturación desde Reporting
Entra en `Reporting > Ventas > Facturación` con la ubicación activa. La pantalla resuelve la página `billing` del dashboard de reportes y muestra la cabecera de Facturación.
- 2.
Revisar o cambiar el periodo
Usa el panel de filtros para confirmar el rango aplicado o cambiarlo. El formato implementado es `YYYY-MM-DD_YYYY-MM-DD`, con varios periodos separados por `~` para comparar rangos.
- 3.
Interpretar la gráfica y el desglose
Revisa `Dinero ganado` para ver la evolución diaria de ventas y después consulta `Desglose`, donde se agrupan subtotal, impuestos, total, descuentos, total sin descuentos y recargos.
- 4.
Revisar facturas, caja y estadísticas
Consulta las tarjetas de primera y última factura cuando existan facturas no anuladas en el periodo. Después revisa `Caja`, donde el ingreso procede del efectivo recibido y la salida incluye cambios entregados y devoluciones.
- 5.
Analizar pagos por método
Baja hasta `Pagos` para comparar métodos de cobro, importes, propinas e ingresos sin propina. La tabla agrupa por método y prioriza los métodos con mayor importe en el periodo actual.
- 6.
Exportar una tarjeta en web
En web, abre el menú de exportación de una tarjeta para descargar CSV, Excel o PNG. En app nativa, la exportación no está disponible y se muestra una alerta.
Validaciones y límites
- Si no hay organización o ubicación seleccionada, la pantalla pide seleccionar una ubicación para consultar reportes.
- Si el usuario no tiene ninguno de los permisos aceptados, la pantalla informa que no puede ver reportes en esa ubicación.
- La pantalla consume `GET /api/app/{orgId}/{locationId}/reports?periods=...`; no existe un endpoint específico `/reports/billing`.
- Si `periods` está vacío o mal formado, frontend y backend descartan partes inválidas y aplican periodos por defecto.
- Si la fecha final llega antes de la inicial, el rango se normaliza para terminar el mismo día de inicio.
- Los tickets anulados quedan fuera del informe y las tarjetas de primera y última factura excluyen facturas anuladas.
- Si no hay pagos en el periodo, la tabla muestra `No hay pagos para los filtros seleccionados.`
- La acción es solo de lectura: no crea, actualiza ni elimina tickets, pagos, facturas ni sesiones.
Resultado esperado
El responsable obtiene una lectura semanal de facturación por ubicación, con ingresos, desglose, caja y pagos por método, sin modificar datos operativos.