속성
요청 본문의 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 당사자는 브라질과 같은 국가에 수입하기 위해 세금 ID를 제공해야 합니다. 브라질로의 배송에 대해 제공되지 않으면, 세금 ID를 제공하기 위해 수신자에게 연락할 때까지 배송이 세관에 보류됩니다. 수신자에게 연락할 수 없는 경우, 배송이 지연될 가능성이 높으며, 반송되거나 버려진 패키지가 발생할 수 있습니다. |
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를 사용하면 완료된 주문 정보에 대한 새로운 요청을 생성할 수 있으며, 정확한 처리를 위한 필수 세부 정보를 제공합니다. 이 API는 관련 당사자 및 추적 번호에 대한 중요한 정보를 지정하여 주문 완료를 보장합니다.