Cotando Frete

Esta skill deve ser usada quando o usuario pergunta "qual preco para Manaus?", "quanto sai 5000kg para AM?", "frete para SP 3 toneladas", "como funciona o calculo de frete?", "frete do pedido VCD123", "qual transportadora mais barata para RJ?", ou precisa de cotacao, tabelas de preco e lead times. Nao usar para documentacao SSW CarVia (usar acessando-ssw), monitorar entrega (usar monitorando-entregas), ou frete real vs teorico (ler FRETE_REAL_VS_TEORICO.md via Read). - Lead time: "prazo de entrega para Manaus?" (lead_time vem nos vinculos) - Frete real: "quanto gastei de frete com Atacadao?", "divergencia CTe", "fretes pendentes Odoo" - Despesas frete: "custo real do pedido com despesas extras" NAO USAR QUANDO: - Criar embarque/separacao → usar **gerindo-expedicao** - Status de entrega pos-faturamento → usar **monitorando-entregas** - Consultas analiticas SQL → usar **consultando-sql** - Rastrear NF/PO no Odoo → usar **rastreando-odoo**

DECISION TREE - Qual Script Usar?

Mapeamento Rapido

Regras de Decisao

1. TABELAS/PRECOS de cidade (sem peso/valor): → buscar_tabelas_cidade.py
2. COTACAO com peso e valor: → calcular_cotacao.py
3. Frete de PEDIDO/SEPARACAO/NF existente: → consultar_pedido_frete.py
4. Frete REAL GASTO (historico, divergencias, pendentes Odoo): → consultando_frete_real.py
5. EXPLICACAO do calculo: → Ler references/calculo_frete.md
6. TERMOS (GRIS, ADV, etc.): → Ler references/glossario_frete.md

Cenarios Compostos (Multi-Query)

Algumas perguntas exigem MAIS de uma execucao de script:

REGRA: Quando a pergunta menciona "divergencia" junto com frete real, SEMPRE executar --divergencias como chamada separada, mesmo que o primeiro resultado retorne 0 fretes.

Fluxo de Ambiguidade de Cidade

Se o script retornar ambiguidade: true:

1. Script retorna opcoes_uf: ["MG", "SP"]
2. Agente DEVE perguntar ao usuario qual estado
3. Re-executar script com --uf informada

Tratamento de Resultados Vazios (Zero Fretes)

Quando um script retorna 0 resultados:

1. NAO tratar como erro — e um resultado valido
2. Reportar zeros claramente: "0 fretes encontrados", "R$ 0,00 total"
3. Ainda executar queries complementares (ex: --divergencias mesmo com 0 fretes)
4. NAO especular causa sem dados — dizer "nenhum frete registrado no periodo" (NAO "embarques nao finalizados")
5. Sugerir verificacao: "Confirme se existem embarques finalizados para esse cliente no periodo"

Regras de Negocio (Anti-Alucinacao)

REGRA CARDINAL: Fidelidade ao Script Output

SOMENTE apresentar dados que existem no JSON de saida do script.

• Se um campo NAO aparece no script_output.json, NAO incluir na resposta
• Se quiser adicionar contexto de negocio (ex: "DIRETA compensa para volumes acima de X"), rotular explicitamente como [Nota: estimativa, nao vem do script]
• Valores monetarios na resposta DEVEM corresponder EXATAMENTE aos retornados pelo script

O Agente PODE Afirmar:

• Precos e valores retornados pelos scripts (baseados em tabelas REAIS)
• Lead time em dias uteis (campo lead_time dos vinculos)
• Comparacoes entre transportadoras (baseadas nos resultados)

O Agente NAO PODE Inventar:

• Precos de frete sem executar o script
• Lead times sem dados no sistema
• Tabelas de frete que nao existem
• Descontos ou negociacoes especiais
• Dados que NAO existem no JSON de saida do script executado

Formulas CORRETAS

Frete Minimo - CONFUSAO COMUM

• frete_minimo_peso = PESO minimo em kg (NAO e valor em R$)
• frete_minimo_valor = VALOR minimo em R$ (piso do frete)

Scripts — Referencia Detalhada

Para parametros completos, retornos JSON e exemplos: LER SCRIPTS.md

Referencia Cruzada

References (sob demanda)

Tabelas do Dominio