Ordini

Le API per la gestione ordini permettono di processare l’intero ciclo logistico di un ordine ricevuto dal Marketplace.

Ecco in questa tabelle tutte le chiamate API che ti serviranno per gestire i tuoi ordini:

Stati degli ordini

Di seguito gli stati degli ordini nella loro sequenza:

1. WAITING_DEBIT: In attesa di blocco del plafond sulla carta di credito. Al momento invio del carrello viene bloccato il plafond sulla carta di credito ed una volta che l'ordine è stato elaborato viene eseguita la transazione effettiva.

2. WAITING_ACCEPTANCE: In attesa di accettazione, ogni ordine va "elaborato" prima di essere addebitato e messo in spedizione e questo è lo stato in cui diventa visibile a back-office, dopo 6 giorni che è in questo stato l'ordine va nello stato 3A automaticamente

3A. REFUSED: Nel caso in cui non venga elaborato (rifiutati) l'ordine va in questo stato e non può più essere modificato, la transazione non viene eseguita e lo sblocco del plafond della carta viene eseguito in automatico

3B. WAITING_DEBIT_PAYMENT: Una volta elaborato (accettato) l'ordine va in attesa della transazione sulla carta di credito

4. SHIPPING: Una volta completato il ciclo della fase 3B l'ordine va in corso di spedizione.

5. SHIPPED: Spedito

6A. RECEIVED: Ordine ricevuto, stato acquisito dopo 10 giorni dall'accettazione oppure dopo il rilascio della valutazione da parte dell'acquirente

6B. REFUNDED: Stato acquisito a rimborso avvenuto

7. CLOSED: Ordine finalizzato: stato che viene assegnato automaticamente dopo 60 e non ulteriormente lavorabile

E’ possibile poi trovare i seguenti stati aggiuntivi:

CANCELED: annullato, questo stato può essere raggiunto solo dopo richiesta dell'acquirente e prima che il venditore abbia elaborato l'ordine, dalla fase 4 in poi un ordine può essere chiuso unicamente tramite rimborso

INCIDENT_OPEN: Contestazione aperta, può essere chiusa solamente dall'acquirente, dal venditore tramite un rimborso, oppure automaticamente dopo 15 giorni.

TO_COLLECT: è un nuovo stato introdotto dalla nuova versione, ed è utilizzato solamente per gli ordini con ritiro al Pick&Pay.

OR11* Approfondimento

Restituisce la lista degli ordini e supporta l’impaginazione. Contiene dati sul cliente, lo stato dell’ordine, l’offerta alla quale si riferisce e l’importo dell’ordine

Restituisce anche tutte le informazioni necessarie per l’emissione della fatturazione elettronica. All’interno della sezione “order_additional_fiels” sono disponibili i seguenti dati:

fattura (boolean: true o false): contenente specifica sulla richiesta di emissione fattura da parte del cliente
delivery (list): elenco valori contenente la modalità di ricezione fattura scelta dal cliente
piva (text): partita IVA del cliente
cf (text): codice fiscale del cliente
pec (text): mail certificata (in caso delivery sia PEC)
cod-destinatario (text): codice destinatario (in caso delivery sia CodiceDestinatario)

In caso fattura sia “FALSE” (e quindi il cliente non abbia richiesto fattura) non verranno valorizzati gli altri campi.

In caso delivery sia valorizzato con “CassettoFiscale”, verrà fornita solo l’informazione relativa alla partita IVA o codice fiscale (a seconda che il cliente sia privato o azienda)

OR23** Approfondimento

Aggiorna le informazioni del tracking di uno specifico ordine. Bisogna inserire l’order_id per identificare l’ordine.

Struttura dell’input:

{

"carrier_code": String, à codice del corriere

"carrier_name": String, à nome del corriere

"carrier_url": String, à inserire il tracking url

"tracking_number": String à numero del tracking

}

E’ possibile scaricare la lista dei codici e dei relativi corrieri gestiti attraverso la chiamata SH21.

OR28*** Approfondimento

Richiesta di rimborso di una singola riga d’ordine indicando commercial_ID e l’order_lines

Commercial_ID

“Amount” à rimborso parziale o totale
Order_line_id à codice dell’offerta
Eventuali spese di spedizione da rimborsare

Il codice di rimborso che restituisce la chiamata lo inseriamo nella chiamata PA02 per validare il rimborso.

Report abuse