API接口目录

自营业务

退厂API
厂送API
厂送退换货API
品牌串码API
采购订单API
供应商收发货API
售后服务API
供应商财务API
主数据API
自营合同API
自营商品API
自营财务API
采购计划API
收发货API
订单API
易道报表API
不良品API
自营促销API
异常码自查工具
suning.selfmarket.applycuxiao.create 促销活动函申请
¥免费

供应商通过直连API接口,将促销活动函内容发送给苏宁系统,苏宁系统接受后,返回给供应商申请结果。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
supplierCodeStringY10138968供应商编码,必填,只能输入一个。
settleCompanyCodeStringY1002苏宁结算开票公司
supplierApplicationCodeStringYHDIC180622599供应商函件编码,必填,只能输入一个。
expenseBudgetCodeStringN91320115249801110621费用预算单号
areaCompanyCodeStringY5400活动区域管理公司,必填,只能输入一个。
activityTypeStringY1活动类型 1:满减, 2:券
activityStartTimeStringY2024-01-01 00:00:00活动开始时间
activityEndTimeStringY2024-01-31 23:59:59活动结束时间
couponsStartTimeStringN2024-01-01 00:00:00券使用开始时间
couponsEndTimeStringN2024-01-31 23:59:59券使用结束时间
factoryAssumeScaleStringN0.67供应商承担比例
applyLevelStringY01生成层次 01:全国, 03:城市, 04:门店
expandingChannelsStringY50渠道 50:50易购, 10:10门店, 多个之间使用英文逗号分隔
actionDescribeStringN活动描述活动描述
settlementTypeStringYS04结算方式 S04:国税票现汇(电汇), S05:国税票转货款, S01:红发票, S06:供应商发票折扣, S07:折让现汇
invoiceContentStringN01开票内容:适用于结算方式【S04-国税票现汇(电汇)】&【S05-国税票转货款】,01-补差;02-销售补差;03-折扣
lastPayDateStringY2024-02-29支付时间
pdfContentStringYJVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggMTM4MS9GaWx0ZXIvRmxhdGVEZWNPDF内容:base64字符串
cityShopListStringN
cityCodeStringN000001000000生效层次为全国时,填写【ALL】;生效层次为城市&门店时,填写城市代码。
shopCodeStringN9ABL生效层次为城市&全国时,填写【ALL】;生效层次为门店时,填写门店代码
activityDetailListStringN
promotionListStringN
levelIdStringY1层级ID,数字1~10,依次递增
activityModeStringY02活动方式 09:每元用券, 08:满元用券, 10:无门槛券, 02:每元减元, 01:满元减元. 活动类型为1时, 对应选项01,02; 活动类型为2时, 对应选项09,08,10
bounsLimitStringN400.00优惠门槛(元),正数,最多保留两位小数
bounsAmountStringY20.00补贴金额(元),正数,最多保留两位小数
singleMaxRewardAmountStringN100.00最大优惠金额,正数,最多保留两位小数
commodityListStringN
commodityCodeStringN102271946商品编码
brandCodeStringND396品牌编码
commentsStringN备注备注
响应参数
名称 类型 示例值 描述
applicationCodeString540020210804172500函件编码
supplierApplicationCodeStringHDIC2024022307供应商函件编码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <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"
          }
        ]
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <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"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
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 供应商活动函编号苏宁系统已存在 请输入正确参数
公共异常码
API工具
FAQ