Guia Técnico de Importação de Planilhas .CSV no TriCommerce

Modificado em Sex, 24 Out, 2025 na (o) 8:16 AM

1. Introdução

Este guia apresenta o processo completo de importação de produtos e variações na plataforma TriCommerce. Por meio de planilhas no formato .CSV, é possível cadastrar, atualizar e padronizar informações do catálogo da loja de forma rápida, mantendo a consistência dos dados e a integridade da operação.

2. Atenção

Não adicione, remova ou renomeie colunas dos modelos oficiais.
Use sempre a extensão .CSV, com colunas separadas por vírgula (,) e linhas separadas por quebra de linha (\n).
Ao preencher um campo de ID, o sistema fará a edição do registro correspondente.
Ao deixar o campo ID vazio, o sistema fará a inserção de um novo registro.
Se um produto com a mesma referência já estiver cadastrado na loja, ele será substituído na importação — essa ação é irreversível.

Importante: Nem todos os campos são obrigatórios, mas alguns devem ser preenchidos obrigatoriamente conforme o tipo de planilha.

3. Planilha de Produtos (.CSV)

A planilha de produtos permite importar ou atualizar informações do catálogo da loja. Abaixo estão os campos e orientações para preenchimento correto.

Campos Obrigatórios (Produtos)

id_categorias (nome da subcategoria – deve estar previamente criada e o nome deve ser exatamente igual)
id_marcas (nome da marca – ex.: “Nome da Empresa”)
titulo
referencia
ativo
tipo
preco (para produtos do tipo simples)
estoque (para produtos do tipo simples)

Campo Técnico (não alterar)	Significado / Como preencher	Obrigatório	Exemplo	Observações
id_produtos	Identificador único do produto (numérico). Preenchido = edição; vazio = inserção.	Opcional	(vazio)	Gerado automaticamente se deixado em branco.
id_categorias	Nome da subcategoria. Deve estar previamente criada e o nome deve ser exatamente igual.	Sim	Cadeiras de Jantar	Campo essencial.
id_marcas	Nome da marca cadastrada.	Sim	TriCommerce	Exemplo: “Nome da Empresa”.
titulo	Nome do produto exibido na loja.	Sim	Cadeira de Madeira Natural	Campo essencial.
referencia	Código interno ou SKU.	Sim	CAD-MAD-001	Usado para controle e integração com ERP.
descricao	Texto descritivo detalhado do produto (suporta HTML).	Não	Cadeira em madeira maciça.	Essencial para SEO.
peso	Peso em kg (numérico).	Não	5.3	Utilize ponto em vez de vírgula.
altura	Altura em cm (numérico).	Não	90	—
largura	Largura em cm (numérico).	Não	45	—
profundidade	Comprimento em cm (numérico).	Não	50	—
ipi	Percentual de IPI.	Não	0	Use números, sem símbolo %.
social_title	Título para redes sociais (SEO).	Não	Cadeira de Madeira Natural - Linha Domus	—
social_keywords	Palavras-chave associadas.	Não	cadeira, madeira, jantar	—
social_description	Breve descrição otimizada para SEO.	Não	Cadeira em madeira natural para sala de jantar.	—
ordem	Posição do produto em listagens.	Não	1	Itens com menor número aparecem primeiro.
destaque	Produto em destaque (0 = não, 1 = sim).	Não	1	—
ativo	Define se o produto está ativo (1 = ativo, 0 = inativo).	Sim	1	Campo essencial.
restricao_idade	Restrições de idade (0 = sem, 1 = maiores de 18).	Não	0	Use “1” apenas para produtos adultos.
compra_whatsapp	Venda pelo WhatsApp (0 = não, 1 = sim).	Não	1	Exibe botão “Comprar pelo WhatsApp”.
id_externo	ID do produto no ERP ou sistema externo.	Não	BLING-456	—
tipo	Tipo do produto (1 = simples, 2 = com variação).	Sim	1	Use 2 apenas para produtos com variações.
produto_digital	Produto digital (1 = sim, 0 = não).	Não	0	“1” apenas para e-books, cursos etc.
status_notificacao_produto_digital	Status de envio digital (2 = pagamento aprovado, 5 = entregue).	Não	2	Usado apenas se produto_digital = 1.
link_produto_digital	URL de download/acesso.	Não	https://meusite.com/ebook.pdf	Preencher apenas se produto_digital = 1.
preco	Preço do produto (numérico).	Sim	499.90	Use ponto em vez de vírgula.
estoque	Quantidade disponível (numérico).	Sim	25	Campo essencial.

4. Planilha de Variações (.CSV)

A planilha de variações é utilizada para produtos com atributos diferentes (como cor, tamanho ou modelo). Ela deve ser usada somente para produtos do tipo 2 (com variação).

Campos Obrigatórios (Variações)

id_produtos
titulo
preco
estoque

Campo Técnico	Significado / Como preencher	Obrigatório	Exemplo
id_variacoes	Identificador único da variação (numérico). Preenchido = edição; vazio = inserção.	Opcional	(vazio)
id_produtos	Identificador do produto pai (numérico).	Sim	12
titulo	Nome ou descrição da variação.	Sim	Cadeira Azul
preco	Preço da variação (numérico).	Sim	529.90
estoque	Quantidade da variação (numérico).	Sim	15
prazo	Prazo de entrega em dias.	Não	5
id_externo	Identificador da variação no ERP.	Não	VAR-001

5. Boas Práticas e Encerramento

Valide sempre a planilha antes de importar.
Use editores compatíveis com UTF-8: LibreOffice Calc, Google Sheets ou Excel configurado corretamente.
Em campos numéricos, não use símbolos como R$, %, etc.
Teste importações com pequenos lotes antes de importar grandes volumes.
Guarde sempre uma cópia do modelo oficial do TriCommerce para referência.

Conclusão: Seguindo este guia técnico, você garante uma importação de produtos e variações em .CSV de forma segura, padronizada e eficiente, mantendo a consistência e integridade do catálogo da sua loja na TriCommerce.