YonyouBip_QuickStart.md 3.65 KB

用友BIP集成快速开始

一、配置认证信息

方式1:使用环境变量(推荐)

在项目根目录的 .env 文件中添加以下配置:

# 用友BIP服务地址
YONYOU_BIP_BASE_URL=https://c4.yonyoucloud.com

# 应用密钥
YONYOU_BIP_APP_KEY=
YONYOU_BIP_APP_SECRET=

# 租户ID(如果API需要)
YONYOU_BIP_TENANT_ID=

# 启用集成
YONYOU_BIP_ENABLED=true

方式2:直接修改配置文件

编辑 application/extra/yonyou_bip.php 文件:

return [
    'base_url' => 'https://c4.yonyoucloud.com',
    'app_key' => '',
    'app_secret' => '',
    'tenant_id' => '', // 如果需要请填写
    'enabled' => true,
    // ... 其他配置
];

二、测试连接

1. 测试Token获取

访问以下URL测试连接(需要登录后台):

GET /antis/yonyou_bip/test_connection

或者在浏览器控制台执行:

$.ajax({
    url: '/antis/yonyou_bip/test_connection',
    type: 'GET',
    success: function(res) {
        console.log('连接测试结果:', res);
    }
});

2. 查看日志

如果连接失败,查看日志文件:

  • runtime/log/ 目录下的日志文件
  • 查找 "用友BIP" 相关的错误信息

三、同步基础数据

1. 同步所有基础数据

POST /antis/yonyou_bip/sync_all_base_data

2. 同步指定类型

POST /antis/yonyou_bip/sync_base_data
Content-Type: application/json

{
    "type": "organization"  // organization, transaction_type, department, person, customer
}

四、设置数据映射

在同步订单前,需要将本地数据映射到用友BIP数据:

POST /antis/yonyou_bip/set_data_mapping
Content-Type: application/json

{
    "type": "department",
    "local_id": 1,        // 本地部门ID
    "bip_code": "DEPT001" // 用友BIP部门编码
}

五、同步销售订单

1. 同步单个订单

POST /antis/yonyou_bip/sync_sales_order
Content-Type: application/json

{
    "order_id": 123
}

2. 批量同步订单

POST /antis/yonyou_bip/batch_sync_sales_order
Content-Type: application/json

{
    "order_ids": [123, 124, 125]
}

六、常见问题

1. Token获取失败

错误信息:获取访问令牌失败

可能原因:

  • AppKey 或 AppSecret 配置错误
  • 服务地址不正确
  • 网络连接问题

解决方法:

  1. 检查 .env 文件中的配置是否正确
  2. 确认服务地址 https://c4.yonyoucloud.com 可以访问
  3. 查看日志文件获取详细错误信息

2. API端点不存在

错误信息:API请求失败 (HTTP 404)

解决方法:

  1. 查看用友BIP API文档,确认正确的端点路径
  2. 更新 application/extra/yonyou_bip.php 中的API端点配置

3. 权限不足

错误信息:API返回错误: 权限不足

解决方法:

  1. 检查应用权限配置
  2. 确认应用是否有访问相应API的权限
  3. 联系用友BIP技术支持

七、下一步

  1. ✅ 配置认证信息(已完成)
  2. ⏳ 测试连接
  3. ⏳ 同步基础数据
  4. ⏳ 设置数据映射
  5. ⏳ 同步订单

八、API端点配置

根据用友BIP实际API文档,可能需要调整以下端点:

编辑 application/extra/yonyou_bip.php:

'api' => [
    // 根据实际API文档调整这些路径
    'create_sales_order' => '/api/sales/order/create',
    'create_sales_delivery' => '/api/sales/delivery/create',
    // ...
],

九、安全提醒

⚠️ 重要:请勿将 AppKey 和 AppSecret 提交到代码仓库!

  • 使用 .env 文件存储敏感信息
  • 确保 .env 文件已添加到 .gitignore
  • 生产环境建议使用环境变量或配置中心管理密钥