alebatistella / bling-erp-api
与Bling ERP API的集成包
1.16.0
2024-09-08 20:22 UTC
Requires
- guzzlehttp/guzzle: ^7.8
Requires (Dev)
- fakerphp/faker: ^1.23
- laravel/laravel: ^10.2
- phpunit/phpunit: ^10.5
README
- JS/TS版本
- C#版本(即将推出)
Bling ERP API - PHP
PHP 8.2+的Bling ERP API v3集成包,功能最全面。
已更新到API v308版本(查看变更日志)。
安装
要安装,请运行以下命令
composer require alebatistella/bling-erp-api
创建新的连接
要创建与Bling服务的连接,只需在构造函数中使用API密钥。
use AleBatistella\BlingErpApi\Bling; $apiKey = "sua_api_key"; $blingConnection = new Bling($apiKey);
需要注意的是,应用程序的创建和授权流程不是由库完成的。也就是说,库只接收由/token
端点生成的access_token
。请参阅参考。
要了解上述认证的实际工作原理,请参阅演示项目。
可用的实体
所有Bling实体当前都允许交互。它们包括
- Borderos (
->borderos
) - 自定义字段 (
->camposCustomizados
) - 销售渠道 (
->canaisDeVenda
) - 商店类别 - 商店 (
->categoriasLojas
) - 产品类别 - 产品 (
->categoriasProdutos
) - 收入和支出类别 - 收入和支出 (
->categoriasReceitasDespesas
) - 应付账款 (
->contasPagar
) - 应收账款 (
->contasReceber
) - 会计账户 (
->contasContabeis
) - 联系人 (
->contatos
) - 联系人类型 (
->contatosTipos
) - 合同 (
->contratos
) - 存款 (
->depositos
) - 公司 (
->empresas
) - 库存 (
->estoques
) - 支付方式 (
->formasDePagamento
) - 产品组 (
->gruposDeProdutos
) - 同构 (
->homologacao
) - 物流 (
->logisticas
) - 物流 - 标签 (
->logisticasEtiquetas
) - 物流 - 物体 (
->logisticasObjetos
) - 物流 - 装运 (
->logisticasRemessas
) - 物流 - 服务 (
->logisticasServicos
) - 业务性质 (
->naturezasDeOperacoes
) - 电子消费发票 (
->nfces
) - 电子服务发票 (
->nfses
) - 电子发票 (
->nfes
) - 通知 (
->notificacoes
) - 生产订单 (
->ordensDeProducao
) - 采购订单 (
->pedidosCompras
) - 销售订单 (
->pedidosVendas
) - 产品 (
->produtos
) - 产品结构 (
->produtosEstruturas
) - 供应商 (
->produtosFornecedores
) - 产品商店 (
->produtosLojas
) - 产品变体 (
->produtosVariacoes
) - 商业提案 (
->propostasComerciais
) - 情况 (
->situacoes
) - 情况 - 模块 (
->situacoesModulos
) - 情况 - 转换 (
->situacoesTransicoes
) - 用户 (
->usuarios
) - 卖家 (
->vendedores
)
使用示例
要列出您的产品,只需执行
use AleBatistella\BlingErpApi\Bling; $apiKey = "sua_api_key"; $blingConnection = new Bling($apiKey); $products = $blingConnection->produtos->get(); var_dump($products);
执行项目测试
克隆项目,安装依赖项并执行
vendor/phpunit/phpunit/phpunit -c phpunit.xml