文档
测试

1.1创建入库单

POST
https://api.jd.com/routerjson

接口描述

开发者可通过此接口添加采购入库单据

JOS开放平台官网说明:

[https://jos.jd.com/apilist?apiGroupId=138&apiId=13160&apiName=jingdong.eclp.po.addPoOrder](https://jos.jd.com/apilist?apiGroupId=138&apiId=13160&apiName=jingdong.eclp.po.addPoOrder)

采购单交互图(内外部系统)

![采购单交互图 1.png](https://cos.easydoc.net/48578360/files/kpqiuc5z.png)

数据格式及编码

```language Content_type:application/x-www-form-urlencoded Accept:application/json Charset:utf-8 ```

params公共参数:

参数名
类型
描述
必填
method
string
接口方法名,请填写"jingdong.eclp.po.addPoOrder"
必填
app_key
string
开发者应用app_key
必填
access_token
string
京东账户授权访问令牌码
必填
timestamp
string
请求时间(网关允许误差为10分钟), 示例:2020-09-23 12:23:45
必填
format
string
数据格式,固定值"json"
必填
v
string
接口版本号,固定值“2.0”
必填
sign_method
string
签名方式,可支持"md5"(默认),"hmacmd5","hmacsha256"
可选
sign
string
签名值。签名算法请参考https://easydoc.xyz/doc/85914950/QULSrw7u/EnnJTVOz
必填

Request Body应用级参数:

application/x-www-form-urlencoded
参数名
类型
描述
必填
360buy_param_json
object
业务系统参数
必填
deptNo
string(50)
eclp-事业部编码
必填
spPoOrderNo
string(50)
ISV/商家-入库单号(幂等键,商家自定义)
必填
poType
string(4)
采购单类型【1-普通采购单,默认值; 3-全球购采购单; 4-直邮采购单】
可选
bizType
string(4)
业务类型(1-采购;2-门店调拨;3-门店退货入库;9-调拨;10-转储入;12-普通调拨入;13-待确定)
可选
supplierNo
string(50)
eclp-供应商编号
必填
whNo
string(100)
eclp-申请入库库房编号
必填
receiveLevel
string
eclp-收货等级(1-按商家指定商品等级收货 2-按实物商品等级收货)
可选
orderMark
string(50)
采购单标记位
可选
allowLackFlag
string
是否允许缺量入库(0-否;1-是)
可选
isUpdate
string
是否允许修改采购单(0-否;1-是)
可选
acceptUnQcFlag
string(4)
是否支持不合格验收(0-不支持 1-支持)
可选
unitFlag
string
是否集单标识(0-否;1-是)
可选
multiReceivingFlag
string
是否分批次收货(0-否 1-是)
可选
entirePrice
string(20)
采购单金额合计(元)
可选
poReturnMode
number
wms库存回传eclp节点(1-采购单验收关单回传,2-wms容器内商品上架后回传)
可选
inboundRemark
string(200)
采购单备注
可选
boxFlag
string(4)
是否按箱收货(0-否 1-是)
可选
waitBoxDetailFlag
string
按箱收货--等待箱明细标识(0-否;1-是)
可选
boxNo
string[]
按箱收货--箱号,多个箱号用英文逗号分隔,箱内商品信息以逗号的顺序对应,每个箱号长度不可超过100字符
可选
boxGoodsNo
string[]
按箱收货--箱内eclp商品编号
可选
boxIsvGoodsNo
string[]
按箱收货--箱内isv/商家侧商品编号
可选
boxGoodsQty
number[]
按箱收货--箱号内商品申请入库数量
可选
boxSerialNo
string[]
按箱收货--箱内商品序列号段
可选
deptGoodsNo
string[]
申请入库商品明细--京东商品编码
必填
orderLine
string[]
申请入库商品明细--商家系统行号
可选
isvGoodsNo
string[]
申请入库商品明细--商家商品编码
必填
numApplication
number[]
申请入库商品明细--申请入库数量
必填
goodsStatus
string[]
申请入库商品明细--商品等级
可选
goodsPrice
number[]
申请入库商品明细--商品单价(元,精度为小数点后2位)
可选
unitPrice
string[]
【医药专用】申请入库商品明细--商品单价
可选
totalPrice
string[]
申请入库商品明细----商品总价(商品单价*入库数量)
可选
barCodeType
string[]
申请入库商品明细--申请贴码服务(1-申请贴码 2-商家自贴)
可选
sidCheckout
string[]
申请入库商品明细--入库是否校验序列号(0-否 1-是)
可选
checkLotattrs
string[]
申请入库商品明细--是否验证验收采集(预留功能,暂未启用)
可选
qualityCheckRate
string[]
申请入库商品明细--商品入库质检比例(大件专用,0-100整数)
可选
batAttrListJson
string[]
申请入库商品明细--商品批属性值,枚举:packageBatchNo(包装批号) productionDate(生产日期) expirationDate(到期日期) lot(批次号), poNo(采购单号), supplier(供应商),receiveDate(收货日期),plu(plu管理),logisticCompany(物流公司),originProArea(原产地),manufacturer(制造商),boxNo(箱号),nosale(不可售),gysgL(供应商管理),store(门店),qualityState(质量状态),isBusinessPo(商家采购单号) ;示例:
可选
isvLotattrs
string[]
申请入库商品明细--批属性(物流云专用)
可选
serialDetailMapJson
string
序列号清单json串,示例:{'EMG4418079539823':'358802094981047_$_358802094688725'_$_'EMG4418081437322':'357393096230832'},注意:在正式调用的时,把 单引号 改为 反斜杠+双引号。同一sku只能使用清单或号段
可选
serialNoScopeMapJson
string
序列号号段json串,格式:前缀_#_开始序列号_#_结束序列号,示例:{'EMG4418079539823':'ABC_#_ABC0008_#_ABC0010_$_DFG_#_DFG001_#_DFG010'_$_'EMG4418081437322':'PEX_#_PEX10_#_PEX11'},注意:在正式调用的时,把 单引号 改为 反斜杠+双引号。
可选

Response响应参数:

application/json
参数名
类型
描述
必填
jingdong_eclp_po_addPoOrder_responce
object
数据字典
必填
code
string
网关响应结果码(0-成功;)
必填
poOrderNo
string
eclp系统--采购入库单号
必填

请求示例

`url示例:` --- > https://api.jd.com/routerjson?method=jingdong.eclp.po.addPoOrder&app_key=**++{{app_key值}}++**&access_token=**++{{access_token值}}++**& timestamp=**++{{请求时间}}++**&format=json&v=2.0&sign_method=**md5**&sign=**++{{签名值}}++** `Request Body示例:` --- ```json 360buy_param_json={ "deptNo":"EBU4418046670139", //事业部编码 "poType":"1", //采购单类型(1-普通采购单 3-全球购采购单 4-直邮采购单) "spPoOrderNo":"123456", //商家侧采购单号 "bizType":"1", //业务场景(1-采购;2-门店调拨;3-门店退货入库;9-调拨;10-转储入;12-普通调拨入;13-待确定) "whNo":"110000180", //京东库房编码 "supplierNo":"EMS4418047652673", //京东eclp系统-供应商编码 "receiveLevel":"2", //商品收货等级(1-按商家指定商品等级收货 2-按实际商品等级收货) "allowLackFlag":"1", //是否允许商品缺量入库(0-否;1-是) "multiReceivingFlag":"0", //是否分批次收货(0-否 1-是) "inboundRemark":"采购单测试备注", //采购单备注 "entirePrice":"10000", //采购单商品价格合计(元) "deptGoodsNo":"EMG4418126614172,EMG4418124253043", //申请入库商品编码(京东eclp系统-商品资料编码) "numApplication":"100,200", //申请入库数量 "goodsStatus":"1,1", //申请入库商品等级(1-良品 2-残品 3-样品) "goodsPrice":"2,3", //商品单价 "totalPrice":"200,600", //商品总价=单价*入库数量 "barCodeType":"2,2", //商品代贴条码(1-申请贴码 2-商家自贴) "sidCheckout":"0,0", //商品入库是否校验序列号(0-否 1-是) "batAttrListJson":"[{\"batchKey\":\"lot\"_$_\"batchValue\":\"2113018010\"}], [{\"batchKey\":\"lot\"_$_\"batchValue\":\"2113018020\"}]" //sku指定商品批属性入库,batchkey代表批属性键,batchValue代表批属性值 } ```

响应示例

`Response示例:` --- ```json { "jingdong_eclp_po_addPoOrder_responce": { "code": "0", //网关响应码 "poOrderNo": "EPL4418054386713" //京东eclp系统-采购入库单号 } } ```