README

与 Bling ERP v3 API 集成

安装

您可以通过 composer 安装此包

composer require prhost/bling-v3-sdk

认证

请求授权

use Prhost\Bling\Bling;

// Instancia o objeto
$bling = new Bling(
    "CLIENT ID",
    "SECRET KEY",
);

// Adiciona a url de callback caso seja diferente da cadastrada no Bling
$bling->setCallbackURL("URL PARA RETORNO");

// Solicita a autenticação
// O usuário será redirecionado para uma página de autenticação do Bling
$bling->requestAuthorization();

获取访问令牌

$retorno = $bling->requestToken($_GET["code"]);

$retorno 数据

[
    "access_token" => "TOKEN PARA REQUISIÇÕES",
    "refresh_token" => "TOKEN PARA RENOVAÇÂO DO accessToken",
    "token_validate" => "Data de validade do token em segundos"
]

更新访问令牌

// Solicita a atualizacao
$retorno = $bling->refreshToken($refreshToken);

定义访问令牌

// A partir daqui, informe o token toda vez que for utilizar a API
$bling->setAccessToken("Access Token");

产品

列出产品

//Retorna um array com todos os produtos
$bling->produtos()->get();

//Retorna um array com todos os produtos na pagina 2 com 10 itens por pagina
$bling->produtos()->get(2, 10);

创建产品

//Criando um produto simples
$response = $this->bling
    ->produtos()
    ->create([
        'nome'     => 'Bolacha recheada (e não biscoito)',
        'codigo'   => '123456789',
        'tipo'     => 'P', //P - Produto
        'situacao' => 'A', //A - Ativo
        'formato'  => 'S', //S - Simples
    ]);

更新产品

//Atualizando um produto simples
$response = $this->bling
    ->produtos()
    ->update($id, [
        'nome'     => 'Agora sim biscoito recheado',
        'codigo'   => '123456789',
        'tipo'     => 'P', //P - Produto
        'situacao' => 'A', //A - Ativo
        'formato'  => 'S', //S - Simples
    ]);

删除产品

//Deletando um produto
$this->bling
    ->produtos()
    ->deleteById($id);

查找产品

//Buscando um produto
$this->bling
    ->produtos()
    ->getById($id);

测试

要运行测试，请下载开发依赖项并执行

php vendor/bin/codecept run

路由列表

• - 类别 - 产品
• - 联系人
• - 联系人 - 类型
• - 存款
• - 支付方式
• - 库存
• - 电子消费者发票
• - 订单 - 销售
• - 情况
• - 情况模块
• - 产品

版权

• Kallef Alexandre

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 了解更多信息。