Esta skill deve ser usada quando o usuario pergunta sobre pedidos ANTES do faturamento: "tem pedido do Atacadao?", "pedido VCD123 esta em separacao?", "quanto tem de palmito?", "quando VCD123 fica disponivel?", "crie separacao do VCD123 pra amanha", ou qualquer consulta de carteira, estoque e separacao. Nao usar para pedidos ja faturados (usar monitorando-entregas), rastrear NF no Odoo (usar rastreando-odoo), ou analise P1-P7 completa da carteira (usar subagente analista-carteira). - Criar separacao: "crie separacao do VCD123 pra amanha" NAO USAR QUANDO (APOS faturar): - Status de entrega → usar **monitorando-entregas** - "que dia embarcou?", "foi entregue?" → usar **monitorando-entregas** - Rastrear NF no Odoo → usar **rastreando-odoo**
Skill para consultas e operacoes logisticas da Nacom Goya.
USE para:
NAO USE para:
analista-carteira)PROIBIDO 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.
TODA informacao na resposta DEVE ter origem no JSON retornado pelo script.
Scripts com busca semantica podem retornar produtos irrelevantes (ex: "maionese" ao buscar "ketchup").
Se um script falhar: SEMPRE responda ao usuario com erro e alternativa. NUNCA: Ficar em silencio, travar, ou tentar criar scripts customizados.
Para QUALQUER acao que modifica dados (criar separacao):
| Se a pergunta menciona... | Use este script | Com estes parametros |
|---|---|---|
| PRODUTO + CLIENTE/GRUPO ("quanto de X pro Y?") | consultando_situacao_pedidos.py | --grupo Y --produto X |
| Pedidos de um grupo ("tem pedido do atacadao?") | consultando_situacao_pedidos.py | --grupo atacadao |
| Pedidos de um cliente ("tem pedido do Carrefour?") | consultando_situacao_pedidos.py | --cliente Carrefour |
| Pedidos atrasados | consultando_situacao_pedidos.py | --atrasados |
| Estoque de produto ("quanto tem de X?") | consultando_produtos_estoque.py | --produto X --completo |
| Entradas recentes ("chegou X?") | consultando_produtos_estoque.py | --produto X --entradas |
| Ruptura/falta ("vai faltar X?") | consultando_produtos_estoque.py | --ruptura --dias 7 |
| Scan ruptura proativo ("o que vai faltar?") | consultando_produtos_estoque.py | --scan-ruptura-global --dias 7 |
| Co-passageiros embarque | consultando_situacao_pedidos.py | --co-passageiros-embarque 1234 |
| Quando pedido fica disponivel | analisando_disponibilidade_estoque.py | --pedido VCD123 |
| Disponibilidade de grupo | analisando_disponibilidade_estoque.py | --grupo atacadao --completude |
| Prazo de entrega ("quando chega?") | calculando_leadtime_entrega.py | --pedido X --data-embarque Y |
| Criar separacao | criando_separacao_pedidos.py | (SEM --executar!) |
consultando_situacao_pedidos.py --grupo X --produto Yconsultando_situacao_pedidos.py --grupo Xconsultando_produtos_estoque.py --produto X --completoanalisando_disponibilidade_estoque.py --pedido Xcalculando_leadtime_entrega.pycriando_separacao_pedidos.py (SEMPRE simular antes!)--cliente "ATACADAO 183"--grupo atacadao--grupo veio muito amplo e usuario quer loja especifica: refinar com --clientePASSO 1: O que o usuario quer? (PEDIDOS / ESTOQUE / DISPONIBILIDADE / PRAZO / ACAO) PASSO 2: Tem cliente/grupo? (SIM + produto → situacao_pedidos | SIM sem produto → situacao_pedidos | NAO → produtos_estoque) PASSO 3: A escolha faz sentido? (ESTOQUE mas "pro atacadao" → ERRADO, use PEDIDOS) PASSO 4: Em duvida → pergunte ao usuario!
A) Data que cliente solicitou (data_entrega_pedido) | B) Data de expedicao (expedicao) | C) Data de chegada (agendamento) | D) Protocolo de agendamento (protocolo)
Acao padrao: Mostrar AMBOS: "Na carteira: X un | Em separacao: Y un | Total: Z un"
Se resultado tiver mais de 1 loja: PERGUNTAR qual loja.
Para parametros completos, retornos e modos de operacao: LER SCRIPTS.md
Resumo dos 8 scripts:
| # | Script | Proposito |
|---|---|---|
| 1 | analisando_disponibilidade_estoque.py | Disponibilidade para pedidos/grupos |
| 2 | consultando_situacao_pedidos.py | Pedidos por filtros diversos |
| 3 | consultando_produtos_estoque.py | Estoque, movimentacoes, projecoes |
| 4 | calculando_leadtime_entrega.py | Data entrega ou data embarque reversa |
| 5 | criando_separacao_pedidos.py | Criar separacoes (simular antes!) |
| 6 | consultando_programacao_producao.py | Programacao de producao |
| 7 | resolver_entidades.py | Utilitario interno de resolucao |
| 8 | analisando_carteira_completa.py | Analise P1-P7 completa com decisoes |
| Campo | Obrigatorio | Como Obter |
|---|---|---|
| Pedido | SIM | Usuario informa |
| Data expedicao | SIM | Usuario informa |
| Tipo (completa/parcial) | SIM | Perguntar se nao especificado |
| Agendamento | CONDICIONAL | Verificar ContatoAgendamento pelo CNPJ |
| Protocolo | CONDICIONAL | Se exige agendamento |
Sequencia: SIMULAR → Verificar alertas → Mostrar → Confirmar → EXECUTAR
| Gatilho na Pergunta | Reference a Ler |
|---|---|
| Produto mencionado | references/products.md |
| Cliente/Grupo | references/business.md |
| Termo desconhecido | references/glossary.md |
| Variacao de escrita | references/synonyms.md |
| Comunicar PCP/Comercial | references/communication.md |
| Duvida de script | references/examples.md |
| Priorizacao, clientes top, SLAs | references/context.md |
Grupos Empresariais: --grupo atacadao, --grupo assai, --grupo tenda
--pedido X --expedicao Y| Programacao de producao | consultando_programacao_producao.py | --listar --dias 7 |
| Analise completa da carteira | analisando_carteira_completa.py | --resumo ou sem parametros |
| Priorizar por P1-P7 | analisando_carteira_completa.py | --prioridade N |