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

Modificado em Sex, 3 Out na (o) 10:57 AM

A plataforma TriCommerce permite a importação em massa de informações por meio de arquivos no formato .csv. Esse recurso otimiza a gestão de catálogo, variações e regras personalizadas de frete, garantindo rapidez na atualização dos dados e consistência nas operações.

Este guia apresenta as regras e formatos obrigatórios para a utilização de planilhas de importação, conforme os modelos fornecidos pela plataforma.

⚠️ Atenção:

Não adicione, remova ou renomeie colunas dos modelos fornecidos.
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.

1. Planilha de Produtos

[link do modelo]

A planilha de produtos permite importar ou atualizar informações do catálogo da loja.

Campos da planilha de produtos

Campo	Descrição
id_produtos	Identificador único de cada produto (numérico). Preenchido = edição; vazio = inserção.
id_categorias	Identificador da subcategoria (numérico).
id_marcas	Identificador da marca (numérico).
titulo	Nome do produto.
referencia	Código interno ou referência comercial.
descricao	Texto descritivo detalhado do produto (suporta HTML).
peso	Peso do produto em kg (numérico).
altura	Altura do produto em cm (numérico).
largura	Largura do produto em cm (numérico).
profundidade	Profundidade/comprimento em cm (numérico).
ipi	Percentual de IPI (numérico).
social_title	Título para redes sociais (SEO).
social_keywords	Palavras-chave associadas ao produto (SEO).
social_description	Breve descrição otimizada para SEO.
ordem	Posição do produto em listagens (numérico).
destaque	Indica se o produto é destaque (0 = não, 1 = sim).
ativo	Status do produto (1 = ativo, 0 = inativo).
restricao_idade	Restrições de idade (0 = sem, 1 = maiores de 18).
compra_whatsapp	Venda direta pelo WhatsApp (0 = não, 1 = sim).
id_externo	ID do produto em sistema externo (ERP).
tipo	Tipo do produto (1 = simples, 2 = com variação).
produto_digital	Produto digital (1 = sim, 0 = não).
status_notificacao_produto_digital	Status do pedido para envio digital (2 = pagamento aprovado, 5 = entregue).
link_produto_digital	URL de download ou acesso do produto digital.
preco	Preço do produto (válido apenas para produtos simples).
estoque	Quantidade em estoque (válido apenas para produtos simples).

2. Planilha de Variações

[link do modelo]

A planilha de variações é utilizada quando o produto possui diferentes atributos (como tamanho, cor ou modelo).

Campos da planilha de variações

Campo	Descrição
id_variacoes	Identificador único da variação (numérico). Preenchido = edição; vazio = inserção.
id_produtos	Identificador do produto pai (numérico).
titulo	Nome ou descrição da variação.
preco	Preço da variação (numérico).
estoque	Quantidade em estoque da variação (numérico).
prazo	Prazo de entrega em dias (numérico).
id_externo	Identificador da variação em sistema externo (ERP).

3. Planilha de Regras de Frete Personalizadas

[link do modelo]

Essa planilha permite configurar fretes específicos, além das regras padrão da plataforma.

Campos da planilha de regras de frete

Campo	Descrição
id_entregas	Identificador único da regra de frete (numérico). Preenchido = edição; vazio = inserção.
titulo	Nome da regra de frete personalizada.
descricao	Detalhes ou observações sobre a regra.
cep_inicial	Faixa inicial de CEP atendida pela regra.
cep_final	Faixa final de CEP atendida pela regra.
valor	Valor fixo do frete (numérico).
prazo	Prazo de entrega em dias (numérico).
ativo	Status da regra (1 = ativa, 0 = inativa).

Boas Práticas na Importação

Sempre valide a planilha antes de importar.
Use editores confiáveis para arquivos .csv (ex.: LibreOffice Calc, Google Sheets ou Excel configurado para UTF-8).
Verifique que os valores numéricos não contenham símbolos (R$, %, etc.) — apenas números e, quando necessário, pontos decimais.
Faça importações em lotes menores ao testar novos cadastros, evitando erros em massa.
Guarde uma cópia do modelo oficial do TriCommerce para referência.

✅ Seguindo este guia, a importação de planilhas .csv será realizada de forma correta, garantindo consistência e agilidade na gestão da sua loja no TriCommerce.