Compilazione automatica delle dichiarazioni doganali
Segui i passaggi seguenti per abilitare il popolamento automatico delle dichiarazioni doganali utilizzando gli ID dichiarazione dalla tua piattaforma.
1. Abilita il campo ID dichiarazione nel flusso di creazione dell'etichetta
Aggiungi un campo ID dichiarazione all'interfaccia di creazione delle etichette postali. Quando gli utenti inseriscono un ID dichiarazione valido, la tua piattaforma può compilare automaticamente la dichiarazione doganale, eliminando l'immissione manuale dei dati.
2. Richiedere lo stato dell'ID della dichiarazione e i dettagli della dichiarazione doganale
Utilizzare la query seguente per recuperare i dati completi della dichiarazione doganale utilizzando l'ID dichiarazione. Ciò restituisce lo stato di convalida insieme ai dettagli dell'articolo, ai valori, ai codici HS e alle informazioni sul destinatario, quando disponibili
query DeclarationQuery($id: ID!) { declaration(id: $id) { id status paymentStatus landedCost { id method landedCostGuaranteeCode amountSubtotals { duties taxes fees landedCostTotal } } items { id sku productId amount currencyCode name hsCode description hsCodeSource countryOfOrigin quantity measurements { type value unitOfMeasure } } parties { id type person { firstName lastName email phone } location { id line1 line2 countryCode postalCode } } }}3. Gestire la risposta e compilare automaticamente la dichiarazione doganale
La risposta API include lo stato di convalida e i dati doganali. Usa le informazioni di status per determinare se l'ID della dichiarazione è valido, quindi compila automaticamente i dati doganali disponibili o richiedi l'immissione manuale.
Risposte di esempio
ID dichiarazione valida con dati doganali completi:
{
"data": {
"declaration": {
"id": "0mm1993s0mdcn",
"status": "OPEN",
"paymentStatus": "OPEN",
"landedCost": {
"id": "landed_cost_eabb13ab-df23-45df-9ce8-96dd29d396d1",
"method": "DAP",
"landedCostGuaranteeCode": "NOT_APPLICABLE",
"amountSubtotals": {
"duties": 0.0,
"taxes": 0.0,
"fees": 2.62,
"landedCostTotal": 2.62
}
},
"items": [
{
"id": "item_0mm199388v57g",
"sku": "item_1",
"productId": "item_1",
"amount": 70.0,
"currencyCode": "USD",
"name": "Item 1",
"hsCode": "9504.90.4000",
"description": "This is the description for Item 1",
"hsCodeSource": "TARIFF_COMPLETED",
"countryOfOrigin": "CN",
"quantity": 2,
"measurements": [
{
"type": "WEIGHT",
"value": 1,
"unitOfMeasure": "POUND"
}
]
}
],
"parties": [
{
"id": "party_0kesb32rw5hfa",
"type": "DESTINATION",
"person": {
"firstName": "test",
"lastName": "origin",
"email": null,
"phone": "1234567890"
},
"location": {
"id": "location_c7882546-652e-49cb-81a4-98962a54c49f",
"line1": "123 Test Street",
"line2": "",
"countryCode": "US",
"postalCode": "84790"
}
},
{
"id": "party_0mjfz59bgg175",
"type": "ORIGIN",
"person": {
"firstName": "test",
"lastName": "destination",
"email": null,
"phone": "1234567890"
},
"location": {
"id": "location_0mdzb9vk8bp7c",
"line1": "998 Ridgehaven",
"line2": null,
"countryCode": "CA",
"postalCode": "N0N 0N0"
}
}
]
}
}
}
4. Crea la spedizione
Elabora la creazione dell'etichetta utilizzando i dati compilati automaticamente da un ID dichiarazione o le informazioni della dichiarazione immesse manualmente.
5. Collega il numero di tracciabilità all'ID della dichiarazione
Dopo la creazione dell'etichetta, utilizzare la mutazione declarationShipmentCreate per collegare il numero di tracciabilità all'ID dichiarazione, garantendo la corretta convalida del pagamento dei dazi e il tracciamento della spedizione.
mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) { declarationShipmentCreate(input: $input)}È possibile creare una spedizione legata a un ID dichiarazione passando un array di trackingNumbers e il declarationID utilizzato per la spedizione.
Puoi anche creare una spedizione passando il declarationID con i dettagli sui cartoni e sugli articoli all'interno dei cartoni; puoi passarli nel shipmentCarton insieme al trackingNumber per quel cartone.
Etichette di spedizione | Convalidare un ID di dichiarazione
Recupera lo stato di un ID dichiarazione e compila automaticamente la documentazione doganale
Se crei etichette postali, puoi chiamare Zonos per recuperare i dettagli completi della dichiarazione doganale quando un utente fornisce un ID dichiarazione. Ciò elimina la necessità per gli utenti di compilare manualmente la documentazione doganale, creando un'esperienza di spedizione fluida in cui i dazi sono prepagati e i moduli doganali vengono compilati automaticamente.