Atributos
| Campo | Notas |
|---|---|
id STRING | O identificador único para o objeto. O id para o objeto Landed Cost sempre será prefixado com ldct. |
amount_subtotal HASH | Total do Landed cost. Se estiver usando para um checkout de ecommerce, recomendamos usar esses totais para exibir ao usuário final. Esses totais permitem uma integração mais fácil sem a necessidade de somar direitos, impostos ou taxas por item e nível de remessa. Detalhes adicionais estão disponíveis no objeto landed cost. Veja os atributos filhos abaixo. |
amount_subtotal.duties DECIMAL | Soma de todos os direitos no array de direitos. Inclui direitos aplicados a itens, envio ou quaisquer direitos adicionais aplicados à importação. Para entender como os direitos são calculados, veja o documento de direitos de importação. |
amount_subtotal.fees DECIMAL | Soma das várias taxas no array de taxas. Inclui taxas de liberação, taxas de importação do país ou outras taxas aplicadas à importação. Para entender mais sobre taxas de importação, veja o documento de taxas de importação. |
amount_subtotal.taxes DECIMAL | Soma de todos os impostos no array de impostos. Inclui impostos aplicados a itens, direitos, envio ou taxas. Para entender mais sobre impostos de importação, veja o documento de impostos de importação. |
currency HASH | Hash fornecendo informações sobre a moeda base enviada na solicitação e outras moedas com a rate de câmbio usada no momento da resposta. Isso é útil se você quiser converter para a moeda do país de importação ou para outras moedas usadas no cálculo do landed cost. Veja os atributos filhos abaixo. |
currency.id STRING | O identificador único para o objeto de moeda. |
currency.base STRING | A moeda base enviada na solicitação de landed cost, representada por um código ISO de três letras. Todos os valores no objeto landed cost estão listados na moeda base. |
currency.date TIMESTAMP | A data em que a rate de câmbio foi obtida, no formato ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ |
currency.rates HASH | Hash contendo as moedas e taxas de câmbio necessárias para conversão da moeda base. |
currency.rates.currency STRING | Uma moeda de rate de câmbio usada no cálculo do landed cost. |
currency.rates.rate DECIMAL | A rate de câmbio no momento da solicitação de landed cost para a moeda especificada. |
customs HASH | Hash contendo informações usadas para determinar o landed cost, bem como informações necessárias para documentação e liberação alfandegária. Veja os atributos filhos abaixo. |
customs.delivery_duty_paid STRING | A capacidade de cobrar taxas e impostos para alguém que não seja o destinatário (DDP - entrega com impostos pagos) varia de acordo com a transportadora, serviço de envio ou país de destino. Os valores possíveis são disponível, indisponível e desconhecido. Se o landed cost for usado para um checkout de comércio eletrônico, você só deve permitir que o comprador pague taxas e impostos se o resultado for disponível. Se o resultado for desconhecido, você pode apresentar ao comprador uma estimativa do valor de taxas e impostos que terá que pagar na entrega ou pode optar por não exibir as taxas e impostos para esse nível de serviço da transportadora. Se o resultado for indisponível, sua conta foi configurada no Painel Zonos para não permitir DDP, mesmo que seja um serviço permitido pela transportadora selecionada. |
customs.items LIST | A lista de itens enviados na solicitação. Consulte os atributos abaixo. |
customs.items.id STRING | O identificador único enviado na solicitação. |
customs.items.amount DECIMAL | O valor do item na moeda base. Este é o valor enviado na solicitação para este item. |
customs.items.country_of_origin STRING | O país de fabricação onde o item ou artigo foi produzido. Representado por um código ISO de duas letras. Consulte o documento sobre tarifas de importação para entender como o país de origem impacta o cálculo do landed cost. |
customs.items.country_of_origin_source STRING | A fonte do país de origem. Os valores possíveis são zonos, solicitação_api, e padrão_conta plataforma. |
customs.items.description_customs STRING | A descrição sugerida dos produtos para a fatura comercial. Essa descrição geralmente difere de uma descrição de varejo e normalmente inclui uma descrição geral do que é, do que é feito e para que é usado. |
customs.items.description_retail STRING | A descrição de varejo do item. |
customs.items.detail STRING | Recursos adicionais, atributos ou descrições do item. |
customs.items.dimensions LIST | O tamanho do envio. hash |
customs.items.dimensions.height DECIMAL | A altura do item. |
customs.items.dimensions.length DECIMAL | O comprimento do item. |
customs.items.dimensions.unit STRING | A unidade de medida para as dimensões do item. Os valores possíveis são polegada, centímetro, milímetro e nulo. Quando nulo, polegada será usada. |
customs.items.dimensions.width DECIMAL | A largura do item. |
customs.items.hs_code STRING | O código tarifário harmonizado usado para determinar a rate na calculação do landed cost. |
customs.items.hs_code_source STRING | A fonte do código tarifário harmonizado usado, que pode ser definido pela Zonos. Os valores possíveis são zonos, solicitação_api, zonos, padrão_conta e correção_hs. |
customs.items.image_url STRING | A URL da imagem. |
customs.items.note STRING | Detalhes adicionais sobre o desembaraço aduaneiro do item ou código HS, se aplicável. Um exemplo para a Índia é Conforme as diretrizes de importação da Índia para remessas pessoais, seu código HS foi corrigido para 9804.90.00. |
customs.items.quantity INTEGER | A quantidade do item enviada na solicitação. |
customs.items.upc_code STRING | O código UPC do item. |
customs.items.weight DECIMAL | O peso do item. |
customs.items.weight_unit STRING | A unidade de medida para o peso. Os valores possíveis são libra, onça, quilograma e nulo. Quando nulo, libra será usada. |
customs.ship_to_country STRING | O país de importação onde as taxas e impostos são aplicados. |
customs.shipping_amount DECIMAL | O valor do frete que deve ser listado na documentação aduaneira. |
de_minimis HASH | Informações sobre o limite específico do país que determina quando impostos e taxas se aplicam. A matriz de taxas de câmbio conterá a conversão rate usada para determinar se a importação estava acima ou abaixo dos limites de impostos e taxas. Veja os atributos filhos abaixo. |
de_minimis.formula STRING | A fórmula usada para calcular a elegibilidade do limite de de minimis. |
de_minimis.method STRING | Este é o método de cálculo, como cif, cifd, cifdt, fob ou fobd. |
de_minimis.note STRING | Detalhes adicionais sobre o de minimis, como fornecer informações se um item não era elegível para consideração de minimis, como vinho. |
de_minimis.threshold STRING | Se o imposto está abaixo ou acima do limite de imposto. Valores possíveis incluem above ou below. |
de_minimis.type STRING | O de minimis aplicado ao type. Valores possíveis incluem tax e duty. |
duties HASH | Uma matriz de impostos aplicados à importação. A soma dos valores dos impostos é igual ao amount_subtotal.duties. Veja os atributos filhos abaixo. |
duties.amount DECIMAL | O valor do imposto sobre o item, shipping ou fee. |
duties.description STRING | Descrições variadas do imposto, como duty, anti_dumping_duty e mais. |
duties.formula STRING | A fórmula usada para calcular o valor do imposto. Para o imposto, isso é tipicamente a tarifa para o país de importação e pode ser ad valorem ou um imposto específico rate. |
duties.item_id STRING | O identificador único enviado na solicitação. O id é fornecido apenas quando o tipo é item. |
duties.note STRING | Detalhes adicionais sobre o imposto, incluindo acordos de livre comércio, taxas de imposto reduzidas, impostos antidumping e mais. |
duties.type STRING | O imposto é aplicado ao type. Valores possíveis incluem item, shipping e fee. |
fees HASH | Uma matriz de taxas aplicadas à importação. A soma dos valores das taxas é igual ao amount_subtotal.fees. Veja os atributos filhos abaixo. |
fees.amount DECIMAL | O valor da taxa aplicada ao item, frete, imposto, nível de serviço, transportadora ou país. Este valor está na moeda base e pode ter sido convertido da moeda respectiva do país de importação para a moeda base enviada na solicitação. |
fees.description STRING | Descrições variadas da taxa, como UPS Disbursement Fee, FedEx Advancement Fee e An Post Clearance Fee. |
fees.formula STRING | A fórmula usada para calcular a taxa. Para taxas, isso é tipicamente um valor fixo, uma porcentagem dos impostos e taxas, ou outra fórmula. |
fees.item_id STRING | Seu identificador único enviado na solicitação de landed cost. O id é fornecido apenas quando o tipo é item. |
fees.note STRING | Detalhes adicionais sobre a taxa, se necessário. |
fees.type STRING | A taxa é aplicada ao type. Valores possíveis incluem advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country e other. |
messages HASH | Uma lista de mensagens não críticas, por exemplo, “O valor do frete na solicitação era nulo, isso pode impactar o cálculo.” |
messages.message STRING | Uma mensagem útil relacionada à sua solicitação de Landed Cost e qual informação não crítica estava faltando. |
messages.type STRING | O tipo de mensagem. Valores possíveis incluem price_adjustment, default_value_used, shipping_missing e item_weight_missing |
remittance HASH | Uma matriz contendo o valor e os detalhes do que precisa ser remetido para um país específico (por exemplo, Austrália, Nova Zelândia, Noruega ou Reino Unido). |
remittance.amount DECIMAL | O valor do dinheiro que precisa ser remetido para um país específico. |
remittance.description STRING | Uma descrição do que é a remessa (por exemplo, IVA do Reino Unido). |
remittance.note STRING | Uma nota sobre como o imposto deve ser remetido (por exemplo, remit ao HMRC trimestralmente). |
removed_items LIST | A lista de itens removidos do pedido para o cálculo do landed cost. ItensVeja os atributos filhos abaixo. |
removed_items.id STRING | O identificador único enviado no pedido. |
removed_items.amount DECIMAL | O valor do item na moeda base. Este é o valor enviado no pedido para este item. |
removed_items.country_of_origin STRING | O país de fabricação onde o item ou artigo foi produzido. Representado por um código ISO de duas letras. Consulte o documento sobre impostos de importação para entender como o país de origem impacta o cálculo do landed cost. |
removed_items.country_or_origin_source STRING | A fonte do país de origem. Os valores possíveis são zonos_catalog, api_request, e account_default platform. |
removed_items.description_customs STRING | A descrição sugerida dos bens para a fatura comercial. Esta descrição geralmente difere de uma descrição de varejo e normalmente incluirá uma descrição geral do que é, do que é feito e para que é usado. |
removed_items.description_retail STRING | A descrição de varejo do item. |
removed_items.hs_code STRING | O código tarifário harmonizado usado para determinar a rate tarifária no cálculo do landed cost. |
removed_items.hs_code_source STRING | A fonte do código tarifário harmonizado usado, que pode ser definido pela Zonos. Os valores possíveis são zonos_catalog, api_request, platform, zonos_classified, account_default, e hs_correction. |
removed_items.note STRING | Detalhes adicionais sobre a liberação do item ou código HS, se aplicável. Um exemplo para a Índia é Conforme as diretrizes de importação da Índia para remessas pessoais, seu código HS foi corrigido para 9804.90.00. |
removed_items.quantity INTEGER | A quantidade do item enviada no pedido. |
taxes HASH | Uma matriz de impostos aplicados à importação. A soma dos valores dos impostos é igual a amount_subtotal.taxes. Veja os atributos filhos abaixo. |
taxes.amount DECIMAL | O valor do imposto sobre o item, transporte, tarifa ou taxa. |
taxes.description STRING | Descrições variadas do imposto aplicado, como imposto, IVA, GST, PST, HST e outros. |
taxes.formula STRING | A fórmula usada para calcular o valor do imposto geralmente inclui o imposto do país de importação; no entanto, isso também pode ser um imposto estadual (ou provincial) ou um imposto reduzido (ou adicionado). |
taxes.item_id STRING | O identificador único enviado no pedido do landed cost. O id é fornecido apenas quando o tipo é item. |
taxes.note STRING | Detalhes adicionais sobre o imposto, incluindo taxas de imposto reduzidas ou outras informações aplicáveis sobre o imposto aplicado. |
taxes.type STRING | O imposto é aplicado ao type. Os valores possíveis incluem item duty e shipping bem como os tipos de taxas advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country e other. |
Exemplo de pedido
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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
{
"id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
"amount_subtotal": {
"duties": 0,
"fees": 15,
"taxes": 12.25
},
"currency": {
"id": "b5f06418-3",
"base": "USD",
"date": "2021-01-07T00:34:03.471+0000",
"rates": [
{
"currency": "GBP",
"rate": 0.8117
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 39.17,
"country_of_origin": "FR",
"country_of_origin_source": null,
"description_customs": "Hoka One Running Shoe - Women's",
"description_retail": "Hoka One Running Shoe - Women's",
"hs_code": "6116.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
"quantity": 1
},
{
"id": "294396",
"amount": 7.83,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Galaxy Quest Men's Tee Blue",
"description_retail": "Galaxy Quest Men's Tee Blue",
"hs_code": "6217.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "GB"
},
"de_minimis": [
{
"formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
"method": "FOB",
"note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
"threshold": "below",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 gbp)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [],
"fees": [
{
"amount": 15,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
}
],
"remittance": [
{
"amount": 12.25,
"description": "UK VAT",
"note": "remit to HMRC quarterly"
}
],
"removed_items": [],
"taxes": [
{
"amount": 7.83,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 2.3719,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "shipping"
},
{
"amount": 1.57,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 0.4741,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "shipping"
}
]
}
Objeto Landed Cost
Explore as capacidades e funções do objeto Landed Cost.
O objeto Landed Cost fornece uma divisão e total dos direitos de importação, impostos e taxas.