API开放平台

TIP

调拨订单新增接口
调拨订单审批接口
调拨订单查询接口
其他出库单新增接口
其他出库单确认接口
其他出库单查询接口
其他出库单自定义字段修改
其他入库单新增接口
其他入库单确认接口
其他入库单查询接口
其他入库单自定义字段修改

# 调拨订单新增接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsStorehouseChange/v1/saveStorehouseChange/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "code": "",
    "from_storehouse_code": "",
    "to_storehouse_code": "",
    "date": "",
    "emp_code": "",
    "emp_sourcecode": "",
    "remark": "",
    "products": [
      {
        "sequ": "",
        "product_code":"",
        "product_sourcecode": "",
        "input_unit_id": "",
        "input_unit_name": "",
        "apply_num": "",
        "remark": ""
      }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
code	VARCHAR(32)	否	调拨订单编号。如果单据单号不存在则新增，已存在则修改。只有待审批的单据允许修改
from_storehouse_code	VARCHAR(32)	是	调出仓库编号
to_storehouse_code	VARCHAR(32)	是	调入仓库编号
date	DATE	是	调拨日期，格式："yyyy-mm-dd"
emp_code	VARCHAR(32)	否	经办人编码。经办人编码和sourcecode必传一个，优先级emp_sourcecode -> emp_code
emp_sourcecode	VARCHAR(32)	否	经办人sourcecode。经办人编码和sourcecode必传一个，优先级emp_sourcecode -> emp_code
remark	VARCHAR(4000)	否	备注
products	LIST	是	商品明细列表，编辑时商品数据全覆盖
products.sequ	NUMERIC(20)	否	排序号。不传默认按商品明细列表升序，如第一行排序号1，第二行排序号2，依次类推
products.product_code	VARCHAR(32)	否	商品编码。code和sourcecode必传一个，优先级sourcecode -> code
products.product_sourcecode	VARCHAR(32)	否	商品sourcecode。code和sourcecode必传一个，优先级sourcecode -> code
products.input_unit_id	INT8	否	商品录入单位id。录入单位id和name必须传一个，优先级：id -> name
products.input_unit_name	VARCHAR(32)	否	商品录入单位名称。录入单位id和name必须传一个，优先级：id -> name
products.apply_num	NUMERIC(20,8)	是	申请数量
products.remark	VARCHAR(4000)	否	行备注

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 调拨订单审批接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsStorehouseChange/v1/confirmStorehouseChange/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
id	INT8	否	单据编号。id和code必须传入一个，优先级id -> code
code	VARCHAR(32)	否	单据id。id和code必须传入一个，优先级id -> code
confirm_status	VARCHAR(32)	是	审批状态("1"：审批通过，"2"：审批作废)。审批通过时确认数量默认申请数量
confirm_emp_code	VARCHAR(32)	否	审批经办人编码。审批经办人编码和sourcecode必传一个，优先级confirm_emp_sourcecode -> confirm_emp_code
confirm_emp_sourcecode	VARCHAR(32)	否	审批经办人sourcecode。审批经办人编码和sourcecode必传一个，优先级confirm_emp_sourcecode -> confirm_emp_code

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 调拨订单查询接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsStorehouseChange/v1/queryStorehouseChange/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "page_number": "",
    "page_length": "",
    "status": "",
    "confirm_status": "",
    "id": "",
    "code": "",
    "from_storehouse_code": "",
    "to_storehouse_code": "",
    "create_date": "",
    "modify_date": "",
    "after_create_date": "",
    "after_modify_date": "",
    "start_create_date": "",
    "end_create_date": "",
    "start_modify_date": "",
    "end_modify_date": "",
    "start_confirm_time": "",
    "end_confirm_time":""
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
page_number	INT8	否	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
status	CHAR(1)	否	记录状态。0：已删除，1：正常
confirm_status	VARCHAR(32)	否	0：待审批，1：已审批， 2：已作废，3：待出库，4：出库中，5：待入库，6：已完成
id	VARCHAR(32)	否	调拨单id
code	VARCHAR(32)	否	调拨单号
from_storehouse_code	VARCHAR(32)	否	调出仓库编码
to_storehouse_code	VARCHAR(32)	否	调入仓库编码
create_date	CHAR(10)	否	创建日期。格式：yyyy-MM-dd
modify_date	CHAR(10)	否	修改日期。格式：yyyy-MM-dd
after_create_date	CHAR(10)	否	创建时间之后。格式：yyyy-MM-dd HH:mm:ss
after_modify_date	CHAR(10)	否	修改时间之后。格式：yyyy-MM-dd HH:mm:ss
start_create_date	VARCHAR(32)	否	创建时间开始。格式：yyyy-MM-dd
end_create_date	VARCHAR(32)	否	创建时间结束。格式：yyyy-MM-dd
start_modify_date	VARCHAR(32)	否	修改时间开始。格式：yyyy-MM-dd
end_modify_date	VARCHAR(32)	否	修改时间结束。格式：yyyy-MM-dd
start_confirm_time	VARCHAR(32)	否	确认时间开始。格式：yyyy-MM-dd HH:mm:ss
end_confirm_time	VARCHAR(32)	否	确认时间结束。格式：yyyy-MM-dd HH:mm:ss

响应示例：

{
    "id": "",
    "status": "",
    "confirm_status": "",
    "code": "",
    "direction": "",
    "from_storehouse_code": "",
    "from_storehouse_name": "",
    "to_storehouse_code": "",
    "to_storehouse_name": "",
    "date": "",
    "emp_dept_code": "",
    "emp_dept_name": "",
    "emp_dept_sourcecode": "",
    "emp_code": "",
    "emp_name": "",
    "emp_sourcecode": "",
    "remark": "",
    "varieties": "",
    "total_confirm_num": "",
    "total_confirm_amount": "",
    "creator_code": "",
    "creator_name": "",
    "creator_sourcecode": "",
    "create_time": "",
    "modifyier_code": "",
    "modifyier_name": "",
    "modifyier_sourcecode": "",
    "modify_time": "",
    "last_approver_code": "",
    "last_approver_name": "",
    "last_approver_sourcecode": "",
    "confirm_time": "",
    "export_emp_code": "",
    "export_emp_name": "",
    "export_emp_sourcecode": "",
    "export_time": "",
    "import_emp_code": "",
    "import_emp_name": "",
    "import_emp_sourcecode": "",
    "import_time": "",
    "products": [
      {
        "id":"",
        "sequ": "",
        "product_id": "",
        "product_name": "",
        "product_code": "",
        "product_sourcecode": "",
        "unit_id": "",
        "unit_name": "",
        "apply_num": "",
        "confirm_num": "",
        "export_num": "",
        "improt_num": "",
        "confirm_price": "",
        "confirm_amount": "",
        "base_unit_id": "",
        "base_unit_name": "",
        "confirm_base_unit_num": "",
        "remark": ""
      }
    ]
}

参数说明：

参数	类型	必填	说明
id	INT8	否	调拨订单ID
status	CHAR(1)	否	记录状态 0：已删除，1：正常
confirm_status	VARCHAR(32)	否	0：待审批，1：已审批， 2：已作废，3：待出库，4：出库中，5：待入库，6：已完成
code	VARCHAR(32)	否	调拨订单编号
direction	VARCHAR(32)	否	调拨方向：EXPORT：调出，IMPORT：调入
from_storehouse_code	VARCHAR(32)	否	调出仓库编号
from_storehouse_name	VARCHAR(100)	否	调出仓库名称
to_storehouse_code	VARCHAR(32)	否	调入仓库编号
to_storehouse_name	VARCHAR(100)	否	调入仓库名称
date	TIMESTAMP	否	调拨日期，yyyy-mm-dd 格式
emp_dept_code	VARCHAR(32)	否	业务员下单时候所在的部门编码
emp_dept_name	VARCHAR(100)	否	业务员下单时候所在的部门名称
emp_dept_sourcecode	VARCHAR(32)	否	部门sourcecode
emp_code	VARCHAR(32)	否	经办人编码
emp_name	VARCHAR(100)	否	经办人名称
emp_sourcecode	VARCHAR(32)	否	经办人sourcecode
remark	VARCHAR(4000)	否	备注
varieties	NUMERIC(15)	否	品种数
total_confirm_num	NUMERIC(20,8)	否	合计确认数量
total_confirm_amount	NUMERIC(20,2)	否	合计确认金额
creator_code	VARCHAR(32)	否	创建人编码
creator_name	VARCHAR(100)	否	创建人名称
creator_sourcecode	VARCHAR(32)	否	创建人sourcecode
create_time	TIMESTAMP	否	创建时间，yyyy-mm-dd hh24:mi:ss格式
modifyier_code	VARCHAR(32)	否	修改人编码
modifyier_name	VARCHAR(100)	否	修改人名称
modifyier_sourcecode	VARCHAR(32)	否	修改人sourcecode
modify_time	TIMESTAMP	否	修改时间，yyyy-mm-dd hh24:mi:ss格式
last_approver_code	VARCHAR(32)	否	最后审批人编码
last_approver_name	VARCHAR(100)	否	最后审批人名称
last_approver_sourcecode	VARCHAR(32)	否	最后审批人sourcecode
confirm_time	TIMESTAMP	否	审批时间，yyyy-mm-dd hh24:mi:ss格式
export_emp_code	VARCHAR(32)	否	出库人编码
export_emp_name	VARCHAR(100)	否	出库人名称
export_emp_sourcecode	VARCHAR(32)	否	出库人sourcecode
export_time	TIMESTAMP	否	出库时间，yyyy-mm-dd hh24:mi:ss格式
import_emp_code	VARCHAR(32)	否	入库人编码
import_emp_name	VARCHAR(100)	否	入库人名称
import_emp_sourcecode	VARCHAR(32)	否	入库人sourcecode
import_time	TIMESTAMP	否	入库时间，yyyy-mm-dd hh24:mi:ss格式
products	LIST	否	明细子表
products.id	INT8	否	订单子表id
products.sequ	NUMERIC(15)	否	序号
products.product_id	INT8	否	商品id
products.product_name	VARCHAR(100)	否	商品名称
products.product_code	VARCHAR(32)	否	商品编码
products.product_sourcecode	VARCHAR(32)	否	商品对应sourcecode
products.unit_id	INT8	否	行单位id
products.unit_name	VARCHAR(32)	否	行单位名称
products.apply_num	NUMERIC(20,8)	否	申请数量
products.confirm_num	NUMERIC(20,8)	否	确认数量
products.export_num	NUMERIC(20,8)	否	出库数量
products.improt_num	NUMERIC(20,8)	否	入库数量
products.confirm_price	NUMERIC(20,8)	否	批发价
products.confirm_amount	NUMERIC(20,2)	否	批发价确认金额
products.base_unit_id	INT8	否	商品基本单位id
products.base_unit_name	VARCHAR(32)	否	商品基本单位名称
products.confirm_base_unit_num	NUMERIC(20,8)	否	基本单位确认数量
products.remark	VARCHAR(4000)	否	行备注

# 其他出库单新增接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherOut/v1/add/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "delivery_no": "",
    "date": "2020-12-10",
    "storehouse_code": "",
    "emp_code": "",
    "emp_source_code": "",
    "emp_dept_code": "",
    "emp_dept_source_code": "",
    "remark": "",
    "ext_columns": [
        {
            "ext_key": "级别",
            "ext_value": "四星"
        },
        {
            "ext_key": "主营商品",
            "ext_value": "食品,电器,日化用品"
        }
    ],
    "prods": [
        {
            "product_id": "",
            "product_source_code": "",
            "product_code": "",
            "posnr": "1",
            "num": "5.00000000",
            "price": "5.00000000",
            "unit_id": "6782340125265424027",
            "unit_name": "箱",
            "remark": "易损件",
            "ext_columns": [
                {
                    "ext_key": "级别",
                    "ext_value": "四星"
                },
                {
                    "ext_key": "主营商品",
                    "ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
delivery_no	VARCHAR(100)	否	单据编号。如果单据不存在则新增，已存在则修改。已出库的单据不能修改。生成“待出库”的其他出库单。
date	VARCHAR(32)	是	业务日期，yyyy-mm-dd 格式
storehouse_code	VARCHAR(100)	是	仓库编号
delivery_type_third_code	VARCHAR(32)	否	出库类型第三方编码，新增时必填
emp_code	VARCHAR(100)	是	经办人编码
emp_source_code	VARCHAR(100)	否	经办人sourcecode
emp_dept_code	VARCHAR(100)	否	业务员下单时候所在的部门编码
emp_dept_source_code	VARCHAR(100)	否	部门sourcecode
remark	text	否	备注
prods	List		列表
prods.product_id	VARCHAR(32)	否	商品id。商品id、商品编码和商品sourcecode必须传一个
prods.product_source_code	VARCHAR(100)	否	商品sourcecode。商品id、商品编码和商品sourcecode必须传一个
prods.product_code	VARCHAR(100)	否	商品编码。商品id、商品编码和商品sourcecode必须传一个
prods.num	NUMERIC(18,8)	是	数量
prods.price	NUMERIC(18,2)	否	批发价
prods.unit_id	VARCHAR(32)	否	行单位id。行单位id和行单位名称必须传一个位
prods.unit_name	VARCHAR(100)	否	行单位名称。行单位id和行单位名称必须传一个
prods.posnr	NUMERIC(10)	否	明细行行号
prods.remark	text	否	行备注
prods.ext_columns	List	否	子表自定义字段
prods.ext_columns.ext_key	varchar(4000)	否	子表自定义字段key值扩展字段需先在我方系统中创建
prods.ext_columns.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接
ext_columns	List	否	主表自定义字段
ext_columns.ext_key	varchar(4000)	否	主表自定义字段key值扩展字段需先在我方系统中创建
ext_columns.ext_value	varchar(4000)	否	扩展字段value值对多个选项值，以“,”分隔拼接

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 其他出库单确认接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherOut/v1/confirm/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "delivery_no": "",
    "id": "",
    "delivery_status": "",
    "confirm_time": "",
    "confirm_emp_id": "",
    "confirm_emp_code": "",
    "confirm_the_whole_order": "",
    "details_req_list": [
      {
        "id": "",
        "sequ": 1,
        "unitName": "",
        "num": 0.00
      }
    ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
delivery_no	VARCHAR(100)	否	单据编号。单据ID和单据编码必须传入一个
id	VARCHAR(32)	否	单据ID。单据ID和单据编码必须传入一个
delivery_status	VARCHAR(32)	是	确认状态(“YCK”：已出库，“CANCEL”：已作废)
confirm_time	TIMESTAMP	否	确认时间
confirm_emp_id	VARCHAR(32)	否	数据操作员id，操作员id和编码code必须传一个
confirm_emp_code	VARCHAR(32)	否	数据操作员编码code，操作员id和编码code必须传一个
confirm_the_whole_order	VARCAHR(2)	否	整单确认标识。如果不传该字段或该字段传"Y"则所有明细行按申请数量确认出库；传"N"则按实际传入明细行确认数量出库，没有传入的明细行按0出库
details_req_list.id	VARCHAR(32)	否	明细行id。confirm_the_whole_order为"N"时，明细行id和明细行行号必须传一个
details_req_list.sequ	INT	否	行号。confirm_the_whole_order为"N"时，明细行id和明细行行号必须传一个
details_req_list.unitName	VARCAHR(32)	否	行单位名称，不传取待出库单位
details_req_list.num	numeric(28,8)	是	确认数量。

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 其他出库单查询接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherOut/v1/list/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "page_number": 1,
    "page_length": 1000,
    "status": "1",
    "delivery_status": "DCK",
    "id": "",
    "delivery_no": "",
    "storehouse_code": "",
    "create_date": "2017-05-01",
    "modify_date": "2017-05-31",
    "after_create_date": "2017-05-31 00:00:00",
    "after_modify_date": "2017-05-31 00:00:00",
    "start_create_date": "2017-05-31 00:00:00",
    "end_create_date": "2017-05-31 00:00:00",
    "start_modify_date": "2017-05-31 00:00:00",
    "end_modify_date": "2017-05-31 00:00:00"
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
page_number	INT	否	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
status	CHAR(1)	否	记录状态。0：已删除，1：正常
delivery_status	VARCHAR(32)	否	出库状态(DCK：待出库，YCK：已出库，CANCEL：已作废)
id	VARCHAR(32)	否	id
delivery_no	VARCHAR(32)	否	单据编号
storehouse_code	VARCHAR(32)	否	仓库编码
create_date	TIMESTAMP	否	创建日期。格式：yyyy-MM-dd
modify_date	TIMESTAMP	否	修改日期。格式：yyyy-MM-dd
after_create_date	TIMESTAMP	否	创建时间之后。格式：yyyy-MM-dd HH:mm:ss
after_modify_date	TIMESTAMP	否	修改时间之后。格式：yyyy-MM-dd HH:mm:ss
start_create_date	TIMESTAMP	否	创建时间开始。格式：yyyy-MM-dd
end_create_date	TIMESTAMP	否	创建时间结束。格式：yyyy-MM-dd
start_modify_date	TIMESTAMP	否	修改时间开始。格式：yyyy-MM-dd
end_modify_date	TIMESTAMP	否	修改时间结束。格式：yyyy-MM-dd

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
	{
		"date": "2023-01-12",
		"storehouseCode": "stock101",
		"empDeptCode": "ddms",
		"id": "5568220575921634830",
		"billNo": "DB202301120010",
		"creatorCode": "xkp",
		"empDeptSourceCode": null,
		"confirmTime": "2023-01-12 14:49",
		"confirmCode": "xkp",
		"billId": "7823042645662928584",
		"deliveryStatus": "YCK",
		"status": "1",
		"emp": "xkp",
		"remark": "",
		"modifyierCode": "xkp",
		"confirmSourceCode": "",
		"modifyierSourceCode": null,
		"creator": "xkp",
		"modifyierTime": "2023-01-12 14:49",
		"deliveryNo": "QTCK20230112000001",
		"empCode": "xkp",
		"createTime": "2023-01-12 08:57",
		"creatorSourceCode": null,
		"empSourceCode": null,
		"prods": [
			{
				"inputUnitName": "瓶",
				"num": 2.0,
				"detailId": "5560973370190686042",
				"baseUnit": "5519928039918243912",
				"productId": "5341006217672926930",
				"baseUnitName": "瓶",
				"productSourceCode": null,
				"sequ": 1,
				"baseUnitNum": 2.0,
				"emp": "xkp",
				"price": 1314.0,
				"remark": "",
				"inputUnit": "5519928039918243912",
				"waitNum": 2,
				"waitBaseUnitNum": 2,
				"creator": "xkp",
				"productCode": "1002"
			}
		]
	}
]

参数说明：

参数	类型	必填	说明
id	VARCHAR(32)	是	单据ID
status	VARCHAR(1)	否	0：已删除，1：正常
deliveryStatus	VARCHAR(32)	否	出库状态(DCK：待出库，YCK：已出库，CANCEL：已作废)
deliveryNo	VARCHAR(100)	否	单据编号
deliveryType	VARCHAR(100)	否	出库类型
deliveryTypeId	VARCHAR(32)	否	出库类型ID
billNo	VARCHAR(100)	否	源订单号
billId	VARCHAR(32)	否	源订单id
billDate	TIMESTAMP	否	源订单业务日期。格式：yyyy-mm-dd
storehouseId	VARCHAR(32)	否	仓库Id
storehouseCode	VARCHAR(32)	否	仓库编号
storehouseName	VARCHAR(100)	否	仓库名称
date	TIMESTAMP	否	单据业务日期。格式：yyyy-mm-dd
empDeptCode	VARCHAR(100)	否	业务员下单时候所在的部门编码
empDeptSourceCode	VARCHAR(32)	否	部门sourcecode
empCode	VARCHAR(100)	否	经办人编码
empSourceCode	VARCHAR(32)	否	经办人sourcecode
remark	TEXT	否	备注
exts			主表自定义字段
exts.ext_key	VARCHAR(100)	否	自定义字段编码
exts.ext_value	VARCHAR(1000)	否	自定义字段值
varieties	numeric(28,8)	否	品种数
totalNum	numeric(28,8)	否	合计出库数量
creatorCode	VARCHAR(200)	否	创建人编码
creatorSourceCode	VARCHAR(32)	否	创建人sourcecode
createTime	VARCHAR(32)	否	创建时间，yyyy-mm-dd hh24:mi:ss格式
modifyierCode	VARCHAR(32)	否	修改人编码
modifyierSourceCode	VARCHAR(32)	否	修改人sourcecode
modifyierTime	VARCHAR(32)	否	修改时间，yyyy-mm-dd hh24:mi:ss格式
confirmCode	VARCHAR(32)	否	出库人（作废人）编码
confirmSourceCode	VARCHAR(32)	否	出库人（作废人）sourcecode
confirmTime	VARCHAR(32)	否	出库（作废）时间，yyyy-mm-dd hh24:mi:ss格式
prods	List		列表
prods.detailId	VARCHAR(32)	是	子表id
prods.sequ	VARCHAR(32)	否	序号
prods.productId	varchar(32)	否	商品id
prods.productCode	varchar(100)	否	商品编码
prods.productSourceCode	varchar(32)	否	商品sourcecode
prods.inputUnit	VARCHAR(32)	否	行单位id
prods.inputUnitName	VARCHAR(100)	否	行单位名称
prods.confirmInputUnit	VARCHAR(32)	否	出库单位id
prods.confirmUnitName	VARCHAR(100)	否	出库单位名称
prods.waitNum	numeric(28,8)	否	待出库数量
prods.num	numeric(28,8)	否	出库数量
prods.price	numeric(28,2)	否	批发价
prods.baseUnit	VARCHAR(32)	否	商品基本单位id
prods.baseUnitName	VARCHAR(100)	否	商品基本单位名称
prods.waitBaseUnitNum	numeric(28,8)	否	基本单位待出库数量
prods.baseUnitNum	numeric(28,8)		基本单位出库数量
prods.remark	TEXT	否	行备注
prods.exts			子表自定义字段
prods.exts.ext_key	VARCHAR(100)	否	自定义字段编码
prods.exts.ext_value	VARCHAR(1000)	否	自定义字段值

# 其他出库单自定义字段修改

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherOut/v1/modifyUseDefinedVal/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "delivery_no": "FH20201110000001",
    "exts":[{
        "ext_key":"等级",
        "ext_value":"VIP"
    }],
    "products":[{
        "id":"20201110000001",
        "sequ":"1",
        "exts":[{
        	"ext_key":"商品等级",
        	"ext_value":"88VIP"
    	}]
    }]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
delivery_no	VARCHAR(100)	是	其他出库单单号
exts	List		列表
exts.ext_key	VARCHAR(100)	是	出库单主数据扩展字段名称
exts.ext_value	VARCHAR(100)	是	出库单主数据扩展字段数据值
products	List		列表
products.id	VARCHAR(100)	是	出库单明细行id（id和行号必传一个）
products.sequ	VARCHAR(100)	是	出库单明细行行号（id和行号必传一个）
products.exts	List		出库单明细数据扩展字段列表
products.exts.ext_key	VARCHAR(100)	是	出库单明细数据扩展字段名称
products.exts.ext_value	VARCHAR(100)	是	出库单明细数据扩展字段数据值

响应示例：

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明
response_data	String	响应数据

# 其他入库单新增接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherIn/v1/add/{openid}/{timestamp}/{digest}/{msg_id} 在线调试

请求示例：

{
    "receive_no": "",
    "storehouse_code": "",
    "receive_type_third_code": "",
    "date": "",
    "dept_code": "",
    "dept_sourcecode": "",
    "emp_code": "",
    "emp_sourcecode": "",
    "remark": "",
    "receive_status": "",
    "exts": [
      {
        "ext_key": "",
        "ext_value": ""
      }
    ],
    "products": [
      {
        "sequ": "",
        "product_id": "",
        "product_code": "",
        "product_sourcecode": "",
        "input_unit_id": "",
        "input_unit_name": "",
        "num": "",
        "price": "",
        "remark": "",
        "exts": [
          {
            "ext_key": "",
            "ext_value": ""
          }
        ]
      }
    ]
}

参数说明：

参数	类型	必填	说明
receive_no	VARCHAR(32)	否	单据编号。如果单据不存在则新增，已存在则修改，不传自动生成。已入库的单据不能修改。
storehouse_code	VARCHAR(32)	是	仓库编号
receive_type_third_code	VARCHAR(100)	是	入库类型第三方编码（在入库类型设置中由用户设置）
date	VARCHAR(32)	是	业务日期，yyyy-mm-dd 格式
dept_code	VARCHAR(32)	否	业务员下单时候所在的部门编码。优先级：sourcecode -> code，不传取业务员所在部门
dept_sourcecode	VARCHAR(32)	否	业务员下单时候所在的部门sourcecode。
emp_code	VARCHAR(32)	否	经办人编码和经办人sourcecode必填其一。优先级：sourcecode -> code
emp_sourcecode	VARCHAR(32)	否	经办人sourcecode
remark	VARCHAR(400)	否	备注
receive_status	VARCHAR(32)	是	入库状态("CLZ"：处理中、"DRK"：待入库)
exts	LIST	否	主表自定义字段
exts.ext_key	VARCHAR(4000)	否	自定义字段编码
exts.ext_value	VARCHAR(4000)	否	自定义字段值
products	LIST	是	商品明细列表，编辑时商品数据全覆盖
products.sequ	VARCHAR(5)	否	序号
products.product_id	VARCHAR(32)	否	商品id。商品id、商品编码和商品sourcecode必须传一个，优先级：id -> sourcecode -> code
products.product_code	VARCHAR(32)	否	商品编码。
products.product_sourcecode	VARCHAR(32)	否	商品sourcecode。
products.input_unit_id	VARCHAR(32)	否	录入单位id。录入单位id和录入单位名称必须传一个,优先级：id -> name
products.input_unit_name	VARCHAR(32)	否	录入单位名称。
products.num	VARCHAR(32)	是	数量
products.price	VARCHAR(32)	否	批发价
products.remark	VARCHAR(400)	否	行备注
products.exts	LIST	否	子表自定义字段列表
products.exts.ext_key	VARCHAR(4000)	否	自定义字段编码
products.exts.ext_value	VARCHAR(4000)	否	自定义字段值

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 其他入库单确认接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherIn/v1/confirm/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "receive_no": "",
    "id": "",
    "receive_status": "",
    "confirm_time": "",
  "confirm_the_whole_order": "",
  "details_req_list": [
    {
      "id": "",
      "sequ": 1,
      "unitName": "",
      "num": 0.00
    }
  ]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
receive_no	VARCHAR(100)	否	单据编号。单据ID和单据编码必须传入一个
id	VARCHAR(32)	否	单据ID。单据ID和单据编码必须传入一个
receive_status	VARCHAR(32)	是	确认状态(“CONFIRM”：确认入库，“CANCEL”：已作废)
confirm_time	VARCHAR(100)	否	确认时间，格式'yyyy-MM-dd'或'yyyy-MM-dd HH24:mi'或'yyyy-MM-dd HH24:mi:ss'，默认当前时间
confirm_the_whole_order	VARCAHR(2)	否	整单确认标识。如果不传该字段或该字段传"Y"则所有明细行按申请数量确认出库；传"N"则按实际传入明细行确认数量出库，没有传入的明细行按0出库
details_req_list.id	VARCHAR(32)	否	明细行id。confirm_the_whole_order为"N"时，明细行id和明细行行号必须传一个
details_req_list.sequ	INT	否	行号。confirm_the_whole_order为"N"时，明细行id和明细行行号必须传一个
details_req_list.unitName	VARCAHR(32)	否	行单位名称，不传取待入库单位
details_req_list.num	numeric(28,8)	是	确认数量。

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明

# 其他入库单查询接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherIn/v1/list/{openid}/{timestamp}/{digest}/{msg_id} 在线调试

请求示例：

{
    "page_number": "",
    "page_length": "",
    "status": "",
    "receive_status": "",
    "id": "",
    "receive_no": "",
    "storehouse_code": "",
    "receive_type_third_code": "",
    "create_date": "",
    "modify_date": "",
    "after_create_date": "",
    "after_modify_date": "",
    "start_create_date": "",
    "end_create_date": "",
    "start_modify_date": "",
    "end_modify_date":""
}

参数说明：

参数	类型	必填	说明
page_number	INT8	否	页码默认1，每页默认1000条
page_length	INT	否	每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整
status	CHAR(1)	否	记录状态。0：已删除，1：正常
receive_status	VARCHAR(32)	否	入库状态(CLZ：处理中，DRK：待入库，YRK：已入库，CANCEL：已作废)
id	VARCHAR(32)	否	其他入库单id
receive_no	VARCHAR(32)	否	单据编号
storehouse_code	VARCHAR(32)	否	仓库编码
receive_type_third_code	VARCHAR(100)	是	入库类型第三方编码（在入库类型设置中由用户设置）
create_date	CHAR(10)	否	创建日期。格式：yyyy-MM-dd
modify_date	CHAR(10)	否	修改日期。格式：yyyy-MM-dd
after_create_date	CHAR(10)	否	创建时间之后。格式：yyyy-MM-dd HH:mm:ss
after_modify_date	CHAR(10)	否	修改时间之后。格式：yyyy-MM-dd HH:mm:ss
start_create_date	VARCHAR(32)	否	创建时间开始。格式：yyyy-MM-dd
end_create_date	VARCHAR(32)	否	创建时间结束。格式：yyyy-MM-dd
start_modify_date	VARCHAR(32)	否	修改时间开始。格式：yyyy-MM-dd
end_modify_date	VARCHAR(32)	否	修改时间结束。格式：yyyy-MM-dd

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

{
    "id": "",
    "status": "",
    "receive_status": "",
    "receive_no": "",
    "bill_no": "",
    "bill_id": "",
    "storehouse_code": "",
    "storehouse_name": "",
    "receive_type_third_code": "",
    "date": "",
    "dept_code": "",
    "dept_sourcecode": "",
    "emp_code": "",
    "emp_sourcecode": "",
    "remark": "",
    "exts": [
      {
        "ext_key": "",
        "ext_value": ""
      }
    ],
    "varieties": "",
    "total_num": "",
    "total_amount": "",
    "creator_code": "",
    "creator_sourcecode": "",
    "create_time": "",
    "modifyier_code": "",
    "modifyier_sourcecode": "",
    "modify_time": "",
    "receive_emp_code": "",
    "receive_emp_sourcecode": "",
    "receive_time": "",
    "cancel_emp_code": "",
    "cancel_emp_sourcecode": "",
    "cancel_time": "",
    "products": [
      {
        "id": "",
        "sequ": "",
        "product_id": "",
        "product_code": "",
        "product_sourcecode": "",
        "input_unit_id": "",
        "input_unit_name": "",
        "wait_num": "",
        "receive_num": "",
        "price": "",
        "base_unit_id": "",
        "base_unit_name": "",
        "base_wait_num": "",
        "base_receive_num": "",
        "remark": "",
        "exts": [
          {
            "ext_key": "",
            "ext_value": ""
          }
        ]
      }
    ]
}

参数说明：

参数	类型	必填	说明
id	INT8	否	id
status	CHAR(1)	否	记录状态 0：已删除，1：正常
receive_status	VARCHAR(32)	否	入库状态("CLZ"：处理中、"DRK"：待入库、"YRK"：已入库、"YJS"：已拒收、"CANCEL"：已作废)
receive_no	VARCHAR(32)	否	单据编号
bill_no	VARCHAR(32)	否	源订单号
bill_id	INT8	否	源订单id
bill_date	VARCHAR(32)	否	源订单业务日期
storehouse_code	VARCHAR(32)	否	仓库编号
storehouse_name	VARCHAR(100)	否	仓库名称
receive_type_third_code	VARCHAR(100)	否	入库类型第三方编码（在入库类型设置中由用户设置）
date	TIMESTAMP	否	业务日期，yyyy-mm-dd 格式
dept_code	VARCHAR(32)	否	业务员下单时候所在的部门编码
dept_sourcecode	VARCHAR(32)	否	部门sourcecode
emp_code	VARCHAR(32)	否	经办人编码
emp_sourcecode	VARCHAR(32)	否	经办人sourcecode
remark	VARCHAR(400)	否	备注
exts	LIST	否	主表自定义字段
exts.ext_key	VARCHAR(4000)	否	自定义字段编码
exts.ext_value	VARCHAR(4000)	否	自定义字段值
varieties	NUMERIC(20, 8)	否	品种数
total_num	VARCHAR(4000)	否	合计入库数量
total_amount	NUMERIC(20, 2)	否	合计入库金额
creator_code	VARCHAR(32)	否	创建人编码
creator_sourcecode	VARCHAR(32)	否	创建人sourcecode
create_time	TIMESTAMP	否	创建时间，yyyy-mm-dd hh24:mi:ss格式
modifyier_code	VARCHAR(32)	否	修改人编码
modifyier_sourcecode	VARCHAR(32)	否	修改人sourcecode
modify_time	TIMESTAMP	否	修改时间，yyyy-mm-dd hh24:mi:ss格式
receive_emp_code	VARCHAR(32)	否	入库人编码
receive_emp_sourcecode	VARCHAR(32)	否	入库人sourcecode
receive_time	TIMESTAMP	否	入库时间，yyyy-mm-dd hh24:mi:ss格式
cancel_emp_code	VARCHAR(32)	否	作废人编码
cancel_emp_sourcecode	VARCHAR(32)	否	作废人sourcecode
cancel_time	TIMESTAMP	否	作废时间，yyyy-mm-dd hh24:mi:ss格式
products	LIST	否	明细子表
products.id	INT8	否	子表id
products.sequ	NUMERIC(20,8)	否	序号
products.product_id	INT8	否	商品id
products.product_code	VARCHAR(32)	否	商品编码
products.product_sourcecode	VARCHAR(32)	否	商品sourcecode
products.input_unit_id	INT8	否	确认入库录入单位id
products.input_unit_name	VARCHAR(32)	否	确认入库录入单位名称
products.wait_num	NUMERIC(20,8)	否	待入库数量
products.receive_num	NUMERIC(20,8)	否	确认入库数量
products.price	NUMERIC(20,2)	否	批发价
products.base_unit_id	INT8	否	商品基本单位id
products.base_unit_name	VARCHAR(32)	否	商品基本单位名称
products.base_wait_num	NUMERIC(20,8)	否	基本单位待入库数量
products.base_receive_num	NUMERIC(20,8)	否	基本单位确认入库数量
products.remark	VARCHAR(400)	否	行备注
products.exts	LIST	否	子表自定义字段
products.exts.ext_key	VARCHAR(4000)	否	自定义字段编码
products.exts.ext_value	VARCHAR(4000)	否	自定义字段值

# 其他入库单自定义字段修改

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/storehouseOtherIn/v1/modifyUseDefinedVal/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "receive_no": "FH20201110000001",
    "exts":[{
        "ext_key":"等级",
        "ext_value":"VIP"
    }],
    "products":[{
        "id":"20201110000001",
        "sequ":"1",
        "exts":[{
        	"ext_key":"商品等级",
        	"ext_value":"88VIP"
    	}]
    }]
}

说明：本示例仅供参考，具体以参数说明为准。

参数说明：

参数	类型	必填	说明
receive_no	VARCHAR(100)	是	其他入库单单号
exts	List		列表
exts.ext_key	VARCHAR(100)	是	入库单主数据扩展字段名称
exts.ext_value	VARCHAR(100)	是	入库单主数据扩展字段数据值
products	List		列表
products.id	VARCHAR(100)	是	入库单明细行id（id和行号必传一个）
products.sequ	VARCHAR(100)	是	入库单明细行行号（id和行号必传一个）
products.exts	List		入库单明细数据扩展字段列表
products.exts.ext_key	VARCHAR(100)	是	入库单明细数据扩展字段名称
products.exts.ext_value	VARCHAR(100)	是	入库单明细数据扩展字段数据值

响应示例：

{
	"msg_id": "X000001",
	"return_code": 1,
	"return_msg": "",
	"response_data": null
}

参数说明：

参数	类型	说明
msg_id	String	请求消息ID
return_code	int	响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg	String	响应说明
response_data	String	响应数据

← 经销商调货推送调拨单推送 →