Antylogic
Probar demoAcceso app

399 guías operativas

Secciones de Docs
DocsEntrega
Dispositivo

Cómo compartir una factura por enlace, WhatsApp o SMS

Registra la entrega de una factura TPV ya emitida copiando un enlace temporal al PDF, abriendo WhatsApp o preparando un SMS. Antylogic guarda cada intento en el historial de entrega de la factura.

En este artículo

Este flujo empieza en el detalle de un ticket que ya tiene factura emitida. No crea una factura nueva: usa el documento existente para compartirlo por un canal operativo y dejar trazabilidad junto al ticket.

En la demo base, WhatsApp y SMS se comportan como enlaces externos que el dispositivo intenta abrir. Si la ubicación tiene Twilio configurado, el mismo endpoint puede enviar el mensaje automáticamente y registrar el resultado del proveedor.

Antes de empezar

  • Tener sesión iniciada en Grupo Marea Demo y acceso a Marea Gran Via.
  • Abrir un ticket existente y accesible desde el TPV; en el runtime de captura se usa `TPV_PAID_TICKET_ID`.
  • El ticket debe tener una factura emitida, no anulada y con documento PDF asociado (`invoice.file_id`).
  • El usuario necesita `tpv:invoice` o `tickets:manage`; si no tiene `tickets:manage`, también debe poder operar el ticket desde la sesión activa del TPV.
  • El backend debe tener `fileStore` disponible para resolver la URL temporal del PDF.
  • Para envíos automáticos de WhatsApp o SMS con Twilio, la factura debe conservar `billing_snapshot.phone_e164` o recibir un destinatario válido.

Instrucciones

  1. 1.

    Abre el ticket facturado

    Entra en el detalle del ticket pagado desde el TPV y confirma que aparece el bloque de factura emitida con la ficha fiscal correspondiente. En la demo ES, el ejemplo esperado usa `Marea Gran Via Demo SL`.

  2. 2.

    Comprueba las acciones de entrega

    Localiza `Copiar enlace`, `WhatsApp` y `SMS` dentro del bloque de factura. Estas acciones solo aparecen cuando la factura tiene PDF disponible y no sustituyen al flujo de emisión.

  3. 3.

    Copia el enlace del PDF

    Pulsa `Copiar enlace` para crear un intento de entrega `share_link`. La app copia una URL temporal del documento y Antylogic registra el intento con proveedor `filestore`.

  4. 4.

    Comparte por WhatsApp o SMS

    Pulsa `WhatsApp` o `SMS` cuando quieras abrir un mensaje preparado con el enlace de la factura. Sin Twilio, la app genera un deep link externo; con Twilio configurado, el backend intenta enviar el mensaje automáticamente.

  5. 5.

    Revisa el historial de entrega

    Vuelve al detalle del ticket y revisa `Historial de entrega`. Ahí se comprueba el canal usado, el destinatario, el proveedor, el estado del intento y si el registro corresponde a un reenvío.

Validaciones y límites

  • `Copiar enlace`, `WhatsApp` y `SMS` requieren una factura con `invoice.file_id`; si no hay documento, la UI no muestra esas acciones.
  • `share_link` crea un intento `shared`, usa proveedor `filestore`, asigna `shared-link` como destinatario de respaldo y no marca la factura como enviada por defecto.
  • WhatsApp sin Twilio genera una URL `https://wa.me/...`; SMS sin Twilio genera una URL `sms:` con el cuerpo preparado. Ambos quedan como intentos compartidos por `deep_link`.
  • Con Twilio, WhatsApp y SMS exigen teléfono válido y credenciales completas; el intento puede quedar `sent` o `failed` según la respuesta del proveedor.
  • Una factura anulada, un bloqueo fiscal o la falta de permisos impiden registrar el intento de entrega.
  • La URL temporal del PDF vence a los 7 días y los reintentos incrementan el número de intento.

Resultado esperado

La factura sigue vinculada al ticket, el operador dispone de un enlace compartible o un canal externo y Antylogic conserva un historial auditable de cada intento de entrega.

Artículos relacionados