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

ActiveLibrary[API Development](/categories/api)

prhost/bling-v3-sdk
===================

SDK PHP de integração com o Bling v3

192.8k↑150%8PHP

Since Jan 30Pushed 2mo ago4 watchersCompare

[ Source](https://github.com/prhost/bling-v3-sdk)[ Packagist](https://packagist.org/packages/prhost/bling-v3-sdk)[ RSS](/packages/prhost-bling-v3-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

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

[](#bling-v3-sdk)

[![Total Downloads](https://camo.githubusercontent.com/b20cb2580df35dc056c0fe08c000c06106cf4a50a51b14f46bc5a38545192cf1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7072686f73742f626c696e672d76332d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/prhost/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 prhost/bling-v3-sdk
```

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

[](#autenticação)

### Solicitar autorização

[](#solicitar-autorização)

```
use Prhost\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)

Licença
-------

[](#licença)

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

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance56

Moderate activity, may be stable

Popularity32

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity22

Early-stage or recently created project

 Bus Factor1

Top contributor holds 53.3% 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3984760?v=4)[Kallef Alexandre](/maintainers/prhost)[@prhost](https://github.com/prhost)

---

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 (7 commits)")

---

Tags

blingphpsdkv3

### Embed Badge

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

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

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M478](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M271](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

263103.1M454](/packages/google-gax)

PHPackages © 2026

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