根据供应商编码查询采购订单信息,供应商编码必输,支持单个供应商
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
pageNo | String | N | 1 | 页码 |
pageSize | String | N | 10 | 每页条数 |
endDate | String | N | 2017-11-10 11:01:00 | 订单创建结束日期。查询交易创建结束时间。格式:yyyy-MM-dd 或 yyyy-MM-dd hh:mm:ss。时间范围为近30天内 |
orderCode | String | N | 4500075418 | 采购订单编码 |
orderStatus | String | N | 10 | 采购订单的状态。10-待确认及已确认订单 ,50-取消。该字段不输入的话默认获取所有状态的订单。 |
orderType | String | N | NB | 订单类型。采购订单类型。NB:标准采购订单,ZNB1:特价机采购订单,ZNB2:包销定制机采购订单,ZNB3:样机采购订单,ZNB4:工程机采购订单,ZNB5:赠品机采购订单,ZZO:行政用外部采购订单,ZCS1:材料采购订单,ZCS2:配件采购订单,ZCS3:零星采购订单,ZCS5:售后低值易耗品采购订单,ZCSS:配件,材料采购订单,ZZR:工程物资采购订单,ZCSR:材料,配件退货订单 |
startDate | String | N | 2014-04-01 10:00:00 | 订单创建开始日期。查询交易创建开始时间。格式:yyyy-MM-dd或yyyy-MM-dd hh:mm:ss |
supplierCode | String | Y | 10170001 | 单个供应商编码 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
orderHead | String | ||
coCode | String | 5006 | 苏宁公司代码。 |
orderCode | String | 4500075418 | 采购订单号 |
orderCreateDate | String | 2014-04-12 | 订单创建日期 |
orderStatus | String | 10 | 采购订单的状态。10-待确认订单, 30-已确认、40-(待确认+确认+部分收货) 、41-(待确认+部分收货)、42-(确认+部分收货)、50-取消 |
orderType | String | NB | 订单类型。采购订单类型 |
prePurchaseNo | String | 12000012 | 预采购订单号 |
purchaseCode | String | prs采购订单号 | prs采购订单号 |
supplierCode | String | 70057356 | 商户编码 |
planAutomaticPo | String | Y | 计划转采 |
rebateFlag | String | Y | 付款类型:Y-返利;A-授信;B-退换货;C-预付;D-账期 |
createBusinessType | String | 149 | 订单业务类型 |
orderDetail | String | ||
currencyUnit | String | CNY | 货币单位 |
oadocCode | String | CJJ201612190872640 | 合同框架号 |
deliveryDate | String | 2014-04-28 | 订单有效期。采购订单行项目的最晚交货日期 |
discountRate | String | 0.17 | 折扣率。 |
ean | String | 6945213504706 | EAN码。商品的EAN码 |
itemNo | String | 10 | 采购订单行号 |
itemStatus | String | 10 | 订单行状态 |
orderQty | String | 50 | 订单数量。采购的商品数量 |
sn | String | 1212121212 | 序列号。样机的序列号,样机采购订单专用 |
snProductCode | String | 120009121 | 苏宁商品编码 |
storeCode | String | DE11 | 地址。苏宁门店库,送货地址以此为准 |
subTotal | String | 500.50 | 合计金额。行项目的合计金额 |
supplierConfirm | String | X | 确认标识。null :不需要确认 X:需要确认 |
supplierProductCode | String | 124521 | 供应商商品编码 |
unit | String | 件 | 计量单位。 |
unitPrice | String | 40.50 | 含税单价。精确到小数点 |
purchaseItemCode | String | 1或10 | prs采购订单行号 |
productName | String | 空调 | 商品名称 |
plantName | String | 南京中心仓 | 地址名称 |
secondCateName | String | 卫浴电器 | 二级类目名称 |
pkgUnitName | String | 箱 | 采购单位 |
orderBoxQty | String | 2 | 订货箱数 |
boxRuleInfo | String | 12瓶/箱 | 箱规信息 |
externalEanCode | String | EN1000075418 | 商品条形码 |
coreProductLabel | String | X | X:表示核心单品 |
advOrderFlag | String | 1:预付款订单 ;空:非预付款订单 | 预付款标识 |
bindFlag | String | 绑定状态:0未绑定 1已绑定 | 0 |
<sn_request> <sn_body> <purchaseOrder> <orderType>NB</orderType> <endDate>2017-11-10 11:01:00</endDate> <pageNo>1</pageNo> <orderStatus>10</orderStatus> <pageSize>10</pageSize> <orderCode>4500075418</orderCode> <supplierCode>10170001</supplierCode> <startDate>2014-04-01 10:00:00</startDate> </purchaseOrder> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "purchaseOrder": { "orderType": "NB", "endDate": "2017-11-10 11:01:00", "pageNo": "1", "orderStatus": "10", "pageSize": "10", "orderCode": "4500075418", "supplierCode": "10170001", "startDate": "2014-04-01 10:00:00" } } } }
<sn_responseContent> <sn_head> <totalSize>1</totalSize> <pageTotal>1</pageTotal> <pageNo>1</pageNo> <returnMessage>biz.handler.data-get:success</returnMessage> </sn_head> <sn_body> <purchaseOrder> <orderDetail> <discountRate>0.17</discountRate> <secondCateName>卫浴电器</secondCateName> <externalEanCode>EN1000075418</externalEanCode> <itemNo>10</itemNo> <snProductCode>120009121</snProductCode> <subTotal>500.50</subTotal> <productName>空调</productName> <ean>6945213504706</ean> <itemStatus>10</itemStatus> <supplierConfirm>X</supplierConfirm> <oadocCode>CJJ201612190872640</oadocCode> <orderQty>50</orderQty> <purchaseItemCode>1或10</purchaseItemCode> <sn>1212121212</sn> <deliveryDate>2014-04-28</deliveryDate> <currencyUnit>CNY</currencyUnit> <unitPrice>40.50</unitPrice> <bindFlag>绑定状态:0未绑定 1已绑定</bindFlag> <unit>件</unit> <advOrderFlag>1:预付款订单 ;空:非预付款订单</advOrderFlag> <orderBoxQty>2</orderBoxQty> <coreProductLabel>X</coreProductLabel> <pkgUnitName>箱</pkgUnitName> <supplierProductCode>124521</supplierProductCode> <boxRuleInfo>12瓶/箱</boxRuleInfo> <plantName>南京中心仓</plantName> <storeCode>DE11</storeCode> </orderDetail> <orderHead> <orderType>NB</orderType> <orderCreateDate>2014-04-12</orderCreateDate> <purchaseCode>prs采购订单号</purchaseCode> <planAutomaticPo>Y</planAutomaticPo> <prePurchaseNo>12000012</prePurchaseNo> <createBusinessType>149</createBusinessType> <coCode>5006</coCode> <orderStatus>10</orderStatus> <rebateFlag>Y</rebateFlag> <orderCode>4500075418</orderCode> <supplierCode>70057356</supplierCode> </orderHead> </purchaseOrder> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_head": { "totalSize": "1", "pageTotal": "1", "pageNo": "1", "returnMessage": "biz.handler.data-get:success" }, "sn_body": { "purchaseOrder": [ { "orderDetail": [ { "discountRate": "0.17", "secondCateName": "卫浴电器", "externalEanCode": "EN1000075418", "itemNo": "10", "snProductCode": "120009121", "subTotal": "500.50", "productName": "空调", "ean": "6945213504706", "itemStatus": "10", "supplierConfirm": "X", "oadocCode": "CJJ201612190872640", "orderQty": "50", "purchaseItemCode": "1或10", "sn": "1212121212", "deliveryDate": "2014-04-28", "currencyUnit": "CNY", "unitPrice": "40.50", "bindFlag": "绑定状态:0未绑定 1已绑定", "unit": "件", "advOrderFlag": "1:预付款订单 ;空:非预付款订单", "orderBoxQty": "2", "coreProductLabel": "X", "pkgUnitName": "箱", "supplierProductCode": "124521", "boxRuleInfo": "12瓶/箱", "plantName": "南京中心仓", "storeCode": "DE11" } ], "orderHead": { "orderType": "NB", "orderCreateDate": "2014-04-12", "purchaseCode": "prs采购订单号", "planAutomaticPo": "Y", "prePurchaseNo": "12000012", "createBusinessType": "149", "coCode": "5006", "orderStatus": "10", "rebateFlag": "Y", "orderCode": "4500075418", "supplierCode": "70057356" } } ] } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.selfmarket.querypurchaseordersupplier.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.scpc | 服务不可用 | 请联系苏宁技术人员 |
biz.selfmarket.querypurchaseordersupplier.invalid-biz:100 | 日期跨度超过限制(30天) | 请输入正确参数 |
biz.selfmarket.querypurchaseordersupplier.invalid-biz:101 | 日期传输有误,开始日期和截止日期只传了一个或开始日期大于等于截止日期 | 请输入正确参数 |
biz.selfmarket.querypurchaseordersupplier.invalid-biz:102 | 订单状态无效。请检查传输的订单状态字段,目前只接收10、20、40、50几种状态。 | 请输入正确参数 |
biz.selfmarket.querypurchaseordersupplier.invalid-biz:103 | 商家编码非法(供应商编码不能为空且长度不能超过8位,多个编码以英文逗号分隔,不能超过10个) | 请输入正确参数 |
biz.selfmarket.querypurchaseordersupplier.invalid-biz:104 | 开始时间格式不正确 | 请输入正确参数 |
biz.selfmarket.querypurchaseordersupplier.invalid-biz:105 | 结束时间格式不正确 | 请输入正确参数 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |