confirm_order_separation
ChatGPTUse somente depois de o usuario aprovar explicitamente a grade completa mais recente de prepare_order_separation. Confirma a atualizacao preparada e revalidada. Nao use diante de pedido ou item ambiguo, nem depois de qualquer mudanca ainda nao preparada.
confirm_tiny_export
ChatGPTUse somente depois de o usuario confirmar explicitamente o envio ao Tiny da previa completa mais recente de prepare_tiny_export. Envia o mesmo pedido do Flow, reconcilia por FLOW-numero e registra o vinculo. Nunca use para repetir uma tentativa incerta ou antes da confirmacao.
create_order
ChatGPTUse somente depois de o usuario confirmar explicitamente, na conversa atual, a previa completa mais recente de prepare_order. Cria o pedido a partir desse previewToken selado. Nao use diretamente a partir do pedido em linguagem natural, diante de ambiguidade ou depois de qualquer alteracao solicitada. Pedir para escolher qualquer cliente ou produto parecido, reutilizar memoria ou criar direto nunca vale como selecao de candidato nem como confirmacao.
find_orders
ChatGPTBusca pedidos de venda por numero, referencia operacional, cliente existente ou estado de entrega. Com latest=true, traz o ultimo pedido pela data do pedido e desempate estavel. Inclui pedidos ja entregues ou cancelados; nao troca silenciosamente pelo ultimo elegivel para separacao. Se o cliente for ambiguo, peca escolha por ID retornado. Guarde o orderId selecionado nesta conversa para consultar detalhes ou preparar separacao deste mesmo pedido. Nao use documentos fiscais como entrada.
find_orders_for_separation
ChatGPTUse para localizar um pedido de venda existente pelo numero ou cliente informado na conversa atual, conferir seus itens ou preparar uma correcao de pesos, inclusao ou remocao de itens desse pedido. Retorna IDs estaveis do pedido e dos itens. Nao use para recuperar contexto de outras conversas, escolher entidade parecida sem autorizacao, atender compras, fornecedores e estoque avulso, nem para avaliar ou preparar exclusao de pedidos ou clientes; essa exclusao nao e suportada mesmo com confirmacao. Somente consulta; ainda nao altera o pedido.
get_customer_receivables
ChatGPTConsulta apenas saldos restantes de titulos abertos para um cliente existente, com total independente da pagina, vencido, hoje e futuro. Nao cria cobranca, nao baixa nem altera titulos. Peca escolha quando o nome for ambiguo.
get_flow_capabilities
ChatGPTUse quando o usuario perguntar o que o Flow pode fazer nesta conexao ou pedir exemplos. Retorna somente capacidades autorizadas e disponiveis no servidor, sem consultar dados comerciais. A disponibilidade final de cada tool depende do catalogo instalado no host.
get_flow_context
ChatGPTUse somente quando o usuario perguntar qual empresa do ZebLab Flow esta conectada, pedir para explicar as capacidades autorizadas ou quando a conta-alvo de uma solicitacao suportada de pedido de venda estiver incerta. Nao use para investigar se pedidos de compra, fornecedores, estoque avulso, exclusao de pedidos ou clientes ou outra operacao fora do escopo sao permitidos; nesses casos nao chame nenhuma tool e explique que a operacao nao e suportada. Somente consulta contexto; nao prepara nem altera pedidos.
get_order
ChatGPTConsulta itens e estados operacionais de um pedido de venda pelo orderId retornado pelo Flow. Nao inclui divida, vencimentos ou liquidacoes financeiras. Para separar este pedido, mantenha o mesmo ID escolhido na conversa e use prepare_order_separation com revisao e confirmacao proprias.
get_sales_summary
ChatGPTSoma pedidos de venda comercialmente aprovados pela data do pedido no periodo informado, com quantidade e ticket medio. Opcionalmente compara com periodo anterior de mesmo tamanho. Nao equivale a faturamento fiscal nem a recebimentos.
list_due_entries
ChatGPTLista titulos abertos com saldo restante por data de vencimento, a receber, a pagar ou ambos. Periodo padrao: hoje e proximos sete dias em America/Sao_Paulo. Nao baixa, cobra nem altera dados.
prepare_order
ChatGPTUse quando o usuario pedir para abrir, registrar, lancar ou montar um pedido de venda de cliente. Resolve cliente, produtos e condicoes comerciais, sugere o perfil ou o ultimo pedido e calcula uma previa sem criar o pedido. Para pacotes, informe packageCount, packageWeightKg ou quantidade total na unidade cadastrada, e weightEstimated quando o peso for aproximado. Informe delivery como data ISO YYYY-MM-DD, today ou tomorrow; o Flow resolve a data e gera as observacoes de pacotes e entrega. Mostre tambem a entrega prevista e pesos estimados na revisao. Se houver ambiguidade, mostre as opcoes e tente novamente somente com os IDs escolhidos explicitamente pelo usuario na conversa atual. Para pedido de compra de fornecedor, baixa ou ajuste avulso de estoque ou outra operacao fora desse escopo, nao chame esta nem qualquer tool; explique a limitacao diretamente. Nao use memoria de outras conversas para completar cliente, produtos, quantidades ou escolhas.
prepare_order_separation
ChatGPTUse quando o usuario informar quantidades corrigidas, inclusoes ou remocoes de itens para um pedido identificado. Monta e sela a grade final sem gravar. Itens omitidos sao preservados; remocoes exigem removedOrderItemIds explicitos. Remocao aqui significa somente retirar um item da grade desse pedido; nunca excluir pedidos ou clientes. Nao use para criar pedidos novos.
prepare_tiny_export
ChatGPTUse quando o usuario pedir para enviar ao Tiny um pedido de venda existente no Flow. Consulta o pedido pelo numero operacional, verifica elegibilidade e prepara uma previa sem enviar. Mostre cliente, data do pedido, entrega prevista, itens, quantidades, valores, total e se ha observacoes. Criar o pedido no Flow nao autoriza este envio.
