接口总述
接口约定使用POST
请求
参数描述
名称 | 描述 | 备注 |
Data | 请求的数据 | 格式为JSON字符串 |
TimeStamp | 时间戳 | 格式为："yyyyMMddhhmmss"，必须为13位数字字符串 |
Sign | 签名 | 字符串 生成规则详见下面的说明，其中secretkey是由平台为统一分配并提供的密钥. sign生成规则可以分为4个步骤： 1. 将对象数据转换成json格式字符串 2. 移除掉字符“{、}、[、]、:、,、"、'、/、(、)、空格”，并转换大写 3. 对数据进行url编码，并转换成大写 4. 按照ASCII反向排序并 5. 采用MD5方式生成签名，并转换成大写 6. 转换成json字符串格式 7. 采用url编码并提交 |
UFAcc | 用友账套 | 三位数字字符串：001，002 |
请求示例
1. {
2. "Data":"{}",
3. "TimeStamp":"20210912132045",
4. "Sign":"",
5. "UFAcc":"001"
6. }
响应
参数描述
名称 | 描述 | 备注 |
Data | 成功返回的数据 | 格式为JSON字符串 |
Message | 相应状态描述 | 字符串 |
IsSucceed | 命令执行成功标志 | 布尔类型 |
相应示例
1. {
2. "Data":"{}",
3. "Message":"",
4. "IsSucceed":true
5. }
测试方法
启动项目HY.UF.exe。在本地http://127.0.0.1:8088开启服务器
通过UF.SignTool将需要传递的数据签名并转换为接口请求接口
通过Fiddler，PostMan等第三方工具发送到对应的api进行接口测试
总账接口
凭证接口(api/Credential/GLaccvouch/Write)
字段描述
名称 | 格式 | 描述 | 备注 |
Accvouchs | 数组 | 凭证列表 | Accvouch对象数组 |
Accvouch字段：
名称 | 格式 | 描述 | 备注 |
csign | 凭证类别 | ||
isignseq | 凭证类别排序号 | ||
ino_id | 凭证号 | ||
md | 借方金额 | ||
mc | 贷方金额 | ||
dbill_date | 凭证日期 | ||
cbill | 制单人 | ||
cdigest | 摘要 | ||
ccode | 科目编码 | ||
cdept_id | 部门编码 | ||
cperson_id | 个人代码 | ||
ccus_id | 客户编码 | ||
csup_id | 供应商编码 | ||
citem_class | 项目大类编码 | ||
citem_id | 项目编码 | ||
idoc | 附单据数 | ||
iyear | 凭证的会计年度 | ||
iYPeriod | 包括年度的会计期间 | ||
iperiod | 会计期间 | ||
AssType | 多辅助类型 | ||
FlowCode | 现金流量编码 | ||
FlowClassCode | 现金流量大类编码 | ||
md_f | 外币借方金额 | ||
mc_f | 外币贷方金额 | ||
nfrat | 税率 | ||
csettle | 结算方式编码 | ||
ccodeexch_equal | 对方科目带币种 | ||
cexch_name | 币种 | ||
ccode_equal | 对方科目 |
测试数据
1. {
2. "Accvouchs": [
3. {
4. "csign": "记",
5. "inid": 1,
6. "md": 2000,
7. "mc": 0,
8. "dbill_date": "2018-12-12",
9. "cbill": "制单人",
10. "cdigest": "摘要",
11. "ccode": "100101",
12. "cdept_id": null,
13. "cperson_id": null,
14. "ccus_id": null,
15. "csup_id": null,
16. "citem_class": null,
17. "citem_id": null,
18. "idoc": 0,
19. "iyear": 2018,
20. "iYPeriod": 201812,
21. "iperiod": 12,
22. "FlowCode": "02"
23. },
24. {
25. "csign": "记",
26. "inid": 2,
27. "md": 0,
28. "mc": 2000,
29. "dbill_date": "2018-12-12",
30. "cbill": "制单人",
31. "cdigest": "摘要",
32. "ccode": "122101",
33. "cdept_id": "301",
34. "cperson_id": "307001",
35. "ccus_id": null,
36. "csup_id": null,
37. "citem_class": null,
38. "citem_id": null,
39. "idoc": 0,
40. "iyear": 2018,
41. "iYPeriod": 201812,
42. "iperiod": 12
43. }
44. ]
45. }
测试请求
1. {"Data":"{\n\"Accvouchs\":[\n{\n\"csign\":\"记\",\n\"inid\":1,\n\"md\":2000,\n\"mc\":0,\n\"dbill_date\":\"2018-12-12\",\n\"cbill\":\"制单人\",\n\"cdigest\":\"摘要\",\n\"ccode\":\"100101\",\n\"cdept_id\":null,\n\"cperson_id\":null,\n\"ccus_id\":null,\n\"csup_id\":null,\n\"citem_class\":null,\n\"citem_id\":null,\n\"idoc\":0,\n\"iyear\":2018,\n\"iYPeriod\":201812,\n\"iperiod\":12,\n\"FlowCode\":\"02\"\n},\n{\n\"csign\":\"记\",\n\"inid\":2,\n\"md\":0,\n\"mc\":2000,\n\"dbill_date\":\"2018-12-12\",\n\"cbill\":\"制单人\",\n\"cdigest\":\"摘要\",\n\"ccode\":\"122101\",\n\"cdept_id\":\"301\",\n\"cperson_id\":\"307001\",\n\"ccus_id\":null,\n\"csup_id\":null,\n\"citem_class\":null,\n\"citem_id\":null,\n\"idoc\":0,\n\"iyear\":2018,\n\"iYPeriod\":201812,\n\"iperiod\":12\n}\n]\n}","TimeStamp":"20211112161332","Sign":"5AF4895D2A93095C1761CF0673924139","UFAcc":"007"}
测试结果
1. {"Message":"写入成功","IsSucceed":true,"Data":"\"1\""}
共有条评论 网友评论