Preparar o pedido
Calcular um Landed Cost por API requer várias entradas, que organizamos em fluxos de trabalho. Uma vez completado, você pode fazer um pedido para devolver um Landed Cost segundo o destino de envio, os artigos do carrinho e os detalhes de envio.
Cada fluxo de trabalho tem suas próprias entradas requeridas. GraphQL permite-lhe passar mais dados dos necessários, mas apenas certos campos são obrigatórios para devolver um Landed Cost. Estão claramente marcados em nossa referência de API para ver todos os campos possíveis.
Observe que alguns campos são condicionalmente obrigatórios se você quiser que seu cálculo esteja garantido.
Abaixo apresentamos todos os campos necessários para calcular um Landed Cost garantido. Certifique-se de incluir esta informação antes de fazer o seu pedido.
Entradas requeridas para cálculos garantidos
partyCreateWorkflowInputEl 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:
locationadministrativeAreaCode: 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 da direção.postalCode: O código postal do endereço.
personemail: 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.
typeDESTINATION: Informações delocationepersonpara o destino de envio.ORIGIN: Informações delocationpara a origem de envio. Não é necessário opersonassociada à origem de envio.
itemCreateWorkflowInputEl 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. SequantityEste é o custo total do artigo. Sequantitydo artigo é >1, a API multiplicará oamountdo artigo pelaquantitydo artigo para obter o total da linha. Não coloque o preço total de todas as unidades do artigo emamount.currencyCode: O código de moeda do montante do artigo.quantity: A quantidade do artigo. A API multiplicará oamountdo artigo pelaquantitydo artigo para obter o total da linha.countryOfOrigin: O país onde o artigo foi fabricado.- Um dos seguintes (o que está configurado como seu 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.
Las measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) só são obrigatórias se quiser cartonizar seus artigos ao obter uma tarifa de envio.
cartonsCreateWorkflowInputEl cartonsCreateWorkflowInput Só requer 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.
shipmentRatingCreateWorkflowInputEste 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 habilitado, substitua este fluxo de trabalho e use shipmentRatingCalculateWorkflow em seu lugar.
El 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.
landedCostWorkFlowInputEl 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 (a tarifas e impostos pré-pagados) 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 não for permitida uma DDP. UsarDAPEm 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.
- Se utilizar nossa garantia de Landed Cost, este valor deve sempre ser
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 quotização, caso haja um intervalo de taxas pautais que possam ser aplicadas. *Ao usar nossa garantia de Landed Cost, isso sempre deve serZONOS_PREFERRED.
Agregar envío calculado: Si desea que Zonos calcule el costo de envío por usted, reemplace
shipmentRatingCreateWorkflowconshipmentRatingCalculateWorkflow. AgreguecartonizeWorkflowsi desea que Zonos ordene sus artículos en cartones antes de encontrar el costo de envío (utilizado para peso dimensional).
Códigos HS e opções de envio
O GraphQL oferece flexibilidade para personalizar o pedido de acordo com a sua preferência. Existem algumas opções sobre como incluir código HS e custos de envio no pedido.
Códigos HS
Os códigos HS afectam as taxas pautais, pelo que são obrigatórios. Pode passar o código HS de cada artigo ou deixar Classify os gerar.
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á ao voo 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 Reclassificação seu artigo ao voo e usar o novo código HS válido em vez do que forneceu.
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.
Custo de envio
Tanto o nível de serviço de envio como o seu custo afetam as tarifas, impostos e taxas, e portanto são obrigatórios. Zonos pode calcular o envio ou pode pasá-lo.
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.
Solución de problemas: Si espera un
serviceLevelen la respuesta pero no aparece, asegúrese de que elserviceLevelesté habilitado y sea compatible con elmethodque seleccionó.
Agregue cartonizeWorkflow (que não tem itens) se quiser que Zonos Ordem dois 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.
Pedir um Landed Cost por API
Depois de ter os dados de entrada necessários, envie a mutação GraphQL para o endpoint de API utilizando a sua biblioteca ou ferramenta de cliente escolhida. Aqui estão alguns exemplos de como a mutação pode estruturar.
Use este pedido quando Zonos calcule o custo de envio como parte do pedido de Landed Cost. Depois, calcularemos tarifas e impostos sobre o envio se forem avaliados pelo país de destino.
mutation CalculateLandedCost($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$landedCostConfig: LandedCostWorkFlowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount productId } cartonizeWorkflow { id type items { item { id } } } shipmentRatingCalculateWorkflow { id amount } landedCostCalculateWorkflow(input: $landedCostConfig) { id duties { amount currency note } taxes { amount currency note } fees { amount currency note } }}Passo Seguinte: Criar um pedido
Depois de calcular um Landed Cost e receber o landedCostId da resposta de API, você deve criar um pedido para terminar a transação no sistema de Zonos. Use a mutação orderCreate e passe o landedCostId da sua cotação. Saiba mais sobre criar pedidos.
Pedir um Landed Cost em Dashboard
Também pode calcular Landed Cost diretamente em Zonos Dashboard sem usar API. Isso é útil para testar cálculos, treinar sua equipe ou obter cotações rápidas para consultas de clientes.
Dashboard usa os mesmos endpoints de API descritos anteriormente, pelo que os resultados coincidirão com o que obteria de chamadas diretas à API. Isto torna-o uma excelente forma de validar a sua integração de API ou explorar como diferentes entradas afetam os cálculos.
Usar a calculadora de Dashboard
Com a calculadora de Landed Cost em Dashboard, pode obter cotações com tarifas de envio calculadas, criar cotações com custos de envio conhecidos ou processar múltiplas cotações em lote.
Use este fluxo quando você conhece o nível de serviço e o custo de envio de seu envio.
- Vá a Dashboard → Orders → Quotes
- Clique em New quote
- Opcional — Modifique a localização do seu endereço de envio de origem
- Seleccione um Destination country no menu suspenso
- Introduza a quantidade de envio
- O nível de serviço é opcional; adicioná-lo permite-nos calcular as taxas de transportador aplicáveis
- Adicione os detalhes do artigo para o envio
- Quando introduz uma descrição, classificamos automaticamente o produto e geramos um código HS
- Pode sobrepor o código HS gerado se necessário
- Para vários artigos, clique em Save and add another. Caso contrário, clique em Save
- Opcional — Clique em More options para mudar:
- Sale type a For resale
- Delivery mode a Delivery duties unpaid
- Clique em Get quote
- Para fazer alterações, clique em Edit form e altere qualquer detalhe
- Clique em Get quote novamente para atualizar
Uma cotação de Landed Cost aparecerá à direita, incluindo os custos de produto, remessa e importação. Expanda a cotação para ver discriminações detalhadas de artigos, envio, tarifas, impostos e taxas. Todas as cotações são guardadas na página de quotizações para referência futura.
Editar cotações existentes: Clique em Quote again na parte superior direita para modificar uma cotação existente em vez de começar a partir de zero.
Benefícios de usar Dashboard
- Sem necessidade de programar — Genere quotizações através de uma interface fácil de usar
- Capacitação da equipe — Ajude os membros da equipe não técnicos a entender os componentes de Landed Cost
- Validação de API — Verifique se a sua integração de API produz os resultados esperados
- Atenção ao cliente — Genere cotações rapidamente para consultas de clientes
- Processamento em lote — Gerir múltiplos cálculos de forma eficiente (próximamente)
As cotações de Dashboard incluem as mesmas desagregações detalhadas disponíveis através da API, tornando-a um excelente complemento para a sua integração automatizada.
Calcular um Landed Cost
Calcule aranceles, impuestos y tasas con GraphQL.GraphQL
O Zonos calcula o total do Landed Cost para remessas internacionais, incluindo tarifas, impostos e quaisquer taxas adicionais cobradas por alfândegas, agentes ou transportadores. Na maioria dos casos, garantimos estes cálculos pagando a factura final nós mesmos e cobrindo exatamente o que calculamos. Em alguns casos, você pode usar nosso Landed Cost sem garantia, o que significa que assume a responsabilidade de qualquer diferença entre nosso cálculo e os cargos reais.