Flujo de documento y mensajes de estado

Cómo un documento recorre las seis fases del PSB: de Submit a Delivered o Failed, con mensajes de estado, webhooks y política de reintentos.

Un documento enviado a través del PSB sigue una secuencia fija de fases de procesamiento — desde la presentación hasta la entrega confirmada o el fallo definitivo. En cada punto de transición, el PSB publica un mensaje de estado que puede recuperarse a través de la API de estado o capturarse mediante un webhook.

Las seis fases de un documento
Submit → Validate → Transform → Route → Acknowledge → Delivered
                                                   ↘ Failed
FaseQué ocurreTopics típicosSubmitEl documento ha sido enviado a través de la API, un hook mailfrom, SFTP pull u otro método entrante.PendingValidateEl PSB valida el documento según el esquema y las reglas de negocio (p.ej. NLCIUS, Peppol BIS Billing, DICO).Validated, *ReceivedError en caso de errorTransformConversión de formato opcional mediante el motor Transform. Paso interno.(interno, sin topic separado)RouteEl PSB determina el destino: Peppol, correo electrónico, SFTP u otro canal.RoutedAcknowledgeConfirmación del punto de acceso o canal receptor.AcknowledgedDelivered / FailedLa entrega está confirmada, o definitivamente fallida después de agotar todos los reintentos.*Sent, *SentError
Códigos de estado
EstadoSignificado¿Estado final?PendingEnviado, validación aún no iniciadaNoValidatedValidación exitosaNoRoutedDestino determinado, listo para entregaNoDeliveredEntrega confirmada por el destinatario o canalRejectedRechazado por el destinatario (p.ej. via MLS Reject)FailedEntrega definitivamente fallida después de todos los reintentos
Política de reintentos para la entrega de documentos
ParámetroValorNúmero máximo de intentos8Duración total de reintentos~3 días (aproximadamente 72 horas) desde el primer intentoCódigos reintentables5xx y 429No reintentable4xx (excepto 429) — *SentError inmediatoBackoffExponencial
Política de reintentos para la entrega de webhooks
ParámetroValorNúmero máximo de intentos12Duración total de reintentos~6 días (aproximadamente 137 horas) desde el primer intentoBackoffExponencialTimeout por intento100 segundosEvento por intentoHookSentRetryEvento tras fallo definitivoHookSentError
Preguntas frecuentes
¿Cómo puedo seguir el estado de un documento enviado?

Tiene dos opciones. A través de la API de estado (GET …/salesInvoice/{documentId}/status) recupera el estado actual. Para monitorización en tiempo real, configure webhooks en los topics relevantes como InvoiceSent, InvoiceSentRetry e InvoiceSentError.

¿Durante cuánto tiempo intenta el PSB entregar un documento?

El PSB reintenta la entrega automáticamente hasta 8 veces durante aproximadamente 3 días (72 horas). Tras el fallo definitivo, sigue {DocumentType}SentError y se requiere acción manual.

¿Durante cuánto tiempo intenta el PSB entregar un webhook?

El PSB intenta entregar una notificación webhook hasta 12 veces, distribuidas a lo largo de aproximadamente 6 días (137 horas). Tras el fallo definitivo, sigue el evento HookSentError.

Ver la documentación API interactiva