{"id":23916741,"url":"https://github.com/alexandrebellas/bling-erp-api-js","last_synced_at":"2025-04-09T08:08:16.601Z","repository":{"id":46282924,"uuid":"415613302","full_name":"AlexandreBellas/bling-erp-api-js","owner":"AlexandreBellas","description":"Módulo de integração com a API do Bling ERP em Javascript/Typescript.","archived":false,"fork":false,"pushed_at":"2024-10-05T00:19:19.000Z","size":668,"stargazers_count":31,"open_issues_count":2,"forks_count":13,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-02-07T21:45:48.815Z","etag":null,"topics":["api","bling","bling-erp","csharp","erp","integration","javascript","js","nfe","php","sefaz","ts","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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":"2021-10-10T14:44:26.000Z","updated_at":"2025-02-06T17:18:02.000Z","dependencies_parsed_at":"2024-01-08T02:31:08.309Z","dependency_job_id":"3ae8e51d-3608-4495-8ac6-2f7e236bb86f","html_url":"https://github.com/AlexandreBellas/bling-erp-api-js","commit_stats":{"total_commits":159,"total_committers":3,"mean_commits":53.0,"dds":0.05031446540880502,"last_synced_commit":"e21174d5d3fdfb29dd07bf6b9825f8bc5185bdba"},"previous_names":["alexandrebellas/bling-erp-api-js","alexandrebellas/bling-erp-api"],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreBellas%2Fbling-erp-api-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexandreBellas","download_url":"https://codeload.github.com/AlexandreBellas/bling-erp-api-js/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247999859,"owners_count":21031046,"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":"2025-01-05T12:13:51.536Z","updated_at":"2025-04-09T08:08:16.569Z","avatar_url":"https://github.com/AlexandreBellas.png","language":"TypeScript","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 PHP](https://github.com/AlexandreBellas/bling-erp-api-php)\n- Versão em C# (em breve)\n\n# Bling ERP API - Javascript/Typescript\n\n[![](https://img.shields.io/npm/v/bling-erp-api.svg)](https://www.npmjs.com/package/bling-erp-api)\n[![install size](https://packagephobia.com/badge?p=bling-erp-api)](https://packagephobia.com/result?p=bling-erp-api)\n[![code coverage](https://coveralls.io/repos/github/AlexandreBellas/bling-erp-api-js/badge.svg?branch=main)](https://coveralls.io/github/AlexandreBellas/bling-erp-api?branch=main)\n\nPacote de integração com a [API v3 do ERP Bling](https://developer.bling.com.br)\npara Javascript/TypeScript. 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**Atenção**: a versão 5.0.0+ do `bling-erp-api` para Javascript/TypeScript\nutiliza a API v3 do Bling. Caso deseja utilizar a API v2 do Bling,\n[utilize a versão 4.0.0](https://github.com/AlexandreBellas/bling-erp-api-js/tree/v4.0.0).\n\n## Instalação\n\nPara instalar, execute o comando:\n\n```bash\nnpm i 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```js\nimport Bling from 'bling-erp-api'\n\nconst apiKey = 'sua_api_key'\nconst 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-js/tree/main/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 (`.borderos`)\n- [x] Campos customizados (`.camposCustomizados`)\n- [x] Canais de Venda (`.canaisDeVenda`)\n- [x] Categorias - Lojas (`.categoriasLojas`)\n- [x] Categorias - Produtos (`.categoriasProdutos`)\n- [x] Categorias - Receitas e Despesas (`.categoriasReceitasDespesas`)\n- [x] Contas a Pagar (`.contasPagar`)\n- [x] Contas a Receber (`.contasReceber`)\n- [x] Contas Contábeis (`.contasContabeis`)\n- [x] Contatos (`.contatos`)\n- [x] Contatos - Tipos (`.contatosTipos`)\n- [x] Contratos (`.contratos`)\n- [x] Depósitos (`.depositos`)\n- [x] Empresas (`.empresas`)\n- [x] Estoques (`.estoques`)\n- [x] Formas de Pagamento (`.formasDePagamento`)\n- [x] Grupos de Produtos (`.gruposDeProdutos`)\n- [x] Homologação (`.homologacao`)\n- [x] Logísticas (`.logisticas`)\n- [x] Logísticas - Etiquetas (`.logisticasEtiquetas`)\n- [x] Logísticas - Objetos (`.logisticasObjetos`)\n- [x] Logísticas - Remessas (`.logisticasRemessas`)\n- [x] Logísticas - Serviços (`.logisticasServicos`)\n- [x] Naturezas de Operações (`.naturezasDeOperacoes`)\n- [x] Notas Fiscais de Consumidor Eletrônicas (`.nfces`)\n- [x] Notas Fiscais de Serviço Eletrônicas (`.nfses`)\n- [x] Notas Fiscais Eletrônicas (`.nfes`)\n- [x] Notificações (`.notificacoes`)\n- [x] Ordens de Produção (`.ordensDeProducao`)\n- [x] Pedidos - Compras (`.pedidosCompras`)\n- [x] Pedidos - Vendas (`.pedidosVendas`)\n- [x] Produtos (`.produtos`)\n- [x] Produtos - Estruturas (`.produtosEstruturas`)\n- [x] Produtos - Fornecedores (`.produtosFornecedores`)\n- [x] Produtos - Lojas (`.produtosLojas`)\n- [x] Produtos - Variações (`.produtosVariacoes`)\n- [x] Propostas Comerciais (`.propostasComerciais`)\n- [x] Situações (`.situacoes`)\n- [x] Situações - Módulos (`.situacoesModulos`)\n- [x] Situações - Transições (`.situacoesTransicoes`)\n- [x] Usuários (`.usuarios`)\n- [x] Vendedores (`.vendedores`)\n\n## Exemplo de uso\n\nPara listar seus produtos, basta executar:\n\n```js\nimport Bling from 'bling-erp-api'\n\nconst apiKey = 'sua_api_key'\nconst blingConnection = new Bling(apiKey)\n\nconst products = await blingConnection.produtos.get()\n\nconsole.log(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\nnpm run test\n```\n\n## Contribuindo ao projeto\n\n- [Guia de contribuição](https://github.com/AlexandreBellas/bling-erp-api-js/blob/v5.0.0/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-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexandrebellas%2Fbling-erp-api-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexandrebellas%2Fbling-erp-api-js/lists"}