iGUi, A sua piscina!

Buscar Clientes Por Email

Busca clientes já cadastrados no sistema pelo email. Se o cliente existir, pegue o seu 'id' e os dados obrigatórios retornados para usar na criação do orçamento.

Buscar Clientes Por Telefone

Busca clientes já cadastrados no sistema pelo telefone. Se o cliente existir, pegue o seu 'id' e os dados obrigatórios retornados para usar na criação do orçamento.

Buscar Clientes Por Nome Ou Razao Social

Busca clientes já cadastrados no sistema pelo nome ou razão social. SEMPRE use esta ferramenta ANTES de criar um orçamento para verificar se o cliente já existe. Se o cliente existir, pegue o seu 'id' e os dados obrigatórios retornados para usar na criação do orçamento.

Buscar Orcamentos Pelo Cliente

Busca a lista de orçamentos associados a um cliente. 🧠 COMPORTAMENTO PADRÃO: Se o usuário pedir apenas "orçamentos do cliente X", busque APENAS os "Em aberto". Se ele pedir o "histórico" ou especificar "cancelados/confirmados", mude o status. ⚠️ IMPORTANTE: Esta API retorna apenas um RESUMO. Use a ferramenta 'buscar_orcamento_por_codigo' se precisar de detalhes e valores.

Buscar Orcamento Pelo Codigo

Busca orcamento pelo código no sistema comercial da iGUi.

Listar Opcoes Referencia

Consulta os dicionários de dados da iGUi. IMPORTANTE: Se precisar do ID de um parcelamento para criar um orçamento, siga estes passos na ordem: 1. Chame esta ferramenta com entidade="formas-pagamentos" para descobrir o ID do método de pagamento. 2. Chame esta ferramenta de novo com entidade="parcelamentos" passando o ID encontrado no campo "id_referencia".

Criar Orcamento

Cria um novo orçamento no sistema comercial da iGUi. 🚨 ATENÇÃO - MODO ASSISTENTE DE VENDAS (STRICT WIZARD): NÃO chame esta ferramenta tentando adivinhar dados. Você DEVE conversar com o usuário e fazer perguntas até preencher TODO o checklist abaixo. Faça as perguntas de forma natural e em etapas, para não cansar o usuário. CHECKLIST OBRIGATÓRIO (NÃO EXECUTE ANTES DE TER TODAS AS RESPOSTAS): 1. [ ]

Editar Orcamento

Edita (atualiza) um orçamento existente no sistema comercial da iGUi. 🚨 REGRA DE OURO (MÉTODO PUT): Esta ferramenta exige o envio do payload COMPLETO do orçamento, e não apenas o que mudou. Se você não tem os dados completos atuais do orçamento, VOCÊ DEVE usar primeiro a ferramenta de busca de orçamento por código para recuperar o JSON original. Após recuperar o JSON original, altere APENAS os campos solicitados pe

Deletar Orcamento

Cancela (exclui) um orçamento no sistema comercial da iGUi. 🚨 REGRA CRÍTICA DE SEGURANÇA (OPERAÇÃO DESTRUTIVA): NUNCA chame esta ferramenta sem antes pedir a CONFIRMAÇÃO EXPLÍCITA do usuário. Se o usuário pedir para cancelar, PARE A EXECUÇÃO e pergunte no chat: "Você tem certeza que deseja cancelar definitivamente o orçamento [ID]?" Somente chame esta ferramenta SE o usuário já tive

Gerar Link Pdf Orcamento

Gera o documento PDF de um orçamento e retorna o link para visualização ou impressão. Use esta ferramenta sempre que o usuário pedir para gerar o PDF, ou logo após criar um orçamento se o usuário solicitar o documento final.

Enviar Email Orcamento

Dispara o envio de um orçamento por e-mail para o cliente. Use esta ferramenta quando o usuário pedir explicitamente para "enviar o orçamento por e-mail" ou logo após a criação de um orçamento, caso o usuário já tenha solicitado o envio automático.

Buscar Produtos

Busca produtos no catálogo da iGUi pelo nome. Os cadastros de piscinas com filtro seguem o padrão "<Nome da piscina> - <Nome do filtro>". Por exemplo, a piscina Ática com o filtro G7 Comfort está cadastrada como: "Ática - G7 Comfort". Use esta ferramenta para descobrir o ID dos produtos antes de preencher a array 'orcamentoItem' na ferramenta de criação de orçamentos. Os valores unitários sempre virão zerados, pois o usuário é quem define o valor

Buscar Cidade

Busca cidades e estados (UF) válidos na API dos Correios. ⚠️ REGRA ESTRITA: SEMPRE que for cadastrar um endereço de cliente no orçamento, USE ESTA FERRAMENTA para validar a cidade e descobrir a UF (estado). Mapeamento obrigatório: - O campo 'nome' retornado vai no campo 'cidade' do orçamento. - O campo 'sigla' retornado vai no campo 'uf' do orçamento.