DOCS

Objeto Landed Cost

Explore os recursos e funções do objeto Landed Cost.

O objeto Landed Cost fornece um detalhamento e o total de direitos, impostos e taxas de importação.

Atributos 

CampoNotas
id STRINGO identificador exclusivo do objeto. O ID do objeto Landed Cost sempre será prefixado com ldct.
amount_subtotal HASHCusto total no destino. Se usado para uma checkout de comércio eletrônico, recomendamos usar esses totais para exibir ao usuário final. Estes totais permitem uma integração mais fácil sem a necessidade de somar direitos, impostos ou taxas por item e por remessa. Detalhes adicionais estão disponíveis no objeto de landed cost. Veja os atributos secundários abaixo.
amount_subtotal.duties DECIMALSoma de todos os direitos na matriz de deveres. Inclui taxas aplicadas a itens, remessa ou quaisquer taxas adicionais aplicadas à importação. Para entender como as taxas são calculadas, consulte documentação de taxas de importação.
amount_subtotal.fees DECIMALSoma das diversas taxas na matriz de taxas. Inclui taxas de desembaraço, taxas de importação do país ou outras taxas aplicadas à importação. Para obter mais informações sobre taxas de importação, consulte documentação de taxas de importação.
amount_subtotal.taxes DECIMALSoma de todos os impostos na matriz de impostos. Inclui impostos aplicados a itens, taxas, frete ou taxas. Para obter mais informações sobre impostos de importação, consulte documentação fiscal de importação.
currency HASHHash que fornece informações sobre a moeda base enviada na solicitação e outras moedas com a taxa de câmbio utilizada no momento da resposta. É útil se você quiser converter para a moeda do país importador ou para outras moedas usadas no cálculo do custo de importação. Veja os atributos secundários abaixo.
currency.id STRINGO identificador exclusivo do objeto de moeda.
currency.base STRINGA moeda base enviada na solicitação de landed cost, representada por um código ISO de três letras. Todos os valores no objeto de landed cost são indicados na moeda base.
currency.date TIMESTAMPA data em que a taxa de câmbio foi obtida, no formato ISO 8601: YYYY-MM-DDTHH:mm:ss.sssZ
currency.rates HASHHash contendo as moedas e taxas de câmbio necessárias para conversão da moeda base.
currency.rates.currency STRINGUma moeda de taxa de câmbio usada no cálculo do landed cost.
currency.rates.rate DECIMALA taxa de câmbio no momento da solicitação de landed cost para a moeda especificada.
customs HASHHash que contém informações utilizadas para determinar o custo de entrega, bem como informações necessárias para documentação aduaneira e desembaraço aduaneiro. Veja os atributos secundários abaixo.
customs.delivery_duty_paid STRINGA possibilidade de faturar taxas e impostos a outra pessoa que não o destinatário (DDP – delivery dutypaid) varia consoante o transportador, o serviço de envio ou o país de destino. Valores possíveis: available, unavailable e unknown. Se o landed cost for usado para uma checkout de comércio eletrônico, você só deverá permitir que o comprador pague taxas e impostos se o resultado for available. Se o resultado for unknown, você poderá mostrar ao comprador um valor estimado de taxas e impostos a serem pagos na entrega ou optar por não mostrar as taxas e impostos para esse nível de serviço da transportadora. Se o resultado for unavailable, sua conta foi configurada no Zonos Dashboard para não permitir DDP, mesmo sendo um serviço permitido pela operadora selecionada.
customs.items LISTA lista de itens enviados na solicitação. Veja os atributos secundários abaixo.
customs.items.id STRINGO identificador exclusivo enviado na solicitação.
customs.items.amount DECIMALO valor do item na moeda base. Este é o valor enviado na solicitação deste item.
customs.items.country_of_origin STRINGO país de fabricação onde o item foi produzido. Representado por um código ISO de duas letras. Consulte a documentação de taxas de importação para entender como o país de origem afeta o cálculo do landed cost.
customs.items.country_of_origin_source STRINGA origem do país de origem. Valores possíveis: zonos_catalog, api_request e account_default platform.
customs.items.description_customs STRINGA descrição sugerida de mercadorias para a fatura comercial. Esta 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 STRINGA descrição de varejo do item.
customs.items.detail STRINGRecursos, atributos ou descrições adicionais do item.
LIST customs.items.dimensionsO tamanho do envio. hash
customs.items.dimensions.height DECIMALA altura do item.
customs.items.dimensions.length DECIMALO comprimento do item.
customs.items.dimensions.unit STRINGA unidade de medida das dimensões do item. Valores possíveis: inch, centimeter, millimeter e null. Quando for null, inch será usado.
customs.items.dimensions.width DECIMALA largura do item.
customs.items.hs_code STRINGO código tarifário harmonizado usado para determinar a tarifa no cálculo do landed cost.
customs.items.hs_code_source STRINGA origem do código tarifário harmonizado utilizado, que pode ser estabelecido por Zonos. Valores possíveis: zonos_catalog, api_request, zonos_classified, account_default e hs_correction.
customs.items.image_url STRINGO URL da imagem.
customs.items.note STRINGDetalhes adicionais sobre envio do item ou código HS, se aplicável. Um exemplo para a Índia é As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00.
customs.items.quantity INTEGERA quantidade do item enviado na solicitação.
customs.items.upc_code STRINGO código UPC do item.
customs.items.weight DECIMALO peso do item.
customs.items.weight_unit STRINGA unidade de medida do peso. Valores possíveis: pound, ounce, kilogram e null. Quando for null, pound será usado.
customs.ship_to_country STRINGO país de importação onde se aplicam taxas e impostos.
customs.shipping_amount DECIMALO valor do frete que deve constar na documentação alfandegária.
de_minimis HASHInformações sobre o limite específico do país que determina quando se aplicam taxas e impostos. A matriz de taxas de câmbio conterá a taxa de conversão usada para determinar se a importação estava acima ou abaixo dos limites de direitos e impostos. Veja os atributos secundários abaixo.
de_minimis.formula STRINGA fórmula usada para calcular a elegibilidade do limite de minimis.
de_minimis.method STRINGEste é o método de cálculo, como cif, cifd, cifdt, fob ou fobd.
de_minimis.note STRINGDetalhes adicionais sobre de minimis, como informações se um item não for elegível para consideração de minimis, como vinho.
de_minimis.threshold STRINGSe o imposto está abaixo ou acima do limite fiscal. Os valores possíveis incluem above ou below.
de_minimis.type STRINGO mínimo se aplica a type. Os valores possíveis incluem tax e duty.
duties HASHUma série de direitos aplicados à importação. A soma dos valores dos direitos é igual a amount_subtotal.duties. Veja os atributos secundários abaixo.
duties.amount DECIMALO valor do imposto sobre item, shipping ou fee.
duties.description STRINGDiversas descrições do direito, como duty, anti_dumping_duty, entre outras.
duties.formula STRINGA fórmula usada para calcular o valor do imposto. Para direitos, esta é geralmente a tarifa do país importador e pode ser ad valorem ou uma tarifa específica.
duties.item_id STRINGO identificador exclusivo enviado na solicitação. O id só é fornecido quando o tipo é item.
duties.note STRINGDetalhes adicionais sobre o direito, incluindo acordos de livre comércio, tarifas reduzidas, direitos antidumping e muito mais.
duties.type STRINGO direito se aplica a type. Os valores possíveis incluem item, shipping e fee.
fees HASHUma série de taxas aplicadas à importação. A soma dos valores das taxas é igual a amount_subtotal.fees. Veja os atributos secundários abaixo.
fees.amount DECIMALO valor da taxa aplicada ao item, frete, taxa, nível de serviço, transportadora ou país. Este valor está na moeda base e pode ter sido convertido da respectiva moeda do país importador para a moeda base enviada na solicitação.
fees.description STRINGDescrições de taxas variáveis, como UPS Disbursement Fee, FedEx Advancement Fee e An Post Clearance Fee.
fees.formula STRINGA fórmula usada para calcular a taxa. Para taxas, geralmente é um valor fixo, uma porcentagem de taxas e impostos ou outra fórmula.
fees.item_id STRINGSeu identificador exclusivo enviado na solicitação de landed cost. O id só é fornecido quando o tipo é item.
fees.note STRINGDetalhes adicionais sobre a tarifa, se necessário.
fees.type STRINGA tarifa se aplica a type. Os valores possíveis incluem advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country e other.
messages HASHUma lista de mensagens não críticas, por exemplo, O valor do frete na solicitação era nulo, isso pode afetar o cálculo.
messages.message STRINGUma mensagem útil sobre sua solicitação de Landed Cost e quais informações não críticas estavam faltando.
messages.type STRINGO tipo de mensagem. Os valores possíveis incluem price_adjustment, default_value_used, shipping_missing e item_weight_missing
remittance HASHUma 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 DECIMALA quantidade de dinheiro que deve ser remetida para um país específico.
remittance.description STRINGUma descrição da finalidade da remessa, por exemplo IVA do Reino Unido.
remittance.note STRINGUma nota sobre como o imposto deve ser remetido, por exemplo, remeter ao HMRC trimestralmente.
removed_items LISTA lista de itens removidos da solicitação de cálculo de landed cost. Veja os atributos secundários abaixo.
removed_items.id STRINGO identificador exclusivo enviado na solicitação.
removed_items.amount DECIMALO valor do item na moeda base. Este é o valor enviado na solicitação deste item.
removed_items.country_of_origin STRINGO país de fabricação onde o item foi produzido. Representado por um código ISO de duas letras. Consulte a documentação de taxas de importação para entender como o país de origem afeta o cálculo do landed cost.
removed_items.country_or_origin_source STRINGA origem do país de origem. Valores possíveis: zonos_catalog, api_request e account_default platform.
removed_items.description_customs STRINGA descrição sugerida de mercadorias para a fatura comercial. Esta 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.
removed_items.description_retail STRINGA descrição de varejo do item.
removed_items.hs_code STRINGO código tarifário harmonizado usado para determinar a tarifa no cálculo do landed cost.
removed_items.hs_code_source STRINGA origem do código tarifário harmonizado utilizado, que pode ser estabelecido por Zonos. Valores possíveis: zonos_catalog, api_request, platform, zonos_classified, account_default e hs_correction.
removed_items.note STRINGDetalhes adicionais sobre envio do item ou código HS, se aplicável. Um exemplo para a Índia é As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00.
removed_items.quantity INTEGERA quantidade do item enviado na solicitação.
taxes HASHUma série de impostos aplicados à importação. A soma dos valores dos impostos é igual a amount_subtotal.taxes. Veja os atributos secundários abaixo.
taxes.amount DECIMALO valor do imposto sobre o item, frete, imposto ou taxa.
taxes.description STRINGDescrições variáveis do imposto aplicado, como tax, VAT, GST, PST, HST e mais.
taxes.formula STRINGA fórmula utilizada para calcular o valor do imposto geralmente inclui o imposto do país importador; no entanto, também pode ser um imposto estadual (ou provincial) ou um imposto reduzido (ou adicional).
taxes.item_id STRINGO identificador exclusivo enviado na solicitação de landed cost. O id só é fornecido quando o tipo é item.
taxes.note STRINGDetalhes adicionais sobre o imposto, incluindo taxas de imposto reduzidas ou outras informações aplicáveis sobre o imposto aplicado.
taxes.type STRINGO imposto aplica-se a type. Os valores possíveis incluem item, duty e shipping, bem como tipos de taxa advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country e other.
1{
2 "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
3 "amount_subtotal": {
4 "duties": 0,
5 "fees": 15,
6 "taxes": 12.25
7 },
8 "currency": {
9 "id": "b5f06418-3",
10 "base": "USD",
11 "date": "2021-01-07T00:34:03.471+0000",
12 "rates": [
13 {
14 "currency": "GBP",
15 "rate": 0.8117
16 }
17 ]
18 },
19 "customs": {
20 "delivery_duty_paid": "available",
21 "items": [
22 {
23 "id": "294395",
24 "amount": 39.17,
25 "country_of_origin": "FR",
26 "country_of_origin_source": null,
27 "description_customs": "Hoka One Running Shoe - Women's",
28 "description_retail": "Hoka One Running Shoe - Women's",
29 "hs_code": "6116.10",
30 "hs_code_source": "api_request",
31 "note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
32 "quantity": 1
33 },
34 {
35 "id": "294396",
36 "amount": 7.83,
37 "country_of_origin": "CN",
38 "country_of_origin_source": "account_default",
39 "description_customs": "Galaxy Quest Men's Tee Blue",
40 "description_retail": "Galaxy Quest Men's Tee Blue",
41 "hs_code": "6217.10",
42 "hs_code_source": "api_request",
43 "note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
44 "quantity": 1
45 }
46 ],
47 "shipping_amount": 14.23,
48 "ship_to_country": "GB"
49 },
50 "de_minimis": [
51 {
52 "formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
53 "method": "FOB",
54 "note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
55 "threshold": "below",
56 "type": "duty"
57 },
58 {
59 "formula": "(cost {'<='} 0 gbp)",
60 "method": "FOB",
61 "note": "Tax applies to all shipments",
62 "threshold": "above",
63 "type": "tax"
64 }
65 ],
66 "duties": [],
67 "fees": [
68 {
69 "amount": 15,
70 "description": "UPS United States Duty and Tax Forwarding Charge",
71 "item_id": null,
72 "formula": "15 USD",
73 "note": null,
74 "type": "ddp_service_fee"
75 }
76 ],
77 "remittance": [
78 {
79 "amount": 12.25,
80 "description": "UK VAT",
81 "note": "remit to HMRC quarterly"
82 }
83 ],
84 "removed_items": [],
85 "taxes": [
86 {
87 "amount": 7.83,
88 "description": "VAT (Value-added tax)",
89 "item_id": "294395",
90 "formula": "20%",
91 "note": null,
92 "type": "item"
93 },
94 {
95 "amount": 2.3719,
96 "description": "VAT (Value-added tax)",
97 "item_id": "294395",
98 "formula": "20%",
99 "note": null,
100 "type": "shipping"
101 },
102 {
103 "amount": 1.57,
104 "description": "VAT (Value-added tax)",
105 "item_id": "294396",
106 "formula": "20%",
107 "note": null,
108 "type": "item"
109 },
110 {
111 "amount": 0.4741,
112 "description": "VAT (Value-added tax)",
113 "item_id": "294396",
114 "formula": "20%",
115 "note": null,
116 "type": "shipping"
117 }
118 ]
119}

Esta página foi útil?