Pacote de integração com a API v3 do ERP Bling para PHP 8.2+. O mais completo existente.
Atualizado com a versão v310
da API (veja o registro de alterações).
Para instalar, execute o comando:
composer require alebatistella/bling-erp-api
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.
Todas as entidades do Bling atualmente são permitidas para interação. São elas:
->borderos
)->camposCustomizados
)->canaisDeVenda
)->categoriasLojas
)->categoriasProdutos
)->categoriasReceitasDespesas
)->contasPagar
)->contasReceber
)->contasContabeis
)->contatos
)->contatosTipos
)->contratos
)->depositos
)->empresas
)->estoques
)->formasDePagamento
)->gruposDeProdutos
)->homologacao
)->logisticas
)->logisticasEtiquetas
)->logisticasObjetos
)->logisticasRemessas
)->logisticasServicos
)->naturezasDeOperacoes
)->nfces
)->nfses
)->nfes
)->notificacoes
)->ordensDeProducao
)->pedidosCompras
)->pedidosVendas
)->produtos
)->produtosEstruturas
)->produtosFornecedores
)->produtosLojas
)->produtosVariacoes
)->propostasComerciais
)->situacoes
)->situacoesModulos
)->situacoesTransicoes
)->usuarios
)->vendedores
)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);
Faça o clone do projeto, instale as dependências e execute:
vendor/phpunit/phpunit/phpunit -c phpunit.xml