Order Response | eConnect

Quando come fornitore riceve un ordine, una modifica o un annullamento, invia un Order Response per comunicare all'acquirente cosa farà con l'ordine. L'Order Response è un componente chiave del profilo Peppol Advanced Ordering.

Endpoint

POST /api/v1/{partyId}/salesOrder/{documentId}/response

Il {partyId} è l'identificativo Peppol del fornitore. Il {documentId} è l'ID dell'ordine ricevuto a cui si risponde.

Codici di stato

L'Order Response contiene un codice di stato che indica cosa si farà con l'ordine:

Codice

Nome

Quando utilizzare

Acknowledged

L'ordine è stato ricevuto ed è leggibile. Da utilizzare come conferma provvisoria mentre si sta ancora valutando l'ordine.

Accepted

Si accetta l'ordine completamente e si procederà all'esecuzione.

Conditionally Accepted

Si accetta l'ordine, ma con modifiche (ad esempio tempi di consegna o quantità aggiornati). Aggiungere le righe d'ordine modificate alla risposta.

Rejected

Si rifiuta l'ordine. L'acquirente deve inviare un nuovo ordine se la commessa deve comunque procedere.

Suggerimento: è possibile inviare più risposte per lo stesso ordine. Ad esempio, iniziare con AB (conferma di ricezione) e inviare successivamente AP (accettato) una volta che l'ordine è stato approvato internamente.

Flusso di esempio

Uno scenario tipico di Advanced Ordering:

L'acquirente invia un ordine tramite POST /{partyId}/purchaseOrder/send
Il fornitore riceve l'ordine tramite il webhook OrderReceived
Il fornitore scarica l'ordine tramite GET /{partyId}/salesOrder/{documentId}/download
Il fornitore invia una risposta AB (conferma di ricezione)
Il fornitore valuta l'ordine internamente
Il fornitore invia una risposta AP (ordine accettato)
L'acquirente riceve la risposta tramite il webhook OrderResponseReceived

Accettazione condizionale (CA)

Con una risposta CA (Conditionally Accepted) si indica che si accetta l'ordine, ma con modifiche. La risposta contiene una versione modificata delle righe d'ordine. L'acquirente può decidere sulla base di questa se l'ordine modificato è accettabile.

Possibili motivi per una risposta CA includono tempi di consegna aggiornati, quantità modificate (scorte limitate) o articoli sostitutivi.

Topic webhook

Topic

Direzione

Quando

OrderResponseSent

Fornitore

La risposta è stata inviata con successo all'acquirente

OrderResponseReceived

Acquirente

La risposta del fornitore è stata ricevuta

Corpo della richiesta

La risposta viene inviata come documento UBL OrderResponse XML nel body della richiesta, con content-type application/xml. Il documento deve contenere il corretto riferimento all'ordine originale.

Consulti la documentazione Swagger su psb.econnect.eu per l'esatta struttura XML e i campi obbligatori.

Domande frequenti

Quando uso AB, AP, CA o RE in una Order Response?

AB significa che l'ordine è stato ricevuto ed è leggibile, spesso come passaggio intermedio. AP è l'accettazione completa e l'esecuzione. CA è l'accettazione con modifiche; si includono le righe d'ordine aggiornate. RE rifiuta l'ordine; l'acquirente deve quindi presentare un nuovo ordine se l'acquisto deve procedere.

Posso inviare più Order Response per lo stesso ordine?

Sì. Può, ad esempio, inviare prima AB non appena ha acquisito l'ordine e successivamente AP quando l'approvazione interna è completata. Questo si adatta a una tipica catena Advanced Ordering con il webhook OrderResponseReceived lato acquirente.

Come chiamo tecnicamente l'endpoint Order Response?

Utilizzi POST /api/v1/{partyId}/salesOrder/{documentId}/response con {partyId} come identificatore Peppol del fornitore e {documentId} come ID dell'ordine ricevuto. Il body è un XML UBL OrderResponse con Content-Type: application/xml e il riferimento corretto all'ordine originale.

Consulti la specifica API completa su psb.econnect.eu per i payload di esempio e i messaggi di errore.

Apra il riferimento API

Correlati