Attributen
JSON sleutel/waarde-paren in de aanvraagbody
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
De bovenstaande header is een vereiste invoer voor deze aanvraag voor een voltooide order om succesvol te kunnen worden voltooid.
| Veld | Opmerkingen |
|---|---|
account_order_id OPTIONEEL | De nummerreeks voor de order. |
landed_cost_id VERPLICHT | De unieke landed cost identificatie voor de handelaar of exporteur. |
parties VERPLICHT | Een lijst van de partijen die betrokken zijn bij de verzending. Dit omvat de informatie voor de partij die het pakket verzendt, het pakket ontvangt, het pakket bemiddelt en verantwoordelijk is voor de betaling van invoerrechten en belastingen. Het verstrekken van de ship_from en ship_to partijen is vereist. |
parties.city VERPLICHT | Een tekenreeks voor de stad, het dorp, het district, de buitenwijk of het dorp van de vermelde partij. |
parties.contact_email VERPLICHT | Een tekenreeks voor het contact-e-mailadres. |
parties.contact_name VERPLICHT | Een tekenreeks voor de contactnaam. |
parties.contact_phone VERPLICHT | Het contacttelefoonnummer. |
parties.company_name OPTIONEEL | De bedrijfsnaam. |
parties.country VERPLICHT | Het land, weergegeven door een tweeletterige ISO-code. |
parties.line1 VERPLICHT | Een tekenreeks voor regel 1 van het adres. |
parties.line2 VERPLICHT | Een tekenreeks voor regel 2 van het adres. |
parties.postal_code VERPLICHT | Een tekenreeks voor de postcode. Optioneel voor ship_to afhankelijk van het importland. |
parties.state OPTIONEEL | Een tekenreeks voor de staatscode wanneer beschikbaar. Alleen vereist in Canada en Brazilië voor ship_to. |
parties.tax_id OPTIONEEL | De ship_to partij moet een belasting-ID verstrekken om te importeren in landen zoals Brazilië. Als deze niet wordt verstrekt voor zendingen naar Brazilië, zal de zending bij de douane worden vastgehouden totdat de ontvanger kan worden gecontacteerd om de belasting-ID te verstrekken. Als de ontvanger niet kan worden bereikt, zullen leveringen waarschijnlijk worden vertraagd, wat mogelijk resulteert in geretourneerde of verlaten pakketten. |
parties.type VERPLICHT | Het type partij dat de verstrekte informatie vertegenwoordigt. Mogelijke waarden zijn ship_to, ship_from, shipper, sold_to, duties_taxes_payor en broker. |
test OPTIONEEL | Als ingevuld met de waarde true, ontvang je geen factuur voor kosten die verband houden met deze order. |
tracking_numbers OPTIONEEL | Een lijst voor de order trackingnummers. |
Voorbeeldaanvraag
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
"account_order_id": "123456",
"landed_cost_id": "ldct_1LOYliG6NmEu31cVkvGHvv",
"parties": [
{
"city": "Campinas",
"contact_email": "info@example.com",
"contact_name": "Jean-Luc Picard",
"contact_phone": "1234567890",
"company_name": "Starfleet",
"country": "BR",
"line1": "49 Chapadao Rua",
"line2": null,
"postal_code": "75828-000",
"state": "SP",
"tax_id": "12-3456789",
"type": "ship_to"
}
],
"tracking_numbers": ["1Z12345E0205271688"]
}
Voorbeeldreactie
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"id": "ordr_5LwjnR9AW6L9eXs9lfeMC7",
"landed_cost_id": "ldct_1LOYliG6NmEu31cVkvGHvv",
"account_order_id": "123456",
"zonos_order_id": "1000151",
"parties": [
{
"id": "prty_12165151351",
"city": "Campinas",
"contact_email": "info@example.com",
"contact_name": "Jean-Luc Picard",
"contact_phone": "1234567890",
"company_name": "Starfleet",
"country": "BR",
"line1": "49 Chapadao Rua",
"line2": null,
"line3": null,
"postal_code": "75828-000",
"state": "SP",
"tax_id": "12-3456789",
"type": "ship_to"
}
],
"tracking_numbers": ["1Z12345E0205271688"]
}
Aanvraag voor een voltooide order
Verken de sleutel/waarde-paren in een aanvraag voor een voltooide order.
De Order Complete API stelt je in staat om een nieuwe aanvraag voor voltooide orderinformatie te creëren, met essentiële details voor nauwkeurige verwerking. Deze API zorgt voor een succesvolle voltooiing van de order door vitale informatie over de betrokken partijen en trackingnummers, onder andere vereiste velden, op te geven.