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 配置错误
- 服务地址不正确
- 网络连接问题
解决方法:
- 检查
.env文件中的配置是否正确 - 确认服务地址
https://c4.yonyoucloud.com可以访问 - 查看日志文件获取详细错误信息
2. API端点不存在
错误信息:API请求失败 (HTTP 404)
解决方法:
- 查看用友BIP API文档,确认正确的端点路径
- 更新
application/extra/yonyou_bip.php中的API端点配置
3. 权限不足
错误信息:API返回错误: 权限不足
解决方法:
- 检查应用权限配置
- 确认应用是否有访问相应API的权限
- 联系用友BIP技术支持
七、下一步
- ✅ 配置认证信息(已完成)
- ⏳ 测试连接
- ⏳ 同步基础数据
- ⏳ 设置数据映射
- ⏳ 同步订单
八、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 - 生产环境建议使用环境变量或配置中心管理密钥