Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prhost/bling-v3-sdk
SDK do Bling ERP v3
https://github.com/prhost/bling-v3-sdk
bling php sdk v3
Last synced: about 2 months ago
JSON representation
SDK do Bling ERP v3
- Host: GitHub
- URL: https://github.com/prhost/bling-v3-sdk
- Owner: prhost
- License: mit
- Created: 2023-12-28T03:51:41.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-23T14:55:34.000Z (3 months ago)
- Last Synced: 2024-10-06T08:38:23.685Z (3 months ago)
- Topics: bling, php, sdk, v3
- Language: PHP
- Homepage:
- Size: 125 KB
- Stars: 11
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [Working in progress] Bling v3 SDK
[](https://packagist.org/packages/prhost/bling-v3-sdk)
[](https://packagist.org/packages/prhost/bling-v3-sdk)
---
Integração com a API do Bling ERP v3
## Instalação
Você pode instalar o pacote via composer:
```bash
composer require prhost/bling-v3-sdk
```
## Autenticação
### Solicitar autorização
```php
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
```php
$retorno = $bling->requestToken($_GET["code"]);
```
### Dados do `$retorno`
```php
[
"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
```php
// Solicita a atualizacao
$retorno = $bling->refreshToken($refreshToken);
```
### Definindo o token de acesso
```php
// A partir daqui, informe o token toda vez que for utilizar a API
$bling->setAccessToken("Access Token");
```
## Produtos
### Listar produtos
```php
//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
```php
//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
```php
//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
```php
//Deletando um produto
$this->bling
->produtos()
->deleteById($id);
```
### Buscando um produto
```php
//Buscando um produto
$this->bling
->produtos()
->getById($id);
```
## Testando
Para rodar os testes, baixe as dependências de desenvolvimento e execute:
```bash
php vendor/bin/codecept run
```
## Lista de rotas
- [X] - Categorias - Produtos
- [X] - Contatos
- [X] - Contatos - Tipos
- [X] - Depositos
- [X] - Formas de Pagamentos
- [X] - Estoques
- [X] - Notas Fiscais de Consumidor Eletrônicas
- [X] - Pedidos - Vendas
- [X] - Situações
- [X] - Situações Módulos
- [X] - Produtos
## Créditos
- [Kallef Alexandre](https://github.com/prhost)
## Licença
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.