Cómo marcar una factura como enviada
Marca una factura TPV ya emitida como enviada cuando la entrega se ha hecho fuera de Antylogic o no necesita un canal registrado.
En este artículo
Esta acción sirve para dejar constancia de que una factura ya emitida debe considerarse enviada, por ejemplo cuando el equipo la ha entregado manualmente o por un medio externo.
No envía email, WhatsApp ni SMS. Tampoco crea una factura nueva ni registra un intento de entrega; solo actualiza el estado de la factura y su fecha de envío.
Antes de empezar
- Tener un ticket TPV pagado con factura ya emitida.
- La factura no puede estar anulada y debe estar pendiente de marcar como enviada.
- Tener permiso `tpv:invoice` o `tickets:manage`; para abrir la pantalla desde la app también hace falta `tpv:use`.
- Para capturas del runtime de documentación, preparar una factura `issued` sin `sent_at` si `TPV_PAID_TICKET_ID` no trae ese estado.
Instrucciones
- 1.
Abre el ticket facturado
Entra en el detalle del ticket TPV y localiza la tarjeta de factura. La acción solo aparece cuando la factura ya existe; no sirve para emitir una factura nueva.
- 2.
Comprueba que la acción está disponible
Revisa que la tarjeta muestra la factura emitida y que aparece `Marcar enviada`. El botón se oculta cuando la factura ya está en estado `sent`.
- 3.
Marca la factura como enviada
Pulsa `Marcar enviada`. La app no pide destinatario ni canal porque esta acción solo registra que la factura ya debe considerarse enviada.
- 4.
Confirma el resultado
Tras refrescarse el ticket, la tarjeta pasa a `Factura enviada`, muestra la fecha de envío y deja de mostrar `Marcar enviada`. Si la factura ya estaba enviada con fecha, repetir la acción conserva la fecha original.
Validaciones y límites
- La llamada es `POST /api/app/{orgId}/{locationId}/tickets/{ticketId}/invoice/send` y no lleva body.
- El estado final normal es `invoice.status = "sent"` con `invoice.sent_at` registrado en UTC.
- Si falta `file_id` y el backend tiene `fileStore`, se genera y vincula el PDF; si `fileStore` no está configurado, la factura puede quedar enviada sin PDF adjunto.
- La acción directa no crea `invoice_delivery_attempt`; para historial de entrega hay que usar el flujo de entrega de factura.
- Las facturas `void` y los bloqueos de validación fiscal impiden marcar la factura como enviada.
Resultado esperado
La factura queda registrada como enviada dentro del ticket TPV, con fecha visible y sin activar ningún canal de entrega desde Antylogic.