Comprobar la entrega de facturas

Resumen

Después de enviar una factura, puede comprobar su estado de entrega para asegurarse de que ha llegado al destinatario. faktoora registra los intentos de entrega por correo electrónico, por Peppol y manuales.

Comprobar el estado de entrega en la interfaz web

1. Abra los detalles de la factura en su instancia de faktoora
2. Desplácese hasta el apartado "Entregas"
3. Verá una lista de todos los intentos de entrega con la siguiente información:
   • Tipo: modalidad de entrega (correo electrónico, Peppol, manual)
   • Destinatario: dirección de correo electrónico o identificador Peppol
   • Estado: estado de entrega actual
   • Actualizado el: fecha y hora del último cambio de estado

Consultar el estado de entrega mediante la API

Utilice el endpoint de la API GET /invoices/{faktooraId}/status para consultar el estado de entrega:

GET https://api.faktoora.com/api/v1/invoices/{faktooraId}/status

La respuesta contiene el campo delivery, un array con todos los intentos de entrega:

{
  "delivery": [
    {
      "type": "email",
      "recipient": "rechnung@beispielkunde.de",
      "carbonCopy": "cc1@example.com",
      "blindCarbonCopy": "bcc@example.com"
    }
  ]
}

Valores del estado de entrega

Entrega por correo electrónico

Las entregas por correo electrónico guardan las direcciones de los destinatarios, pero no hacen un seguimiento continuo del estado de entrega. Puede valorar si la entrega se ha realizado por la ausencia de informes de error o de notificaciones de rebote.

Entrega por Peppol

Las entregas por Peppol tienen un estado de entrega que se actualiza continuamente:

• PENDING_GENERATION: el XML de la factura todavía se está generando; aún no se ha solicitado la entrega por Peppol.
• ACTIVE: la transmisión está en curso.
• READY: a la espera del siguiente reintento (se produce tras un error en un reintento).
• DELIVERED: entrega confirmada por el punto de recepción.
• REJECTED: rechazada por el punto de recepción.
• FAILED: fallo definitivo (p. ej., debido a un error de validación).
• SUSPENDED: abandonada tras agotar los reintentos o detenida. Se puede reiniciar mediante POST /invoices/{faktooraId}/dispatch/peppol/resend.

Informes de error

En las entregas por Peppol fallidas (estado FAILED, REJECTED, SUSPENDED), la respuesta puede contener un campo messages con mensajes de error o de advertencia:

{
  "type": "peppol",
  "recipient": "9930:DE123456789",
  "state": "REJECTED",
  "attempts": 3,
  "messages": [
    {
      "level": "ERROR",
      "code": "BR-S-02",
      "text": "Un error en la validación de las reglas de negocio"
    }
  ]
}

Problemas frecuentes

No hay confirmación de entrega

De forma predeterminada, las entregas por correo electrónico no guardan confirmaciones de entrega de los servidores de correo. Si desea comprobar si una entrega por correo electrónico se ha realizado correctamente:

1. Revise el historial de entregas en la interfaz web
2. Revise los registros de su servidor de correo (si utiliza su propio servidor SMTP)
3. Pida al destinatario que confirme que ha recibido la factura
4. Compruebe si ha recibido notificaciones de rebote de su servicio de correo

Ha fallado la entrega por Peppol

Si falla una entrega por Peppol:

1. Revise los mensajes de error del campo messages
2. Corrija el problema (p. ej., datos no válidos, información que falta)
3. Utilice POST /invoices/{faktooraId}/dispatch/peppol/resend para repetir el envío
4. Póngase en contacto con el soporte de faktoora si el problema persiste

No se ven intentos de entrega

Si el array delivery está vacío:

1. Es posible que la factura aún no se haya enviado
2. Compruebe si la factura sigue en estado de borrador (draftOnly: true)
3. Asegúrese de que ha solicitado el envío correctamente

Supervisar el historial de entregas

Para una supervisión automatizada o la integración con su sistema, puede consultar periódicamente el estado de entrega:

1. Guarde el faktooraId tras crear la factura
2. Consulte GET /invoices/{faktooraId}/status
3. Compruebe si hay cambios de estado en el array delivery
4. Implemente la gestión de errores para los estados REJECTED, FAILED o SUSPENDED