# 用友BIP集成快速开始 ## 一、配置认证信息 ### 方式1:使用环境变量(推荐) 在项目根目录的 `.env` 文件中添加以下配置: ```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` 文件: ```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 ``` 或者在浏览器控制台执行: ```javascript $.ajax({ url: '/antis/yonyou_bip/test_connection', type: 'GET', success: function(res) { console.log('连接测试结果:', res); } }); ``` ### 2. 查看日志 如果连接失败,查看日志文件: - `runtime/log/` 目录下的日志文件 - 查找 "用友BIP" 相关的错误信息 ## 三、同步基础数据 ### 1. 同步所有基础数据 ```bash POST /antis/yonyou_bip/sync_all_base_data ``` ### 2. 同步指定类型 ```bash POST /antis/yonyou_bip/sync_base_data Content-Type: application/json { "type": "organization" // organization, transaction_type, department, person, customer } ``` ## 四、设置数据映射 在同步订单前,需要将本地数据映射到用友BIP数据: ```bash POST /antis/yonyou_bip/set_data_mapping Content-Type: application/json { "type": "department", "local_id": 1, // 本地部门ID "bip_code": "DEPT001" // 用友BIP部门编码 } ``` ## 五、同步销售订单 ### 1. 同步单个订单 ```bash POST /antis/yonyou_bip/sync_sales_order Content-Type: application/json { "order_id": 123 } ``` ### 2. 批量同步订单 ```bash 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`: ```php 'api' => [ // 根据实际API文档调整这些路径 'create_sales_order' => '/api/sales/order/create', 'create_sales_delivery' => '/api/sales/delivery/create', // ... ], ``` ## 九、安全提醒 ⚠️ **重要**:请勿将 AppKey 和 AppSecret 提交到代码仓库! - 使用 `.env` 文件存储敏感信息 - 确保 `.env` 文件已添加到 `.gitignore` - 生产环境建议使用环境变量或配置中心管理密钥