lucasberto/laravel-bling-client

Um consumidor da API do Bling para Laravel

Maintainers

Details

github.com/lucasberto/laravel-bling-client

Source

Issues

Installs: 394

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

1.0.6 2023-04-13 19:53 UTC

Requires

Requires (Dev)

MIT 880a5de3b17e03190fc6353a4f3af2e560508329

  • lucasberto

This package is auto-updated.

Last update: 2025-05-29 01:27:24 UTC

README

Warning

Esse pacote foi descontinuado, pois utiliza a versão 2 da API do Bling, que foi descontinuada para dar lugar à versão 3.

Este pacote implementa a comunicação com a API do Bling ERP.

Pacote ainda em desenvolvimento. Nem todas as funcionalidades da API estão implementadas.

Requisitos

- Laravel >= 8.x

Instalação

via Packagist (composer):

composer require lucasberto/laravel-bling-client

Utilização

A Facade Lucasberto\LaravelBlingClient\Facades\BlingClient deverá ser importada automaticamente pelo Autoloader, porém, se encontrar algum problema (classe BlingClient não encontrada), você poderá importar manualmente a Facade:

use Lucasberto\LaravelBlingClient\Facades\BlingClient;

Este pacote utiliza interface fluente (Fluent API / Method Chaining) para realizar as operações.

Exemplo 1: Listar todos os produtos

BlingClient::withToken('SEU_TOKEN')->products()->fetch();

Exemplo 2: Listar todos os produtos para uma loja específica

BlingClient::withToken('SEU_TOKEN')->products()->byStore('CÓDIGO_LOJA')->fetch();

Exemplo 3: Trazer informações de um produto específico

BlingClient::withToken('SEU_TOKEN')->product('SKU_DO_PRODUTO')->fetch();

Métodos disponíveis

Método Descrição
withToken('SEU_TOKEN') Obrigatório. Especifica o token da API Bling a ser usado na requisição.
products() Lista todos os produtos. Pode ser associado a byStore() para trazer informações específicas de uma loja.
product('SKU') Traz informações de um produto específico identificado pelo número SKU do Bling. Pode ser associado a byStore().
updateLink('SKU', 'ID-INTERNO', 'ID-LOJA') Atualiza vínculo entre SKU e ID-INTERNO no Bling para a loja ID-LOJA.
updateProduct(Array dados) Atualiza dados de um produto no Bling. A informação dados['sku'] é obrigatória. Campos possíveis: weight(peso bruto e líquido), brand(marca), ean(EAN), location(Localização no estoque)
byStore('CODIGO-LOJA') Especifica a loja para a qual a requisição está sendo feita. O CODIGO-LOJA pode ser encontrado nas configurações de Integração no Bling.

Testando

Caso queira executar os testes no pacote, será necessário preencher as informações de teste no arquivo .env.test e, em seguida, renomeá-lo para .env.