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
Na plataforma Coolset, selecione a categoria que deseja enviar.
Clique em “Importar” no canto superior direito.
Baixe o modelo CSV fornecido para essa categoria.

Abrindo o modelo CSV no Microsoft Excel
O modelo é um .csv arquivo.
Para abri‑lo com as colunas exibidas corretamente no Excel:
Abra o Microsoft Excel.
Vá até a aba Dados.
Clique em Obter Dados → De Texto/CSV.
Selecione o arquivo de modelo baixado e carregue os dados.
Seu arquivo aparecerá agora em uma estrutura de colunas clara.

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:
Vá ao item para o qual deseja enviar.
Clique em “Importar” no canto superior direito.
Arraste e solte seu arquivo na área de envio, ou clique na caixa para procurar no seu computador.
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.

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 |