Guia de importação para uploads de CSV

Last updated: November 13, 2026

Na plataforma Coolset, você pode enviar os seguintes itens em massa usando um upload CSV:

  • Produtos,

  • Fornecedores,

  • Itens do pedido (pedidos de compra ou venda)

  • Origens.

Antes de começar

Cada categoria tem suas próprias colunas obrigatórias e tipos de dados.
É importante usar os nomes exatos das colunas e preencher os tipos de dados corretos conforme mostrado no modelo ou na tabela fornecida abaixo.

Você pode:

  • Criar seu próprio arquivo CSV seguindo a estrutura requerida, ou

  • Baixar um modelo pré-formatado diretamente da plataforma.

Baixando o modelo

  1. Na plataforma Coolset, selecione a categoria que deseja enviar.

  2. Clique em “Importar” no canto superior direito.

  3. Baixe o modelo CSV fornecido para essa categoria.

Screenshot 2025-10-09 at 16.37.11.png

Abrindo o modelo CSV no Microsoft Excel

O modelo é um .csv arquivo.
Para abri‑lo com as colunas exibidas corretamente no Excel:

  1. Abra o Microsoft Excel.

  2. Vá até a aba Dados.

  3. Clique em Obter Dados → De Texto/CSV.

  4. Selecione o arquivo de modelo baixado e carregue os dados.

Seu arquivo aparecerá agora em uma estrutura de colunas clara.

Screenshot 2025-10-09 at 16.39.40.png

Preenchendo o modelo

Ao completar o modelo (ou criar o seu próprio), siga as tabelas ao final desta página como orientação:

  • Nome da Coluna – Os nomes exatos a serem usados para as colunas em seu arquivo.

  • Tipo de Dados – O formato de dados esperado em cada coluna (ex.: texto, número).

  • Descrição – Explica que informação fornecer.

  • Obrigatório – Indica se a coluna deve ser preenchida para um upload bem‑sucedido.

Carregando seu arquivo CSV

Quando seu arquivo CSV estiver pronto:

  1. Vá ao item para o qual deseja enviar.

  2. Clique em “Importar” no canto superior direito.

  3. Arraste e solte seu arquivo na área de envio, ou clique na caixa para procurar no seu computador.

  4. Depois que seu arquivo for selecionado, clique em “Importar” para iniciar o envio.

Antes de fazer o upload, verifique duas coisas:

  • Salve o arquivo como CSV UTF-8. O Coolset só consegue ler arquivos CSV salvos na codificação UTF-8. O Excel geralmente salva CSVs em um formato regional, e esse é o motivo mais comum para uma falha no upload. No Excel, acesse Arquivo → Salvar como e escolha CSV UTF-8 (delimitado por vírgulas) (.csv) como tipo de arquivo.

  • Um erro interrompe todo o upload. Se alguma linha do seu arquivo tiver um erro, nada no arquivo será importado, incluindo as linhas que estavam corretas. Corrija a linha que falhou e faça o upload do arquivo completo novamente.

  • O que acontece quando faço o upload do mesmo arquivo novamente? Uma reimportação atualiza os registros existentes e adiciona novos registros. Ela nunca exclui nada. O Coolset associa cada linha a um registro existente por meio do seu external_id.

Screenshot 2025-10-09 at 16.51.46.png

Colunas obrigatórias e descrições

Produtos

Nome da coluna

Tipo de dado

Descrição

Obrigatório

external_id

texto

Identificador exclusivo do produto no seu sistema externo (por exemplo, ERP ou CRM). Usado para vincular dados entre sistemas.

TRUE

name

texto

O nome do produto.

TRUE

description

texto

Informações descritivas adicionais sobre o produto.

FALSE

hs_code

Número inteiro com no máximo 6 dígitos (sem decimais)

O código do Sistema Harmonizado (SH) que identifica o produto para fins de classificação aduaneira.

TRUE

commodity

texto

A categoria de commodity à qual o produto pertence (por exemplo, gado, cacau, café, palm_oil, borracha, soja e madeira).

TRUE

scientific_name

texto

O nome científico da espécie. Obrigatório somente para produtos à base de madeira.

FALSE

common_name

texto

O nome comum (não científico) da espécie. Obrigatório somente para produtos à base de madeira.

FALSE

sku

texto

A unidade de manutenção de estoque (SKU) do produto.

TRUE

type

texto

Indica se o produto é produzido, comprado ou fabricado.

TRUE

bill_of_materials

texto

Lista separada por vírgulas dos external_ids dos produtos que compõem a lista de materiais deste produto (se fabricado).

FALSE

Fornecedores

Nome da coluna

Tipo de dado

Descrição

Obrigatório

external_id

texto

ID exclusivo do seu ERP ou CRM

TRUE

company_name

texto

Nome legal do fornecedor

TRUE

description

texto

Observações opcionais sobre o fornecedor

FALSE

country_code

texto (2 caracteres)

Código ISO 3166-1 alfa-2 (por exemplo, NL, DE)

TRUE

is_self_managed

TRUE ou FALSE

Defina como TRUE se você estiver fazendo a autodeclaração em nome deste fornecedor

FALSE

contact_name

texto

Pessoa de contato principal; deixe em branco se você fizer a autogestão

FALSE

contact_email

texto

E-mail de contato usado para convites; deixe em branco se você fizer a autogestão

FALSE

additional_contact_emails

texto

Endereços de e-mail adicionais para convidar do mesmo fornecedor, além do contato principal.

FALSE

type

texto

O tipo de parceiro da cadeia de valor. Sempre preencha com "supplier"

TRUE

Itens do pedido

Nome da coluna

Tipo de dado

Descrição

Obrigatório

external_id

texto

Identificador exclusivo do item do pedido no seu sistema externo (por exemplo, ERP, CRM). Usado para vincular dados entre sistemas.

TRUE

action

texto

O tipo de atividade deste pedido. Action é "buying" ou "selling".

TRUE

border_cross_country_code

texto

Código do país da UE onde as mercadorias entram ou saem da UE, ou seja, NL, DE.

TRUE

order_external_id

texto

Identificador do pedido associado. Todos os itens pertencentes ao mesmo pedido compartilham este ID.

TRUE

order_created_at

data

A data em que o pedido foi criado (formato: YYYY-MM-DD).

TRUE

order_arrival_at

data

A data prevista de chegada do pedido (formato: YYYY-MM-DD).

FALSE

value_chain_external_id

texto

ID externo do fornecedor (correspondente ao external_id do fornecedor da importação de fornecedores).

TRUE

buyer_product_external_id

texto

ID externo do produto (correspondente ao external_id do produto da importação de produtos).

TRUE quando action é buying

seller_product_external_id

texto

ID externo do produto (correspondente ao external_id do produto da importação de produtos).

TRUE quando action é selling

volume

Um número com casas decimais

Quantidade de produto incluída no item do pedido.

TRUE

unit

texto (máx. 3 caracteres)

Unidade de medida do produto: kg.

TRUE

Origens

Nome da coluna

Tipo de dado

Descrição

Obrigatório

external_id

texto

Identificador exclusivo do seu sistema externo (por exemplo, ERP ou CRM). Usado para vincular dados entre sistemas.

FALSE

name

texto

Nome legível da área ou origem

TRUE

description

texto

Texto opcional descrevendo a origem

FALSE

country_code

texto (máx. 2 caracteres)

Código alfa-2 ISO 3166-1 (por exemplo, NL, FR, US)

VERDADEIRO

coordenadas

texto

(formato GeoJSON)

Matriz de coordenadas na ordem [longitude, latitude]; pode representar um ponto ou o limite de um polígono.

VERDADEIRO