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

243927103

已于 2025-04-14 19:42:10 修改

阅读量1.6k

点赞数 24

分类专栏：用友U8开发文章标签： U8 用友U8接口用友接口用友U8 API 用友U8

于 2024-10-26 22:24:28 首次发布

本文链接：https://blog.csdn.net/wyqihsj/article/details/143259949

版权

用友U8开发专栏收录该内容

11 篇文章

订阅专栏

概括

本文的操作需要正确部署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中传入接口