Atrybuty
Pary klucz/wartość JSON w ciele żądania
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
Powyższy nagłówek jest wymaganym elementem dla tego żądania zrealizowanego zamówienia, aby zakończyło się pomyślnie.
| Pole | Uwagi |
|---|---|
account_order_id OPCJONALNE | Ciąg liczbowy dla zamówienia. |
landed_cost_id WYMAGANE | Unikalny landed cost identyfikator dla sprzedawcy lub eksportera. |
parties WYMAGANE | Lista stron zaangażowanych w przesyłkę. Obejmuje to informacje dla strony, która wysyła paczkę, odbiera paczkę, pośredniczy w paczce oraz odpowiada za opłacenie ceł i podatków. Podanie stron ship_from i ship_to jest wymagane. |
parties.city WYMAGANE | Ciąg dla miasta, miasteczka, dzielnicy, przedmieścia lub wsi wymienionej strony. |
parties.contact_email WYMAGANE | Ciąg dla adresu e-mail kontaktowego. |
parties.contact_name WYMAGANE | Ciąg dla imienia i nazwiska kontaktu. |
parties.contact_phone WYMAGANE | Numer telefonu kontaktowego. |
parties.company_name OPCJONALNE | Nazwa firmy. |
parties.country WYMAGANE | Kraj, reprezentowany przez dwuliterowy kod ISO. |
parties.line1 WYMAGANE | Ciąg dla linii 1 adresu. |
parties.line2 WYMAGANE | Ciąg dla linii 2 adresu. |
parties.postal_code WYMAGANE | Ciąg dla kodu pocztowego. Opcjonalne dla ship_to w zależności od kraju importu. |
parties.state OPCJONALNE | Ciąg dla kodu stanu, gdy jest dostępny. Wymagane tylko w Kanadzie i Brazylii dla ship_to. |
parties.tax_id OPCJONALNE | Strona ship_to musi podać identyfikator podatkowy, aby importować do krajów takich jak Brazylia. Jeśli nie zostanie podany dla przesyłek do Brazylii, przesyłka będzie zatrzymana w urzędzie celnym, aż odbiorca zostanie skontaktowany w celu podania identyfikatora podatkowego. Jeśli odbiorca nie może być osiągnięty, dostawy prawdopodobnie będą opóźnione, co może skutkować zwróceniem lub porzuceniem paczek. |
parties.type WYMAGANE | Typ strony, którą reprezentują podane informacje. Możliwe wartości to ship_to, ship_from, shipper, sold_to, duties_taxes_payor i broker. |
test OPCJONALNE | Jeśli wypełnione wartością true, nie zostaniesz obciążony kosztami związanymi z tym zamówieniem. |
tracking_numbers OPCJONALNE | Lista numerów śledzenia zamówienia. |
Przykładowe żądanie
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"]
}
Przykładowa odpowiedź
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"]
}
Żądanie zrealizowanego zamówienia
Przeglądaj pary klucz/wartość w żądaniu zrealizowanego zamówienia.
API Order Complete pozwala na stworzenie nowego żądania dotyczącego informacji o zrealizowanym zamówieniu, dostarczając niezbędne szczegóły do dokładnego przetwarzania. To API zapewnia pomyślne zakończenie zamówienia poprzez określenie istotnych informacji o zaangażowanych stronach oraz numerach śledzenia, wśród innych wymaganych pól.