Calcular um Landed Cost

O partyCreateWorkflowInput identifica as partes envolvidas e seus locais. Veja o esquema completo na Referência de nossa API GraphQL. Os campos necessários são:

• location
  • administrativeAreaCode: O código de estado ou província, em duas letras. Só necessário para CA e BR.
  • countryCode: O Código ISO de duas letras do país.
  • line1: A primeira linha do endereço.
  • postalCode: O código postal do endereço.
• person
  • email: O endereço de e-mail da pessoa.
  • firstName: O nome da pessoa.
  • lastName: O sobrenome da pessoa.
  • phone: O número de telefone da pessoa.
• type
  • DESTINATION: Informações de location e person para o destino de envio.
  • ORIGIN: Informações de location para a origem de envio. Não é necessária a person associada à origem de envio.

O itemCreateWorkflowInput lista os artigos do carrinho. Há muitos campos opcionais (veja todas as possibilidades em nossa referência de API), mas os campos a seguir são obrigatórios.

• amount: O valor de uma única unidade do produto que é enviado, antes de se multiplicar pela quantidade. Tenha em conta que isto difere da definição postal de um artigo postal. Se a quantity do artigo for 1, este é o custo total do artigo. Se a quantity do artigo for >1, a API multiplicará o amount do artigo pela quantity do artigo para obter o total da linha. Não coloque o preço total de todas as unidades do artigo em amount.
• currencyCode: O código de moeda do montante do artigo.
• quantity: A quantidade do artigo. A API multiplicará o amount do artigo pela quantity do artigo para obter o total da linha.
• countryOfOrigin: O país onde o artigo foi fabricado.
• Um dos seguintes (o que estiver configurado como sua preferência da chave do artigo. Sua chave de artigo conecta informações armazenadas em Catalog com o artigo do carrinho e é usada durante a criação de etiquetas. )
  • productId: O ID do produto do artigo.
  • sku: O SKU do artigo.

As measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) só são obrigatórias se quiser cartonizar seus artigos ao obter uma tarifa de envio.

O cartonsCreateWorkflowInput requer apenas a entrada em si. Veja o esquema completo na Referência de nossa API GraphQL para ver todos os valores que podem ser passados. É importante passar as dimensões e o peso do cartão se Zonos está calculando o custo de envio.

Este fluxo de trabalho é usado quando você já conhece o serviço e o custo de envio; se você quiser que Zonos calcule esses custos para os serviços que você habilitou, substitua este fluxo de trabalho e use shipmentRatingCalculateWorkflow em seu lugar.

O shipmentRatingCreateWorkflowInput comunica o custo de envio. Veja o esquema completo na Referência de nossa API GraphQL. Os campos necessários são:

• amount: O custo de envio.
• currencyCode: O código de moeda do custo de envio.
• serviceLevelCode: O código que indica o nível de serviço de envio utilizado na tarifa de envio.

O landedCostWorkFlowInput dita as preferências para o cálculo de Landed Cost. Veja o esquema completo na Referência de nossa API GraphQL. Os campos necessários são:

• calculationMethod: Indica a sua preferência sobre como tenciona enviar: DDP (tarifas e impostos pré-pagos) ou DAP (os direitos e impostos são pagos na entrega, ou se aplica um esquema de remissão, são encaminhados por um ID fiscal).
  • Se utilizar nossa garantia de Landed Cost, este valor deve sempre ser DDP_PREFERRED, que fornecerá uma cotação DDP quando possível e uma cotação DAP quando uma DDP não for permitida. Usar DAP em vez disso pode fazer com que os Landed Cost já não estejam garantidos, uma vez que isso normalmente resulta em tarifas e impostos pagos na entrega.
• endUse: Indica se as mercadorias são vendidas a outro negócio (FOR_RESALE) ou para uso final com um consumidor (NOT_FOR_RESALE).
• tariffRate: Indica o método que Zonos deve utilizar para calcular as taxas pautais desta cotação, caso haja um intervalo de taxas pautais que possam ser aplicadas. *Ao usar nossa garantia de Landed Cost, isso sempre deve ser ZONOS_PREFERRED.

Zonos recomenda fortemente a utilização de códigos HS específicos do produto, uma vez que conduz a uma cotação de Landed Cost mais precisa. Se você conhece seus códigos HS, passe o hsCode de cada item durante itemCreateWorkflow.

Se você passar um código HS, Zonos o validará automaticamente ao obter uma cotação de Landed Cost. Se o código HS fornecido não for válido (ou seja, não existe), Zonos irá reclassificar seu artigo automaticamente e usar o novo código HS válido em vez do fornecido.

Se precisar de ajuda para gerar códigos HS para seus produtos, conheça Zonos Classify e como solicitar uma classificação.

Se não passar para Zonos um hsCode, primeiro verificaremos Zonos Catalog para ver se tem um código HS armazenado para seu artigo. Se não, chamaremos Classify para gerar uma classificação que apoie o seu cálculo de Landed Cost segundo os seguintes campos de detalhe do produto itemCreateWorkflow: description, category e material. Se os campos de detalhes do seu produto não forem suficientemente detalhados para gerar uma classificação segundo a pontuação de confiança de Classify, o código HS por omissão atribuído à sua loja será utilizado.

Para que Zonos calcule os custos de envio, use shipmentRatingCalculateWorkflow. As opções de envio devolvidas na resposta de envio calculada serão correlacionadas com os serviceLevels que tenha atribuído aos perfis de envio em Dashboard.

Solução de problemas: Se você espera um serviceLevel na resposta, mas ele não aparece, certifique-se de que o serviceLevel esteja habilitado e seja compatível com o method selecionado.

Adicione cartonizeWorkflow (que não tem entradas) se quiser que Zonos organize seus artigos em cartões antes de encontrar o custo de envio (utilizado para peso dimensional).

Se conhecer o serviceLevel e o amount de um envio, você pode passá-los na porção shipmentRatingCreateWorkflow do pedido. Usaremos esses valores para calcular as taxas de transportador associadas e devolvê-las na resposta.