Upload em massa de pedidos

Baixe o modelo de CSV diretamente na página de upload do Dashboard. O modelo inclui todas as colunas obrigatórias e opcionais — as colunas obrigatórias são marcadas com um asterisco (*) na linha de cabeçalho.

Uma linha por item 

Cada linha representa um item, não um pedido. Linhas que compartilham o mesmo Order ID são agrupadas em um único pedido com vários itens, então um pedido de três itens ocupa três linhas. Os valores em nível de pedido — destinatário, endereço, nível de serviço, valor do frete, moeda, responsável pelo pagamento de impostos e caixa — são lidos da primeira linha de cada grupo.

Colunas obrigatórias 

As informações obrigatórias de cada linha se dividem em três categorias:

Recipient — O nome, o número de telefone e o endereço de entrega do destinatário, incluindo o país de destino. O e-mail é opcional, mas seu formato é validado quando você o informa. O código postal e o estado/província são obrigatórios apenas para países cujo formato de endereço os utiliza — para um país sem código postal (por exemplo, Hong Kong ou Tanzânia), basta deixar a célula em branco. Para países com uma lista de estados/províncias, use um nome ou código de região reconhecido (por exemplo, "Dubayy" ou "DU" para Dubai) para que as transportadoras possam tarifar o destino.

Items — No mínimo, o nome e o preço do item. A quantidade é opcional e o padrão é 1. Informar um código HS e o país de origem melhora a precisão da classificação e pode reduzir o tempo de processamento na tela de confirmação.

Shipping — Um código de nível de serviço que corresponda a uma transportadora configurada em sua conta (por exemplo, fedex.international_priority, ups_worldwide_expedited). A coluna Shipping Amount é opcional: informe um valor (0 é permitido) para usá-lo como o valor do frete do pedido, ou deixe em branco para que uma estimativa de tarifa da transportadora seja calculada para o seu nível de serviço. Linhas calculadas levam alguns segundos a mais cada uma na tela de confirmação, e o valor final cobrado pela transportadora na criação da etiqueta pode diferir da estimativa. Alguns destinos não podem ser tarifados automaticamente (um erro de "service not available for destination country") — informe um valor de frete apenas nessas linhas; linhas em branco e preenchidas podem ser combinadas livremente em um mesmo arquivo.

Colunas opcionais 

Recipient tax ID — Use as colunas Tax ID Type e Tax ID Number para incluir um identificador fiscal do destinatário no pedido. O tipo deve ser um dos códigos abaixo (sem diferenciar maiúsculas de minúsculas). Informe as duas colunas juntas; um tipo sem número (ou vice-versa) é sinalizado como erro na tela de confirmação. O identificador fiscal é salvo no destinatário do pedido e enviado à transportadora quando uma etiqueta é criada. Para pedidos com vários itens, é usado o identificador fiscal da primeira linha do pedido.

Use o código específico do país, quando houver um; para qualquer país não listado, use TIN.

Códigos adicionais para finalidades específicas (FED, FTZ, DUN, e as contas de diferimento de direitos e impostos DAN/TAN/DTF) são aceitos quando seu representante Zonos indicar que você use um deles.

Duty Paid By — DDP ou DDU opcional por pedido. Deixe em branco para o comportamento padrão: DDP onde o destino oferecer suporte, com fallback automático para DDU onde não oferecer. Um DDP explícito é estrito — as linhas geram erro em vez de fazer fallback — e DDU torna o destinatário responsável pelos direitos e impostos na entrega. A tela de confirmação e o download de resultados mostram qual dos dois foi efetivamente usado em cada pedido, com um selo laranja nas linhas DDU. Para pedidos com vários itens, prevalece o primeiro valor informado, e valores conflitantes são um erro.

Carton quantity — Se um pedido é enviado em várias caixas idênticas, defina Carton Quantity junto com as colunas Carton Length/Width/Height/Weight. As colunas de caixa descrevem uma caixa (o peso é o peso de uma única caixa embalada), e a quantidade o multiplica — por exemplo, 360 unidades embaladas 30 por caixa usariam as dimensões da caixa, o peso de uma caixa cheia e uma quantidade de caixa igual a 12. Em branco significa 1. Pedidos com caixas de tamanhos variados não podem ser descritos no CSV — deixe as colunas de caixa em branco nesses pedidos, e a Zonos fará a embalagem automaticamente com base no peso dos itens.

Dicas 

• Use os códigos de nível de serviço exatos exibidos nas suas configurações de transportadora. Linhas com códigos de nível de serviço não reconhecidos exibirão um aviso na tela de confirmação.
• Os territórios dos EUA são diferentes: as Ilhas Virgens Americanas usam seu próprio código de país (VI) e são enviadas como remessas internacionais, enquanto Porto Rico usa US e é enviado como remessa doméstica.
• As transportadoras (a UPS em particular) recusam endereços de entrega do tipo caixa postal — linhas com "P.O. Box" em uma linha de endereço podem falhar na tarifação com um erro genérico de indisponibilidade de serviço. Use um endereço de rua sempre que possível.
• Pontuação tipográfica do Word ou do Excel (aspas curvas, travessões en/em) é corrigida automaticamente. Pontos de interrogação aparecendo onde deveriam estar letras acentuadas indicam que o arquivo perdeu sua codificação — essas linhas são sinalizadas para que você possa reinserir o texto.
• Para países de destino que exigem um código de estado ou província (por exemplo, Brasil, EUA, Canadá), garanta que o campo de estado esteja preenchido com o código ISO correto.
• O Order ID é obrigatório e deve ser único em toda a sua conta, incluindo uploads anteriores — um ID que já tenha sido usado antes (mesmo em um arquivo de uma temporada anterior ou em um pedido cancelado) é rejeitado na criação do pedido. Reutilizando um arquivo? Adicione um sufixo aos IDs (por exemplo, ACALB-33 para o volume 33). O ID aparece na tela de confirmação e é transferido para o pedido criado como referência do lojista.
• Nomes de destinatário, endereços, cidade, estado/província, nome da empresa e nomes de itens devem usar caracteres latinos. Escritas não latinas, como japonês ou árabe, são rejeitadas.
• Linhas totalmente em branco são ignoradas, então linhas vazias no final do seu arquivo são inofensivas.

Todas as colunas do modelo padrão, na ordem do modelo. Condicional significa que a coluna só é obrigatória em determinados casos — veja Colunas obrigatórias acima para os detalhes.

A Japan Post usa seu próprio modelo de CSV, baixado na página de upload da mesma forma. Ele não tem coluna de nível de serviço — o upload atribui o primeiro nível de serviço da transportadora e você seleciona um novamente no fluxo de etiqueta — e não tem coluna de quantidade de caixa, já que esses uploads sempre são enviados como uma única caixa.

Colunas que são opcionais no modelo padrão, mas obrigatórias para a Japan Post:

• HS code
• Country of origin
• Item weight — a unidade de peso continua opcional aqui e o padrão é gramas
• Postal code
• State/province
• Shipping amount — diferentemente do modelo padrão, este não pode ficar em branco

O modelo também adiciona campos de envio da Japan Post que são armazenados no pedido e aplicados à remessa quando uma etiqueta é criada: Contents Type, Licence Number, Certificate Number, Invoice, Tax Code/VAT Number, Pay Condition, Remarks, Sender's Reference Number e Non-commercial. Todos são opcionais. Os campos de texto aceitam até 25 caracteres, e Non-commercial aceita apenas true ou false.

Após o upload, uma tela de confirmação exibe o detalhamento do landed cost calculado para cada pedido antes que qualquer coisa seja criada. A tela mostra:

Linhas podem exibir $0 em direitos, impostos e taxas quando o destino não cobra taxas de importação sobre o valor declarado da remessa (está abaixo do limite de minimis do país) — o landed cost é genuinamente zero, não está faltando, e o frete é o único custo desses pedidos.

O botão Create orders exibe a quantidade de pedidos que serão enviados (por exemplo, Create 17 orders). Somente linhas com status Ready ou Warning são incluídas — linhas com erros são excluídas.

Use Download results CSV para exportar o detalhamento completo da cotação (tarifa selecionada, valor do item, frete, direitos, impostos, taxas e totais por pedido) — útil para cotar valores aos seus clientes antes que qualquer pedido seja criado. Clique em Start over para descartar o upload e recomeçar com um arquivo revisado.

Quando você deixa Shipping Amount em branco, a coluna de nível de serviço mostra a tarifa correspondente ao nível de serviço do seu CSV. Se o nível de serviço solicitado não estiver disponível para um destino, a tarifa disponível mais próxima é selecionada e sinalizada com um selo Different service level — ou, quando existem várias alternativas, um menu suspenso Select a rate permite que você escolha antes que o pedido possa ser criado.

Problemas são sinalizados em linha na tela de confirmação.

Erros 

Linhas com erros são excluídas quando você clica em Create orders. Corrija o problema no seu CSV e reenvie para incluir essas linhas. Erros comuns incluem:

• Low-value orders not allowed — O valor do pedido está abaixo do limite mínimo da sua loja.
• Invalid state code — O código de estado ou província não é válido para o país de destino. Obrigatório para países como Brasil, EUA e Canadá.
• Missing required field — Uma coluna obrigatória está vazia ou não pôde ser analisada.
• Order ID already exists — Cada ID de pedido deve ser único em toda a sua conta, incluindo pedidos de uploads anteriores. Linhas com IDs já usados falham na criação enquanto o restante do arquivo é concluído com sucesso — reenvie apenas as linhas com falha com IDs novos (um sufixo como -33 funciona bem).

Avisos 

Linhas com avisos são incluídas no envio. Revise-as antes de clicar em Create orders. Avisos comuns incluem:

• Service level not configured — O código de nível de serviço no seu CSV não está conectado à sua conta. O pedido será criado, mas pode não ser tarifado corretamente. Verifique suas configurações de transportadora ou atualize o código de nível de serviço no seu CSV.

O limite atual de upload é de 200 pedidos por CSV. Os pedidos são enviados em lotes de até 50 por chamada de API — se o seu upload contiver mais de 50 pedidos prontos, eles são processados automaticamente em vários lotes.

Em breve: Uma atualização futura removerá o limite de 200 pedidos e adicionará processamento em segundo plano para uploads maiores.