DOCS

Recuperar detalles aduaneros

Recuperar detalles aduaneros

Recupere los detalles del pedido para preparar un envío.

GraphQL

Si es socio de Zonos y trabaja con un cliente que utiliza su plataforma para envíos, puede consultar a Zonos para obtener detalles sobre el pedido. Estos detalles pueden utilizarse en su solicitud de etiqueta al transportista para garantizar que los datos enviados sean los mismos utilizados para que Zonos garantice los aranceles e impuestos evaluados en ese envío. Devolveremos detalles sobre IDs fiscales, artículos (incluidos códigos HS y descripciones aduaneras) y números de cuenta que deben facturarse por aranceles e impuestos.

Consultar a Zonos para obtener detalles aduaneros 

Siga los pasos a continuación para permitir que sus clientes recuperen detalles aduaneros que puedan utilizarse al crear envíos desde su plataforma.

1

Permitir que los clientes ingresen sus credenciales de la API de Zonos

La API de Zonos es accesible mediante un credentialToken. Su plataforma deberá permitir que los clientes ingresen su credentialToken desde el Zonos Dashboard en su plataforma. A partir de ahí, podrá realizar solicitudes a Zonos en su nombre.

Utilice la siguiente consulta para obtener los detalles aduaneros necesarios para crear el envío. Para el orderId, puede utilizar el ID de pedido de Zonos o el accountOrderNumber que probablemente ya esté en su sistema.

1query GetCustomsSpec($referenceId: String!) {
2 customsSpecByReference(referenceId: $referenceId) {
3 id
4 currencyCode
5 amountSubtotals {
6 items
7 shipping
8 }
9 reasonForExport
10 incoterm
11 declarationStatement
12 attributes {
13 type
14 value
15 }
16 serviceLevel {
17 name
18 code
19 carrier {
20 name
21 code
22 }
23 }
24 parties {
25 id
26 type
27 person {
28 companyName
29 firstName
30 lastName
31 email
32 phone
33 }
34 location {
35 countryCode
36 line1
37 locality
38 postalCode
39 administrativeAreaCode
40 administrativeArea
41 }
42 }
43 customsItems {
44 id
45 amount
46 quantity
47 hsCode
48 hsCodeSource
49 description
50 countryOfOrigin
51 items {
52 id
53 amount
54 currencyCode
55 quantity
56 }
57 }
58 }
59}

Una vez que haya obtenido los detalles aduaneros de un pedido, puede utilizar esos detalles en su solicitud al transportista. Cuando recupere la etiqueta y el número de seguimiento del transportista, puede utilizar la mutación shipmentCreate para informar a Zonos sobre el número de seguimiento y así actualizar el estado del pedido.

¿Fue útil esta página?