Атрибуты
Пары ключ/значение JSON в теле запроса
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
Заголовок выше является обязательным для успешного завершения этого запроса на завершение заказа.
| Поле | Примечания |
|---|---|
account_order_id НЕОБЯЗАТЕЛЬНО | Строка номера для заказа. |
landed_cost_id ОБЯЗАТЕЛЬНО | Уникальный landed cost идентификатор для продавца или экспортера. |
parties ОБЯЗАТЕЛЬНО | Список сторон, участвующих в отправке. Это включает информацию о стороне, отправляющей пакет, получающей пакет, брокерской стороне и ответственной за оплату пошлин и налогов. Предоставление сторон ship_from и ship_to обязательно. |
parties.city ОБЯЗАТЕЛЬНО | Строка для города, населенного пункта, района, пригородной зоны или деревни указанной стороны. |
parties.contact_email ОБЯЗАТЕЛЬНО | Строка для контактного электронного адреса. |
parties.contact_name ОБЯЗАТЕЛЬНО | Строка для контактного имени. |
parties.contact_phone ОБЯЗАТЕЛЬНО | Номер контактного телефона. |
parties.company_name НЕОБЯЗАТЕЛЬНО | Название компании. |
parties.country ОБЯЗАТЕЛЬНО | Страна, представленная двухбуквенным ISO кодом. |
parties.line1 ОБЯЗАТЕЛЬНО | Строка для строки 1 адреса. |
parties.line2 ОБЯЗАТЕЛЬНО | Строка для строки 2 адреса. |
parties.postal_code ОБЯЗАТЕЛЬНО | Строка для почтового кода. Необязательно для ship_to в зависимости от страны импорта. |
parties.state НЕОБЯЗАТЕЛЬНО | Строка для кода штата, если доступно. Требуется только в Канаде и Бразилии для ship_to. |
parties.tax_id НЕОБЯЗАТЕЛЬНО | Сторона ship_to должна предоставить налоговый идентификатор для импорта в такие страны, как Бразилия. Если он не предоставлен для отправлений в Бразилию, отправление будет задержано на таможне, пока не удастся связаться с получателем для предоставления налогового идентификатора. Если получателя не удастся найти, доставка, вероятно, будет задержана, что может привести к возврату или оставлению пакетов. |
parties.type ОБЯЗАТЕЛЬНО | Тип стороны, которую представляет предоставленная информация. Возможные значения включают ship_to, ship_from, shipper, sold_to, duties_taxes_payor и broker. |
test НЕОБЯЗАТЕЛЬНО | Если заполнено значением true, вам не будет выставлен счет за расходы, связанные с этим заказом. |
tracking_numbers НЕОБЯЗАТЕЛЬНО | Список номеров отслеживания заказа. |
Пример запроса
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"]
}
Пример ответа
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"]
}
Запрос на завершение заказа
Изучите пары ключ/значение в запросе на завершение заказа.API Order Complete позволяет создать новый запрос на информацию о завершенном заказе, предоставляя важные детали для точной обработки. Этот API обеспечивает успешное завершение заказа, указывая жизненно важную информацию о вовлеченных сторонах и номерах отслеживания, среди других необходимых полей.