PHPackages                             alebatistella/bling-erp-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. alebatistella/bling-erp-api

ActiveLibrary[API Development](/categories/api)

alebatistella/bling-erp-api
===========================

Pacote de integração com a API do Bling ERP

1.17.0(1y ago)1873412[3 issues](https://github.com/AlexandreBellas/bling-erp-api-php/issues)[1 PRs](https://github.com/AlexandreBellas/bling-erp-api-php/pulls)MITPHP

Since Jan 21Pushed 1y ago3 watchersCompare

[ Source](https://github.com/AlexandreBellas/bling-erp-api-php)[ Packagist](https://packagist.org/packages/alebatistella/bling-erp-api)[ Fund](https://www.paypal.com/donate/?hosted_button_id=G2NJKZ5MUMKBS)[ GitHub Sponsors](https://github.com/AlexandreBellas)[ RSS](/packages/alebatistella-bling-erp-api/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (4)Versions (21)Used By (0)

- [Versão em JS/TS](https://github.com/AlexandreBellas/bling-erp-api-js)
- Versão em C# (em breve)

Bling ERP API - PHP
===================

[](#bling-erp-api---php)

Pacote de integração com a [API v3 do ERP Bling](https://developer.bling.com.br)para PHP 8.2+. O mais completo existente.

Atualizado com a versão `v310` da API ([veja o registro de alterações](https://developer.bling.com.br/changelogs#2024-10-02)).

Instalação
----------

[](#instalação)

Para instalar, execute o comando:

```
composer require alebatistella/bling-erp-api
```

Criação de uma nova conexão
---------------------------

[](#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](https://developer.bling.com.br/autenticacao) 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](https://developer.bling.com.br/aplicativos#tokens-de-acesso).

Para entender na prática como a autenticação citada acima funciona, [veja o projeto de demonstração](https://github.com/AlexandreBellas/bling-erp-api-php/tree/v1.13.1/demo).

Entidades disponíveis
---------------------

[](#entidades-disponíveis)

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

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

Exemplo de uso
--------------

[](#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
-------------------------------

[](#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
-----------------------

[](#contribuindo-ao-projeto)

- [Guia de contribuição](https://github.com/AlexandreBellas/bling-erp-api-php/blob/v1.13.1/CONTRIBUTING.md)
- [Apoie o projeto](https://www.paypal.com/donate/?hosted_button_id=G2NJKZ5MUMKBS)

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~14 days

Total

19

Last Release

636d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/12dd69129a7c00f61b4fdd95249ca80973c28b1dcdab8688114bbf734dad960d?d=identicon)[AlexandreBellas](/maintainers/AlexandreBellas)

---

Top Contributors

[![AlexandreBellas](https://avatars.githubusercontent.com/u/22872374?v=4)](https://github.com/AlexandreBellas "AlexandreBellas (117 commits)")

---

Tags

apiblingbling-erpcsharperpintegrationjavascriptjsnfephpsefaztstypescript

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/alebatistella-bling-erp-api/health.svg)

```
[![Health](https://phpackages.com/badges/alebatistella-bling-erp-api/health.svg)](https://phpackages.com/packages/alebatistella-bling-erp-api)
```

###  Alternatives

[statamic/cms

The Statamic CMS Core Package

4.8k3.6M986](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M47](/packages/tencentcloud-tencentcloud-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k656.1k38](/packages/neuron-core-neuron-ai)[avalara/avataxclient

Client library for Avalara's AvaTax suite of business tax calculation and processing services. Uses the REST v2 API.

528.5M7](/packages/avalara-avataxclient)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)