用友U8接口-库存管理(7)

概括

1. 本文的操作需要正确部署U8API
2. 主要讲述库存管理接口的使用，以产成品入库单作为说明，其他单据接口都是大同小异的！
3. 许多时候先在ERP做个单，然后仿造ERP单据参数，构造接口JSON参数是不错的做法。
   

获取Token访问令牌

1. 必须先调用此接口获取token令牌
   
2. 将token放请求头
   

单据字段来源

1. 接口文档上的字段是测试的json数据，并不是说明只能传这些字段到接口
2. 字段参考erp数据库、数据字典、api资源管理器
   
3. 实际测试时可以先复制接口文档上的json，粘贴到接口测试工具中，字段微调，传入缺少的字段即可！
   
4. 字段以传入的json数据为准，接口封装时会设置一些字段的默认值。比如接口默认某单据头VTID=1，接口传入为VTID=2，此时值就是2

产成品入库

1. 主表rdrecord10，视图RecordInQ、子表rdrecords10，视图RecordInSQ
2. 此模块下的接口可以获取单据数据、新增、审核、弃审、删除
   

新增

无来源

1. 对应ERP空白单据，无参照来源
   
2. 这种无上下游的单据，整单关联为空白
   
3. 传入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":"白色"}]}}
]

参照生产订单

1. 对应ERP的生产订单蓝字
   
2. 传入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}]}}]

审核、弃审、删除

1. 这三个动作传参比较简单，传个单据ID即可
   
2. POST请求，传入请求体
   

{"VouchId": 0
}

查询

自定义sql查询单据列表

1. 此接口类似于ERP的列表查询，通过构造查询条件查询主表视图
   
2. 传入参数构造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日志文件中打印

获取单据数据

1. 此操作类似于ERP的查询列表中，点击打开单据
   
2. JSON参数

• 通过查询xml节点下的sql，构建查询语句执行，返回dataset序列化返回json

{"customSQLFileName": "U8SQL","customSQLPath": "U8API/RdRecord10/GetWithDetail","paramObj": {"@code": "0000000010"}
}

返回时DataTable为主表视图，DataTable1为子表视图

常见问题

接口文档字段太少

1. ERP单据表字段太多，加上某些字段非必填，接口文档上是测试例子。可以参考erp数据库，数据字典，api资源管理器

不知道某字段传什么值

1. 去ERP做个单据，然后查询数据库，将字段放json中传入接口