Calcular um landed cost

O partyCreateWorkflowInput identifica as partes envolvidas e as respetivas localizações. Consulte o esquema completo na referência da nossa API GraphQL. Os campos obrigatórios são:

• location
  • administrativeAreaCode: O código do estado ou província, com duas letras. Apenas obrigatório para CA e BR.
  • countryCode: O código ISO de duas letras do país.
  • line1: A primeira linha da morada.
  • postalCode: O código postal da morada.
• person
  • email: O endereço de e-mail da pessoa.
  • firstName: O nome próprio da pessoa.
  • lastName: O apelido da pessoa.
  • phone: O número de telefone da pessoa.
• type
  • DESTINATION: As informações de location e person do destino do envio.
  • ORIGIN: As informações de location da origem do envio. A person associada à origem do envio não é obrigatória.

O itemCreateWorkflowInput lista os artigos do carrinho. Existem muitos campos opcionais (consulte todas as possibilidades na nossa referência da API), mas os campos abaixo são obrigatórios.

• amount: O valor de uma única unidade do produto enviado, antes de ser multiplicado pela quantidade. Tenha em atenção 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 indique o preço total de todas as unidades do artigo no amount.
• currencyCode: O código da moeda do valor 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 definido como a sua preferência de chave do artigo. A sua chave do artigo liga as informações armazenadas no Catalog ao artigo do carrinho e é utilizada 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 pretender cartonizar os seus artigos ao obter uma tarifa de envio.

O cartonsCreateWorkflowInput requer apenas a própria entrada. Consulte o esquema completo na referência da nossa API GraphQL para ver todos os valores que podem ser enviados. É importante enviar as dimensões e o peso da caixa se a Zonos estiver a calcular o custo de envio.

Este fluxo de trabalho é utilizado quando já conhece o serviço e o custo de envio; se pretender que a Zonos calcule estes custos para os serviços que tem ativados, substitua este fluxo de trabalho e utilize o shipmentRatingCalculateWorkflow.

O shipmentRatingCreateWorkflowInput comunica o custo de envio. Consulte o esquema completo na referência da nossa API GraphQL. Os campos obrigatórios são:

• amount: O custo de envio.
• currencyCode: O código da 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 define as preferências para o cálculo do landed cost. Consulte o esquema completo na referência da nossa API GraphQL. Os campos obrigatórios são:

• calculationMethod: Indica a sua preferência quanto à forma como pretende enviar: DDP (direitos aduaneiros e impostos pré-pagos) ou DAP (os direitos aduaneiros e impostos são pagos na entrega ou, se se aplicar um regime de remessa, são entregues através de um número de identificação fiscal).
  • Se utilizar a nossa garantia de landed cost, este valor deve ser sempre DDP_PREFERRED, que fornecerá uma cotação DDP sempre que possível e uma cotação DAP quando uma DDP não for permitida. Utilizar DAP em alternativa pode fazer com que os landed costs deixem de estar garantidos, uma vez que isso resulta normalmente em direitos aduaneiros e impostos pagos na entrega.
• endUse: Indica se as mercadorias são vendidas a outra empresa (FOR_RESALE) ou destinadas a utilização final por um consumidor (NOT_FOR_RESALE).
• tariffRate: Indica o método que a Zonos deve utilizar para calcular as taxas pautais desta cotação, caso exista um intervalo de taxas pautais que possam ser aplicadas. *Ao utilizar a nossa garantia de landed cost, este valor deve ser sempre ZONOS_PREFERRED.

A Zonos recomenda vivamente a utilização de códigos SH específicos de cada produto, uma vez que resultam numa cotação de landed cost mais precisa. Se conhecer os seus códigos SH, envie o hsCode de cada item durante o itemCreateWorkflow.

Se enviar um código SH, a Zonos irá validá-lo em tempo real ao obter uma cotação de landed cost. Se o código SH que forneceu for inválido (ou seja, não existir), a Zonos irá reclassificar o seu artigo em tempo real e utilizar o novo código SH válido em vez do que forneceu.

Se precisar de ajuda para gerar códigos SH para os seus produtos, saiba mais sobre o Zonos Classify e como pedir uma classificação.

Se não enviar um hsCode à Zonos, verificaremos primeiro o Zonos Catalog para ver se tem um código SH armazenado para o seu artigo. Caso não tenha, chamaremos o Classify para gerar uma classificação que suporte o seu cálculo de landed cost, com base nos seguintes campos de detalhes do produto do itemCreateWorkflow: description, category e material. Se os campos de detalhes do produto não forem suficientemente detalhados para gerar uma classificação de acordo com a pontuação de confiança do Classify, será utilizado o código SH predefinido atribuído à sua loja.

Para que a Zonos calcule os custos de envio, utilize o shipmentRatingCalculateWorkflow. As opções de envio devolvidas na resposta de envio calculado corresponderão aos serviceLevels que atribuiu aos perfis de envio no Dashboard.

Resolução de problemas: Se espera um serviceLevel na resposta, mas este não aparece, certifique-se de que o serviceLevel está ativado e é suportado pelo method que selecionou.

Adicione o cartonizeWorkflow (que não tem entradas) se pretender que a Zonos organize os seus artigos em caixas antes de determinar o custo de envio (utilizado para o peso volumétrico.

Se conhecer o serviceLevel e o amount de um envio, pode indicá-los na parte shipmentRatingCreateWorkflow do pedido. Utilizaremos esses valores para calcular as taxas de transportadora associadas e devolvê-las na resposta.