Alpha ERP

O que ele faz

• As mesmas ferramentas para todos os ERPs: SKU, preço, custo e saldo têm os mesmos nomes em qualquer empresa.
• Saldo disponível de verdade: soma só os depósitos que o ERP manda considerar.
• A API completa do ERP (erp_api) para o que não tem ferramenta própria.
• Várias empresas na mesma conversa, com o isolamento entre elas.
• Trabalha junto com o Alpha Commerce, pelo SKU: veja a página os dois juntos.

Próximos ERPs

Outros ERPs entram como um adaptador, sem mudar as ferramentas. Omie, Olist, eGestor estão no roadmap do Alpha ERP, sem data fechada: ainda não funcionam.

Credenciais do Bling

O Alpha ERP não pede a sua senha do Bling. Ele usa um aplicativo que você mesmo cria dentro do Bling, e esse aplicativo só dá ao assistente as permissões que você marcar. É feito uma vez e leva poucos minutos.

O que você precisa

• Acesso ao Bling como administrador, ou com um usuário que tenha a permissão Cadastro de aplicativos (em Preferências > Sistema > Usuários).
• O instalador aberto ao lado: ele mostra o endereço de retorno pronto para copiar e tem os campos onde você cola o que o Bling mostrar.

Passo a passo

1. No Bling, abra a Central de Extensões e clique em Área do Integrador (ou entre direto em developer.bling.com.br).
2. Clique em Criar aplicativo.
3. Preencha o cadastro com o que o Bling marcar como obrigatório (nome, categoria, descrição e os seus dados de contato). Dê um nome que você reconheça, como "Alpha ERP".
4. No campo Link de redirecionamento, cole http://localhost:8765/callback. O instalador mostra o mesmo endereço, com o botão Copiar.
5. Em Lista de escopos, clique em Adicionar, marque as permissões da tabela abaixo e confirme.
6. Salve. Na aba Informações do app aparecem o Client ID e o Client Secret (clique no ícone de olho para ver o segredo).
7. Copie os dois e cole no instalador, nos campos de mesmo nome.

O que copiar e onde colar

Permissões (escopos) a marcar

Marque as que combinam com o que você vai pedir ao assistente. Sem a permissão, o Bling responde 403, e mudar as permissões depois exige que cada empresa autorize de novo.

Conferir se deu certo

Feche e abra o assistente e peça "Conecte minha empresa do Bling". O assistente mostra um endereço de login: abra, entre no Bling com um usuário que tenha permissão nos módulos escolhidos e autorize. Com o endereço de retorno localhost, a conta conecta sozinha. Depois, o instalador mostra a empresa na tela Seus programas.

Se algo der errado

Revogar o acesso

Para encerrar o acesso de vez, remova o aplicativo na Área do Integrador do Bling.

Ferramentas

As respostas trazem um resumo com os mesmos campos para todos os ERPs. Com raw: true, a resposta inclui o registro original do ERP. Listas paginam com cursor: o assistente passa o next da resposta anterior. Quando uma empresa tem mais de uma conta, cada ferramenta recebe account.

Exemplos de pedidos

Você não precisa saber o nome das ferramentas: peça em português, e o assistente escolhe.

• "Quanto tenho em estoque do SKU CAM-001-M, por depósito?"
• "Qual o custo e o preço de venda desse produto?"
• "Liste os pedidos de venda de ontem, com o valor total."
• "Quais notas fiscais saíram esta semana?"
• "Em quais lojas o produto CAM-001-M está vinculado?"
• "Muda o preço do CAM-001-M para R$ 89,90." (o assistente mostra o preço de antes e o de depois e só altera depois do seu sim)

Mais de uma empresa

• Com mais de uma empresa, account é obrigatório em toda chamada. Sem ele, o erro lista as empresas, e erp_accounts mostra o que cada uma suporta.
• Cada empresa enxerga só os seus produtos, saldos, depósitos, pedidos e vínculos. Escrever numa não mexe na outra.
• Perder o acesso de uma empresa pede a reconexão dela e não derruba as outras. O aplicativo (Client ID e Secret) é o mesmo para todas.
• Acrescentar uma empresa depois não refaz nada. Peça "conecte outra empresa do Bling": só a nova é conectada, e as que já estavam continuam como estão. Se for a primeira empresa de um ERP novo (quando a Alcateia publicar um), você pode precisar fechar e abrir o assistente para as ferramentas dele aparecerem.

Confirmação e somente leitura

As ferramentas de escrita (erp_product_update, erp_stock_move e a erp_api fora do GET) só alteram com confirm: true. Sem ele, a resposta é o plano do que mudaria. A resposta de uma escrita traz o valor de antes e a chamada que desfaz.

No instalador, a opção Somente leitura tira as ferramentas de escrita do assistente e deixa a erp_api só com GET.

O que ele não faz

O Alpha ERP só trata das empresas do ERP que você conectou: produtos, saldos de estoque, depósitos, pedidos de venda, notas fiscais, contatos e os vínculos com as lojas. Um pedido fora disso (previsão do tempo, um texto livre, contas bancárias, uma loja ou um sistema que você não conectou) não usa nenhuma ferramenta do programa: o assistente responde com o conhecimento dele ou diz que aquilo não é com o programa.

Não há como o programa chegar ao que você não ligou a ele: as ferramentas só falam com as empresas conectadas. E um ERP que ainda não existe no programa só passa a existir quando a Alcateia publicar o conector.

Limites e comportamentos do Bling

• Taxa: 3 requisições por segundo e 120 mil por dia por empresa. O programa espaça as chamadas sozinho e repete quando o Bling pede para esperar. O Bling também bloqueia o IP por um tempo quando há excesso de erros.
• Escopo faltando responde 403. Libere o escopo no aplicativo e faça o login de novo.
• Acesso do Bling: vence se a empresa ficar mais de 30 dias sem uso. É só reconectar.
• Vínculo produto × loja: o vínculo sozinho não sincroniza. O Bling só envia estoque à loja quando o saldo se movimenta. Altere o estoque no ERP (erp_stock_move), não na loja.
• Depósitos que não entram no total: um depósito marcado para desconsiderar saldo não entra no disponível. A erp_stock já faz essa conta.
• Custo: fica no fornecedor do produto, não no cadastro principal. Para alterar, use a erp_api em /produtos/fornecedores.
• Situações de pedido têm ids próprios de cada empresa. Os nomes saem na erp_api em GET /situacoes/modulos.
• NF-e: só dá para editar antes de autorizar.
• Na busca de produtos, GTIN e unidade vêm vazios (a lista do Bling não os traz): peça por ids para o cadastro completo.
• Alterar o custo e criar vínculos com lojas ainda não têm ferramenta própria: use a erp_api.

O que já foi validado

Estado em 03/10/2026. Prefira saber o que foi e o que não foi testado: