buscar_clientes
ChatGPTLista ou procura clientes pelo nome, telefone ou e-mail (sem texto, lista toda a base). Devolve o TOTAL de clientes do filtro (use para "quantos clientes eu tenho"), e por página nome, tipo, cidade e se o cliente tem valor a receber em aberto. Documento, telefone e e-mail saem parcialmente ocultos; o contato completo de UM cliente está em obter_cliente. Somente leitura.
buscar_produtos
ChatGPTLista ou procura produtos e serviços do catálogo pelo nome, SKU ou marca (sem texto, lista o catálogo). Devolve o TOTAL do filtro (use para "quantos produtos eu tenho"), e por página preço, saldo em estoque, estoque mínimo e se tem grade (tamanho/cor). Para o saldo por tamanho/cor de um produto use consultar_estoque. O custo só aparece para quem a tela deixa ver. Somente leitura.
consultar_estoque
ChatGPTMostra o saldo em estoque de um produto, e o saldo de cada variação da grade (tamanho, cor, sabor...) quando o produto tem. Informe o nome, SKU ou o id do produto; se o texto casar com vários produtos (até 5), devolve cada um. Use para "quanto tenho da camiseta M". Somente leitura.
contas_a_receber
ChatGPTParcelas em aberto de vendas a prazo e crediário (quem deve, quanto, e desde quando), em ordem de vencimento, com juros e multa já calculados. Aceita filtrar por cliente e só as vencidas. Devolve também o total em aberto. Use para "quem está me devendo" ou "o que vence esta semana". Somente leitura.
criar_cliente
ChatGPTCadastra UM cliente novo na empresa (o mesmo cadastro da tela de Clientes). Só dono e gerente podem. ANTES, rode buscar_clientes com o nome: cliente repetido é o erro mais comum. Informe só o que o usuário disse (nome; opcionais: telefone, e-mail, endereço, observações); nunca invente nem complete dado. Se já houver cliente com nome igual ou parecido, NÃO cria e devolve possiveisDuplicados: pergunte ao usuário se é a mesma pessoa; só se ele disser que é outra pessoa chame de novo com confirmoQueENovo: true. Se a resposta vier com repetido: true, o cadastro já tinha sido feito há poucos minutos e nada foi duplicado. Para empresa informe tipo PJ e nomeOficial (razão social). Documentos de identificação não são recebidos por aqui: o usuário completa na tela de Clientes do Nivro. Dado cadastrado é dado de verdade da loja.
criar_pedido
ChatGPTCria o pedido que a prévia (previa_pedido) mostrou, DEPOIS de o usuário confirmar com um "sim" explícito. Envie os MESMOS argumentos da prévia e o campo confirmacao que ela devolveu; se o total passar de R$ 5.000, também totalConfirmado com o valor que o usuário confirmou. Se algo mudou desde a prévia (preço, produto), recusa com confirmacao_desatualizada: refaça a prévia e pergunte de novo. O pedido nasce confirmado e RESERVA o estoque dos itens; pode ser recusado por estoque insuficiente ou desconto acima do limite do usuário (não há como forçar por aqui). Não avisa o cliente e não envia link de aprovação: não faça isso. Repetir a chamada com o mesmo confirmacao devolve o mesmo pedido (repetido: true), sem criar outro. Não cancela nem altera pedido.
criar_venda
ChatGPTRegistra a venda que a prévia (previa_venda) mostrou, DEPOIS de o usuário confirmar com um "sim" explícito. Envie os MESMOS argumentos da prévia e o campo confirmacao que ela devolveu; se o total passar de R$ 5.000, também totalConfirmado com o valor que o usuário confirmou. Se algo mudou desde a prévia (preço, produto, pagamentos), recusa com confirmacao_desatualizada: refaça a prévia e pergunte de novo. A venda é feita AGORA, em nome do usuário, baixa o estoque e registra os pagamentos; pode ser recusada por estoque, limite de crédito ou desconto acima do limite do usuário (não há como forçar por aqui). A nota fiscal só é emitida se o usuário respondeu emitirNota: true na prévia (o mesmo "sim" cobre a venda e a nota); a nota nunca sai sozinha e, se ela falhar, a venda continua registrada e a resposta diz o motivo. Repetir a chamada com o mesmo confirmacao devolve a mesma venda (repetido: true), sem criar outra nem emitir outra nota. Não cancela nem altera venda: se o usuário desistir, o cancelamento é pela tela do Nivro.
emitir_nota_da_venda
ChatGPTEmite a nota fiscal (NFC-e ou NF-e, conforme a regra da empresa) de uma venda que já foi registrada. USE SÓ quando o usuário pedir a nota desta venda: antes, chame obter_venda e leia o bloco notaFiscal (se a venda já tem nota, se dá para emitir, qual modelo e se o ambiente é de homologação, onde a nota NÃO tem valor fiscal), diga ao usuário o que vai acontecer e só chame esta ferramenta com um "sim" explícito dele. Informe o id (UUID) da venda, de listar_vendas ou obter_venda. A emissão é um ato fiscal e pode gerar cobrança conforme o plano. Não aconselhe o usuário a emitir ou não: essa decisão e as questões de tributo são dele e do contador. Se a venda já tem nota, devolve a nota que existe, sem emitir outra. Se faltar cadastro (cliente, produto, empresa), a nota não sai e nenhum número é gasto: explique o que falta; corrigir é pela tela do Nivro (nunca preencha dado fiscal). Se a nota ficar em processamento, não repita a chamada: consulte obter_venda mais tarde. Só dono e gerente, e só venda de balcão ou pedido faturado (venda de ordem de serviço é pela tela). Não cancela nota.
faturar_pedido
ChatGPTFatura o pedido (cria a venda, baixa o estoque reservado e registra os pagamentos) que a prévia (previa_faturamento) mostrou, DEPOIS de o usuário confirmar com um "sim" explícito. Envie os MESMOS argumentos da prévia e o campo confirmacao que ela devolveu; se o total passar de R$ 5.000, também totalConfirmado com o valor que o usuário confirmou. Se algo mudou desde a prévia (separação, adiantamento, preço), recusa com confirmacao_desatualizada: refaça a prévia e pergunte de novo. A nota fiscal só é emitida se o usuário respondeu emitirNota: true na prévia (o mesmo "sim" cobre a venda e a nota); a nota nunca sai sozinha e, se falhar, a venda continua registrada e a resposta diz o motivo. Repetir a chamada, ou faturar um pedido que já foi faturado, devolve a mesma venda (repetido: true) sem criar outra nem emitir outra nota. Não cancela nem estorna venda.
fluxo_de_caixa
ChatGPTEntradas, saídas e saldo do caixa num período (valores já confirmados: o que realmente entrou e saiu), com o saldo inicial e o saldo atual. Períodos de até 62 dias vêm dia a dia; maiores vêm mês a mês. Use para "quanto entrou e saiu este mês". Informe o período. Somente leitura.
listar_pedidos
ChatGPTLista os pedidos da empresa (orçamentos e pedidos de venda), do mais novo para o mais antigo, com situação, cliente e valor. Use para perguntas como "quais foram os pedidos de hoje" ou "o que está para entregar". Aceita filtro por situação, período e busca (código ou número do pedido, nome do cliente). Para ver os itens de um pedido, use obter_pedido. Somente leitura.
listar_vendas
ChatGPTLista as vendas já feitas (balcão, pedidos faturados, etc.), da mais nova para a mais antiga, com cliente, valor, quanto foi pago e a situação (Pago, Pendente ou Cancelada). Use para "quais foram as vendas de ontem" ou "vendas pendentes do cliente X". Para totais e ticket médio de um período use resumo_vendas. Somente leitura.
obter_cliente
ChatGPTMostra a ficha de UM cliente (contato, endereço e o documento parcialmente oculto), quanto ele já comprou e o que tem a receber em aberto (parcelas, vencidas ou não). Informe o id do cliente (obtido em buscar_clientes). Somente leitura.
obter_pedido
ChatGPTMostra um pedido completo: itens (com variação/grade, quantidade, preço e o que já foi separado), cliente, situação, entrega, adiantamento recebido e histórico de situações. Aceita o id do pedido ou o código/número que aparece na tela (ex.: 00123). Somente leitura.
obter_venda
ChatGPTMostra uma venda completa: itens (com variação/grade e número de série quando houver), formas de pagamento, parcelas a receber, cliente e vendedor. Informe o id da venda (obtido em listar_vendas). Somente leitura.
pdf_do_pedido
ChatGPTGera o PDF de um pedido ou orçamento (o mesmo documento do botão de PDF da tela do Nivro) para o usuário baixar ou enviar ao cliente. Aceita o id do pedido ou o código/número que aparece na tela (ex.: 00123). Devolve um LINK temporário que vale 10 minutos: o usuário precisa abrir o link no navegador, o conteúdo do PDF não vem na resposta. O PDF tem os dados do cliente. Use quando o usuário pedir o PDF, o orçamento em arquivo ou algo para mandar ao cliente. Somente leitura: não envia nada a ninguém.
previa_faturamento
ChatGPTPRIMEIRO PASSO para faturar um pedido (transformá-lo em venda): mostra o que a venda terá (itens separados, total, faltas, adiantamento já recebido, o que falta pagar), confere as formas de pagamento e a nota fiscal, e devolve o resumo com um confirmacao. NÃO fatura nada. Informe o id do pedido, os pagamentos (forma e valor, ditos pelo usuário: a soma tem de ser igual ao que falta pagar; a parte que fica para depois é A_PRAZO) e, se a nota fiscal estiver disponível, emitirNota (pergunte; sem padrão). Se faltar pagamento ou a resposta da nota, devolve informacao_faltando com o valor que falta pagar: pergunte tudo ao usuário de uma vez. Mostre o resumo ao usuário e só com um "sim" explícito chame faturar_pedido. Recusa: pedido cancelado, orçamento vencido, nada separado, cobrança na entrega, item com IMEI/série, loja com controle de caixa ligado. Pedido já faturado devolve a venda. Pode ser feito só por gerente ou dono.
previa_pedido
ChatGPTPRIMEIRO PASSO para criar um pedido (orçamento/pedido de venda): confere cliente, produtos, variações e quantidades, calcula o preço de cada item como o PDV (tabela de preço do cliente) e o total, e devolve o resumo com um confirmacao. NÃO cria nada. Use SÓ ids de buscar_clientes e buscar_produtos (nunca nomes); se faltar algo (cliente, quantidade, variação de um produto com grade), devolve informacao_faltando: pergunte ao usuário tudo de uma vez. Mostre ao usuário o resumo (cliente, cada item com preço e de onde veio o preço, total) e pergunte se confirma; só com um "sim" explícito chame criar_pedido. Não faz parte da prévia: o estoque e o teto de desconto, conferidos só ao criar. Item com IMEI/série não é aceito.
previa_venda
ChatGPTPRIMEIRO PASSO para registrar uma venda de balcão (venda agora, à vista ou parte a prazo): confere cliente, produtos, variações, quantidades, estoque, pagamentos e nota fiscal, calcula o preço de cada item como o PDV (tabela de preço do cliente) e o total, e devolve o resumo com um confirmacao. NÃO registra nada. Use SÓ ids de buscar_clientes e buscar_produtos (nunca nomes). Os pagamentos são ditos pelo usuário (forma e valor): a soma tem de ser IGUAL ao total; a parte que o cliente pagará depois é A_PRAZO (exige cliente). Não há troco. Se faltar algo (produto, quantidade, variação, forma de pagamento, resposta da nota fiscal), devolve informacao_faltando: pergunte tudo ao usuário de uma vez. Mostre o resumo (cliente, itens com preço e de onde veio, total, pagamentos, vencimento) e só com um "sim" explícito chame criar_venda. Recusa: loja com controle de caixa ligado, teste da empresa encerrado, estoque insuficiente, item com IMEI/série, cliente acima do limite de crédito. Não faz parte da prévia: o teto de desconto do usuário, conferido só ao registrar.
produtos_mais_vendidos
ChatGPTRanking dos produtos que mais venderam num período, por faturamento ou por quantidade, descontando devoluções e vendas canceladas. O faturamento é preço x quantidade das linhas, antes do desconto dado no total da venda. Informe o período. Somente leitura.
quem_sou_eu
ChatGPTDiz com qual usuário e em qual empresa do Nivro esta conversa está conectada, e qual é o papel dele (dono, gerente, operador, leitor ou contador). Use no começo da conversa para confirmar com o usuário que é a empresa certa, e quando uma consulta for recusada por falta de permissão. Lista também quais consultas este usuário pode fazer. Somente leitura.
resumo_vendas
ChatGPTResumo do desempenho de um período: faturamento, número de vendas, ticket médio, formas de pagamento, valores a receber gerados e recebidos, lucro bruto, melhores vendedores, melhores clientes e os 5 produtos que mais venderam. Use para "como foram as vendas do mês". Informe o período. Venda cancelada não conta. Somente leitura.