CotaCompras

Cotacompras Ajuda

CHAMAR quando o usuário iniciar a conversa sem credenciais, perguntar o que o sistema faz, ou pedir ajuda. Retorna versão atual, novidades, aviso de atualização se necessário, e exemplos de uso.

Listar Insumos Catalogo

Lista todos os insumos cadastrados com grupo, categoria e setor. Usar quando o usuário quiser ver o catálogo completo de insumos da rede.

Listar Insumos Por Loja

Lista insumos por loja e fornecedor com paginação. Regra: pagina nunca maior que limite (máx 100, padrão 50).

Consultar Cotacoes

Consulta cotações de compra. Usar SOMENTE quando o usuário mencionar explicitamente 'cotação', 'cotações' ou 'cotar'. NUNCA usar para pedidos, compras ou ordens de compra — para isso usar listar_ordens_compra. Datas no formato yyyyMMdd (diferente das OCs que usam yyyy-MM-dd).

Listar Ordens Compra

Lista ordens de compra (pedidos). Usar SEMPRE que o usuário falar em 'compras', 'pedidos', 'ordens de compra', 'OC' ou 'o que comprei'. NÃO confundir com cotações — cotação é processo ANTERIOR à compra. Datas nos parâmetros em yyyy-MM-dd (o servidor converte automaticamente para yyyyMMdd no payload).

Criar Cotacao

Cria uma nova cotação de compra. Usar quando o usuário quiser abrir cotação para itens. REGRA: apenas 1 loja por cotação. Preferir codigoExportacaoInsumo quando disponível.

Listar Lojas

EXECUTAR SEMPRE ANTES DA PRIMEIRA exec_query. Lista lojas da rede retornando pk_loja, nome e CNPJ. Guardar os pk_loja para passar como pks_lojas no exec_query — garante que os dados retornados sejam apenas do escopo correto da rede.

Schema Banco

USAR SOMENTE quando nenhuma outra ferramenta específica atender e for necessário montar uma exec_query sem conhecer as tabelas. NÃO usar se já existir ferramenta dedicada: listar_ordens_compra, consultar_cotacoes, listar_insumos_catalogo, listar_insumos_por_loja, listar_lojas, criar_cotacao, requisicao_v2, vendas, mensageria, fin_titulo.

Exec Query

USAR SOMENTE para análises customizadas, cruzamentos, rankings ou agregações que nenhuma outra ferramenta consegue responder. REGRA DE ESCOPO DE LOJAS (OBRIGATÓRIA): - Sempre chamar listar_lojas antes da primeira exec_query e guardar os pk_loja - Passar pks_lojas em TODA chamada — o servidor injeta WHERE FK_LOJA IN (...) automaticamente - Se o SQL referenciar TAB_LOJA, PK_LOJA, FK_LOJA, FK_LOJA_ORIGEM ou FK_LOJA_DESTINO, pks_lojas é OBRIGATÓRIO - Nunca incluir filtro de lojas manualmente na que

Vendas

Gerencia registros de vendas diárias por loja. tipo=VENDAS, operação definida por parametro2. QUANDO USAR: usuário mencionar "vendas", "faturamento", "quanto vendeu", "receita do dia" etc. OPERAÇÕES (parametro2): - LER → Consulta vendas. Filtros opcionais: pk_venda, fk_loja, dt_de, dt_ate (YYYY-MM-DD). - INCLUIR → Insere uma ou várias vendas. REGRA: apenas UM registro por loja por dia. Obrigatórios: (fk_loja ou nr_cnpj) + dt_movimento + vr_venda. - ALTERAR → Atualiza campos. Ob

Requisicao V2

Gerencia requisições de compra via contrato REQUISICAO (Junho/2026). OPERAÇÕES (parametro2): - LER → Consulta requisições. Filtros: pk_requisicao, fk_loja_origem, st_status, dt_de, dt_ate. - INCLUIR_POR_ITENS → Cria com lista explícita de insumos. Obrigatórios: lojas + st_tiporeq + itens[]. - INCLUIR_POR_GRUPO → Cria com todos insumos dos grupos. Obrigatórios: lojas + st_tiporeq + grupos[]. - ALTERAR → Atualiza cabeçalho/itens. Obrigatório: pk_requisicao. TIPOS: 1=Compr

Mensageria

Gerencia a fila de envio de mensagens WhatsApp/notificações da rede. tipo=MENSAGERIA. QUANDO USAR: usuário mencionar "mensagem", "whatsapp", "fila de envio", "notificação", "pendentes", "confirmar envio". OPERAÇÕES (parametro2): - PENDENTES → Retorna mensagens ABERTO ou ERRO de uma fila. Obrigatório: nr_fila. Opcional: {"cnpjs":[...]} para filtrar lojas. - INCLUIR → Insere mensagem na fila. Obrigatórios: nr_fila + nr_celular + ds_msg. Retorna pk_mensageria. ⚠️ NUN

Fin Titulo

Gerencia títulos financeiros a pagar e a receber. tipo=FIN_TITULO. QUANDO USAR: usuário mencionar "título", "financeiro", "contas a pagar", "contas a receber", "vencimento", "baixar pagamento", "pagar conta", "receita", "despesa", "parcela". PLANO DE CONTAS (fk_plano_contas) — define PAGAR ou RECEBER automaticamente: PAGAR: 1=Compras Alimentos | 2=Bebidas | 3=Embalagens | 4=Aluguel | 5=Água/Luz/Gás 6=Salários | 7=Impostos | 8=Manutenção | 9=Marketing | 10=Royalties | 11=Outras Despe