DOCS

Objeto Landed Cost

Explore as capacidades e funções do objeto Landed Cost.

O objeto Landed Cost fornece uma discriminação e o total dos direitos de importação, impostos e taxas.

Atributos 

Campo↕Notas↕
id STRINGO identificador único do objeto. O id do objeto Landed Cost tem sempre o prefixo ldct.
amount_subtotal HASHTotal do landed cost. Se o utilizar num checkout de comércio eletrónico, recomendamos que apresente estes totais ao utilizador final. Estes totais facilitam a integração, sem necessidade de somar os direitos aduaneiros, impostos ou taxas por artigo e por envio. Estão disponíveis mais detalhes no objeto Landed Cost. Consulte os atributos filhos abaixo.
amount_subtotal.duties DECIMALSoma de todos os direitos aduaneiros do array de direitos. Inclui os direitos cobrados sobre os artigos, o envio ou quaisquer direitos adicionais aplicados à importação. Para compreender como os direitos aduaneiros são calculados, consulte a documentação sobre direitos de importação.
amount_subtotal.fees DECIMALSoma das várias taxas do array de taxas. Inclui as taxas de desalfandegamento, as taxas de importação do país ou outras taxas aplicadas à importação. Para saber mais sobre as taxas de importação, consulte a documentação sobre taxas de importação.
amount_subtotal.taxes DECIMALSoma de todos os impostos do array de impostos. Inclui os impostos aplicados aos artigos, aos direitos aduaneiros, ao envio ou às taxas. Para saber mais sobre os impostos de importação, consulte a documentação sobre impostos de importação.
currency HASHHash com informações sobre a moeda base enviada no pedido e sobre outras moedas, com a taxa de câmbio utilizada no momento da resposta. É útil se pretender converter para a moeda do país de importação ou para outras moedas utilizadas no cálculo do landed cost. Consulte os atributos filhos abaixo.
currency.id STRINGO identificador único do objeto de moeda.
currency.base STRINGA moeda base enviada no pedido de landed cost, representada por um código ISO de três letras. Todos os montantes do objeto Landed Cost são apresentados 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 que contém as moedas e as taxas de câmbio necessárias para a conversão a partir da moeda base.
currency.rates.currency STRINGUma moeda de taxa de câmbio utilizada no cálculo do landed cost.
currency.rates.rate DECIMALA taxa de câmbio da moeda especificada no momento do pedido de landed cost.
customs HASHHash que contém as informações utilizadas para determinar o landed cost, bem como as informações necessárias para a documentação aduaneira e o desalfandegamento. Consulte os atributos filhos abaixo.
customs.delivery_duty_paid STRINGA possibilidade de faturar os direitos aduaneiros e impostos a alguém que não o destinatário (DDP - delivery duty paid) varia consoante a transportadora, o serviço de envio ou o país de destino. Os valores possíveis são available, unavailable e unknown. Se o landed cost for utilizado num checkout de comércio eletrónico, só deve permitir que o comprador pague os direitos aduaneiros e impostos se o resultado for available. Se o resultado for unknown, pode apresentar ao comprador um montante estimado de direitos aduaneiros e impostos a pagar no momento da entrega ou optar por não apresentar os direitos aduaneiros e impostos para esse nível de serviço da transportadora. Se o resultado for unavailable, a sua conta foi configurada no Zonos Dashboard para não permitir DDP, apesar de este ser um serviço permitido pela transportadora selecionada.
customs.items LISTA lista de artigos enviados no pedido. Consulte os atributos filhos abaixo.
customs.items.id STRINGO identificador único enviado no pedido.
customs.items.amount DECIMALO montante do artigo na moeda base. É o montante enviado no pedido para este artigo.
customs.items.country_of_origin STRINGO país de fabrico onde o artigo foi produzido. Representado por um código ISO de duas letras. Consulte a documentação sobre direitos de importação para compreender 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. Os valores possíveis são zonos_catalog, api_request e account_default platform.
customs.items.description_customs STRINGA descrição sugerida das mercadorias para a fatura comercial. Esta descrição difere normalmente da descrição de venda e inclui, em geral, uma descrição genérica do que é o artigo, do material de que é feito e da sua utilização.
customs.items.description_retail STRINGA descrição de venda do artigo.
customs.items.detail STRINGCaracterísticas, atributos ou descrições adicionais do artigo.
customs.items.dimensions LISTO tamanho do envio. hash
customs.items.dimensions.height DECIMALA altura do artigo.
customs.items.dimensions.length DECIMALO comprimento do artigo.
customs.items.dimensions.unit STRINGA unidade de medida das dimensões do artigo. Os valores possíveis são inch, centimeter, millimeter e null. Quando for null, é utilizado inch.
customs.items.dimensions.width DECIMALA largura do artigo.
customs.items.hs_code STRINGO código pautal harmonizado utilizado para determinar a taxa pautal no cálculo do landed cost.
customs.items.hs_code_source STRINGA origem do código pautal harmonizado utilizado, que pode ser definido pela Zonos. Os valores possíveis são 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 o desalfandegamento do artigo ou o código SH, 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 artigo, tal como enviada no pedido.
customs.items.upc_code STRINGO código UPC do artigo.
customs.items.weight DECIMALO peso do artigo.
customs.items.weight_unit STRINGA unidade de medida do peso. Os valores possíveis são pound, ounce, kilogram e null. Quando for null, é utilizado pound.
customs.ship_to_country STRINGO país de importação onde são aplicados os direitos aduaneiros e impostos.
customs.shipping_amount DECIMALO montante do envio que deve constar da documentação aduaneira.
de_minimis HASHInformações sobre o limiar específico do país que determina quando se aplicam direitos aduaneiros e impostos. O array de taxas de câmbio contém a taxa de conversão utilizada para determinar se a importação ficou acima ou abaixo dos limiares de direitos aduaneiros e impostos. Consulte os atributos filhos abaixo.
de_minimis.formula STRINGA fórmula utilizada para calcular a elegibilidade para o limiar de minimis.
de_minimis.method STRINGO método de cálculo, como cif, cifd, cifdt, fob ou fobd.
de_minimis.note STRINGDetalhes adicionais sobre o de minimis, como a indicação de que um artigo não era elegível para o regime de minimis (por exemplo, vinho).
de_minimis.threshold STRINGIndica se o imposto está abaixo ou acima do limiar fiscal. Os valores possíveis incluem above ou below.
de_minimis.type STRINGO type ao qual se aplica o de minimis. Os valores possíveis incluem tax e duty.
duties HASHUm array de direitos aduaneiros aplicados à importação. A soma dos montantes dos direitos é igual a amount_subtotal.duties. Consulte os atributos filhos abaixo.
duties.amount DECIMALO montante dos direitos aduaneiros sobre item, shipping ou fee.
duties.description STRINGDiversas descrições do direito aduaneiro, como duty, anti_dumping_duty, entre outras.
duties.formula STRINGA fórmula utilizada para calcular o montante dos direitos aduaneiros. Para os direitos aduaneiros, é normalmente a pauta do país de importação, podendo tratar-se de uma taxa ad valorem ou de um direito específico.
duties.item_id STRINGO identificador único enviado no pedido. O id só é fornecido quando o tipo é item.
duties.note STRINGDetalhes adicionais sobre o direito aduaneiro, incluindo acordos de comércio livre, taxas de direitos reduzidas, direitos anti-dumping, entre outros.
duties.type STRINGO type ao qual se aplica o direito aduaneiro. Os valores possíveis incluem item, shipping e fee.
fees HASHUm array de taxas aplicadas à importação. A soma dos montantes das taxas é igual a amount_subtotal.fees. Consulte os atributos filhos abaixo.
fees.amount DECIMALO montante da taxa aplicada ao artigo, ao envio, aos direitos aduaneiros, ao nível de serviço, à transportadora ou ao país. Este montante está na moeda base e pode ter sido convertido da moeda do país de importação para a moeda base enviada no pedido.
fees.description STRINGDiversas descrições da taxa, como UPS Disbursement Fee, FedEx Advancement Fee e An Post Clearance Fee.
fees.formula STRINGA fórmula utilizada para calcular a taxa. No caso das taxas, trata-se normalmente de um montante fixo, de uma percentagem dos direitos aduaneiros e impostos ou de outra fórmula.
fees.item_id STRINGO seu identificador único enviado no pedido de landed cost. O id só é fornecido quando o tipo é item.
fees.note STRINGDetalhes adicionais sobre a taxa, se necessário.
fees.type STRINGO type ao qual se aplica a taxa. 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 montante do envio no pedido era nulo, o que pode afetar o cálculo.
messages.message STRINGUma mensagem útil relacionada com o seu pedido de Landed Cost e com as informações não críticas em falta.
messages.type STRINGO tipo de mensagem. Os valores possíveis incluem price_adjustment, default_value_used, shipping_missing e item_weight_missing
remittance HASHUm array com o montante e os detalhes do que tem de ser entregue a um país específico, por exemplo, Austrália, Nova Zelândia, Noruega ou Reino Unido.
remittance.amount DECIMALO montante que tem de ser entregue a um país específico.
remittance.description STRINGUma descrição da finalidade da entrega, por exemplo, IVA do Reino Unido.
remittance.note STRINGUma nota sobre a forma como o imposto deve ser entregue, por exemplo, entregar ao HMRC trimestralmente.
removed_items LISTA lista de artigos removidos do pedido para o cálculo do landed cost. Artigos: consulte os atributos filhos abaixo.
removed_items.id STRINGO identificador único enviado no pedido.
removed_items.amount DECIMALO montante do artigo na moeda base. É o montante enviado no pedido para este artigo.
removed_items.country_of_origin STRINGO país de fabrico onde o artigo foi produzido. Representado por um código ISO de duas letras. Consulte a documentação sobre direitos de importação para compreender 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. Os valores possíveis são zonos_catalog, api_request e account_default platform.
removed_items.description_customs STRINGA descrição sugerida das mercadorias para a fatura comercial. Esta descrição difere normalmente da descrição de venda e inclui, em geral, uma descrição genérica do que é o artigo, do material de que é feito e da sua utilização.
removed_items.description_retail STRINGA descrição de venda do artigo.
removed_items.hs_code STRINGO código pautal harmonizado utilizado para determinar a taxa pautal no cálculo do landed cost.
removed_items.hs_code_source STRINGA origem do código pautal harmonizado utilizado, 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 STRINGDetalhes adicionais sobre o desalfandegamento do artigo ou o código SH, 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 artigo, tal como enviada no pedido.
taxes HASHUm array de impostos aplicados à importação. A soma dos montantes dos impostos é igual a amount_subtotal.taxes. Consulte os atributos filhos abaixo.
taxes.amount DECIMALO montante do imposto sobre o artigo, o envio, os direitos aduaneiros ou a taxa.
taxes.description STRINGDiversas descrições do imposto aplicado, como tax, VAT, GST, PST, HST, entre outras.
taxes.formula STRINGA fórmula utilizada para calcular o montante do imposto inclui normalmente o imposto do país de importação; no entanto, pode também tratar-se de um imposto estadual (ou provincial) ou de um imposto reduzido (ou acrescido).
taxes.item_id STRINGO identificador único enviado no pedido 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 type ao qual se aplica o imposto. Os valores possíveis incluem item, duty e shipping, bem como os 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?