供应商通过直连API接口,将促销活动函内容发送给苏宁系统,苏宁系统接受后,返回给供应商申请结果。
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 10138968 | 供应商编码,必填,只能输入一个。 |
settleCompanyCode | String | Y | 1002 | 苏宁结算开票公司 |
supplierApplicationCode | String | Y | HDIC180622599 | 供应商函件编码,必填,只能输入一个。 |
expenseBudgetCode | String | N | 91320115249801110621 | 费用预算单号 |
areaCompanyCode | String | Y | 5400 | 活动区域管理公司,必填,只能输入一个。 |
activityType | String | Y | 1 | 活动类型 1:满减, 2:券 |
activityStartTime | String | Y | 2024-01-01 00:00:00 | 活动开始时间 |
activityEndTime | String | Y | 2024-01-31 23:59:59 | 活动结束时间 |
couponsStartTime | String | N | 2024-01-01 00:00:00 | 券使用开始时间 |
couponsEndTime | String | N | 2024-01-31 23:59:59 | 券使用结束时间 |
factoryAssumeScale | String | N | 0.67 | 供应商承担比例 |
applyLevel | String | Y | 01 | 生成层次 01:全国, 03:城市, 04:门店 |
expandingChannels | String | Y | 50 | 渠道 50:50易购, 10:10门店, 多个之间使用英文逗号分隔 |
actionDescribe | String | N | 活动描述 | 活动描述 |
settlementType | String | Y | S04 | 结算方式 S04:国税票现汇(电汇), S05:国税票转货款, S01:红发票, S06:供应商发票折扣, S07:折让现汇 |
invoiceContent | String | N | 01 | 开票内容:适用于结算方式【S04-国税票现汇(电汇)】&【S05-国税票转货款】,01-补差;02-销售补差;03-折扣 |
lastPayDate | String | Y | 2024-02-29 | 支付时间 |
pdfContent | String | Y | JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggMTM4MS9GaWx0ZXIvRmxhdGVEZWN | PDF内容:base64字符串 |
cityShopList | String | N | ||
cityCode | String | N | 000001000000 | 生效层次为全国时,填写【ALL】;生效层次为城市&门店时,填写城市代码。 |
shopCode | String | N | 9ABL | 生效层次为城市&全国时,填写【ALL】;生效层次为门店时,填写门店代码 |
activityDetailList | String | N | ||
promotionList | String | N | ||
levelId | String | Y | 1 | 层级ID,数字1~10,依次递增 |
activityMode | String | Y | 02 | 活动方式 09:每元用券, 08:满元用券, 10:无门槛券, 02:每元减元, 01:满元减元. 活动类型为1时, 对应选项01,02; 活动类型为2时, 对应选项09,08,10 |
bounsLimit | String | N | 400.00 | 优惠门槛(元),正数,最多保留两位小数 |
bounsAmount | String | Y | 20.00 | 补贴金额(元),正数,最多保留两位小数 |
singleMaxRewardAmount | String | N | 100.00 | 最大优惠金额,正数,最多保留两位小数 |
commodityList | String | N | ||
commodityCode | String | N | 102271946 | 商品编码 |
brandCode | String | N | D396 | 品牌编码 |
comments | String | N | 备注 | 备注 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
applicationCode | String | 540020210804172500 | 函件编码 |
supplierApplicationCode | String | HDIC2024022307 | 供应商函件编码 |
<sn_request> <sn_body> <createApplycuxiao> <settlementType>S04</settlementType> <areaCompanyCode>5400</areaCompanyCode> <invoiceContent>01</invoiceContent> <pdfContent>JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggMTM4MS9GaWx0ZXIvRmxhdGVEZWN</pdfContent> <settleCompanyCode>1002</settleCompanyCode> <activityStartTime>2024-01-01 00:00:00</activityStartTime> <expenseBudgetCode>91320115249801110621</expenseBudgetCode> <supplierCode>10138968</supplierCode> <actionDescribe>活动描述</actionDescribe> <couponsStartTime>2024-01-01 00:00:00</couponsStartTime> <factoryAssumeScale>0.67</factoryAssumeScale> <supplierApplicationCode>HDIC180622599</supplierApplicationCode> <activityEndTime>2024-01-31 23:59:59</activityEndTime> <applyLevel>01</applyLevel> <activityDetailList> <commodityList> <comments>备注</comments> <commodityCode>102271946</commodityCode> <brandCode>D396</brandCode> </commodityList> <promotionList> <activityMode>02</activityMode> <bounsLimit>400.00</bounsLimit> <singleMaxRewardAmount>100.00</singleMaxRewardAmount> <levelId>1</levelId> <bounsAmount>20.00</bounsAmount> </promotionList> </activityDetailList> <lastPayDate>2024-02-29</lastPayDate> <expandingChannels>50</expandingChannels> <activityType>1</activityType> <couponsEndTime>2024-01-31 23:59:59</couponsEndTime> <cityShopList> <shopCode>9ABL</shopCode> <cityCode>000001000000</cityCode> </cityShopList> </createApplycuxiao> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "createApplycuxiao": { "settlementType": "S04", "areaCompanyCode": "5400", "invoiceContent": "01", "pdfContent": "JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggMTM4MS9GaWx0ZXIvRmxhdGVEZWN", "settleCompanyCode": "1002", "activityStartTime": "2024-01-01 00:00:00", "expenseBudgetCode": "91320115249801110621", "supplierCode": "10138968", "actionDescribe": "活动描述", "couponsStartTime": "2024-01-01 00:00:00", "factoryAssumeScale": "0.67", "supplierApplicationCode": "HDIC180622599", "activityEndTime": "2024-01-31 23:59:59", "applyLevel": "01", "activityDetailList": [ { "commodityList": [ { "comments": "备注", "commodityCode": "102271946", "brandCode": "D396" } ], "promotionList": [ { "activityMode": "02", "bounsLimit": "400.00", "singleMaxRewardAmount": "100.00", "levelId": "1", "bounsAmount": "20.00" } ] } ], "lastPayDate": "2024-02-29", "expandingChannels": "50", "activityType": "1", "couponsEndTime": "2024-01-31 23:59:59", "cityShopList": [ { "shopCode": "9ABL", "cityCode": "000001000000" } ] } } } }
<sn_responseContent> <sn_body> <createApplycuxiao> <supplierApplicationCode>HDIC2024022307</supplierApplicationCode> <applicationCode>540020210804172500</applicationCode> </createApplycuxiao> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "createApplycuxiao": { "supplierApplicationCode": "HDIC2024022307", "applicationCode": "540020210804172500" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.selfmarket.createapplycuxiao.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.selfmarket.createapplycuxiao.length-overlong:* | 参数的值超过规定长度 | 请检查此参数的值,*号表示参数字段名 |
isp.sys.service.unavailable.sbc | 服务不可用 | 请联系苏宁技术人员 |
biz.selfmarket.createapplycuxiao.invalid-biz:100 | 供应商编码不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:101 | 苏宁结算开票公司不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:102 | 活动区域管理公司不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:103 | 活动类型不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:104 | 活动时间不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:105 | 活动结束时间不得早于活动开始时间 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:106 | 活动开始时间与活动结束时间的间隔不得超过30天 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:107 | 活动开始时间不得早于系统当前时间 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:108 | 券使用时间不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:109 | 券使用结束时间不得早于券使用开始时间 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:110 | 券使用开始时间不得早于活动开始时间 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:111 | 券使用结束时间不得晚于活动结束时间 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:112 | 供应商承担比例必须输入0.67~1.00之间的两位小数(包含0.67与1.00) | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:113 | 生成层次不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:114 | 活动类型为满减时,生成层次不能选择门店 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:115 | 渠道不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:116 | 活动类型为满减时,渠道只能选择50易购 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:117 | 生成层次为门店时,渠道只能选择10门店 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:118 | 结算方式不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:119 | 开票内容不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:120 | 支付日期不能早于活动开始日期 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:121 | 支付日期不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:122 | 支付日期不能晚于活动结束日期后30天 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:123 | 活动明细集合为空 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:124 | 活动信息集合为空 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:125 | 商品品牌集合为空 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:126 | 活动方式不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:127 | 每元减元或每元用券或无门槛券只能维护1个层级 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:128 | 一个活动明细只能维护一种活动方式 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:129 | 满元用券或满元减元最多可以维护10个层级 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:130 | 优惠门槛金额不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:131 | 补贴金额不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:132 | 补贴金额大于优惠门槛金额 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:133 | 最大优惠金额不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:134 | 最大优惠金额小于补贴金额 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:135 | 最大优惠金额大于优惠门槛金额 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:136 | 层级ID不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:137 | N+1层优惠门槛金额需大于N层优惠门槛金额 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:138 | N+1层补贴金额需大于N层补贴金额 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:139 | 商品明细最多可以添加100条 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:140 | 商品编码或品牌编码,二者必填其一 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:141 | 商品编码重复 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:142 | 品牌编码重复 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:143 | 商品明细列品牌编码、商品编码不能同时存在 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:144 | 商品编码不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:145 | 品牌编码不存在或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:146 | 签章文件为空 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:147 | 供应商主数据品类不存在 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:148 | 活动明细最多可以添加10条 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:149 | 保存签章文件失败 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:150 | 城市门店集合为空 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:151 | 生成层次为全国时,只能选择全部城市、全部门店 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:152 | 城市编码为空或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:153 | 门店编码为空或格式错误 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:154 | 城市编码重复 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:155 | 城市编码和门店编码不存在 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:156 | 城市编码和门店编码重复 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:157 | 保存促销活动函数据失败 | 请联系苏宁技术 |
biz.selfmarket.createapplycuxiao.invalid-biz:158 | 供应商活动函编码只能为数字或字母,长度不得超过 | 请输入正确参数 |
biz.selfmarket.createapplycuxiao.invalid-biz:159 | 供应商活动函编号苏宁系统已存在 | 请输入正确参数 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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位 |