2db47680
hexiaodong
chore: 初始提交 php 遗...
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
|
# 用友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`
- 生产环境建议使用环境变量或配置中心管理密钥
|