• Versão em JS/TS
• Versão em C# (em breve)

Bling ERP API - PHP

Pacote de integração com a API v3 do ERP Bling para PHP 8.2+. O mais completo existente.

Atualizado com a versão v310 da API (veja o registro de alterações).

Instalação

Para instalar, execute o comando:

composer require alebatistella/bling-erp-api

Criação de uma nova conexão

Para criar uma conexão ao serviço do Bling, basta instanciar o objeto com a API key em seu construtor.

use AleBatistella\BlingErpApi\Bling;

$apiKey = "sua_api_key";
$blingConnection = new Bling($apiKey);

Vale destacar que o fluxo de criação e autorização do aplicativo não é feito pela biblioteca. Ou seja, a biblioteca somente recebe o access_token gerado a partir do endpoint /token. Veja a referência.

Para entender na prática como a autenticação citada acima funciona, veja o projeto de demonstração.

Entidades disponíveis

Todas as entidades do Bling atualmente são permitidas para interação. São elas:

• [x] Borderos (->borderos)
• [x] Campos customizados (->camposCustomizados)
• [x] Canais de Venda (->canaisDeVenda)
• [x] Categorias - Lojas (->categoriasLojas)
• [x] Categorias - Produtos (->categoriasProdutos)
• [x] Categorias - Receitas e Despesas (->categoriasReceitasDespesas)
• [x] Contas a Pagar (->contasPagar)
• [x] Contas a Receber (->contasReceber)
• [x] Contas Contábeis (->contasContabeis)
• [x] Contatos (->contatos)
• [x] Contatos - Tipos (->contatosTipos)
• [x] Contratos (->contratos)
• [x] Depósitos (->depositos)
• [x] Empresas (->empresas)
• [x] Estoques (->estoques)
• [x] Formas de pagamento (->formasDePagamento)
• [x] Grupos de produtos (->gruposDeProdutos)
• [x] Homologação (->homologacao)
• [x] Logísticas (->logisticas)
• [x] Logísticas - Etiquetas (->logisticasEtiquetas)
• [x] Logísticas - Objetos (->logisticasObjetos)
• [x] Logísticas - Remessas (->logisticasRemessas)
• [x] Logísticas - Serviços (->logisticasServicos)
• [x] Naturezas de Operações (->naturezasDeOperacoes)
• [x] Notas Fiscais de Consumidor Eletrônicas (->nfces)
• [x] Notas Fiscais de Serviço Eletrônicas (->nfses)
• [x] Notas Fiscais Eletrônicas (->nfes)
• [x] Notificações (->notificacoes)
• [x] Ordens de produção (->ordensDeProducao)
• [x] Pedidos - Compras (->pedidosCompras)
• [x] Pedidos - Vendas (->pedidosVendas)
• [x] Produtos (->produtos)
• [x] Produtos - Estruturas (->produtosEstruturas)
• [x] Produtos - Fornecedores (->produtosFornecedores)
• [x] Produtos - Lojas (->produtosLojas)
• [x] Produtos - Variações (->produtosVariacoes)
• [x] Propostas comerciais (->propostasComerciais)
• [x] Situações (->situacoes)
• [x] Situações - Módulos (->situacoesModulos)
• [x] Situações - Transições (->situacoesTransicoes)
• [x] Usuários (->usuarios)
• [x] Vendedores (->vendedores)

Exemplo de uso

Para listar seus produtos, basta executar:

use AleBatistella\BlingErpApi\Bling;

$apiKey = "sua_api_key";
$blingConnection = new Bling($apiKey);

$products = $blingConnection->produtos->get();

var_dump($products);

Executando os testes do projeto

Faça o clone do projeto, instale as dependências e execute:

vendor/phpunit/phpunit/phpunit -c phpunit.xml

Contribuindo ao projeto

• Guia de contribuição
• Apoie o projeto