API接口目录

自营业务

退厂API
厂送API
厂送退换货API
品牌串码API
采购订单API
供应商收发货API
售后服务API
供应商财务API
主数据API
自营合同API
自营商品API
自营财务API
采购计划API
收发货API
订单API
易道报表API
不良品API
自营促销API
异常码自查工具
suning.application.protocol.apply 展示位使用协议申请
¥免费

通过此接口可展示位使用协议申请

公共参数
请求参数
名称 类型 是否必须 示例值 描述
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 失败原因 失败原因
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<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..."
			}
		}
	}
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<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"
			}
		}
	}
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
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 供应商编码为空 请输入正确参数。
公共异常码
API工具
FAQ

Q:展示位使用协议申请接口如何使用?

A:通过此接口可展示位使用协议申请