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.

Antes de poder criar etiquetas

Conclua sua configuração da conta e adicione um fulfillment center primeiro. As etiquetas não podem ser criadas até que ambos estejam prontos.

Apenas destinos suportados

O Country Code de cada linha deve ser um destino suportado pela sua Verified Account. Destinos não suportados são rejeitados no upload. Veja O que você pode fazer com sua Verified Account para a lista de destinos suportados.

Uploads por CSV usam o número IOSS da Zonos

Envios para a UE com valor de até €150 que você faz upload por CSV sempre usam o número IOSS da Zonos. A Zonos cobra o IVA de você e o repassa à UE. Números IOSS de terceiros (não Zonos) não são suportados em uploads por CSV nem em etiquetas impressas no Zonos Dashboard, então não informe um número IOSS na coluna Tax Code/VAT Number. Para usar o seu próprio número IOSS ou o do seu marketplace, crie a etiqueta pela API da Zonos.

Fazer upload de um CSV

Baixar o modelo CSV

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.

Coluna↕	Obrigatório↕	Descrição↕
Order ID	Sim	Identificador exclusivo do pedido. Linhas repetidas com o mesmo `Order ID` são agrupadas em um envio.
Item Name	Sim	Nome do item enviado. Apenas caracteres latinos.
HS Code	Sim	Código tarifário HS do item.
Country of Origin	Sim	Código ISO de duas letras do país onde o item foi fabricado (p.ex. `JP`).
Item Price	Sim	Preço unitário do item, em `JPY`. Deve ser maior que 0.
Currency	Não	Pedidos da Japan Post são sempre precificados em `JPY`. Deixe em branco ou defina como `JPY`.
Quantity	Não	Número de unidades. Número inteiro maior que 0; padrão 1.
Item Weight	Sim	Peso por unidade. Deve ser maior que 0.
Weight Unit	Não	Unidade de Item Weight (`kg`, `lb`, `g` ou `oz`). Padrão gramas quando em branco. Veja Unidades de peso e dimensão.
Carton Length	Não	Comprimento da caixa. Veja Caixas.
Carton Width	Não	Largura da caixa.
Carton Height	Não	Altura da caixa.
Carton Dimensional Unit	Não	Unidade das dimensões da caixa (`cm`, `in`, `mm` ou `m`). Padrão centímetros.
Carton Weight	Não	Peso da caixa.
Carton Weight Unit	Não	Unidade de Carton Weight (`kg`, `lb`, `g` ou `oz`). Padrão gramas.
Company Name	Não	Nome da empresa do destinatário. Apenas caracteres latinos.
First Name	Sim	Nome do destinatário. Apenas caracteres latinos.
Last Name	Sim	Sobrenome do destinatário. Apenas caracteres latinos.
Email	Não	E-mail do destinatário.
Phone	Sim	Telefone do destinatário.
Address Line 1	Sim	Endereço do destinatário. Apenas caracteres latinos.
Address Line 2	Não	Apartamento, sala ou unidade do destinatário. Apenas caracteres latinos.
City	Sim	Cidade do destinatário. Apenas caracteres latinos.
Postal Code	Sim	CEP do destinatário.
State/Province	Sim	Nome ou código de duas letras do estado dos EUA (p.ex. `CA`).
Country Code	Sim	País de destino, como código de duas letras (p.ex. `US`, `FR`). Deve ser um destino suportado.
End Use	Não	`FOR_RESALE` ou `NOT_FOR_RESALE`. Padrão `NOT_FOR_RESALE`.
Shipping Amount	Sim	Custo de envio cobrado do cliente. Pode ser `0`, mas a coluna não pode ficar em branco.
Contents Type	Não	Tipo de conteúdo aduaneiro. Um dos oito valores — veja Campos aduaneiros e de declaração para a lista completa.
Licence Number	Não	Número da licença de exportação, quando aplicável.
Certificate Number	Não	Número do certificado, quando aplicável.
Invoice	Não	Número da fatura comercial.
Tax Code/VAT Number	Não	O identificador fiscal ou número de IVA do destinatário (importador), impresso na declaração aduaneira CN23. Não é para números IOSS: uploads por CSV sempre usam o número IOSS da Zonos.
Pay Condition	Não	Condições de pagamento do envio.
Remarks	Não	Observações aduaneiras em texto livre.
Sender's Reference Number	Não	Sua referência interna ou número do pedido de compra.
Non-commercial	Não	`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. Aceita um de oito valores, listados abaixo.
Licence Number, Certificate Number — identificadores regulatórios quando um item os exige.
Invoice — número da fatura comercial.
Tax Code/VAT Number — o identificador fiscal ou número de IVA do destinatário (importador), impresso no campo de referência do importador na declaração aduaneira CN23. Não informe um número IOSS aqui. Uploads por CSV sempre usam o número IOSS da Zonos.
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 true para 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.

Valores de Contents Type. Use um destes oito, exatamente como está escrito:

Valor↕	Usar para↕
`ECOMMERCE_GOODS`	Produtos de e-commerce vendidos a um consumidor (BtoC). O pedido on-line típico.
`COMMERCIAL_GOODS`	Produtos comerciais vendidos entre empresas (BtoB).
`SALE_OF_GOODS`	Uma venda que não é especificamente e-commerce BtoC nem BtoB.
`COMMERCIAL_SAMPLE`	Amostras enviadas para avaliação, não para venda.
`RETURNED_GOODS`	Produtos sendo devolvidos ao remetente ou fornecedor.
`GIFT`	Um presente genuíno. Observe que presentes têm tratamento alfandegário próprio.
`DOCUMENTS`	Documentos em papel sem valor comercial.
`OTHER`	Qualquer coisa que nenhuma das opções acima descreva.

ECOMMERCE_GOODS e COMMERCIAL_GOODS não são apenas rótulos — eles definem o pkgType que a Zonos envia na chamada de etiqueta da Japan Post, então a escolha entre BtoC e BtoB muda o que é impresso na declaração aduaneira. Escolha a que corresponde à transação.

Contents Type também é independente de End Use (FOR_RESALE / NOT_FOR_RESALE) e de Non-commercial (true / false). Um pedido BtoC normal é ECOMMERCE_GOODS com End Use FOR_RESALE e Non-commercial em branco.

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.

Agendar uma demonstração