gerindo-expedicao

name: gerindo-expedicao description: >- Carteira, estoque e separacao PRE-faturamento. Gatilhos: "tem pedido do Atacadao?", "pedido VCD123 esta em separacao?", "quanto tem de palmito?", "quando VCD123 fica disponivel?", "crie separacao do VCD123 pra amanha". Anti: ja faturado -> monitorando-entregas; NF no Odoo -> rastreando-odoo; analise P1-P7 completa -> analista-carteira. allowed-tools: Read, Bash, Glob, Grep

Gerindo Expedicao

Skill para consultas e operacoes logisticas da Nacom Goya.

Quando Usar Esta Skill

USE para:

• Consultas de pedidos: "tem pedido do Atacadao?", "pedido VCD123 esta em separacao?"
• Consultas de estoque: "quanto tem de palmito?", "chegou cogumelo?"
• Analise de disponibilidade: "quando VCD123 fica disponivel?", "o que vai dar falta?"
• Calculo de prazo: "se embarcar amanha, quando chega?"
• Criacao de separacao: "crie separacao do VCD123 pra amanha"

NAO USE para:

• Analise COMPLETA da carteira com decisoes (use o Agent analista-carteira)
• Comunicacao com PCP ou Comercial (use o Agent)
• Decisoes de priorizacao P1-P7 (use o Agent)

REGRAS CRITICAS (NUNCA VIOLAR)

1. GUARDRAIL ANTI-ALUCINACAO

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.

2. FIDELIDADE AO OUTPUT DO SCRIPT

TODA informacao na resposta DEVE ter origem no JSON retornado pelo script.

• Quantidades, valores, datas, nomes: copiar EXATAMENTE do JSON
• NAO arredondar, estimar ou interpolar valores
• Se o script retornou resultado vazio (0 itens), informar claramente: "Nao ha dados cadastrados para [periodo/filtro]"
• NAO inventar dados para preencher resultados vazios
• Sugerir alternativas: "Posso verificar com horizonte maior" ou "Quer que consulte por outro filtro?"

3. FILTRAGEM DE FALSE POSITIVES

Scripts com busca semantica podem retornar produtos irrelevantes (ex: "maionese" ao buscar "ketchup").

• Verificar se cada item retornado corresponde ao que o usuario pediu
• Descartar itens que nao sao do produto solicitado
• Informar ao usuario quando houver descarte: "O script tambem retornou [X] por semelhanca, mas nao e [produto pedido]"

4. REGRA DE FALLBACK (NUNCA TRAVAR)

Se um script falhar: SEMPRE responda ao usuario com erro e alternativa. NUNCA: Ficar em silencio, travar, ou tentar criar scripts customizados.

5. SIMULAR ANTES DE EXECUTAR (ACOES)

Para QUALQUER acao que modifica dados (criar separacao):

1. Executar SEM --executar (simular)
2. Mostrar resultado ao usuario
3. AGUARDAR confirmacao explicita
4. So entao executar COM --executar

6. ITEM LIMITANTE — CONFIRMACAO DUPLA OBRIGATORIA

Se a simulacao de criando_separacao_pedidos.py retornar alertas_estoque NAO-VAZIO:

• PROIBIDO executar --executar direto, mesmo com confirmacao previa generica do usuario (ex: "criar separacao na data Y" NAO autoriza executar com item em falta).
• OBRIGATORIO apresentar ao usuario as opcoes explicitamente:
  • A) Separacao COMPLETA com item em falta (usuario aceita risco de inconsistencia operacional na expedicao — separacao tera item incompleto vs estoque)
  • B) Separacao PARCIAL --apenas-estoque ou excluindo o item limitante (--excluir-produtos '["COD"]'), expedindo apenas o disponivel
  • C) Aguardar disponibilidade (sem criar separacao agora) — sugerir nova data baseada em consultando_programacao_producao.py --produto <produto_em_falta>
• AGUARDAR escolha explicita (A, B ou C) ANTES de executar --executar.
• Motivo: criar separacao completa com item em falta gera inconsistencia na expedicao (item nao saira no embarque mas estara reservado, gerando ajuste manual posterior).

DECISION TREE - Qual Script Usar?

Mapeamento Rapido

Regras de Decisao (em ordem de prioridade)

1. PRODUTO + CLIENTE/GRUPO juntos: → consultando_situacao_pedidos.py --grupo X --produto Y
2. PEDIDOS de cliente/grupo (sem produto): → consultando_situacao_pedidos.py --grupo X
3. ESTOQUE de produto (sem cliente): → consultando_produtos_estoque.py --produto X --completo
4. DISPONIBILIDADE de pedido: → analisando_disponibilidade_estoque.py --pedido X
5. PRAZO de entrega: → calculando_leadtime_entrega.py
6. ACAO de criar separacao: → criando_separacao_pedidos.py (SEMPRE simular antes!)
7. ACAO de gerar embarque (separacoes JA escolhidas → Cotacao+Embarque): → gerar_embarque.py (SEMPRE dry-run antes! --confirmar efetiva). NAO lanca frete — o frete nasce depois na portaria/faturamento. v1 SO Nacom (recusa CARVIA-/ASSAI-).
8. ACAO de adicionar 1 lote a embarque JA EXISTENTE: → adicionando_item_embarque.py (SEMPRE dry-run antes! --confirmar efetiva). Recalcula os totais por SOMA dos itens ativos (sincronizar_totais_embarque) — NUNCA incremente o total na mao (infla). SO Nacom (LOTE_*); itens CARVIA-* tem fluxo proprio (reconciliar_embarque_carvia).

--cliente vs --grupo (IMPORTANTE)

• Loja especifica mencionada (ex: "Atacadao 183", "Assai SP"): usar --cliente "ATACADAO 183"
• Grupo inteiro (ex: "Atacadao", "Assai"): usar --grupo atacadao
• Se resultado de --grupo veio muito amplo e usuario quer loja especifica: refinar com --cliente

Como Decidir (Raciocinio Obrigatorio)

PASSO 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!

Termos Ambiguos - PERGUNTE antes de agir!

"programacao de entrega" (CRITICO - 4 interpretacoes)

A) Data que cliente solicitou (data_entrega_pedido) | B) Data de expedicao (expedicao) | C) Data de chegada (agendamento) | D) Protocolo de agendamento (protocolo)

"quantidade pendente"

Acao padrao: Mostrar AMBOS: "Na carteira: X un | Em separacao: Y un | Total: Z un"

Multiplas lojas do mesmo grupo

Se resultado tiver mais de 1 loja: PERGUNTAR qual loja.

Scripts — Referencia Detalhada

Para parametros completos, retornos e modos de operacao: LER SCRIPTS.md

Resumo dos 10 scripts:

Fluxo de Criacao de Separacao

Sequencia: SIMULAR → Verificar alertas → Mostrar → Confirmar → EXECUTAR

Resumo Padrao de Pedido (CONSULTAS)

Quando responder consulta de UM pedido especifico (ex: "pedido VCD123 esta completo?"), INCLUIR PROATIVAMENTE no resumo inicial — sem o usuario pedir:

Motivo: peso/volume/pallets sao informacoes operacionais basicas frequentemente solicitadas para planejar embarque, frete e logistica. Omiti-las gera turnos desnecessarios. Se o script nao retornar volume_total_m3 (cadastro sem dimensoes — altura/largura/comprimento zerados em CadastroPalletizacao), o valor sera 0; informar "volume nao cadastrado para [N produtos]" em vez de simular.

Organizacao de Resultados na Resposta

Muitos itens (>10): Priorizar e agrupar

• Ordenar por relevancia: valor em risco, urgencia (ruptura antes de deficit), quantidade
• Mostrar top 5-10 na resposta principal com tabela
• Agrupar por categoria quando aplicavel (familia de produto, loja, urgencia)
• Resumir totais: "39 produtos criticos, Top 10 por valor em risco:"
• Oferecer detalhamento: "Quer ver a lista completa?" ou "Posso detalhar por [criterio]?"

Poucos itens (<10): Mostrar todos

• Listar individualmente com dados completos

Resultado vazio (0 itens):

• Informar claramente: "Nao ha [X] para [filtro/periodo]"
• Sugerir motivos possiveis (dados nao cadastrados, periodo diferente)
• Oferecer alternativas (horizonte maior, filtro diferente)

Leitura de References (Sob Demanda)

Grupos Empresariais: --grupo atacadao, --grupo assai, --grupo tenda