java三级审核_技术文档

l  接口名称

jingdong.po.list.page.get

l  功能说明

根据条件分页查询采购单列表(至多支持100条)

l API用户授权类型

需要

l 系统级别输入参数

名称 类型 是否必须 描述

method String 是 API接口名称

access_token String 是 采用OAuth授权方式为必填参数

app_key String 是 应用的app_key

sign String 是 签名

timestamp String 是 时间戳，格式为yyyy-MM-dd HH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

format String 否 暂时只支持json

v String 否 API协议版本，可选值:2.0

l  应用级输入参数

名称 类型 是否必须 示例值 描述

deliverCenterId Number 否 订购城市(3,上海 4,成都 5,武汉 6,北京 7,南京 8, 济南 9,沈阳 10,广州 316,西安 322, 福州 545, 杭州 601,天津 603,深圳 605,重庆 606,苏州 607,宁波 608,郑州 609,厦门 610,青岛 614,石家庄 615,太原 616,南宁 617,哈尔滨 618,大连 619,长沙 625,EPT配送中心628,兰州 629,包头 630,乌鲁木齐 631,合肥 632,宿迁 633,昆明 634,贵阳 636,长春 644,佛山 648,烟台)

status Number 否 是否删除(0:删除 1：正常)

createdDateStart Date 否 2013-12-26 16:09:07 创建日期-开始时间

createdDateEnd Date 否 2013-12-26 16:09:10 创建日期-结束时间

isEptCustomized Boolean 否 true 是否定制(不填:全部 false：EPT非定制 true：EPT定制)

pageIndex Number 是 1 当前页码(从1开始)

pageSize Number 是 50 每页大小(最大支持100)

orderIds Number[] 否 1016886,575391 采购订单编号列表(不填默认全部)

wareIds Number[] 否 1000248,1000247 商品编号列表(不填默认全部)

states Number[] 否 0,2 采购单状态列表(不填默认全部 0：新采购单；2：等待入库；3：已完成 ；5：等待摆货；6：等待审核；7：审核不通过；8：等待签收；10：等待经理审核；11：等待经理审核；12：等待总监审核；15：待确认；16：暂停 订单)

confirmStates Number[] 否 1,2,3 回告状态列表(不填默认全部 0：未确认；1：回告成功；2：回告中；3：回告失败)

orderAttributes Number[] 否 1,2,3 订单属性列表(不填默认全部 (1:新品订单、2:手工补货单、3:自动补货单、4:问题区补单 5：有单备货单、6：自动补货补给单、7：手工下单补给单、8：新品订单补给单、9：有单备货补给单)

返回结果

名称 类型 示例值 描述

orderResultDto OrderResultDto 采购单列表查询结果

OrderResultDto 属性名称 类型 是否必须 示例值 描述

recordCount Number 否 总记录数

totalPage Number 否 总页数

purchaseOrderList PurchaseOrderDto[] 否 采购单列表

PurchaseOrderDto 属性名称 类型 是否必须 示例值 描述

orderId Number 否 订单号

createdDate Date 否 创建时间

completeDate Date 否 完成日期(订单完成后，才有更新时间)

providerCode String 否 供应商简码

providerName String 否 供应商在京东注册名称

deliverCenterId Number 否 配送中心编号

deliverCenterName String 否 供应商在京东注册名称

totalPrices Number 否 订单总金额

purchaserErpCode String 否 采销员ERPCODE

purchaserName String 否 采销员姓名

isCanConfirm Boolean 否 是否能回告(true表示能回告，false表示不能回告)

status Number 否 是否删除标志

statusName String 否 是否删除标志名称

accountPeriod Number 否 账期

ou String 否 供应商结算主体

ynPaid String 否 是否付款

ynContainTax String 否 是否含税

chargeTransit String 否 承担运费

transitType String 否 运送方式

arrivalDays Number 否 预计到达天数

checkType Number 否 票款方式

checkTypeName String 否 票款方式名称

deliveryAddress String 否 送货地点

receiverName String 否 收货人姓名

warehousePhone String 否 收货库房电话

address String 否 收货详细地址

purchaseType Number 否 采购类型ID(0：正常 1：特价产品 2：季节性产品 3：尾货产品 4：其它)

purchaseTypeName String 否 采购类型名称

orderType Number 否 采购类型ID( 0：正常采购单 1：虚拟采购单 2：厂商直送 1000：POP采购单 2000：EPT定制 2001：EPT非定制 3000：自动采购单)

orderTypeName String 否 采购类型名称

orderAttribute Number 否 订单属性(1:新品订单、2:手工补货单、3:自动补货单、4:问题区补单 5：有单备货单、6：自动补货补给单、7：手工下单补给单、8：新品订单补给单、9：有单备货补给单)

orderAttributeName String 否 订单属性名称

originalTotalNum Number 否 采购总数量

wareVariety Number 否 商品品种数

customOrderId Number 否 顾客单号

confirmState Number 否 回告状态 (0：未确认；1：回告成功；2：回告中；3：回告失败)

confirmStateName String 否 回告状态名称

state Number 否 采购单状态

stateName String 否 采购单状态名称

l  返回示例

JSON数据格式{

"jingdong_po_list_page_get_response": {

"orderResultDto": {

"recordCount": "",

"pageSize": "",

"totalPage": "",

"purchaseOrderList": [

{

"purchaseOrderDto": {

"confirmStateName": "",

"ynPaid": "",

"purchaseTypeName": "",

"statusName": "",

"state": "",

"totalPrices": "",

"purchaserErpCode": "",

"completeDate": "",

"checkTypeName": "",

"confirmState": "",

"receiverName": "",

"ynContainTax": "",

"createdDate": "",

"checkType": "",

"orderTypeName": "",

"orderId": "",

"isCanConfirm": "",

"ou": "",

"purchaserName": "",

"orderType": "",

"status": "",

"transitType": "",

"purchaseType": "",

"arrivalDays": "",

"warehousePhone": "",

"deliverCenterName": "",

"customOrderId": "",

"providerCode": "",

"orderAttribute": "",

"address": "",

"providerName": "",

"stateName": "",

"orderAttributeName": "",

"wareVariety": "",

"chargeTransit": "",

"originalTotalNum": "",

"accountPeriod": "",

"deliverCenterId": "",

"deliveryAddress": ""

}

}

],

"pageIndex": ""

}

}

}

l 错误码错误码 错误描述 解决方案

500 服务器端异常

501 校验数据类型异常

502 (采购单绑定的采销员不存在,采销员简码为：test；该商品不属于该供应商，商品编号为：123456；该用户没有回告权限等) 根据返回的异常信息调整数据，如果还未来解决，请联系对应的采购员解

l  SDK调用示例(java)

public JdClient client=new DefaultJdClient(SERVER_URL,accessToken,appKey,appSecret);

PoListPageGetRequest request=new PoListPageGetRequest();

request.setDeliverCenterId( 123 );

request.setStatus( 123 );

request.setCreatedDateStart( "2012-12-12 12:12:12" );

request.setCreatedDateEnd( "2012-12-12 12:12:12" );

request.setIsEptCustomized( true );

request.setPageIndex( 123 );

request.setPageSize( 123 );

request.setOrderIds( "123,234,345" );

request.setWareIds( "123,234,345" );

request.setStates( "123,234,345" );

request.setConfirmStates( "123,234,345" );

request.setOrderAttributes( "123,234,345" );

PoListPageGetResponse response=client.execute(request);