AlexandreBellas / bling-erp-api-php

Módulo de integração com a API do Bling ERP em PHP.
MIT License
7 stars 3 forks source link
api bling bling-erp csharp erp integration javascript js nfe php sefaz ts typescript

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 v308 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:

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