Preencher automaticamente declarações alfandegárias
Siga os passos abaixo para ativar o preenchimento automático de declarações aduaneiras usando o ID da declaração da sua plataforma.
1. Habilite o campo ID da declaração no fluxo de criação de etiquetas
Adicione um campo de ID de declaração à interface de criação de etiqueta postal. Quando os usuários inserem um ID de declaração válido, sua plataforma pode preencher automaticamente a declaração alfandegária, eliminando a entrada manual de dados.
2. Verifique o status do ID da declaração e os detalhes da declaração aduaneira
Use a consulta a seguir para obter os dados completos da declaração alfandegária usando o ID da declaração. Isso retorna o status de validação junto com detalhes do item, valores, códigos HS e informações do destinatário, quando disponíveis
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. Processar a resposta e preencher automaticamente a declaração aduaneira
A resposta API inclui status de validação e dados alfandegários. Utilize as informações de status para determinar se o ID da declaração é válido, preencha automaticamente os dados alfandegários disponíveis ou solicite a entrada manual.
Exemplos de respostas
ID de declaração válida com dados alfandegários completos:
{
"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. Crie a remessa
Processe a criação de etiquetas usando dados preenchidos automaticamente de um ID de declaração ou informações de declaração inseridas manualmente.
5. Vincule o número de rastreamento ao ID da declaração
Depois de criar a etiqueta, use a mutação declarationShipmentCreate para vincular o número de rastreamento ao ID da declaração, garantindo a validação adequada do pagamento dos impostos e do rastreamento da remessa.
mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) { declarationShipmentCreate(input: $input)}Você pode criar uma remessa vinculada a um ID de declaração passando uma matriz de trackingNumbers e o declarationID usado para envio.
Você também pode criar uma remessa passando o declarationID com detalhes sobre as caixas e os itens dentro delas; você pode informar esses detalhes em shipmentCarton, junto com o trackingNumber daquela caixa.
Etiquetas de envio | Validar um ID de declaração
Obtenha o status de um ID de declaração e preencha automaticamente a documentação alfandegária
Se você criar etiquetas postais, poderá chamar a Zonos para obter detalhes completos da declaração alfandegária quando um usuário fornecer um ID de declaração. Isso elimina a necessidade de os usuários preencherem manualmente a documentação alfandegária, criando uma experiência de remessa perfeita, onde as taxas são pré-pagas e os formulários alfandegários são preenchidos automaticamente.