PHPackages                             saldanhakun/bling-v3-sdk - 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. saldanhakun/bling-v3-sdk

ActiveLibrary[API Development](/categories/api)

saldanhakun/bling-v3-sdk
========================

SDK PHP de integração com o Bling v3

v1.2.1(10mo ago)010MITPHPPHP ^8.0

Since Aug 11Pushed 10mo agoCompare

[ Source](https://github.com/saldanhakun/bling-v3-sdk)[ Packagist](https://packagist.org/packages/saldanhakun/bling-v3-sdk)[ Docs](https://github.com/saldanhakun/bling-v3-sdk)[ RSS](/packages/saldanhakun-bling-v3-sdk/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (7)Versions (2)Used By (0)

Bling v3 SDK
============

[](#bling-v3-sdk)

---

Integração com a API do Bling ERP v3

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

[](#instalação)

Você pode instalar o pacote via composer:

```
composer require saldanhakun/bling-v3-sdk
```

Autenticação
------------

[](#autenticação)

### Solicitar autorização

[](#solicitar-autorização)

```
use Saldanhakun\Bling\Bling;

// Instancia o objeto
$bling = new Bling(
    "CLIENT ID",
    "SECRET KEY",
);

// Adiciona a url de callback caso seja diferente da cadastrada no Bling
$bling->setCallbackURL("URL PARA RETORNO");

// Solicita a autenticação
// O usuário será redirecionado para uma página de autenticação do Bling
$bling->requestAuthorization();
```

### Obter token de acesso

[](#obter-token-de-acesso)

```
$retorno = $bling->requestToken($_GET["code"]);
```

### Dados do `$retorno`

[](#dados-do-retorno)

```
[
    "access_token" => "TOKEN PARA REQUISIÇÕES",
    "refresh_token" => "TOKEN PARA RENOVAÇÂO DO accessToken",
    "token_validate" => "Data de validade do token em segundos"
]
```

### Renovar token de acesso

[](#renovar-token-de-acesso)

```
// Solicita a atualizacao
$retorno = $bling->refreshToken($refreshToken);
```

### Definindo o token de acesso

[](#definindo-o-token-de-acesso)

```
// A partir daqui, informe o token toda vez que for utilizar a API
$bling->setAccessToken("Access Token");
```

Produtos
--------

[](#produtos)

### Listar produtos

[](#listar-produtos)

```
//Retorna um array com todos os produtos
$bling->produtos()->get();

//Retorna um array com todos os produtos na pagina 2 com 10 itens por pagina
$bling->produtos()->get(2, 10);
```

### Criando um produto

[](#criando-um-produto)

```
//Criando um produto simples
$response = $this->bling
    ->produtos()
    ->create([
        'nome'     => 'Bolacha recheada (e não biscoito)',
        'codigo'   => '123456789',
        'tipo'     => 'P', //P - Produto
        'situacao' => 'A', //A - Ativo
        'formato'  => 'S', //S - Simples
    ]);
```

### Atualizando um produto

[](#atualizando-um-produto)

```
//Atualizando um produto simples
$response = $this->bling
    ->produtos()
    ->update($id, [
        'nome'     => 'Agora sim biscoito recheado',
        'codigo'   => '123456789',
        'tipo'     => 'P', //P - Produto
        'situacao' => 'A', //A - Ativo
        'formato'  => 'S', //S - Simples
    ]);
```

### Deletando um produto

[](#deletando-um-produto)

```
//Deletando um produto
$this->bling
    ->produtos()
    ->deleteById($id);
```

### Buscando um produto

[](#buscando-um-produto)

```
//Buscando um produto
$this->bling
    ->produtos()
    ->getById($id);
```

Testando
--------

[](#testando)

Para rodar os testes, baixe as dependências de desenvolvimento e execute:

```
php vendor/bin/codecept run
```

Lista de rotas
--------------

[](#lista-de-rotas)

- - Categorias - Produtos
- - Contatos
- - Contatos - Tipos
- - Depositos
- - Formas de Pagamentos
- - Estoques
- - Notas Fiscais de Consumidor Eletrônicas
- - Pedidos - Vendas
- - Situações
- - Situações Módulos
- - Produtos

Créditos
--------

[](#créditos)

- [Kallef Alexandre](https://github.com/prhost)
- [Marcelo Saldanha](https://www.marcelosaldanha.com.br/)

Licença
-------

[](#licença)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance53

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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

Unknown

Total

1

Last Release

327d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7916958?v=4)[Marcelo Saldanha](/maintainers/saldanhakun)[@saldanhakun](https://github.com/saldanhakun)

---

Top Contributors

[![lucasnpinheiro](https://avatars.githubusercontent.com/u/2411995?v=4)](https://github.com/lucasnpinheiro "lucasnpinheiro (8 commits)")[![prhost](https://avatars.githubusercontent.com/u/3984760?v=4)](https://github.com/prhost "prhost (6 commits)")[![saldanhakun](https://avatars.githubusercontent.com/u/7916958?v=4)](https://github.com/saldanhakun "saldanhakun (4 commits)")

---

Tags

phpapisdkv3Bling

###  Code Quality

TestsCodeception

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/saldanhakun-bling-v3-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/saldanhakun-bling-v3-sdk/health.svg)](https://phpackages.com/packages/saldanhakun-bling-v3-sdk)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k9.5M89](/packages/openai-php-laravel)[hubspot/api-client

Hubspot API client

24016.2M20](/packages/hubspot-api-client)[resend/resend-php

Resend PHP library.

617.2M43](/packages/resend-resend-php)[php-opencloud/openstack

PHP SDK for OpenStack APIs. Supports BlockStorage, Compute, Identity, Images, Networking and Metric Gnocchi

2312.4M25](/packages/php-opencloud-openstack)[checkout/checkout-sdk-php

Checkout.com SDK for PHP

563.6M13](/packages/checkout-checkout-sdk-php)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

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