/ docs
ProdottoConoscenzaSviluppatori
Piattaforma Control
Flusso documento e messaggi di stato

Come un documento percorre le sei fasi del PSB: da Submit a Delivered o Failed, con messaggi di stato, webhook e policy di retry.

Un documento inviato tramite il PSB percorre una sequenza fissa di fasi di elaborazione — dalla presentazione alla consegna confermata o al fallimento definitivo. In ogni punto di transizione, il PSB pubblica un messaggio di stato che può essere recuperato tramite l'API di stato o acquisito via webhook.

Le sei fasi di un documento
Submit → Validate → Transform → Route → Acknowledge → Delivered
                                                   ↘ Failed
FaseCosa avvieneTopic tipiciSubmitIl documento è stato inviato tramite API, hook mailfrom, SFTP pull o altro metodo in entrata.PendingValidateIl PSB valida il documento contro schema e regole di business (es. NLCIUS, Peppol BIS Billing, DICO).Validated, *ReceivedError in caso di erroreTransformConversione di formato opzionale tramite il motore Transform. Fase interna.(interno, nessun topic separato)RouteIl PSB determina la destinazione: Peppol, email, SFTP o altro canale.RoutedAcknowledgeConferma dall'access point o canale ricevente.AcknowledgedDelivered / FailedLa consegna è confermata, o definitivamente fallita dopo aver esaurito tutti i tentativi.*Sent, *SentError
Codici di stato
StatoSignificatoStato finale?PendingInviato, validazione non ancora avviataNoValidatedValidazione riuscitaNoRoutedDestinazione determinata, pronto per la consegnaNoDeliveredConsegna confermata da destinatario o canaleSìRejectedRifiutato dal destinatario (es. via MLS Reject)SìFailedConsegna definitivamente fallita dopo tutti i tentativiSì
Policy di retry per la consegna di documenti
ParametroValoreNumero massimo di tentativi8Durata totale retry~3 giorni (circa 72 ore) dal primo tentativoCodici riprovabili5xx e 429Non riprovabile4xx (tranne 429) — *SentError immediatoBackoffEsponenziale
Policy di retry per la consegna dei webhook
ParametroValoreNumero massimo di tentativi12Durata totale retry~6 giorni (circa 137 ore) dal primo tentativoBackoffEsponenzialeTimeout per tentativo100 secondiEvento per tentativoHookSentRetryEvento dopo fallimento definitivoHookSentError
Domande frequenti
Come posso monitorare lo stato di un documento inviato?

Hai due opzioni. Tramite l'API di stato (GET …/salesInvoice/{documentId}/status) recuperi lo stato attuale. Per il monitoraggio in tempo reale, configura webhook sui topic rilevanti come InvoiceSent, InvoiceSentRetry e InvoiceSentError.

Per quanto tempo il PSB tenta di consegnare un documento?

Il PSB ritenta automaticamente la consegna fino a 8 volte nell'arco di circa 3 giorni (72 ore). Dopo il fallimento definitivo, segue {DocumentType}SentError e richiede azione manuale.

Per quanto tempo il PSB tenta di consegnare un webhook?

Il PSB tenta di consegnare una notifica webhook fino a 12 volte, distribuite su circa 6 giorni (137 ore). Dopo il fallimento definitivo, segue l'evento HookSentError.

Visualizza la documentazione API interattiva

Correlato

Panoramica PSB: architettura e possibilità
Gestione degli errori e logica di retry
Idempotenza: prevenire invii duplicati
PreviousGestione errori
NextConfigurare i webhook