README

PHP客户端，用于操作Enotas Emissor API。 https://enotas.com.br/emissor/

文档

API

Webhooks

安装

composer require vluzrmos/enotas-emissor

独立包

include __DIR__.'/vendor/autoload.php';

use Vluzrmos\Enotas\HttpClient\Enotas;
use Vluzrmos\Enotas\Resources\Produto;

//apiKey gerada no menu "Perfil" > "Acessar configurações para nerds"
$apiKey = 'XXXX-XXXXX-XXXXXX';
$enotas = new Enotas($apiKey);

$enotas->useAsGlobalInstance(); //to use that instance globally in all resources

$produtos = new Produto();

print_r($produtos->last()->toArray());

产品

$produtosService = new \Vluzrmos\Enotas\Resources\Produto();

$produtosService->all(); // Lista a página 0 dos produtos

客户

$clientesService = new \Vluzrmos\Enotas\Resources\Cliente();

$clientesService->all(); // Lista a página 0 dos clientes

销售

$vendasService = new \Vluzrmos\Enotas\Resources\Venda();

$vendasService->all(); // Lista a página 0 dos vendas

Laravel包

Laravel会自动发现服务提供者 "Vluzrmos\Enotas\Providers\LaravelServiceProvider"。 以导出配置文件

php artisan vendor:publish --provider=Vluzrmos\\Enotas\\Providers\\LaravelServiceProvider

资源

每个资源（产品、销售、客户...）都可以用作服务来通过API列出/插入/更新数据。

$produto = new Produto([
    'nome' => 'Computador All-In-One',
    'valorTotal' => 3800.00
]);

$produto->save();

//Alterando o nome
$produto->nome = 'Computador HP';
$produto->save();


//Paginação

$produtoService = new Produto(); // ou laravel: app('enotas.produtos');

//filtros opcionais
$pagina = 0; //zero-based
$itensPorPagina = 999;
$ordenacao = 'createdAt desc';
$filter = "(contains(nome, 'computador') or contains(tags/nome, 'computador'))";

// Todos os produtos para os filtros acima
$produtoService->all($pagina, $itensPorPagina, $ordenacao, $filter);

//últimos 999 produtos
$produtoService->all();

//pagina especifica
$produtoService->all(0);
$produtoService->all(1);
$produtoService->all(2);

// Recuperando um resource pelo ID:

$produto = $produtoService->find($id);

可用资源

Vluzrmos\Enotas\Resources\Produto;
Vluzrmos\Enotas\Resources\Webhook;
Vluzrmos\Enotas\Resources\Cliente;
Vluzrmos\Enotas\Resources\Venda;

环境（Laravel）

ENOTAS_API_KEY=XXX-XXXXX 
#ou
ENOTAS_EMISSOR_API_KEY=XXX-XXXXX