Atributos
Pares clave/valor JSON en el cuerpo de la solicitud
POST | https://api.zonos.com/v1/orders
HEADER zonos-version: 2021-01-01
El encabezado anterior es una entrada requerida para que esta solicitud de pedido completo se complete con éxito.
| Campo | Notas |
|---|---|
account_order_id OPCIONAL | El número de cadena para el pedido. |
landed_cost_id REQUERIDO | El identificador único de landed cost para el comerciante o exportador. |
parties REQUERIDO | Una lista de las partes involucradas en el envío. Esto incluye la información de la parte que envía el paquete, recibe el paquete, gestiona el paquete y es responsable del pago de aranceles e impuestos. Es obligatorio proporcionar las partes ship_from y ship_to. |
parties.city REQUERIDO | Una cadena para la ciudad, pueblo, distrito, suburbio o aldea de la parte listada. |
parties.contact_email REQUERIDO | Una cadena para el correo electrónico de contacto. |
parties.contact_name REQUERIDO | Una cadena para el nombre de contacto. |
parties.contact_phone REQUERIDO | El número de teléfono de contacto. |
parties.company_name OPCIONAL | El nombre de la empresa. |
parties.country REQUERIDO | El país, representado por un código ISO de dos letras. |
parties.line1 REQUERIDO | Una cadena para la línea 1 de la dirección. |
parties.line2 REQUERIDO | Una cadena para la línea 2 de la dirección. |
parties.postal_code REQUERIDO | Una cadena para el código postal. Opcional para ship_to dependiendo del país de importación. |
parties.state OPCIONAL | Una cadena para el código de estado cuando esté disponible. Solo requerido en Canadá y Brasil para ship_to. |
parties.tax_id OPCIONAL | La parte ship_to debe proporcionar un ID fiscal para importar a países como Brasil. Si no se proporciona para envíos a Brasil, el envío se retendrá en aduanas hasta que se pueda contactar al receptor para proporcionar el ID fiscal. Si no se puede contactar al receptor, es probable que las entregas se retrasen, lo que podría resultar en paquetes devueltos o abandonados. |
parties.type REQUERIDO | El tipo de parte que representa la información proporcionada. Los valores posibles incluyen ship_to, ship_from, shipper, sold_to, duties_taxes_payor y broker. |
test OPCIONAL | Si se completa con el valor de true, no se te facturará por los cargos relacionados con este pedido. |
tracking_numbers OPCIONAL | Una lista de los números de seguimiento del pedido. |
Solicitud de ejemplo
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"]
}
Respuesta de ejemplo
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"]
}
Solicitar un pedido completo
Explora los pares clave/valor en una solicitud de pedido completo.
La API de Pedido Completo te permite crear una nueva solicitud de información de pedido completado, proporcionando detalles esenciales para un procesamiento preciso. Esta API garantiza la finalización exitosa del pedido al especificar información vital sobre las partes involucradas y los números de seguimiento, entre otros campos requeridos.