alebatistella / bling-erp-api

1.16.0 2024-09-08 20:22 UTC

This package is auto-updated.

Last update: 2024-09-08 20:26:40 UTC


README

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

为项目做出贡献