DOCS

Richiedere un completamento dell'ordine

Richiedere un completamento dell'ordine

Esplori le coppie chiave/valore in una richiesta di completamento dell'ordine.

L'API Order Complete consente di creare una nuova richiesta di informazioni su un ordine completato, fornendo dettagli essenziali per un'elaborazione accurata. Questa API garantisce il completamento corretto dell'ordine specificando informazioni fondamentali sulle parti coinvolte, sui numeri di tracciamento e su altri campi obbligatori.

Attributi 

Coppie chiave/valore JSON nel corpo della richiesta

POST | https://api.zonos.com/v1/orders

HEADER zonos-version: 2021-01-01

L'header precedente è un input obbligatorio affinché questa richiesta di completamento dell'ordine venga elaborata correttamente.

CampoNote
account_order_id OPTIONALLa stringa numerica dell'ordine.
landed_cost_id REQUIREDL'identificatore univoco del landed cost per il commerciante o l'esportatore.
parties REQUIREDUn elenco delle parti coinvolte nella spedizione. Include le informazioni sulla parte che spedisce il pacco, riceve il pacco, agisce da intermediario e paga dazi e imposte. È obbligatorio fornire le parti ship_from e ship_to.
parties.city REQUIREDUna stringa per la città, il paese, il distretto, il sobborgo o il villaggio dell'indirizzo della parte indicata.
parties.contact_email REQUIREDUna stringa per l'email di contatto.
parties.contact_name REQUIREDUna stringa per il nome del contatto.
parties.contact_phone REQUIREDIl numero di telefono del contatto.
parties.company_name OPTIONALIl nome dell'azienda.
parties.country REQUIREDIl paese, rappresentato da un codice ISO a due lettere.
parties.line1 REQUIREDUna stringa per la riga 1 dell'indirizzo.
parties.line2 REQUIREDUna stringa per la riga 2 dell'indirizzo.
parties.postal_code REQUIREDUna stringa per il codice postale. Facoltativo per ship_to a seconda del paese di importazione.
parties.state OPTIONALUna stringa per il codice dello stato, quando disponibile. Obbligatorio solo in Canada e Brasile per ship_to.
parties.tax_id OPTIONALLa parte ship_to deve fornire un ID fiscale per importare in paesi come il Brasile. Se non viene fornito per spedizioni in Brasile, la spedizione sarà trattenuta in dogana finché non sarà possibile contattare il destinatario per fornire l'ID fiscale. Se il destinatario non è reperibile, le consegne subiranno probabilmente ritardi e i pacchi potrebbero essere restituiti o abbandonati.
parties.type REQUIREDIl tipo di parte rappresentato dalle informazioni fornite. I valori possibili includono ship_to, ship_from, shipper, sold_to, duties_taxes_payor e broker.
test OPTIONALSe popolato con il valore true, non verranno addebitati costi relativi a questo ordine.
tracking_numbers OPTIONALUn elenco dei numeri di tracciamento dell'ordine.
1{
2 "account_order_id": "123456",
3 "landed_cost_id": "ldct_1LOYliG6NmEu31cVkvGHvv",
4 "parties": [
5 {
6 "city": "Campinas",
7 "contact_email": "info@example.com",
8 "contact_name": "Jean-Luc Picard",
9 "contact_phone": "1234567890",
10 "company_name": "Starfleet",
11 "country": "BR",
12 "line1": "49 Chapadao Rua",
13 "line2": null,
14 "postal_code": "75828-000",
15 "state": "SP",
16 "tax_id": "12-3456789",
17 "type": "ship_to"
18 }
19 ],
20 "tracking_numbers": [
21 "1Z12345E0205271688"
22 ]
23}

Questa pagina è stata utile?