用友U8接口-库存管理(7)
概括
- 本文的操作需要正确部署U8API
- 主要讲述库存管理接口的使用，以产成品入库单作为说明，其他单据接口都是大同小异的！
- 许多时候先在ERP做个单，然后仿造ERP单据参数，构造接口JSON参数是不错的做法。
获取Token访问令牌
- 必须先调用此接口获取token令牌
- 将token放请求头
单据字段来源
- 接口文档上的字段是测试的json数据，并不是说明只能传这些字段到接口
- 字段参考erp数据库、数据字典、api资源管理器
- 实际测试时可以先复制接口文档上的json，粘贴到接口测试工具中，字段微调，传入缺少的字段即可！
- 字段以传入的json数据为准，接口封装时会设置一些字段的默认值。比如接口默认某单据头VTID=1，接口传入为VTID=2，此时值就是2
产成品入库
- 主表rdrecord10，视图RecordInQ、子表rdrecords10，视图RecordInSQ
- 此模块下的接口可以获取单据数据、新增、审核、弃审、删除
新增
无来源
- 对应ERP空白单据，无参照来源
- 这种无上下游的单据，整单关联为空白
- 传入JSON示例
[
{
"Inum": "ProductIn",
"Data": {
"iHead": {
"IsVerify": false,
"cWhCode": "04",
"cRdCode": "12",
"cDepCode": "0501",
"cMemo": "API生成",
"cSource": "库存",
"cBusType": "成品入库",
"dDate": "2023-05-14"
},
"iBody": [
{
"iRowNo": 1,
"cInvCode": "F010-S002",
"iQuantity": 50,
"iNQuantity": 50,
"iinvexchrate": 50,
"iNum": 1,
"iNNum": 1,
"cAssUnit": "0502",
"cPosition": "",
"cBatch": "",
"cFree9":"白色"
}
]
}
}
]
参照生产订单
- 对应ERP的生产订单蓝字
- 传入JSON
有参照的单据，传入JSON单头都有上游单据号，单体都有上游子表单据标识ID
- cMPoCode ：传生产订单号
- iMPoIds ：生产订单子表标识(MoDId)
[{
"Inum": "ProductIn",
"Data": {
"iHead": {
"IsVerify": true,
"cWhCode": "36",
"cRdCode": "12",
"cDepCode": "0503",
"cMemo": "API生成",
"cSource": "生产订单",
"cBusType": "成品入库",
"cMPoCode": "0000000037",
"dDate": "2023-05-22"
},
"iBody": [{
"iRowNo": 1,
"cInvCode": "B010-0237002",
"cAssUnit": "",
"cPosition": "",
"cBatch": "",
"iinvexchrate": 0,
"iQuantity": 1,
"iNQuantity": 2,
"iNum": 0,
"iNNum": 0,
"iMPoIds": 1000000037
}]
}
}]
审核、弃审、删除
- 这三个动作传参比较简单，传个单据ID即可
- POST请求，传入请求体
{
"VouchId": 0
}
查询
自定义sql查询单据列表
- 此接口类似于ERP的列表查询，通过构造查询条件查询主表视图
- 传入参数构造sql
- customSQLFileName：接口SqlXML文件夹下的U8SQL.xml
- customSQLPath：U8SQL.xml下的节点sql语句
- paramObj：传入的参数，@pagesize非必填默认25，优先级@code>@where>@version传一个值即可。当需要进行高级查询可以自行构建@where字符串传入，此字符串必须AND开头，大小写无关，会检查
{
"customSQLFileName": "U8SQL",
"customSQLPath": "U8API/RdRecord10/Get",
"paramObj": {
"@pagesize": 25,
"@code": "0000000003",
"@where": "AND m.ccode like '%0000000019%' OR m.cmaker like '%demo%'",
"@version": "7108589"
}
}
SqlXML文件夹下的U8SQL.xml
3. sql将会在Log文件夹下Debug.log日志文件中打印
获取单据数据
- 此操作类似于ERP的查询列表中，点击打开单据
- JSON参数
- 通过查询xml节点下的sql，构建查询语句执行，返回dataset序列化返回json
{
"customSQLFileName": "U8SQL",
"customSQLPath": "U8API/RdRecord10/GetWithDetail",
"paramObj": {
"@code": "0000000010"
}
}
返回时DataTable为主表视图，DataTable1为子表视图
常见问题
接口文档字段太少
- ERP单据表字段太多，加上某些字段非必填，接口文档上是测试例子。可以参考erp数据库，数据字典，api资源管理器
不知道某字段传什么值
- 去ERP做个单据，然后查询数据库，将字段放json中传入接口