{"id":23661073,"url":"https://github.com/alexandrebellas/bling-erp-api-php","last_synced_at":"2026-02-25T21:32:28.835Z","repository":{"id":218403123,"uuid":"746316045","full_name":"AlexandreBellas/bling-erp-api-php","owner":"AlexandreBellas","description":"Módulo de integração com a API do Bling ERP em PHP.","archived":false,"fork":false,"pushed_at":"2024-10-05T00:34:18.000Z","size":473,"stargazers_count":10,"open_issues_count":2,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-24T18:35:00.626Z","etag":null,"topics":["api","bling","bling-erp","csharp","erp","integration","javascript","js","nfe","php","sefaz","ts","typescript"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlexandreBellas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["AlexandreBellas"],"ko_fi":"alebatistella","custom":["https://www.paypal.com/donate/?hosted_button_id=G2NJKZ5MUMKBS"]}},"created_at":"2024-01-21T17:49:55.000Z","updated_at":"2024-11-15T05:15:54.000Z","dependencies_parsed_at":"2024-02-20T23:27:07.395Z","dependency_job_id":"d41cb38a-72e4-4e94-95a1-c7d2d15ac158","html_url":"https://github.com/AlexandreBellas/bling-erp-api-php","commit_stats":null,"previous_names":["alexandrebellas/bling-erp-api-php"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexandreBellas","download_url":"https://codeload.github.com/AlexandreBellas/bling-erp-api-php/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231701624,"owners_count":18413419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","bling","bling-erp","csharp","erp","integration","javascript","js","nfe","php","sefaz","ts","typescript"],"created_at":"2024-12-29T04:40:32.937Z","updated_at":"2026-02-25T21:32:28.806Z","avatar_url":"https://github.com/AlexandreBellas.png","language":"PHP","funding_links":["https://github.com/sponsors/AlexandreBellas","https://ko-fi.com/alebatistella","https://www.paypal.com/donate/?hosted_button_id=G2NJKZ5MUMKBS"],"categories":[],"sub_categories":[],"readme":"- [Versão em JS/TS](https://github.com/AlexandreBellas/bling-erp-api-js)\n- Versão em C# (em breve)\n\n# Bling ERP API - PHP\n\nPacote de integração com a [API v3 do ERP Bling](https://developer.bling.com.br)\npara PHP 8.2+. O mais completo existente.\n\nAtualizado com a versão `v310` da API ([veja o registro de alterações](https://developer.bling.com.br/changelogs#2024-10-02)).\n\n## Instalação\n\nPara instalar, execute o comando:\n\n```bash\ncomposer require alebatistella/bling-erp-api\n```\n\n## Criação de uma nova conexão\n\nPara criar uma conexão ao serviço do Bling, basta instanciar o objeto com a [API key](https://developer.bling.com.br/autenticacao) em seu construtor.\n\n```php\nuse AleBatistella\\BlingErpApi\\Bling;\n\n$apiKey = \"sua_api_key\";\n$blingConnection = new Bling($apiKey);\n```\n\nVale destacar que o fluxo de criação e autorização do aplicativo **não é feito\npela biblioteca**. Ou seja, a biblioteca somente recebe o `access_token` gerado\na partir do _endpoint_ `/token`. [Veja a referência](https://developer.bling.com.br/aplicativos#tokens-de-acesso).\n\nPara entender na prática como a autenticação citada acima funciona, [veja o\nprojeto de demonstração](https://github.com/AlexandreBellas/bling-erp-api-php/tree/v1.13.1/demo).\n\n## Entidades disponíveis\n\nTodas as entidades do Bling atualmente são permitidas para interação. São elas:\n\n- [x] Borderos (`-\u003eborderos`)\n- [x] Campos customizados (`-\u003ecamposCustomizados`)\n- [x] Canais de Venda (`-\u003ecanaisDeVenda`)\n- [x] Categorias - Lojas (`-\u003ecategoriasLojas`)\n- [x] Categorias - Produtos (`-\u003ecategoriasProdutos`)\n- [x] Categorias - Receitas e Despesas (`-\u003ecategoriasReceitasDespesas`)\n- [x] Contas a Pagar (`-\u003econtasPagar`)\n- [x] Contas a Receber (`-\u003econtasReceber`)\n- [x] Contas Contábeis (`-\u003econtasContabeis`)\n- [x] Contatos (`-\u003econtatos`)\n- [x] Contatos - Tipos (`-\u003econtatosTipos`)\n- [x] Contratos (`-\u003econtratos`)\n- [x] Depósitos (`-\u003edepositos`)\n- [x] Empresas (`-\u003eempresas`)\n- [x] Estoques (`-\u003eestoques`)\n- [x] Formas de pagamento (`-\u003eformasDePagamento`)\n- [x] Grupos de produtos (`-\u003egruposDeProdutos`)\n- [x] Homologação (`-\u003ehomologacao`)\n- [x] Logísticas (`-\u003elogisticas`)\n- [x] Logísticas - Etiquetas (`-\u003elogisticasEtiquetas`)\n- [x] Logísticas - Objetos (`-\u003elogisticasObjetos`)\n- [x] Logísticas - Remessas (`-\u003elogisticasRemessas`)\n- [x] Logísticas - Serviços (`-\u003elogisticasServicos`)\n- [x] Naturezas de Operações (`-\u003enaturezasDeOperacoes`)\n- [x] Notas Fiscais de Consumidor Eletrônicas (`-\u003enfces`)\n- [x] Notas Fiscais de Serviço Eletrônicas (`-\u003enfses`)\n- [x] Notas Fiscais Eletrônicas (`-\u003enfes`)\n- [x] Notificações (`-\u003enotificacoes`)\n- [x] Ordens de produção (`-\u003eordensDeProducao`)\n- [x] Pedidos - Compras (`-\u003epedidosCompras`)\n- [x] Pedidos - Vendas (`-\u003epedidosVendas`)\n- [x] Produtos (`-\u003eprodutos`)\n- [x] Produtos - Estruturas (`-\u003eprodutosEstruturas`)\n- [x] Produtos - Fornecedores (`-\u003eprodutosFornecedores`)\n- [x] Produtos - Lojas (`-\u003eprodutosLojas`)\n- [x] Produtos - Variações (`-\u003eprodutosVariacoes`)\n- [x] Propostas comerciais (`-\u003epropostasComerciais`)\n- [x] Situações (`-\u003esituacoes`)\n- [x] Situações - Módulos (`-\u003esituacoesModulos`)\n- [x] Situações - Transições (`-\u003esituacoesTransicoes`)\n- [x] Usuários (`-\u003eusuarios`)\n- [x] Vendedores (`-\u003evendedores`)\n\n## Exemplo de uso\n\nPara listar seus produtos, basta executar:\n\n```php\nuse AleBatistella\\BlingErpApi\\Bling;\n\n$apiKey = \"sua_api_key\";\n$blingConnection = new Bling($apiKey);\n\n$products = $blingConnection-\u003eprodutos-\u003eget();\n\nvar_dump($products);\n```\n\n## Executando os testes do projeto\n\nFaça o clone do projeto, instale as dependências e execute:\n\n```bash\nvendor/phpunit/phpunit/phpunit -c phpunit.xml\n```\n\n## Contribuindo ao projeto\n\n- [Guia de contribuição](https://github.com/AlexandreBellas/bling-erp-api-php/blob/v1.13.1/CONTRIBUTING.md)\n- [Apoie o projeto](https://www.paypal.com/donate/?hosted_button_id=G2NJKZ5MUMKBS)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexandrebellas%2Fbling-erp-api-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexandrebellas%2Fbling-erp-api-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexandrebellas%2Fbling-erp-api-php/lists"}