Encontre os pares chave/valor em uma solicitação de landed cost.
Embora Zonos Landed Cost possa fornecer um landed cost preciso com base apenas na descrição do item, quanto mais informações forem fornecidas, mais precisa será a cotação do landed cost. As entradas OBRIGATÓRIAS e OPCIONAIS estão listadas abaixo, mas é recomendado que você preencha o máximo possível de campos OPCIONAIS.
Um código HS é altamente recomendado. Ao contrário do basic landed cost, o total landed cost incluirá detalhes das taxas tarifárias em nível de item por código HS.
Informações relativas a qualquer desconto, incluindo identificação, valor e quaisquer detalhes.
discounts.id OPCIONAL
O identificador exclusivo de desconto do comerciante ou exportador.
discounts.amount OPCIONAL
Um decimal com o valor do desconto, em dólares e centavos.
discounts.detail OPCIONAL
Recursos, atributos ou descrições adicionais do desconto.
items NECESSÁRIO
A lista de itens que são exportados. hash
items.id NECESSÁRIO
O identificador exclusivo do item do comerciante ou exportador.
items.amount NECESSÁRIO
Um decimal com o total de um único item, em dólares e centavos.
items.amount_discount OPCIONAL
O valor do desconto aplicado ao item.
items.brand OPCIONAL
A marca do item, por exemplo, Leatherman.
items.category OPCIONAL
Descrição da categoria do item, por exemplo, Roupas.
items.color OPCIONAL
Cor do item.
items.country_of_origin OPCIONAL
O país de fabricação ou produção, representado por um código ISO de duas letras. É recomendado para cotações mais precisas. Se nenhum país de origem for recebido, será utilizada a taxa da nação mais favorecida (NMF).
items.description_customs OPCIONAL
A 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.
items.description_retail OPCIONAL
A descrição de varejo do item.
items.detail OPCIONAL
Recursos, atributos ou descrições adicionais do item.
items.dimensions OPCIONAL
O tamanho do envio. Recomenda-se obter cotações mais precisas para países onde as tarifas são afetadas pelas dimensões do item. hash
items.dimensions.height OPCIONAL
Um decimal para a altura do item.
items.dimensions.length OPCIONAL
Um decimal para o comprimento do item.
items.dimensions.unit OPCIONAL
A unidade de medida das dimensões do item. Valores possíveis: inch, centimeter, millimeter e null. Quando for null, inch será usado.
items.dimensions.width OPCIONAL
Um decimal para a largura do item.
items.duty_tax_fee_free OPCIONAL
Uma sequência para especificar se o item não deve ser incluído no cálculo do landed cost. Quando exclude for enviado na solicitação, o item aparecerá como removed_items na resposta da API.
items.hs_code OPCIONAL
Código HS do artigo, de 2 a 10 dígitos.
items.image_url OPCIONAL
O URL da imagem.
items.quantity NECESSÁRIO
Um número inteiro com a quantidade do item.
items.upc_code OPCIONAL
A sequência de código UPC do item.
items.weight OPCIONAL
Um decimal para o peso do item.
items.weight_unit OPCIONAL
A unidade de cadeia de medida para peso. Valores possíveis: pound, ounce, kilogram e null. Quando for null, pound será usado.
landed_cost OPCIONAL
O tipo de solicitação de landed cost. Os valores possíveis incluem delivery_duty_paid e delivery_duty_unpaid. As taxas de um landed cost podem diferir dependendo do envio de DDP ou DDU. Se for null, será assumida uma solicitação DDP. Se uma solicitação DDP for feita e o DDP não estiver disponível, um erro 400 será retornado com uma mensagem indicando que o DDP não está disponível para o nível de serviço fornecido. DDP e DDU normalmente estão disponíveis em cada nível de serviço, portanto, certifique-se de que isso possa ser configurado por nível de serviço e não por nível de conta.
sale_type OPCIONAL
Um indicador do tipo de venda. Valores possíveis: not_for_resalefor_resale. Se for null, será assumida uma solicitação not_for_resale.
Solicitar um Landed Cost
Solicitar um Landed Cost
Encontre os pares chave/valor em uma solicitação de landed cost.
Embora Zonos Landed Cost possa fornecer um landed cost preciso com base apenas na descrição do item, quanto mais informações forem fornecidas, mais precisa será a cotação do landed cost. As entradas OBRIGATÓRIAS e OPCIONAIS estão listadas abaixo, mas é recomendado que você preencha o máximo possível de campos OPCIONAIS.
Atributos
Pares de chave/valor JSON no corpo da solicitação
POST |
https://api.zonos.com/v1/landed_costHEADER
zonos-version: 2019-11-21currencyNECESSÁRIOdiscountsOPCIONALdiscounts.idOPCIONALdiscounts.amountOPCIONALdiscounts.detailOPCIONALitemsNECESSÁRIOhashitems.idNECESSÁRIOitems.amountNECESSÁRIOitems.amount_discountOPCIONALitems.brandOPCIONALitems.categoryOPCIONALitems.colorOPCIONALitems.country_of_originOPCIONALitems.description_customsOPCIONALitems.description_retailOPCIONALitems.detailOPCIONALitems.dimensionsOPCIONALhashitems.dimensions.heightOPCIONALitems.dimensions.lengthOPCIONALitems.dimensions.unitOPCIONALinch,centimeter,millimeterenull. Quando fornull,inchserá usado.items.dimensions.widthOPCIONALitems.duty_tax_fee_freeOPCIONALexcludefor enviado na solicitação, o item aparecerá comoremoved_itemsna resposta da API.items.hs_codeOPCIONALitems.image_urlOPCIONALitems.quantityNECESSÁRIOitems.upc_codeOPCIONALitems.weightOPCIONALitems.weight_unitOPCIONALpound,ounce,kilogramenull. Quando fornull,poundserá usado.landed_costOPCIONALdelivery_duty_paidedelivery_duty_unpaid. As taxas de um landed cost podem diferir dependendo do envio de DDP ou DDU. Se fornull, será assumida uma solicitação DDP. Se uma solicitação DDP for feita e o DDP não estiver disponível, um erro 400 será retornado com uma mensagem indicando que o DDP não está disponível para o nível de serviço fornecido. DDP e DDU normalmente estão disponíveis em cada nível de serviço, portanto, certifique-se de que isso possa ser configurado por nível de serviço e não por nível de conta.sale_typeOPCIONALnot_for_resalefor_resale. Se fornull, será assumida uma solicitaçãonot_for_resale.ship_from_countryNECESSÁRIOship_toNECESSÁRIOhashship_to.cityOPCIONAL*ship_to.countryNECESSÁRIOship_to.postal_codeOPCIONAL*ship_to.stateOPCIONAL*shippingNECESSÁRIOhashshipping.amountNECESSÁRIOshipping.amount_discountOPCIONALshipping.service_levelNECESSÁRIO{"currency": "USD","discounts": [{"id": "sale124","amount": 43,"detail": null}],"items": [{"id": "294395","amount": 75,"amount_discount": 0,"brand": null,"category": "Women's Clothing","color": null,"country_of_origin": "FR","description_customs": null,"description_retail": "Hoka One Running Shoe - Women's","detail": null,"dimensions": {"height": 4,"length": 6,"unit": "inch","width": 11},"duty_tax_fee_free": null,"hs_code": "6116.10.00","image_url": "https://zonos.com/images/handbag.webp","quantity": 1,"upc_code": null,"weight": 10,"weight_unit": "pound"},{"id": "294396","amount": 15,"country_of_origin": "CN","country_of_origin_source": "account_default","description_customs": "Men's t-shirt 100% polyester","description_retail": "Galaxy Quest Men's Tee Blue","detail": null,"dimensions": {"height": 4,"lenght": 6,"unit": "inch","width": 11},"duty_tax_fee_free": "exclude","hs_code": "6217.10","image_url": null,"note": null,"quantity": 1,"upc_code": null,"weight": 1,"weight_unit": "pound"}],"landed_cost": "delivery_duty_paid","sale_type": "not_for_resale","ship_from_country": "US","ship_to": {"city": "Campinas","country": "BR","postal_code": "75828-000","state": "SP"},"shipping": {"amount": 14.23,"amount_discount": 0,"service_level": "ups_express_saver"},"tariff_rate": "zonos_preferred"}Esta página foi útil?