API开放平台

TIP

客户其他出库单新增接口
客户其他出库单审批接口
客户其他出库单确认接口
客户其他出库单查询接口
其他出库单自定义字段修改
客户其他入库单新增接口
客户其他入库单审批接口
客户其他入库单确认接口
客户其他入库单红冲接口
客户其他入库单查询接口
客户其他入库单自定义字段修改

# 客户其他出库单新增接口

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/storehouseKHOtherOut/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)	否	单据编号。如果单据不存在则新增，已存在则修改。已出库的单据不能修改。生成“待出库”的客户其他出库单。
delivery_status	VARCHAR(32)	是	出库状态(“DQR”：待确认，“DCK”：待出库)
cm_id	VARCHAR(32)	是	客户id、客户编码、客户sourcecode必须传一个
cm_code	VARCHAR(100)	是	客户编码，客户id、客户编码、客户sourcecode必须传一个
cm_source_code	VARCHAR(100)	是	客户sourcecode，客户id、客户编码、客户sourcecode必须传一个
storehouse_code	VARCHAR(100)	是	仓库编号
date	VARCHAR(32)	是	业务日期，yyyy-mm-dd 格式
emp_id	VARCHAR(100)	是	经办人id
emp_code	VARCHAR(100)	是	经办人编码
emp_name	VARCHAR(100)	是	经办人名称
emp_source_code	VARCHAR(100)	否	经办人sourcecode
delivery_type_code	VARCHAR(32)	否	出库类型编码，新增时必填
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.input_unit_id	VARCHAR(32)	否	行单位id。行单位id和行单位名称必须传一个位
prods.input_unit_name	VARCHAR(100)	否	行单位名称。行单位id和行单位名称必须传一个
prods.sequ	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.qince.com/api/storehouseKHOtherOut/v1/approve/{openid}/{timestamp}/{digest}/{msg_id} 在线调试

请求示例：

{

}

参数说明：

参数	类型	必填	说明
id	VARCHAR(32)	否	单据id。如果单据不存在则新增，已存在则修改，不传自动生成。已入库的单据不能修改。
delivery_no	VARCHAR(32)	否	单据编号。如果单据不存在则新增，已存在则修改，不传自动生成。已入库的单据不能修改。
delivery_status	VARCHAR(32)	是	审批状态(“1”：审批通过，“2”：取消)
confirm_emp_code	VARCHAR(32)	是	审批人编码。审批人编码和sourcecode必传一个，优先级sourcecode ->code
confirm_emp_source_code	VARCHAR(32)	是	审批人sourcecode。审批人编码和sourcecode必传一个，优先级sourcecode -> 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.qince.com/api/storehouseKHOtherOut/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)	是	确认状态(“QR”：确认，“QX”：取消，“HC”：红冲)
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.qince.com/api/storehouseKHOtherOut/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条，可以根据业务数据的大小自行优化调整
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格式
deliveryEmpCode	VARCHAR(32)	否	出库人（作废人）编码
deliveryEmpSourceCode	VARCHAR(32)	否	出库人（作废人）sourcecode
deliveryTime	VARCHAR(32)	否	出库（作废）时间，yyyy-mm-dd hh24:mi:ss格式
details	List		列表
details.detailId	VARCHAR(32)	是	子表id
details.sequ	VARCHAR(32)	否	序号
details.productId	varchar(32)	否	商品id
details.productCode	varchar(100)	否	商品编码
details.productSourceCode	varchar(32)	否	商品sourcecode
details.inputUnit	VARCHAR(32)	否	行单位id
details.inputUnitName	VARCHAR(100)	否	行单位名称
details.confirmInputUnit	VARCHAR(32)	否	出库单位id
details.confirmUnitName	VARCHAR(100)	否	出库单位名称
details.waitNum	numeric(28,8)	否	待出库数量
details.num	numeric(28,8)	否	出库数量
details.price	numeric(28,2)	否	批发价
details.baseUnit	VARCHAR(32)	否	商品基本单位id
details.baseUnitName	VARCHAR(100)	否	商品基本单位名称
details.waitBaseUnitNum	numeric(28,8)	否	基本单位待出库数量
details.baseUnitNum	numeric(28,8)		基本单位出库数量
details.remark	TEXT	否	行备注
details.exts			子表自定义字段
details.exts.ext_key	VARCHAR(100)	否	自定义字段编码
details.exts.ext_value	VARCHAR(1000)	否	自定义字段值

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

请求方式： POST（HTTPS）
请求地址： https://openapi.qince.com/api/storehouseOtherOut/v1/modifyUserDefinedVal/{ 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.qince.com/api/storehouseKHOtherIn/v1/add/{openid}/{timestamp}/{digest}/{msg_id} 在线调试

请求示例：

{
    "receive_no": "12345",
      "cm_code": "DT00000002",
      "storehouse_code": "CK0184",
      "receive_type_code": "101",
      "date": "2023-11-01",
      "emp_code": "650",
      "remark": "This is a test remark.",
      "receive_status": "DQR",
      "products": [
        {
          "sequ": "001",
          "product_code": "01",
          "input_unit_name": "盒",
          "num": "100",
          "price": "10.99",
          "remark": "Product Remark"
        }
      ]
}

参数说明：

参数	类型	必填	说明
receive_no	VARCHAR(32)	否	单据编号。如果单据不存在则新增，已存在则修改，不传自动生成。已入库的单据不能修改。
cm_id	VARCHAR(32)	是	客户id、客户编码、客户sourcecode必须传一个
cm_code	VARCHAR(100)	是	客户编码，客户id、客户编码、客户sourcecode必须传一个
cm_source_code	VARCHAR(100)	是	客户sourcecode，客户id、客户编码、客户sourcecode必须传一个
storehouse_code	VARCHAR(32)	是	仓库编号
receive_type_code	VARCHAR(100)	是	入库类型编码（在入库类型设置中由用户设置）
date	VARCHAR(32)	是	业务日期，yyyy-mm-dd 格式
emp_code	VARCHAR(32)	否	经办人编码和经办人sourcecode必填其一。优先级：sourcecode -> code
emp_sourcecode	VARCHAR(32)	否	经办人sourcecode
remark	VARCHAR(400)	否	备注
receive_status	VARCHAR(32)	是	入库状态("DQR"：待确认，"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.qince.com/api/storehouseKHOtherIn/v1/approve/{openid}/{timestamp}/{digest}/{msg_id} 在线调试

请求示例：

{
  "receive_no": "123456",
  "approve_status": "APPROVE",
  "approve_emp_code": "650"
}

参数说明：

参数	类型	必填	说明
id	VARCHAR(32)	否	单据id。如果单据不存在则新增，已存在则修改，不传自动生成。已入库的单据不能修改。
receive_no	VARCHAR(32)	否	单据编号。如果单据不存在则新增，已存在则修改，不传自动生成。已入库的单据不能修改。
approve_status	VARCHAR(32)	是	审批状态(“APPROVE”：审批通过，“ABOLISH”：取消)
approve_emp_code	VARCHAR(32)	是	审批人编码。审批人编码和sourcecode必传一个，优先级sourcecode ->code
approve_emp_sourcecode	VARCHAR(32)	是	审批人sourcecode。审批人编码和sourcecode必传一个，优先级sourcecode -> 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.qince.com/api/storehouseKHOtherIn/v1/confirm/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

{
    "receive_no": "123456",
    "receive_status": "CONFIRM",
    "confirm_time": "2023-11-04 16:00:00",
    "confirm_the_whole_order": "N",
    "details_req_list": [
        {
         "id": "8937888455474145090",
         "sequ": 1,
         "unitName": "盒",
         "num": 90
        }
    ]
}

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

参数说明：

参数	类型	必填	说明
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.qince.com/api/storehouseKHOtherIn/v1/redflush/{openid}/{timestamp}/{digest}/{msg_id} 在线调试
请求示例：

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

参数说明：

参数	类型	必填	说明
receive_no	VARCHAR(100)	否	单据编号。单据ID和单据编码必须传入一个
id	VARCHAR(32)	否	单据ID。单据ID和单据编码必须传入一个
hc_emp_code	VARCHAR(32)	是	红冲人编码。红冲人编码和sourcecode必传一个，优先级sourcecode ->code
hc_emp_source_code	VARCHAR(32)	是	红冲人sourcecode。红冲人编码和sourcecode必传一个，优先级sourcecode -> 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.qince.com/api/storehouseKHOtherIn/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_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.qince.com/api/storehouseKHOtherIn/v1/modifyUserDefinedVal/{ 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	响应数据

← 客户库存推送客户其他入库推送 →