通过此接口可展示位使用协议申请
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
supplierCode | String | Y | 10001369 | 供应商编码。供应商编码。 |
supplierBraComp | String | N | SEBJ | 供应商分公司代码。供应商支社代码。 |
supplierOffice | String | N | 北京,天津 | 供应商办事处。供应商办事处。支社对应办事处,可以同时输入多个办事处,逗号隔开。 |
snCode | String | Y | 1001 | 苏宁公司代码。乙方,费用发生的分公司代码,不允许填5400 |
supplierApplicationCode | String | Y | HDGZ20140125 | 供应商协议编号。供应商协议编号 |
expenseBudgetCode | String | N | 123456789 | 费用预算单号。供应商费用预算单号 |
areaCopCode | String | Y | 1001 | 活动区域。活动区域。如果活动区域为全国则为5400;如果活动是分区域的,不允许跨大区操作,只能是苏宁一个大区内的公司. 分公司多个的时候分公司别发送文件 |
contractDate | String | N | 2014-05-10 | 签订日期。年月日 |
contractCode | String | N | 12345 | 合同编号。合同编号 |
adProtocolCity | String | Y | 南京 | 城市。城市 |
adProtocolRode | String | Y | 上海路 | 路。路 |
adProtocolMarket | String | Y | 苏宁广场 | 商场。商场 |
adProtocolBuilding | String | Y | 5楼 | 楼。楼 |
adProtocolArea | String | Y | 200 | 面积。面积 |
startDate | String | Y | 2014-05-19 | 使用开始日期。开始日期不能大于结束日期 |
endDate | String | Y | 2014-05-29 | 使用结束日期。开始日期不能大于结束日期 |
paymentLittleMount | String | Y | 30000.00 | 使用费。小写,最多两位小数,分期合并金额必须等于合并总金额 |
firstMonthAmount | String | N | 10000.00 | 第一次支付金额。最多两位小数 |
secondPayMonth | String | N | 5 | 第二次支付月份。整数 |
nextMonthAmount | String | N | 10000.00 | 第二次支付金额。最多两位小数 |
lastPayMonth | String | N | 11 | 第三次支付月份。整数 |
lastMonthAmount | String | N | 10000.00 | 第三次支付金额。最多两位小数 |
settlementType | String | Y | 1 | 结算方式。1--电汇;3--从苏宁云商股份有限公司苏宁采购中心应付甲方的货款中扣减;; |
otherProtocol | String | N | 其他约定 | 其它约定。不超过400字符 |
htmlContent | String | Y | HTML内容。HTML内容。HTML ENCODE:UTF-8 | |
signNatureContent | String | N | qh2CXxZYkrmjljgfZxFaGFW | SIGNATURE 内容。签章密文。SIGNATURE ENCODE:UTF-8 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
applicationCode | String | 5400X0021405424424 | 活动函编号。5400X0021405424424 |
supplierApplicationCode | String | FYBJ14051603 | 供应商活动函编号。FYBJ14051603 |
resultFlag | String | Y | 成功标识。Y |
errorReason | String | 失败原因 | 失败原因 |
<sn_request> <sn_body> <applyProtocolApplication> <supplierCode>10000335</supplierCode> <supplierBraComp>SEBJ</supplierBraComp> <supplierOffice>北京,天津</supplierOffice> <snCode>5400</snCode> <supplierApplicationCode>FYBJ14061004</supplierApplicationCode> <expenseBudgetCode>123456789</expenseBudgetCode> <areaCopCode>1001</areaCopCode> <contractDate>2014-05-10</contractDate> <contractCode>12345</contractCode> <adProtocolCity>南京</adProtocolCity> <adProtocolRode>上海路</adProtocolRode> <adProtocolMarket>苏宁广场</adProtocolMarket> <adProtocolBuilding>5楼</adProtocolBuilding> <adProtocolArea>200</adProtocolArea> <startDate>2014-05-19</startDate> <endDate>2014-05-29</endDate> <paymentLittleMount>30000.00</paymentLittleMount> <firstMonthAmount>10000.00</firstMonthAmount> <secondPayMonth>5</secondPayMonth> <nextMonthAmount>10000.00</nextMonthAmount> <lastPayMonth>11</lastPayMonth> <lastMonthAmount>10000.00</lastMonthAmount> <settlementType>1</settlementType> <otherProtocol>其他约定</otherProtocol> <htmlContent>XHHGHHKJKKKKLGFHJRTIOOJBK...</htmlContent> <signNatureContent>XHHGHHKJKKKKLGFHJRTIOOJBK...</signNatureContent> </applyProtocolApplication> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "applyProtocolApplication": { "supplierCode": "10000335", "supplierBraComp": "SEBJ", "supplierOffice": "北京,天津", "snCode": "5400", "supplierApplicationCode": "FYBJ14061004", "expenseBudgetCode": "123456789", "areaCopCode": "1001", "contractDate": "2014-05-10", "contractCode": "12345", "adProtocolCity": "南京", "adProtocolRode": "上海路", "adProtocolMarket": "苏宁广场", "adProtocolBuilding": "5楼", "adProtocolArea": "200", "startDate": "2014-05-19", "endDate": "2014-05-29", "paymentLittleMount": "30000.00", "firstMonthAmount": "10000.00", "secondPayMonth": "5", "nextMonthAmount": "10000.00", "lastPayMonth": "11", "lastMonthAmount": "10000.00", "settlementType": "1", "otherProtocol": "其他约定", "htmlContent": "XHHGHHKJKKKKLGFHJRTIOOJBK...", "signNatureContent": "XHHGHHKJKKKKLGFHJRTIOOJBK..." } } } }
<sn_responseContent> <sn_body> <applyProtocolApplication> <applicationCode>5400X0021405424424</applicationCode> <supplierApplicationCode>FYBJ14051603</supplierApplicationCode> <resultFlag>Y</resultFlag> </applyProtocolApplication> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "applyProtocolApplication": { "applicationCode": "5400X0021405424424", "supplierApplicationCode": "FYBJ14051603", "resultFlag": "Y" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.selfmarket.addprotocol.missing-parameter:* | 缺少必填参数,*号用请求参数字段名替换 | 请输入正确参数。 |
biz.selfmarket.addprotocol.format-error:* | 格式错误, *号用请求参数字段名替换 | 请输入正确参数。 |
biz.selfmarket.invalid-biz:suppliercode | 供应商编码不存在 | 请输入正确参数。 |
isp.sys.service.unavailable.scs | 服务不可用(系统异常) | 请联系苏宁技术人员。 |
biz.selfmarket.addprotocol.invalid-biz:100 | 供应商编码由数字组成 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:101 | 供应商编码最大长度8 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:102 | 校验供应商分公司代码(supplierBraComp):是否是数值与字母 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:103 | 校验供应商分公司代码(supplierBraComp):最大长度20 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:104 | 校验供应商办事处(supplierOffice):计算DB2插入或查询字段长度最大长度为60 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:105 | 校验苏宁公司代码(snCode):校验字符串是否由数字组成 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:106 | 校验苏宁公司代码(snCode):最大长度为4 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:107 | 校验供应商协议编号(supplierApplicationCode):是否是数值与字母 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:108 | 校验供应商协议编号(supplierApplicationCode):最大长度为40 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:109 | 校验费用预算单号(expenseBudgetCode):是否是数值与字母 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:110 | 校验费用预算单号(expenseBudgetCode):最大长度45 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:111 | 校验活动区域(areaCopCode):校验字符串是否由数字组成 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:112 | 校验活动区域(areaCopCode):最大长度4 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:113 | 校验合同编号(contractCode):是否是数值与字母 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:114 | 校验合同编号(contractCode):最大长度30 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:115 | 校验城市信息(adProtocolCity):最大长度45 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:116 | 校验路信息(adProtocolRode):最大长度45 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:117 | 校验商场信息(adProtocolMarket):最大长度100 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:118 | 校验楼信息(adProtocolBuilding):最大长度45 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:119 | 校验面积信息(adProtocolArea):最大长度45 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:120 | 校验使用开始日期和使用结束日期大小,开始日期不能大于结束日期 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:121 | 校验使用费 (paymentLittleMount):校验价格类数据,只允许带1到2位小数 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:122 | 校验使用费 (paymentLittleMount):最大长度19 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:123 | 校验第一次支付金额(firstMonthAmount):校验价格类数据,只允许带1到2位小数,不允许负数 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:124 | 校验第一次支付金额(firstMonthAmount):最大长度19 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:125 | 校验第二次支付月份(secondPayMonth):校验月份信息,只允许1-12的整数 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:126 | 校验第二次支付金额(nextMonthAmount):校验价格类数据,只允许带1到2位小数,不允许负数 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:127 | 校验第二次支付金额(nextMonthAmount):最大长度19 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:128 | 校验第三次支付月份(lastPayMonth):校验月份信息,只允许1-12的整数 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:129 | 校验第三次支付金额(lastMonthAmount):校验价格类数据,只允许带1到2位小数,不允许负数 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:130 | 校验第三次支付金额(lastMonthAmount):最大长度19 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:131 | 校验结算方式(settlementType):结算方式只能为1或3 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:132 | 校验其他约定(otherProtocol):计算DB2插入或查询字段长度为400 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:134 | 签订日期格式错误 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:135 | 使用开始日期格式错误 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:136 | 使用结束日期格式错误 | 请输入正确参数。 |
biz.selfmarket.addprotocol.invalid-biz:137 | 供应商编码为空 | 请输入正确参数。 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |
Q:展示位使用协议申请接口如何使用?
A:通过此接口可展示位使用协议申请