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**
Skill para consultar precos de frete, calcular cotacoes detalhadas e explicar a logica de calculo.
| Situacao | Skill Correta | Por que? |
|---|---|---|
| Criar embarque/separacao | gerindo-expedicao | Esta skill apenas CONSULTA precos — nao cria documentos logisticos |
| Status de entrega pos-faturamento | monitorando-entregas | Frete cotado ≠ status de entrega. Apos NF emitida, usar entregas |
| Consultas analiticas SQL complexas | consultando-sql | Rankings, agregacoes, tendencias — nao envolvem calculo de frete |
| Rastrear NF/PO/pagamento no Odoo | rastreando-odoo | Fluxo documental Odoo e diferente de cotacao de frete |
| Analise completa da carteira (P1-P7) | analista-carteira | Priorizacao de embarque exige analise de toda a carteira, nao apenas frete |
| Se a pergunta menciona... | Use este script | Com estes parametros |
|---|---|---|
| Tabelas/precos para cidade | buscar_tabelas_cidade.py | --cidade "Manaus" --uf AM |
| Tabelas por tipo de carga | buscar_tabelas_cidade.py | --cidade "SP" --uf SP --tipo-carga FRACIONADA |
| Cotacao com peso/valor | calcular_cotacao.py | --peso 5000 --valor 50000 --cidade "Manaus" --uf AM |
| Cotacao detalhada (breakdown) | calcular_cotacao.py | + --detalhado |
| Menor prazo | calcular_cotacao.py | + --ordenar menor_prazo |
| Carga direta especifica | calcular_cotacao.py | + --tipo-carga DIRETA |
| Frete de pedido existente | consultar_pedido_frete.py | --pedido VCD2565291 |
| Frete de separacao | consultar_pedido_frete.py | --separacao SEP-2025-001 |
| Frete de NF | consultar_pedido_frete.py | --nf 144533 |
| Recalcular frete | consultar_pedido_frete.py | --pedido VCD123 --recalcular |
| Quanto GASTEI de frete | consultando_frete_real.py | --cliente "Atacadao" --de 2026-01-01 |
| Frete REAL de pedido | consultando_frete_real.py | --pedido VCD123 |
| Divergencia CTe vs cotacao | consultando_frete_real.py | --divergencias |
| Fretes pendentes Odoo | consultando_frete_real.py | --pendentes-odoo |
| Frete por transportadora | consultando_frete_real.py | --transportadora "Braspress" |
| Custo real com despesas | consultando_frete_real.py | --pedido VCD123 --com-despesas |
buscar_tabelas_cidade.pycalcular_cotacao.pyconsultar_pedido_frete.pyconsultando_frete_real.pyreferences/calculo_frete.mdreferences/glossario_frete.mdAlgumas perguntas exigem MAIS de uma execucao de script:
| Pergunta do usuario | Execucoes necessarias |
|---|---|
| "frete real + divergencias do Atacadao" | 1. --cliente "Atacadao" --de ... --ate ... 2. --divergencias --de ... --ate ... |
| "cotacao para Manaus e Recife" | 1. calcular_cotacao.py --cidade Manaus 2. calcular_cotacao.py --cidade Recife |
| "tabelas e cotacao para SP" | 1. buscar_tabelas_cidade.py --cidade SP 2. calcular_cotacao.py --cidade SP --peso ... --valor ... |
REGRA: Quando a pergunta menciona "divergencia" junto com frete real, SEMPRE executar --divergencias como chamada separada, mesmo que o primeiro resultado retorne 0 fretes.
Se o script retornar ambiguidade: true:
opcoes_uf: ["MG", "SP"]--uf informadaQuando um script retorna 0 resultados:
SOMENTE apresentar dados que existem no JSON de saida do script.
[Nota: estimativa, nao vem do script]lead_time dos vinculos)| Calculo | Formula |
|---|---|
| Frete base | (peso x valor_kg) + (valor_mercadoria x percentual_valor%) — e SOMA, nao MAX |
| GRIS | max(valor x percentual_gris%, gris_minimo) |
| ADV | max(valor x percentual_adv%, adv_minimo) |
| RCA | valor x percentual_rca% (sem minimo) |
| Pedagio (fracao) | ceil(peso/100) x pedagio_por_100kg |
| ICMS (nao incluso) | frete_liquido / (1 - icms) |
frete_minimo_peso = PESO minimo em kg (NAO e valor em R$)frete_minimo_valor = VALOR minimo em R$ (piso do frete)Para parametros completos, retornos JSON e exemplos: LER SCRIPTS.md
| # | Script | Proposito | Campos-chave no output |
|---|---|---|---|
| 1 | buscar_tabelas_cidade.py | Tabelas de frete por cidade | transportadora, tipo_carga, valor_kg, frete_minimo_valor, lead_time, percentual_gris, pedagio_por_100kg, percentual_adv |
| 2 | calcular_cotacao.py | Cotacao detalhada peso/valor/destino | valor_com_icms, melhor_opcao, lead_time. Com --detalhado: breakdown completo de cada componente |
| 3 | consultar_pedido_frete.py | Frete de pedido/separacao/NF | frete_cotado, frete_real, transportadora, itens |
| 4 | consultando_frete_real.py | Frete real: historico, divergencias, pendentes | resumo (total_pago, qtd_fretes), por_transportadora, divergencias |
| Skill | Quando usar em vez desta |
|---|---|
| gerindo-expedicao | Criar embarque/separacao (antes de faturar) |
| monitorando-entregas | Status de entrega (apos faturar) |
| consultando-sql | Consultas analiticas complexas |
| rastreando-odoo | Rastrear NF/PO/pagamento no Odoo |
| resolvendo-entidades | Resolver cliente/cidade para IDs |
| Gatilho na Pergunta | Reference a Ler |
|---|---|
| "como funciona o calculo?" | references/calculo_frete.md |
| "o que e GRIS?", termos de frete | references/glossario_frete.md |
| "frete minimo peso vs valor" | references/calculo_frete.md Passo 2 e 6 |
| "ICMS no frete" | references/calculo_frete.md Passo 8 e 9 |
| "direta vs fracionada" | references/glossario_frete.md + references/calculo_frete.md |
| Tabela | Usada por |
|---|---|
cidades | Resolucao de cidade |
cidades_atendidas | buscar_tabelas_cidade.py |
tabelas_frete | buscar_tabelas_cidade.py, calcular_cotacao.py |
transportadoras | Calculo de frete |
veiculos | Carga DIRETA |
carteira_principal | consultar_pedido_frete.py |
separacao | consultar_pedido_frete.py |
faturamento_produto | consultar_pedido_frete.py |
fretes | consultando_frete_real.py |
embarques | consultando_frete_real.py |
embarque_itens | consultando_frete_real.py |
despesas_extras | consultando_frete_real.py |