cotando-frete

name: cotando-frete description: >- Cotacao de frete Nacom: tabelas, calculos, lead time e frete real gasto. Frases: "quanto sai 5000kg para Manaus?", "qual transportadora mais barata para RJ?", "lead time para AM", "frete real do pedido VCD123", "divergencia CTe vs cotacao", "fretes pendentes Odoo". Anti: entrega pos-NF -> monitorando-entregas; criar separacao -> gerindo-expedicao. allowed-tools: Read, Bash, Glob, Grep

Cotando Frete

Skill para consultar precos de frete, calcular cotacoes detalhadas e explicar a logica de calculo.

ANTES de raciocinar sobre custo real, margem ou frete real vs teorico: LER .claude/references/negocio/FRETE_REAL_VS_TEORICO.md (4 valores, divergencias, conta corrente) e .claude/references/negocio/MARGEM_CUSTEIO.md (formula da margem, tabelas de custo) — a logica de calculo mora la, nao adivinhe formula.

Quando NAO Usar Esta Skill

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