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.

lucasberto/laravel-bling-client

包简介

README 文档