Esta skill deve ser usada quando o usuario pergunta sobre operacoes CarVia (frete subcontratado): "operacoes da CarVia", "subcontratos pendentes", "faturas CarVia do Atacadao", "cotar frete subcontratado para SP", "conferencia de fatura transportadora", "resumo CarVia", ou qualquer consulta de operacoes, subcontratos, cotacao e faturas do modulo CarVia. Nao usar para cotacao de frete Nacom (industria embarca = usar cotando-frete), documentacao/processos SSW (usar acessando-ssw), ou criar embarque Nacom (usar gerindo-expedicao). - Resumo: "como esta a CarVia?", "resumo das operacoes" - Cotacao subcontratada: "cotar frete para SP via Braspress" - Faturas: "faturas pendentes", "conferencia da fatura X" NAO USAR QUANDO: - Cotacao frete Nacom (industria, outbound) = usar **cotando-frete** - Documentacao SSW CarVia = usar **acessando-ssw** - Status entrega pos-faturamento Nacom = usar **monitorando-entregas** - Criar embarque/separacao Nacom = usar **gerindo-expedicao**
Skill para consultas e operacoes do modulo CarVia (frete subcontratado).
USE para:
NAO USE para:
cotando-freteacessando-sswgerindo-expedicaoPROIBIDO criar, calcular ou inferir dados que NAO foram retornados pelo script. Se precisar de dado que nao veio no script: EXECUTE o script com flag adequado ou PERGUNTE ao usuario.
Exemplos de violacao:
Scripts retornam JSON estruturado. Sua resposta DEVE:
conferencia.diferenca_vs_cotado, usar ESSE valor — NAO recalcular manualmentevalor_cotado")Se um script falhar: SEMPRE responda ao usuario com erro e alternativa. NUNCA: Ficar em silencio, travar, ou tentar criar scripts customizados.
Quando um script retorna total: 0 ou sucesso: false:
sucesso: false, mostrar o campo erro ao usuarioCarVia = transportadora que SUBCONTRATA frete (inbound).
Nacom = industria que CONTRATA frete (outbound).
Se o usuario perguntar sobre frete de embarque/pedido VCD: use cotando-frete.
Se o usuario perguntar sobre subcontrato/operacao CarVia: use ESTA skill.
Dica de deteccao: Se a pergunta menciona peso/cidade SEM operacao_id/subcontrato = provavelmente Nacom (outbound). Se menciona operacao, subcontrato, fatura transportadora CarVia = ESTA skill.
Quando o usuario pede "resumo geral" ou "como esta a CarVia?":
--resumo para visao geral--subcontratos-pendentesAo apresentar dados de conferencia (--conferencia):
percentual_diferenca_cotado pode ser null quando soma_valor_cotado = 0 — reportar como "N/A (sem cotacoes)"diferenca_vs_cotado positiva = fatura MAIOR que soma cotada. Negativa = fatura MENORstatus_conferencia (NAO status) — CarviaFaturaTransportadoraValores validos para --status: RASCUNHO, COTADO, CONFIRMADO, FATURADO, CANCELADO
| Se a pergunta menciona... | Use este script | Com estes parametros |
|---|---|---|
| Resumo CarVia ("como esta?") | consultando_operacoes_carvia.py | --resumo |
| Operacoes por status | consultando_operacoes_carvia.py | --status RASCUNHO |
| Operacoes de cliente | consultando_operacoes_carvia.py | --cliente "Atacadao" |
| Operacao por ID | consultando_operacoes_carvia.py | --operacao 123 |
| Subcontratos por transportadora | consultando_operacoes_carvia.py | --transportadora "Braspress" |
| Subcontratos pendentes | consultando_operacoes_carvia.py | --subcontratos-pendentes |
| Faturas cliente | consultando_faturas_carvia.py | --tipo cliente |
| Faturas transportadora | consultando_faturas_carvia.py | --tipo transportadora |
| Fatura por numero | consultando_faturas_carvia.py | --numero "FAT-001" |
| Faturas pendentes | consultando_faturas_carvia.py | --tipo cliente --status PENDENTE |
| Conferencia fatura | consultando_faturas_carvia.py | --tipo transportadora --conferencia |
| Cotar subcontrato | cotando_subcontrato_carvia.py | --operacao 123 --transportadora "Braspress" |
| Opcoes de transportadora | cotando_subcontrato_carvia.py | --operacao 123 --listar-opcoes |
| Ranking todas transportadoras | cotando_subcontrato_carvia.py | --operacao 123 --todas |
| Detalhe de fatura especifica | consultando_faturas_carvia.py | --fatura 456 |
consultando_operacoes_carvia.pyconsultando_faturas_carvia.pycotando_subcontrato_carvia.py| # | Script | Proposito |
|---|---|---|
| 1 | consultando_operacoes_carvia.py | Operacoes, subcontratos, resumo |
| 2 | consultando_faturas_carvia.py | Faturas cliente e transportadora |
| 3 | cotando_subcontrato_carvia.py | Cotacao de frete para subcontrato |
| Skill | Quando usar em vez desta |
|---|---|
| cotando-frete | Cotacao frete Nacom (industria, outbound) |
| acessando-ssw | Documentacao/processos SSW |
| gerindo-expedicao | Pedidos, separacao, embarque Nacom |
| monitorando-entregas | Status entrega pos-faturamento Nacom |
| consultando-sql | Consultas analiticas SQL avancadas |
| Tabela | Usada por |
|---|---|
carvia_operacoes | consultando_operacoes_carvia.py |
carvia_subcontratos | consultando_operacoes_carvia.py |
carvia_nfs | consultando_operacoes_carvia.py |
carvia_operacao_nfs | consultando_operacoes_carvia.py |
carvia_faturas_cliente | consultando_faturas_carvia.py |
carvia_faturas_transportadora | consultando_faturas_carvia.py |
transportadoras | cotando_subcontrato_carvia.py |
tabelas_frete | cotando_subcontrato_carvia.py |
| Gatilho na Pergunta | Reference a Ler |
|---|---|
| Termos CarVia (subcontrato, cubagem) | app/carvia/CLAUDE.md |
| Como funciona o calculo de frete | cotando-frete/references/calculo_frete.md |
| Status e fluxos de operacao | app/carvia/CLAUDE.md secao R4 |