ponte erp

Ferramentas

Tudo o que o Ponte ERP faz no Bling

São 60 ferramentas. Você não precisa decorar nenhuma: pede em português e o assistente escolhe. Esta lista serve para o administrador saber o que liberar para cada pessoa e para quem quer conferir os detalhes.

Toda alteração tem prévia. Antes de gravar no Bling, o assistente mostra o que vai mudar e espera você confirmar. As de consulta não alteram nada. As permissões seguem estas mesmas áreas: veja como funcionam.

Produtos 4 de consulta · 8 de alteração

Cadastro, preços, variações, kits e imagens.

Só consulta

Encontra produtos pelo nome (em qualquer ordem das palavras) ou pelo código.

“Busca cadeira de escritório”

“Quais produtos de papelaria temos com estoque?”

buscar_produtos

O que não faz
  • Não filtra por categoria (a listagem do Bling não traz a categoria).
  • Preço e estoque desta lista podem ter até 10 min de atraso; para o saldo atual use consultar_estoque.
Só consulta

Mostra a ficha completa de um produto: preço, custo, NCM, pesos, variações e saldo.

“Ficha do produto 1050”

“Qual o NCM da caneca de porcelana?”

detalhar_produto

O que não faz
  • Não mostra histórico de vendas do produto; use listar_pedidos_venda com `produto`.
Só consulta

Lista todos os campos de produto que dá para preencher ou alterar.

“Quais campos do produto eu consigo alterar?”

listar_campos_produto

O que não faz
  • Não altera nada; é só a lista de nomes aceitos.
Só consulta

Planeja um cadastro antes de criar: confere duplicados e o que falta preencher.

“Quero cadastrar uma camiseta X azul e preta, P, M e G, a 59,90”

“Cadastra um kit com 2 cadernos e 1 caneta”

planejar_produto

O que não faz
  • Não grava nada: devolve o plano (simples, variações ou kit) e as perguntas pendentes.
  • Não decide sozinho entre variações e kit quando a descrição é ambígua: pergunta.
Mostra prévia e pede confirmação

Acrescenta variações (cor, tamanho) a um produto que já tem variações.

“Adiciona a cor verde na camiseta X”

“Adiciona a cor verde em P e M na camiseta X (atributos: Cor=[Verde], Tamanho=[P, M])”

adicionar_variacao

O que não faz
  • Só em produto que já tem variações; para produto simples use converter_em_variacoes.
  • Ignora variações que já existem.
Mostra prévia e pede confirmação

Transforma um produto simples em produto com variações.

“Transforma a camiseta básica em produto com variações de cor, transferindo o estoque”

converter_em_variacoes

O que não faz
  • Não decide sozinho o que fazer com o saldo: exige 'zerar' ou 'transferir'.
  • Não converte produto que já tem variações ou é kit.
Mostra prévia e pede confirmação

Cadastra um produto novo.

“Cadastra o produto Garrafa térmica 500 ml a R$ 38,90, unidade UN”

“(com plano) Pode criar a camiseta com as 6 variações que planejamos”

criar_produto

O que não faz
  • Não cria sem prévia e confirmação.
  • Não aceita plano com pendências: primeiro feche com planejar_produto.
  • Avisa se já existe produto com o mesmo nome.
Mostra prévia e pede confirmação

Monta um kit: define quais produtos e quantidades o compõem.

“Monta o kit escritório com 2 cadernos e 1 caneta”

definir_componentes

O que não faz
  • Não movimenta estoque; só define a estrutura.
  • Produto com variações não pode virar kit.
Mostra prévia e pede confirmação

Coloca ou troca as imagens e o vídeo de um produto, na ordem que você quiser.

“Coloca estas 3 imagens no produto 1050, nesta ordem”

definir_imagens

O que não faz
  • Não faz upload de arquivo: só links públicos (http/https).
  • Substitui as imagens externas atuais.
Mostra prévia e pede confirmação

Altera preço, descrição, NCM ou qualquer outro campo de um produto.

“Muda o preço da caneca de porcelana para 15,90”

“Coloca o NCM 6912.00.00 na caneca de porcelana”

editar_produto

O que não faz
  • Não altera nada sem prévia e confirmação (token de 15 min).
  • Não move saldo de estoque (use movimentar_estoque).
  • Ainda não mexe em variações, composição e imagens.
  • Campos fiscais (NCM, CEST, origem) elevam o risco para R2 e a prévia avisa.
Mostra prévia e pede confirmação

Exclui um produto (dá para restaurar depois).

“Exclui o produto caneca de porcelana”

“Remove o produto 1050 do cadastro”

excluir_produto

O que não faz
  • Não apaga de verdade: muda a situação para Excluído, reversível com restaurar_produto.
  • Não exclui sem prévia e confirmação.
  • Avisa se o produto aparece em pedidos em aberto.
Mostra prévia e pede confirmação

Traz de volta um produto excluído ou inativo.

“Restaura o produto caneca de porcelana”

“Reativa o produto 1050”

restaurar_produto

O que não faz
  • Não restaura sem prévia e confirmação.

Estoque 1 de consulta · 3 de alteração

Saldo por depósito e movimentações.

Só consulta

Mostra o saldo de um produto, no total e por depósito.

“Quanto tem de estoque de papel A4?”

“Saldo do código CAD-01 no depósito Loja”

consultar_estoque

O que não faz
  • Não movimenta estoque (fase F2).
Mostra prévia e pede confirmação

Devolve ao estoque os itens de um pedido.

“Devolve o estoque do pedido 1234 (lancei sem querer)”

estornar_estoque_pedido

O que não faz
  • Não confere se o pedido tinha lançado estoque (a API não informa): avisa.
Mostra prévia e pede confirmação

Dá baixa no estoque dos itens de um pedido.

“Baixa o estoque do pedido 1234”

lancar_estoque_pedido

O que não faz
  • Não estorna estoque (endpoint não confirmado).
  • Não confere baixa dupla se a conta não tiver PEDIDO_SITUACAO_BAIXA_ESTOQUE configurada: avisa.
Mostra prévia e pede confirmação

Lança entrada, saída ou balanço de estoque, com o saldo antes e depois.

“Dá entrada de 10 unidades da caneca de porcelana”

“Baixa 2 da caneca de porcelana, motivo avaria”

movimentar_estoque

O que não faz
  • Não altera nada sem prévia e confirmação.
  • Não transfere entre depósitos (faça saída em um e entrada no outro).
  • Não altera estoque mínimo/máximo (use editar_produto).
  • Avisa quando o saldo vai ficar negativo, mas o Bling permite.

Clientes e fornecedores 3 de consulta · 4 de alteração

Cadastro de contatos.

Só consulta

Encontra clientes e fornecedores pelo nome, CPF/CNPJ ou telefone.

“Busca o cliente João Silva”

“Quem é o CNPJ 12.345.678/0001-95?”

buscar_contatos

O que não faz
  • Não cria nem edita contatos (fase F2).
Só consulta

Mostra o cadastro completo de um contato: documentos, endereços, telefones.

“Cadastro completo da Construtora Horizonte”

“Qual o endereço de entrega do cliente 2001?”

detalhar_contato

O que não faz
  • Não mostra o histórico de pedidos; use listar_pedidos_venda com `cliente`.
Só consulta

Lista todos os campos de contato que dá para preencher ou alterar.

“Quais campos do contato posso alterar?”

listar_campos_contato

O que não faz
  • Não altera nada.
Mostra prévia e pede confirmação

Altera dados de um cliente ou fornecedor.

“Muda o e-mail da Construtora Horizonte para financeiro@horizonte.com.br”

“Atualiza o endereço do cliente 2001 para Rua A, 10, Centro, Contagem, MG”

atualizar_contato

O que não faz
  • Não altera sem prévia e confirmação.
  • Não troca o documento (CPF/CNPJ) de um cadastro.
  • Preserva todos os campos não informados.
Mostra prévia e pede confirmação

Cadastra um cliente ou fornecedor.

“Cadastra o cliente João da Silva, CPF 123.456.789-09, celular (11) 91234-5678”

“Cria o fornecedor Distribuidora Exemplo Ltda, CNPJ 11.222.333/0001-81, tipo Fornecedor”

criar_contato

O que não faz
  • Não cria sem prévia e confirmação.
  • Bloqueia CPF/CNPJ inválido ou já cadastrado (aponta o cadastro existente).
  • Não cadastra pessoas de contato da empresa (ainda).
Mostra prévia e pede confirmação

Exclui um contato (dá para restaurar depois).

“Exclui o contato Cliente Teste”

excluir_contato

O que não faz
  • Não apaga de verdade: muda a situação para Excluído, reversível com restaurar_contato.
  • Avisa se o contato tem pedidos nos últimos 30 dias.
Mostra prévia e pede confirmação

Traz de volta um contato excluído ou inativo.

“Restaura o contato Cliente Teste”

restaurar_contato

O que não faz
  • Não restaura sem prévia e confirmação.

Pedidos de venda 3 de consulta · 4 de alteração

Do rascunho ao pedido gravado.

Só consulta

Mostra um pedido completo: itens, frete, desconto, parcelas e situação.

“Me mostra o pedido 2310”

“Quais itens tem o pedido 2305?”

detalhar_pedido_venda

O que não faz
  • Não mostra a nota fiscal do pedido; use detalhar_nfe com o id_nota_fiscal.
Só consulta

Lista pedidos por período, cliente ou situação, com os totais.

“Quais os últimos 10 pedidos?”

“Pedidos em aberto de setembro”

listar_pedidos_venda

O que não faz
  • Não filtra por vendedor, loja ou forma de pagamento (ainda).
  • Período máximo de 1 ano por consulta.
  • Primeira consulta de um período novo com `produto` é lenta uma vez (baixa os detalhes).
Só consulta

Monta o rascunho de um pedido a partir do que você disse ou de uma conversa colada.

“Monta um pedido para a Construtora Horizonte: 2 cadeiras de escritório a 389,90 e 1 mesa de reunião, Pix”

“(colando a conversa do WhatsApp) Transforma isso num pedido de venda”

montar_pedido

O que não faz
  • Não grava nada: devolve o rascunho com totais, pendências e alertas.
  • Não inventa preço: usa o informado (mostrando a diferença para a tabela) ou o de tabela.
  • Item sem saldo é alerta, não bloqueio (o Bling permite vender sem saldo).
Mostra prévia e pede confirmação

Muda a situação de um pedido (em aberto, atendido, cancelado).

“Marca o pedido 1234 como Atendido”

“Cancela o pedido 1230”

alterar_situacao_pedido

O que não faz
  • Não cancela NF-e: se o pedido tem nota, avisa.
  • Não lança estoque por conta própria: isso depende da regra da situação na conta.
Mostra prévia e pede confirmação

Transforma uma proposta aprovada em pedido de venda.

“O cliente aprovou a proposta 57, vira pedido”

converter_proposta_em_pedido

O que não faz
  • Não muda a situação da proposta no Bling (endpoint ainda não confirmado): avisa para marcar lá.
  • Não atualiza preços: usa os da proposta.
Mostra prévia e pede confirmação

Grava no Bling o pedido montado.

“Pode criar o pedido que montamos”

“Fecha esse pedido para a Construtora Horizonte”

criar_pedido_venda

O que não faz
  • Não cria sem prévia e confirmação.
  • Não aceita rascunho com pendências: primeiro feche com montar_pedido.
  • Não escolhe a situação: usa a configurada na conta (padrão: Em aberto).
Mostra prévia e pede confirmação

Cria um pedido novo copiando um anterior, para reposição.

“Repete o pedido 1234 para a Construtora Horizonte”

“Faz a reposição igual à do mês passado (pedido 1180)”

duplicar_pedido

O que não faz
  • Não atualiza preços: copia os do pedido original e avisa.
  • Não cria sem prévia e confirmação; avisa se o original é dos últimos 7 dias.

Propostas comerciais 3 de consulta · 3 de alteração

Orçamentos: montar, gravar, editar e aprovar.

Só consulta

Mostra uma proposta completa: itens, parcelas, prazo e garantia.

“Detalhes da proposta 1042”

“O que tem na proposta 57?”

detalhar_proposta_comercial

O que não faz
  • Por número, procura só entre as 500 mais recentes; para as antigas use o id.
Só consulta

Lista propostas por período, situação ou cliente.

“Quais propostas estão em rascunho?”

“Propostas da Construtora Horizonte nos últimos 60 dias”

listar_propostas_comerciais

O que não faz
  • Não busca por número: use detalhar_proposta_comercial.
Só consulta

Monta o rascunho de uma proposta (orçamento) a partir do que você disse.

“Monta uma proposta para a Construtora Horizonte: 10 cadeiras de escritório a 389,90, Pix, entrega em 5 dias”

“Orçamento para o João: 2 monitores 24 polegadas, garantia 12 meses”

montar_proposta

O que não faz
  • Não grava nada: devolve o rascunho da proposta com totais, pendências e alertas.
  • Não verifica duplicidade (isso é de pedido).
Mostra prévia e pede confirmação

Muda a situação de uma proposta (aprovada, não aprovada, aguardando).

“Marca a proposta 1042 como Aprovado”

“A proposta 1040 não foi aprovada”

alterar_situacao_proposta

O que não faz
  • Só as 6 situações fixas do Bling: Pendente, Aguardando, Não aprovado, Aprovado, Concluído, Rascunho.
Mostra prévia e pede confirmação

Grava no Bling a proposta montada.

“Pode criar a proposta que montamos”

criar_proposta_comercial

O que não faz
  • Não cria sem prévia e confirmação.
  • Não aceita rascunho com pendências: primeiro feche com montar_proposta.
Mostra prévia e pede confirmação

Altera uma proposta existente: itens, quantidades, frete, pagamento.

“Na proposta 1042, muda a quantidade do teclado sem fio para 8”

“Troca o prazo de entrega da proposta 57 para 10 dias e tira o frete”

editar_proposta_comercial

O que não faz
  • Não grava sem prévia com o antes → depois e confirmação.
  • Não muda a situação (use alterar_situacao_proposta) nem converte em pedido.
  • Não inventa item: produto ambíguo ou não encontrado vira pendência.

Notas fiscais 5 de consulta · 4 de alteração

NF-e de saída e notas de entrada de fornecedor.

Só consulta

Diz se uma nota foi autorizada, rejeitada ou está pendente na SEFAZ.

“A nota 4512 foi autorizada?”

“Situação da NF-e com chave 3526…”

consultar_situacao_nfe

O que não faz
  • Não traz o motivo da rejeição (a API não devolve): veja na tela do Bling.
Só consulta

Mostra uma NF-e completa, com itens, impostos e links do DANFE.

“Detalha a nota 4510”

“Qual o CFOP dos itens da nota 4505?”

detalhar_nfe

O que não faz
  • Não devolve o XML (muito grande); devolve os links do DANFE e do PDF.
Só consulta

Lista notas fiscais por período, situação ou cliente.

“Notas emitidas esta semana”

“Tem alguma nota rejeitada?”

listar_nfe

O que não faz
  • Não traz o valor das notas por padrão (a API não devolve na listagem); use `com_valores`.
  • Não inclui canceladas por padrão; use `incluir_canceladas`.
Só consulta

Confere um pedido antes de gerar a nota e aponta o que falta.

“Dá para faturar o pedido 1300? O que falta?”

“Confere os dados fiscais do pedido 1234 antes de gerar a nota”

preparar_nfe_de_pedido

O que não faz
  • Não gera a nota: só confere e diz o que corrigir (cliente ou produto).
  • Não escolhe natureza fora da regra da conta sem você pedir (`natureza`).
Só consulta

Lê a nota de um fornecedor (XML, PDF ou texto) e monta o rascunho da entrada.

“(colando o XML/texto da nota do fornecedor) Lança essa nota de entrada”

“Chegou a nota 12345 da Distribuidora Exemplo: 10 caixas de papel A4 a 95”

preparar_nota_entrada

O que não faz
  • Não grava nada: devolve o rascunho com pendências (fornecedor, itens, NCM, chave).
  • Não aceita item sem produto cadastrado: pede para cadastrar (com NCM) primeiro.
Fiscal: sempre pede confirmação

Transmite a NF-e para a SEFAZ.

“Transmite a nota 4512”

“Pode emitir a NF-e do pedido 1300 que geramos”

emitir_nfe

O que não faz
  • Não transmite sem confirmação explícita, nunca (Constituição §6).
  • Não cancela depois: nota autorizada só se cancela na tela do Bling.
  • Não retransmite nota em processamento: use consultar_situacao_nfe.
Fiscal: sempre pede confirmação

Exclui uma nota que ainda não foi transmitida.

“Apaga o rascunho da nota 4512, gerei errado”

excluir_rascunho_nfe

O que não faz
  • Não cancela nota autorizada (a API não tem esse endpoint): só na tela do Bling.
Fiscal: sempre pede confirmação

Gera a NF-e de um pedido no Bling, ainda sem transmitir.

“Fatura o pedido 1300”

“Gera a nota do pedido 1234”

gerar_nfe_de_pedido

O que não faz
  • Não transmite à SEFAZ: a nota nasce Pendente; transmitir é emitir_nfe.
  • Não gera com bloqueio na pré-checagem (dados do cliente ou do produto faltando).
  • Não escolhe a natureza na nota: o Bling usa a padrão; se a regra pedir outra, avisa.
Fiscal: sempre pede confirmação

Registra no Bling a nota de entrada do fornecedor.

“Pode lançar a nota de entrada que montamos, com estoque”

lancar_nota_entrada

O que não faz
  • Não transmite à SEFAZ: nota de fornecedor é só registrada.
  • Não lança estoque sem você pedir (lancar_estoque=true).

Financeiro 0 de consulta · 1 de alteração

Contas a receber e a pagar a partir das notas.

Mostra prévia e pede confirmação

Cria no financeiro as contas das parcelas de uma nota (a receber ou a pagar).

“Lança no financeiro a parcela da nota 12345 da Distribuidora Exemplo (previsão de saída em 22/10)”

“Gera as contas a receber da NF-e 4511”

lancar_contas_nfe

O que não faz
  • Não cria conta avulsa: só as parcelas que já estão na nota.
  • Não lança duas vezes sem avisar: confere se já existe conta igual para o contato.

Administração 8 ferramentas

Só o administrador: pessoas, permissões e configurações.

Só consulta

Gera o link para conectar (ou reconectar) o Bling da empresa.

“Conectar o Bling da empresa”

“Reconectar o Bling (o acesso venceu)”

conectar_bling_empresa

O que não faz
  • Não grava nada: só devolve o link; a conexão acontece quando você autoriza no Bling.
  • Não aceita o Bling de outro CNPJ nem um Bling que já esteja em outra empresa.
Só consulta

Mostra quem tem acesso, o que cada pessoa pode fazer e o último uso.

“Quem tem acesso ao MCP?”

“O que a Ana pode fazer?”

listar_usuarios

O que não faz
  • Não mostra tokens (só o hash fica guardado).
Só consulta

Mostra as configurações da empresa: vendedor, loja e situações padrão.

“Quais são as configurações da empresa?”

“Qual vendedor entra por padrão?”

ver_configuracoes

O que não faz
  • Não mostra credenciais nem tokens.
Mostra prévia e pede confirmação

Cadastra uma pessoa com as permissões dela (ou gera um token novo).

“Cria o usuário joao com pedidos e propostas, e só leitura em produtos”

“O João perdeu o token, gera outro”

criar_usuario

O que não faz
  • Não mostra o token de novo depois da confirmação.
  • Não cria usuário no Bling: o acesso é só ao MCP.
Mostra prévia e pede confirmação

Muda uma configuração da empresa, conferida no Bling.

“O vendedor padrão passa a ser o Balcão Loja Centro”

“Não envia a NF-e por e-mail ao emitir”

definir_configuracao

O que não faz
  • Não aceita valor que não exista no Bling da empresa (vendedor, situação, natureza).
  • Não muda o Bling: só o padrão que o assistente usa.
Mostra prévia e pede confirmação

Registra o e-mail com que a pessoa entra e manda o convite.

“O e-mail da Ana é ana@empresa.com.br”

definir_email

O que não faz
  • Não envia e-mail: só registra (o convite e o login por código vêm a seguir).
Mostra prévia e pede confirmação

Muda o que uma pessoa pode consultar e alterar.

“Tira o financeiro da Ana”

“Dá admin para o Bruno”

definir_permissoes

O que não faz
  • Não deixa a conta sem nenhum administrador.
Mostra prévia e pede confirmação

Tira o acesso de uma pessoa na hora.

“Tira o acesso do João, ele saiu da empresa”

revogar_usuario

O que não faz
  • Não revoga o próprio acesso nem o último administrador.
  • Não mexe no usuário do Bling (só no acesso ao MCP).

Sempre disponível 6 ferramentas

Para qualquer pessoa conectada.

Só consulta

Atualiza a lista de produtos e contatos usada nas buscas por nome.

“Acabei de cadastrar um produto e ele não aparece”

“Atualiza o índice”

atualizar_indice

O que não faz
  • Não é necessária no dia a dia: o índice se atualiza sozinho a cada 10 min.
Só consulta

Descarta uma alteração que você não quer mais.

“Não, cancela”

“Deixa pra lá”

cancelar_operacao

O que não faz
  • Não desfaz operações já executadas.
Só consulta

Lista as alterações que estão esperando a sua confirmação.

“Tem alguma operação esperando minha confirmação?”

listar_operacoes_pendentes

O que não faz
  • Não mostra o histórico executado (fica no audit).
Só consulta

Anota qual opção você escolheu quando a busca achou mais de uma.

“(o assistente chama sozinho quando você escolhe entre candidatos)”

registrar_escolha

O que não faz
  • Não altera o Bling; grava só no registro local que calibra o sistema.
Só consulta

Mostra se o Bling está conectado, quem é você e em qual empresa.

“A integração com o Bling está funcionando?”

“Qual a validade do token?”

status_integracao

O que não faz
  • Não renova a autorização; para isso use `blingmcp auth` no terminal.
Depois da sua confirmação

Grava no Bling a alteração que você aprovou na prévia.

“(o assistente chama quando você diz "sim" para uma prévia)”

confirmar_operacao

O que não faz
  • Não executa nada que não tenha passado por prévia; o token vale 15 min e uma vez só.
  • Não recalcula: envia ao Bling exatamente o que a prévia mostrou.

O nome técnico (em letras de máquina) é o que aparece quando o assistente usa a ferramenta. A lista é gerada direto do servidor, então está sempre atualizada.