通过此接口可销售补差确认函申请
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 5400 | 苏宁公司代码。 |
supplierApplicationCode | String | Y | 供应商确认函编号。 | |
productBrand | String | Y | 000027982 | 品牌代码。多个品牌以英文逗号隔开 |
expenseBudgetCode | String | N | 123456789 | 费用预算单号。供应商费用预算单号 |
areaCopCode | String | Y | 1001 | 活动区域。活动区域。如果活动区域为全国则为5400;如果活动是分区域的,不允许跨大区操作,只能是苏宁一个大区内的公司. 分公司多个的时候分公司别发送文件 |
startDate | String | Y | 2014-06-05 | 销售开始日期。开始日期不能大于结束日期 |
endDate | String | Y | 2-14-06-10 | 销售结束日期。开始日期不能大于结束日期 |
discountLittleMount | String | Y | 43.90 | 销售补差金额。小写,不超过两位小数 |
settlementType | String | Y | 1 | 结算方式。1--贵司开出国税普通销售发票给我司,我司在约定的支付时间前以: 方式支付给贵司;①开票日期: ;②开票内容: ;相应电汇款项我司将在约定的支付日期前予以电汇,相应转款款项贵司可在发票开出后最近一个账期的结算清单的货款中扣除。 2--我司出具折让证明,贵司办理“开具红字增值税专用发票通知单”,我司在约定支付时间前开红票给贵司,我司在开给贵司的红票上备注:红字通知单号码。3--我司在约定的支付时间前,在进货发票中以销售折让方式支付给贵司,并在我司开给贵司的增值税发票上备注费用对账单号码。注:A方式中,支付方式下拉框初始默认----,其余选项包含2个:电汇、转款,当选择转款时,支付日期不可填写;开票内容下拉框初始默认----,其余选项包含4个:补差、折扣、促销费、销售补差 |
payType | String | N | 3 | 支付方式。适用于结算方式1,3--电汇、5--转款, |
invoiceDate | String | N | 2014-06-05 | 开票日期。适用于结算方式1,年月日 |
invoiceContent | String | N | 2 | 开票内容。适用于结算方式1,指定为:1--补差、2--折扣、3--促销费、4--销售补差 |
payDate | String | N | 2014-06-07 | 支付日期。支付日期不能早于销售开始日期 |
htmlContent | String | Y | HTXHHGHHKJKKKKLGFHJRTIOOJBK.. | HTML内容。HTML ENCODE:UTF-8 |
signNatureContent | String | N | qh2CXxZYkrmjljgfZxFaGFW | SIGNATURE 内容。SIGNATURE ENCODE:UTF-8 |
invoiceCode | String | N | 16612772 | 单据编号。不超过30个字符 |
lineItem | String | N | 10 | 行项目。不超过30个字符 |
expStartDate | String | Y | 2014-06-05 | 费用发生开始日期。开始日期不能大于结束日期 |
expEndDate | String | Y | 2014-06-10 | 费用发生结束日期。开始日期不能大于结束日期 |
relationCompCode | String | Y | 11 | 发生公司。苏宁公司代码。 |
expDetail | String | Y | 5 | 费用明细。1--折扣补差;2--账面毛利补差;3--运营商礼金券;4--心意券;5--销售补差;6--特价机超标补差;7--礼金券;8--经理卡;9--节能惠民券;10--积分;11--供应商优惠单;12--非标优惠单2;13--非标优惠单1;14--促销品;15--保底补差 |
settlementAmount | String | Y | 43.90 | 结算金额。发生费用明细的结算金额总和必须等于销售补差总额 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
applicationCode | String | 5400X0021405424424 | 活动函编号。 |
supplierApplicationCode | String | FYBJ14051603 | 供应商活动函编号。 |
resultFlag | String | Y | 成功标识。Y-成功,N-失败 |
errorReason | String | 信息有误 | 失败原因 |
<sn_request> <sn_body> <applyBalanceApplication> <applyHead> <supplierCode>10000335</supplierCode> <supplierBraComp>SEBJ</supplierBraComp> <supplierOffice>北京,天津</supplierOffice> <snCode>5400</snCode> <supplierApplicationCode>FYBJ14061004</supplierApplicationCode> <productBrand>0123,0124,0125</productBrand> <expenseBudgetCode>123456789</expenseBudgetCode> <areaCopCode>1001</areaCopCode> <startDate>2014-05-19</startDate> <endDate>2014-05-29</endDate> <discountLittleMount>15000.50</discountLittleMount> <settlementType>2</settlementType> <payType>3</payType> <invoiceDate>2014-05-29</invoiceDate> <invoiceContent>4</invoiceContent> <payDate>2014-05-29</payDate> <htmlContent>XHHGHHKJKKKKLGFHJRTIOOJBK...</htmlContent> <signNatureContent>XHHGHHKJKKKKLGFHJRTIOOJBK...</signNatureContent> </applyHead> <applyDetail> <invoiceCode>16612772</invoiceCode> <lineItem>10</lineItem> <expStartDate>2014-05-15</expStartDate> <expEndDate>2014-05-20</expEndDate> <relationCompCode>5400</relationCompCode> <expDetail>5</expDetail> <settlementAmount>7500.25</settlementAmount> </applyDetail> <applyDetail> <invoiceCode>16612773</invoiceCode> <lineItem>20</lineItem> <expStartDate>2014-05-15</expStartDate> <expEndDate>2014-05-20</expEndDate> <relationCompCode>5400</relationCompCode> <expDetail>5</expDetail> <settlementAmount>7500.25</settlementAmount> </applyDetail> </applyBalanceApplication> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "applyBalanceApplication": { "applyHead": { "supplierCode": "10000335", "supplierBraComp": "SEBJ", "supplierOffice": "北京,天津", "snCode": "5400", "supplierApplicationCode": "FYBJ14061004", "productBrand": "0123,0124,0125", "expenseBudgetCode": "123456789", "areaCopCode": "1001", "startDate": "2014-05-19", "endDate": "2014-05-29", "discountLittleMount": "15000.50", "settlementType": "2", "payType": "3", "invoiceDate": "2014-05-29", "invoiceContent": "4", "payDate": "2014-05-29", "htmlContent": "XHHGHHKJKKKKLGFHJRTIOOJBK...", "signNatureContent": "XHHGHHKJKKKKLGFHJRTIOOJBK..." }, "applyDetail": [ { "invoiceCode": "16612772", "lineItem": "10", "expStartDate": "2014-05-15", "expEndDate": "2014-05-20", "relationCompCode": "5400", "expDetail": "5", "settlementAmount": "7500.25" }, { "invoiceCode": "16612773", "lineItem": "20", "expStartDate": "2014-05-15", "expEndDate": "2014-05-20", "relationCompCode": "5400", "expDetail": "5", "settlementAmount": "7500.25" } ] } } } }
<sn_responseContent> <sn_body> <applyBalanceApplication> <applicationCode>5400X0021405424424</applicationCode> <supplierApplicationCode>FYBJ14051603</supplierApplicationCode> <resultFlag>Y</resultFlag> <errorReason/> </applyBalanceApplication> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "applyBalanceApplication": { "applicationCode": "5400X0021405424424", "supplierApplicationCode": "FYBJ14051603", "resultFlag": "Y" } }, "sn_head":{ } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.selfmarket.addbalanceapply.missing-parameter:* | 请求字段为空,*号用请求参数字段名替换 | 请输入正确参数。 |
biz.selfmarket.invalid-biz:suppliercode | 供应商编码不存在 | 请输入正确参数。 |
isp.sys.service.unavailable.scs | 服务不可用(系统异常) | 请联系苏宁技术人员。 |
biz.selfmarket.addbalanceapply.invalid-biz:100 | 供应商编码必须为数字 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:101 | 供应商编码长度不超过8位 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:102 | 供应商分公司代码只能为数字或字母 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:103 | 供应商分公司代码长度不能超过20 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:104 | 供应商办事处长度不能超过60(中文长度*3) | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:105 | 苏宁公司代码是否为数字 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:106 | 苏宁公司代码长度不能超过4位 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:107 | 供应商确认函编号只能为数字或字母 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:108 | 供应商确认函编号长度不能超过40 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:109 | 品牌代码只允许数字和逗号(,) | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:110 | 品牌代码长度不能超过150 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:111 | 费用预算单号只能为数字或字母 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:112 | 费用预算单号长度不能超过45 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:113 | 活动区域编码只能为数字 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:114 | 活动区域编码长度不能超过4 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:115 | 销售开始时间格式yyyy-MM-dd | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:116 | 销售结束时间格式yyyy-MM-dd | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:117 | 销售开始日期需小于结束日期 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:118 | 销售补差金额只允许带1到2位小数,允许负数 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:119 | 销售部差金额长度不能超过19 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:120 | 结算方式只能为"1"或者"2"或者"3" | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:121 | 支付方式:结算方式不为1时支付方式不可填 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:122 | 支付方式:结算方式为1时支付方式必填 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:123 | 支付方式:支付方式存在时,必须为3或者5 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:124 | 开票日期:若结算方式不为1,则开票日期不可填 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:125 | 开票日期:若结算方式为1,则开票日期必填 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:126 | 开票日期:若结算方式为1,开票日期格式yyyy-MM-dd | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:127 | 开票内容:结算方式不为1时开票内容不可填 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:128 | 开票内容:结算方式为1时开票内容必填 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:129 | 开票内容:若存在,值必须为"1"或者"2"或者"3"或者"4" | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:130 | 支付日期:格式必须为yyyy-MM-dd | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:131 | 支付日期:支付日期必须晚于销售开始日期 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:132 | 明细:单据编号不能包含汉字 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:133 | 明细:单据编号长度不能超过30 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:134 | 明细:行项目必须为数字 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:135 | 明细:行项目长度不能超过30 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:136 | 明细:费用发生开始日期格式yyyy-MM-dd | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:137 | 明细:费用发生结束日期格式yyyy-MM-dd | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:138 | 明细:费用开始日期需小于结束日期 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:139 | 明细:费用发生公司必须为数字或者字母 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:140 | 明细:费用发生公司长度不能大于4 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:141 | 明细:费用明细必须为"1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15"其中一种 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:142 | 明细:结算金额只允许带1到2位小数,允许负数 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:143 | 明细:结算金额长度不能超过19 | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:144 | 不支持批量操作(applyHead节点不是map) | 请输入正确参数。 |
biz.selfmarket.addbalanceapply.invalid-biz:145 | 供应商编码为空 | 请输入正确参数。 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
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:通过此接口可销售补差确认函申请