API文档

wms.stockin.Purchase.quickCreateByApi(快速采购入库单创建接口)

¥标准

1.接口说明

1.1 接口描述：创建快速采购入库单，同时创建并关联采购单。

1.2 适用版本：V1.6.1.9

1.3 注意事项：【仓库权限】

2.调用场景

2.1 举例说明：快速创建采购类型入库单，无需前置创建采购单

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	http://47.92.239.46/openapi
正式环境	http://wdt.wangdian.cn/openapi

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	sid	String	是	卖家账号, 由旺店通分配
接口账号	key	String	是	由旺店通分配appkey, 在发送的数据中对应 key 字段
盐	salt	String	是	由旺店通分配appsecret，是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt.
接口名称	method	String	是	调用的接口名称
版本号	v	String	是	1.0
秒级时间戳	timestamp	Int	是	秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名	sign	String	是	签名
分页大小	page_size	Int	否	分页大小，分页查询必传
分页编号	page_no	Int	否	分页编号，分页查询必传，标准接口page_no从0开始
是否计算查询结果的总条数	calc_total	Int	否	是否计算查询结果的总条数, 需要计算则1, 否则填0

3.3 业务请求参数

名称	字段	类型	长度	是否必须	描述
主单信息	orderInfo	Map<String, Object>	-	Y	采购入库单主单信息。
入库明细	orderDetailList	List<Map<String, Object>>	-	Y
唯一码列表	scCodeList	List	-	Y	已在系统中维护的唯一码列表；没有唯一码时传空数组。

orderInfo

名称	字段	类型	长度	是否必须	描述
仓库编码	warehouse_no	String	-	Y	ERP 内部仓库编码。系统会校验当前调用账号的仓库权限。
供应商编码	provider_no	String	-	Y	供应商编码。供应商必须存在、未停用且未删除。
采购员姓名	purchaser_name	String	-	N	采购员姓名，系统按员工简称匹配。purchaser_no同时传时优先使用 purchaser_name。
采购员编号	purchaser_no	String	-	N	采购员员工编号。仅在 purchaser_name 为空时使用
操作类型	oper_type	Integer	-	N	0：保存；1：提交；2：提交并审核。默认值为 0。
物流公司编码	logistics_code	String	-	N	系统物流公司编码。物流公司必须存在且为采购类型。
物流单号	logistics_no	String	40	N	采购入库物流单号，最长 40 个字符。
联系人	contact	String	-	N	联系人
联系电话	telno	String	-	N	联系电话
收货地址	receive_address	String	-	N	收货地址
其它金额	other_fee	Decimal	-	N	默认值为 0，必须为非负数。
邮资	post_fee	Decimal	-	N	默认值为 0，必须为非负数。
标记名称	flag_name	String	-	N	采购单标记名称。只能使用未停用的非内置采购标记。
单据备注	remark	String	255	N	采购入库单备注，最长 255 个字符。

orderDetailList

名称	字段	类型	长度	是否必须	描述
商家编码	spec_no	String	-	Y	货品商家编码。系统根据该编码匹配未删除的单品。
入库数量	num	Decimal(19,4)	-	Y	入库数量
是否残次品	defect	Boolean	-	N	是否按残次品入库，默认值为 false。
实际重量	actual_weight	Decimal	-	N	实际重量，默认值为 0，必须为非负数。
基本采购价	purchase_price	Decimal	-	N	基本单位采购价。与 unit_price、purchase_amount 同时传入时优先级最高；空字符串和 null 视为未传，显式 0 保留。
辅助采购价	unit_price	Decimal	-	N	辅助单位采购价。未传 purchase_price 时按换算系数反算基本采购价和总采购价。
总采购价	purchase_amount	Decimal	-	N	当前明细总采购价。未传前两个价格字段且数量不为 0 时按数量反算基本采购价和辅助采购价
批次号	batch_no	String	-	N	货品批次号。批次存在时使用已有批次；批次不存在时由接口自动创建。
货位编码	position_no	String	-	N	当前仓库的货位编码。传值时必须能匹配该仓库的有效货位。
辅助单位名称	unit_name	String	-	N	辅助单位名称
生产日期	production_date	String	-	N	支持 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss、yyyy/MM/dd 格式。
有效期	expire_date	String	-	N	支持 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss、yyyy/MM/dd 格式。
保质期	validity_days	Integer	-	N	保质期天数或月数，取货品配置值为默认值；只允许整数 0 至 30000，1.0 可传，1.5 不可传。
明细备注	remark	String	255	N	货品明细备注。
序列号	sn_list	List<String>		N	序列号信息

4.响应参数

名称	字段	类型	是否必填	描述
状态码	status	Integer	Y	0 表示请求处理成功；其他值表示请求级异常。
返回信息	message	String	N	成功时通常为 ok；异常时返回具体错误信息。
响应正文	data	Integer	N	新建采购入库单的 stockin_id。

5.请求示例

Json	[ { "warehouse_no": "WH001", "provider_no": "SUP001", "purchaser_no": "EMP001", "oper_type": 2, "logistics_code": "LOG001", "logistics_no": "PO202607300001", "flag_name": "正常采购", "remark": "供应商到货入库" }, [ { "spec_no": "SKU001", "num": 10, "defect": false, "purchase_price": 12.5, "batch_no": "B20260730", "position_no": "A-01-01", "unit_name": "无", "production_date": "2026-07-29", "expire_date": "2027-07-29", "remark": "首批到货" } ], [] ]
PHP
JAVA
C#
CURL	curl --location 'http://47.92.239.46/openapi?key=wdtapi3-test9&method=wms.stockin.Purchase.quickCreateByApi&salt=136787110023126585465b366becff09&sid=wdtapi3&timestamp=461091552&v=1.0&sign=a4256b75d9d722d76f3140201bda2cde' \ --header 'Content-Type: application/json' \ --data '[ { "warehouse_no": "WH001", "provider_no": "SUP001", "purchaser_no": "EMP001", "oper_type": 2, "logistics_code": "LOG001", "logistics_no": "PO202607300001", "flag_name": "正常采购", "remark": "供应商到货入库" }, [ { "spec_no": "SKU001", "num": 10, "defect": false, "purchase_price": 12.5, "batch_no": "B20260730", "position_no": "A-01-01", "unit_name": "无", "production_date": "2026-07-29", "expire_date": "2027-07-29", "remark": "首批到货" } ], [] ]'

6.响应示例

6.1 正常响应示例

JSON	{ "status": 0, "message": "ok", "data": 123456 }

6.2 异常响应示例

JSON	{ "status": 100, "message": "商家编码为 SKU001 的单品不存在或已删除" }