{"id":20408499,"url":"https://github.com/prhost/bling-v3-sdk","last_synced_at":"2025-04-12T15:32:45.913Z","repository":{"id":214422804,"uuid":"736490798","full_name":"prhost/bling-v3-sdk","owner":"prhost","description":"SDK do Bling ERP v3","archived":false,"fork":false,"pushed_at":"2024-12-04T14:41:41.000Z","size":131,"stargazers_count":13,"open_issues_count":0,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-26T10:04:10.447Z","etag":null,"topics":["bling","php","sdk","v3"],"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/prhost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2023-12-28T03:51:41.000Z","updated_at":"2024-12-04T14:44:15.000Z","dependencies_parsed_at":"2024-05-14T02:51:56.348Z","dependency_job_id":null,"html_url":"https://github.com/prhost/bling-v3-sdk","commit_stats":null,"previous_names":["prhost/bling-v3-sdk"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prhost%2Fbling-v3-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prhost%2Fbling-v3-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prhost%2Fbling-v3-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prhost%2Fbling-v3-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prhost","download_url":"https://codeload.github.com/prhost/bling-v3-sdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248589854,"owners_count":21129690,"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":["bling","php","sdk","v3"],"created_at":"2024-11-15T05:32:48.654Z","updated_at":"2025-04-12T15:32:45.905Z","avatar_url":"https://github.com/prhost.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bling v3 SDK\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/prhost/bling-v3-sdk.svg?style=flat-square)](https://packagist.org/packages/prhost/bling-v3-sdk)\n[![Total Downloads](https://img.shields.io/packagist/dt/prhost/bling-v3-sdk.svg?style=flat-square)](https://packagist.org/packages/prhost/bling-v3-sdk)\n\n---\nIntegração com a API do Bling ERP v3\n\n## Instalação\n\nVocê pode instalar o pacote via composer:\n\n```bash\ncomposer require prhost/bling-v3-sdk\n```\n\n## Autenticação\n\n### Solicitar autorização\n\n```php\n\nuse Prhost\\Bling\\Bling;\n\n// Instancia o objeto\n$bling = new Bling(\n    \"CLIENT ID\",\n    \"SECRET KEY\",\n);\n\n// Adiciona a url de callback caso seja diferente da cadastrada no Bling\n$bling-\u003esetCallbackURL(\"URL PARA RETORNO\");\n\n// Solicita a autenticação\n// O usuário será redirecionado para uma página de autenticação do Bling\n$bling-\u003erequestAuthorization();\n```\n\n### Obter token de acesso\n\n```php\n$retorno = $bling-\u003erequestToken($_GET[\"code\"]);\n```\n\n### Dados do `$retorno`\n\n```php\n[\n    \"access_token\" =\u003e \"TOKEN PARA REQUISIÇÕES\",\n    \"refresh_token\" =\u003e \"TOKEN PARA RENOVAÇÂO DO accessToken\",\n    \"token_validate\" =\u003e \"Data de validade do token em segundos\"\n]\n```\n\n### Renovar token de acesso\n\n```php\n// Solicita a atualizacao\n$retorno = $bling-\u003erefreshToken($refreshToken);\n```\n\n### Definindo o token de acesso\n\n```php\n// A partir daqui, informe o token toda vez que for utilizar a API\n$bling-\u003esetAccessToken(\"Access Token\");\n```\n\n## Produtos\n\n### Listar produtos\n\n```php\n//Retorna um array com todos os produtos\n$bling-\u003eprodutos()-\u003eget();\n\n//Retorna um array com todos os produtos na pagina 2 com 10 itens por pagina\n$bling-\u003eprodutos()-\u003eget(2, 10);\n```\n\n### Criando um produto\n\n```php\n//Criando um produto simples\n$response = $this-\u003ebling\n    -\u003eprodutos()\n    -\u003ecreate([\n        'nome'     =\u003e 'Bolacha recheada (e não biscoito)',\n        'codigo'   =\u003e '123456789',\n        'tipo'     =\u003e 'P', //P - Produto\n        'situacao' =\u003e 'A', //A - Ativo\n        'formato'  =\u003e 'S', //S - Simples\n    ]);\n```\n\n### Atualizando um produto\n\n```php\n//Atualizando um produto simples\n$response = $this-\u003ebling\n    -\u003eprodutos()\n    -\u003eupdate($id, [\n        'nome'     =\u003e 'Agora sim biscoito recheado',\n        'codigo'   =\u003e '123456789',\n        'tipo'     =\u003e 'P', //P - Produto\n        'situacao' =\u003e 'A', //A - Ativo\n        'formato'  =\u003e 'S', //S - Simples\n    ]);\n```\n\n### Deletando um produto\n\n```php\n//Deletando um produto\n$this-\u003ebling\n    -\u003eprodutos()\n    -\u003edeleteById($id);\n```\n\n### Buscando um produto\n\n```php\n//Buscando um produto\n$this-\u003ebling\n    -\u003eprodutos()\n    -\u003egetById($id);\n```\n\n## Testando\n\nPara rodar os testes, baixe as dependências de desenvolvimento e execute:\n```bash\nphp vendor/bin/codecept run\n```\n\n## Lista de rotas\n\n- [X] - Categorias - Produtos\n- [X] - Contatos\n- [X] - Contatos - Tipos\n- [X] - Depositos\n- [X] - Formas de Pagamentos\n- [X] - Estoques\n- [X] - Notas Fiscais de Consumidor Eletrônicas\n- [X] - Pedidos - Vendas\n- [X] - Situações\n- [X] - Situações Módulos\n- [X] - Produtos\n\n## Créditos\n\n- [Kallef Alexandre](https://github.com/prhost)\n\n## Licença\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprhost%2Fbling-v3-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprhost%2Fbling-v3-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprhost%2Fbling-v3-sdk/lists"}