- Versão em JS/TS
- Versão em C# (em breve)
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 v310 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:
- Borderos (
->borderos) - Campos customizados (
->camposCustomizados) - Canais de Venda (
->canaisDeVenda) - Categorias - Lojas (
->categoriasLojas) - Categorias - Produtos (
->categoriasProdutos) - Categorias - Receitas e Despesas (
->categoriasReceitasDespesas) - Contas a Pagar (
->contasPagar) - Contas a Receber (
->contasReceber) - Contas Contábeis (
->contasContabeis) - Contatos (
->contatos) - Contatos - Tipos (
->contatosTipos) - Contratos (
->contratos) - Depósitos (
->depositos) - Empresas (
->empresas) - Estoques (
->estoques) - Formas de pagamento (
->formasDePagamento) - Grupos de produtos (
->gruposDeProdutos) - Homologação (
->homologacao) - Logísticas (
->logisticas) - Logísticas - Etiquetas (
->logisticasEtiquetas) - Logísticas - Objetos (
->logisticasObjetos) - Logísticas - Remessas (
->logisticasRemessas) - Logísticas - Serviços (
->logisticasServicos) - Naturezas de Operações (
->naturezasDeOperacoes) - Notas Fiscais de Consumidor Eletrônicas (
->nfces) - Notas Fiscais de Serviço Eletrônicas (
->nfses) - Notas Fiscais Eletrônicas (
->nfes) - Notificações (
->notificacoes) - Ordens de produção (
->ordensDeProducao) - Pedidos - Compras (
->pedidosCompras) - Pedidos - Vendas (
->pedidosVendas) - Produtos (
->produtos) - Produtos - Estruturas (
->produtosEstruturas) - Produtos - Fornecedores (
->produtosFornecedores) - Produtos - Lojas (
->produtosLojas) - Produtos - Variações (
->produtosVariacoes) - Propostas comerciais (
->propostasComerciais) - Situações (
->situacoes) - Situações - Módulos (
->situacoesModulos) - Situações - Transições (
->situacoesTransicoes) - Usuários (
->usuarios) - Vendedores (
->vendedores)
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