Guia Técnico de Importação de Regras de Frete Personalizadas (.CSV) no TriCommerce

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

1. Introdução

Este guia apresenta o processo completo de importação de regras de frete personalizadas na plataforma TriCommerce. Por meio da planilha entregas.csv, é possível criar e atualizar condições específicas de entrega, como valores fixos, faixas de CEP, prazos diferenciados e taxas adicionais.

Esse recurso oferece mais controle e flexibilidade sobre a operação logística, permitindo configurar diferentes estratégias de frete conforme a região ou tipo de pedido.

2. Atenção

Utilize sempre o modelo oficial de planilha fornecido pela TriCommerce.
Não adicione, remova ou renomeie colunas.
Use sempre o formato .CSV UTF-8, com colunas separadas por vírgula (,) e linhas separadas por quebra de linha (\n).
Ao preencher o campo id_entregas, o sistema editará a regra correspondente.
Ao deixar o campo id_entregas vazio, uma nova regra será criada.

Importante: Campos numéricos devem conter apenas valores (sem R$, %, ou símbolos).
Os campos obrigatórios devem ser preenchidos corretamente para que a importação seja concluída com sucesso.

3. Estrutura da Planilha (.CSV)

Abaixo estão os campos da planilha entregas.csv, conforme o modelo oficial da TriCommerce.

Campos Obrigatórios

titulo
valor
prazo
cep_inicial
cep_final
ativo

Campo Técnico	Significado / Como preencher	Obrigatório	Exemplo
id_entregas	Identificador único da regra de frete (numérico). Preenchido = edição; vazio = inserção.	Opcional	(vazio)
titulo	Nome da regra de frete personalizada.	Sim	Frete Sul - RS e SC
valor	Valor fixo do frete (numérico).	Sim	29.90
prazo	Prazo de entrega em dias (numérico).	Sim	7
cep_inicial	Faixa inicial de CEP atendida pela regra.	Sim	90000000
cep_final	Faixa final de CEP atendida pela regra.	Sim	99999999
ativo	Define se a regra está ativa (1 = ativa, 0 = inativa).	Sim	1
taxa_pedagio	Valor adicional fixo de pedágio (numérico).	Não	10.00
porcentagem_adicional_pedido	Percentual adicional aplicado sobre o valor total do pedido.	Não	2.5
adicional_kg	Valor adicional por kg.	Não	1.50
identificador	Campo livre para controle interno ou identificação da regra.	Não	FRETE_SUL_2025

4. Boas Práticas na Importação

Verifique se as faixas de CEP não se sobrepõem entre as regras.
Sempre utilize valores numéricos, sem símbolos.
Teste a importação com pequenas amostras antes de grandes volumes.
Guarde uma cópia do arquivo original antes de novas importações.
Utilize apenas softwares configurados com codificação UTF-8 (ex.: Google Sheets, LibreOffice Calc, Excel configurado corretamente).

5. Conclusão

Seguindo este guia, você poderá importar e gerenciar regras de frete personalizadas de forma eficiente, segura e escalável.
Isso garante controle total sobre custos, prazos e abrangência das entregas, fortalecendo a gestão logística dentro da plataforma TriCommerce.