Fazer upload de um CSV
- Vá em Dashboard → Orders.
- Clique em Upload orders no cabeçalho da página.
- Arraste e solte seu arquivo CSV ou clique para navegar.
- Revise as linhas analisadas.
- Clique em Create orders para criar os pedidos.
Após o upload, seus pedidos aparecem na lista de envios. Marque os pedidos que deseja etiquetar e clique em Create labels. Veja Criar etiquetas de envio para o fluxo de etiquetas.
Baixar o modelo CSV
Baixe o modelo CSV no diálogo Upload orders do Zonos Dashboard para ver os cabeçalhos de coluna esperados e a ordem.
Salve o modelo, preencha uma linha por item (vários itens do mesmo pedido compartilham o mesmo Order ID) e faça upload do arquivo concluído.
Colunas do CSV
Cada linha representa um item. Vários itens do mesmo envio compartilham o mesmo Order ID, e os valores no nível do pedido (destinatário, caixa e campos aduaneiros) são mesclados entre essas linhas — o primeiro valor não vazio por campo prevalece.
As colunas abaixo estão listadas na mesma ordem do modelo para download.
| Column↕ | Required↕ | Description↕ |
|---|---|---|
| Order ID | Yes | Identificador exclusivo do pedido. Linhas repetidas com o mesmo Order ID são agrupadas em um envio. |
| Item Name | Yes | Nome do item enviado. Apenas caracteres latinos. |
| HS Code | Yes | Código tarifário HS do item. |
| Country of Origin | Yes | Código ISO de duas letras do país onde o item foi fabricado (p.ex. JP). |
| Item Price | Yes | Preço unitário do item. Deve ser maior que 0. |
| Currency | No | Código de moeda de três letras para os preços da linha. Usa a moeda da organização quando em branco. |
| Quantity | No | Número de unidades. Número inteiro maior que 0; padrão 1. |
| Item Weight | Yes | Peso por unidade. Deve ser maior que 0. |
| Weight Unit | No | Unidade de Item Weight (kg, lb, g ou oz). Padrão gramas quando em branco. Veja Unidades de peso e dimensão. |
| Carton Length | No | Comprimento da caixa. Veja Caixas. |
| Carton Width | No | Largura da caixa. |
| Carton Height | No | Altura da caixa. |
| Carton Dimensional Unit | No | Unidade das dimensões da caixa (cm, in, mm ou m). Padrão centímetros. |
| Carton Weight | No | Peso da caixa. |
| Carton Weight Unit | No | Unidade de Carton Weight (kg, lb, g ou oz). Padrão gramas. |
| Company Name | No | Nome da empresa do destinatário. Apenas caracteres latinos. |
| First Name | Yes | Nome do destinatário. Apenas caracteres latinos. |
| Last Name | Yes | Sobrenome do destinatário. Apenas caracteres latinos. |
| No | E-mail do destinatário. | |
| Phone | Yes | Telefone do destinatário. |
| Address Line 1 | Yes | Endereço do destinatário. Apenas caracteres latinos. |
| Address Line 2 | No | Apartamento, sala ou unidade do destinatário. Apenas caracteres latinos. |
| City | Yes | Cidade do destinatário. Apenas caracteres latinos. |
| Postal Code | Yes | CEP do destinatário. |
| State/Province | Yes | Nome ou código de duas letras do estado dos EUA (p.ex. CA). |
| Country Code | Yes | País de destino. Deve ser US. |
| End Use | No | FOR_RESALE ou NOT_FOR_RESALE. Padrão NOT_FOR_RESALE. |
| Shipping Amount | Yes | Custo de envio cobrado do cliente. Pode ser 0, mas a coluna não pode ficar em branco. |
| Contents Type | No | Tipo de conteúdo aduaneiro (p.ex. Sale of goods). Veja Campos aduaneiros e de declaração. |
| Licence Number | No | Número da licença de exportação, quando aplicável. |
| Certificate Number | No | Número do certificado, quando aplicável. |
| Invoice | No | Número da fatura comercial. |
| Tax Code/VAT Number | No | Identificador fiscal ou de IVA do envio. |
| Pay Condition | No | Condições de pagamento do envio. |
| Remarks | No | Observações aduaneiras em texto livre. |
| Sender's Reference Number | No | Sua referência interna ou número do pedido de compra. |
| Non-commercial | No | true para envio não comercial; false ou em branco para comercial. |
Caixas
As seis colunas Carton descrevem a caixa em que cada envio é despachado. As dimensões e o peso são impressos na etiqueta da Japan Post, então a Zonos não faz auto-cartonização — informe valores reais.
As colunas de caixa são opcionais, mas se você informar uma caixa deve preencher juntos Carton Length, Carton Width, Carton Height e Carton Weight. Uma caixa parcial é ignorada. Quando as unidades estão em branco, as dimensões usam centímetros e o peso usa gramas (as unidades aduaneiras CP72).
As caixas são no nível do pedido: em um pedido com vários itens, defina as colunas de caixa em qualquer linha daquele Order ID.
Campos aduaneiros e de declaração
Essas colunas opcionais vão para a declaração aduaneira da Japan Post na etiqueta:
- Contents Type — o motivo aduaneiro do conteúdo (p.ex.
Sale of goods). - Licence Number, Certificate Number — identificadores regulatórios quando um item os exige.
- Invoice — número da fatura comercial.
- Tax Code/VAT Number — identificador fiscal ou de IVA do envio.
- Pay Condition — condições de pagamento do envio.
- Remarks — notas em texto livre para a declaração.
- Sender's Reference Number — sua referência interna ou número do pedido de compra.
- Non-commercial — defina como
truepara marcar o envio como não comercial.
Como a caixa, esses campos são no nível do pedido — defina-os uma vez por Order ID.
Unidades de peso e dimensão
As unidades de peso (Weight Unit e Carton Weight Unit) aceitam kg, lb, g ou oz. As unidades de dimensão (Carton Dimensional Unit) aceitam cm, in, mm ou m.
Para a Japan Post, as colunas de unidade são opcionais e usam por padrão as unidades métricas CP72 — gramas para peso e centímetros para dimensões. Como a unidade é lida do seu arquivo, você pode manter os dados nas unidades que seu canal de vendas exporta; a Zonos converte o peso líquido para gramas na declaração aduaneira.
Você não escolhe um nível de serviço no CSV. Escolha o nível de serviço da Japan Post para cada envio ao criar etiquetas no Dashboard — veja Criar etiquetas de envio.
Upload de pedidos em lote
Sincronize rapidamente pedidos de canais de vendas no Zonos Dashboard fazendo upload de um arquivo CSV. Depois que os pedidos forem carregados, você pode selecioná-los na lista de envios e criar etiquetas da Japan Post.
Conclua sua configuração da conta e adicione um fulfillment center primeiro. As etiquetas não podem ser criadas até que ambos estejam prontos.
Os envios de Verified Account são apenas com destino aos EUA. O Country Code de cada linha deve ser
US— destinos fora dos EUA são rejeitados no upload.