API接口目录

自营业务

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

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

公共参数
请求参数
名称 类型 是否必须 示例值 描述
applyHeadStringN
supplierCodeStringY10000335苏宁供应商编码,必填,只能输入一个
snCodeStringY5400苏宁公司,只能输入一个。
expenseBudgetCodeStringNHDC0001566费用预算单号
supplierApplicationCodeStringYHDIC180622578供应商优惠单编码
areaCompanyCodeStringY5400活动区域公司。如果活动区域为全国则为5400,如果活动是分区域的,不允许跨大区操作,只能是苏宁一个大区内的多个分公司。
startDateStringY2018-05-01活动开始日期,格式为yyyy-mm-dd;活动开始日期不得早于活动结束日期
endDateStringY2018-05-20活动结束日期,格式为yyyy-mm-dd;活动开始日期不得早于活动结束日期
applyLevelStringYFGS生效层次:FGS-分公司 MD-门店
actionDescribeStringN五一门店促销活动活动内容描述
settlementTypeStringY1结算方式。结算方式。1--贵司开出国税普通销售发票给我司,我司在约定的支付时间前以:**方式支付给贵司,开票内容:**;相应电汇款项我司将在约定的支付日期前予以电汇,相应转款款项贵司可在发票开出后最近一个账期的结算清单的货款中扣除。2--我司出具折让证明,贵司办理“开具红字增值税专用发票通知单”,我司在约定支付时间前开红票给贵司,我司在开给贵司的红票上备注:红字通知单号码。3--我司在约定的支付时间前,在进货发票中以销售折让方式支付给贵司,并在我司开给贵司的增值税发票上备注费用对账单号码
invoiceContentStringN3开票内容。选择结算方式1时,开票内容必填,1-补差;2-折扣;3-促销费;4-销售补差。
payTypeStringN3支付方式,选择结算方式1时,支付方式必填,3-电汇;5-转款
payDateStringN2018-06-04支付日期,支付日期必须早于活动开始日期
productBrandStringY1659品牌代码。支持多个,逗号隔开。
htmlContentStringYHTML ENCODE:UTF-8HTML内容。HTML ENCODE:UTF-8
areaDetailStringN
operateAreaCompanyStringY1020活动操作范围公司,只能输入一个
operateAreaShoperStringY4687苏宁操作活动范围门店代码。生效层次为门店时,填写门店代码;生效层次为分公司时,填写“所有门店”
itemDetailStringN
wareHouseStringY0001库位代码。0001常规机库,0002特价机库,0003包销机库、0004备用机库、0005工程机、0006促销品库、0007样机库、0008行政用品库。
channelStringY99渠道,选择项:50团购,99全渠道
favoureAmountStringY100.2活动金额,正数,最多保留两位小数
chargeItemStringY不限商品数量,整数
itemCodeStringY101092731苏宁商品编码,一个行项目只能输入一个苏宁商品编码。
commentsStringN商品优惠备注。若填写,不可超过200个字符。
响应参数
名称 类型 示例值 描述
applicationCodeString5400X0021405424424苏宁活动函编号
supplierApplicationCodeStringHDIC18062927供应商优惠单编码
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <createApplicationPrivilege>
      <areaDetail>
        <operateAreaCompany>1020</operateAreaCompany>
        <operateAreaShoper>4687</operateAreaShoper>
      </areaDetail>
      <itemDetail>
        <comments>商品优惠</comments>
        <favoureAmount>100.2</favoureAmount>
        <chargeItem>不限</chargeItem>
        <itemCode>101092731</itemCode>
        <channel>99</channel>
        <wareHouse>0001</wareHouse>
      </itemDetail>
      <applyHead>
        <settlementType>1</settlementType>
        <areaCompanyCode>5400</areaCompanyCode>
        <invoiceContent>3</invoiceContent>
        <snCode>5400</snCode>
        <endDate>2018-05-20</endDate>
        <productBrand>1659</productBrand>
        <expenseBudgetCode>HDC0001566</expenseBudgetCode>
        <supplierCode>10000335</supplierCode>
        <actionDescribe>五一门店促销活动</actionDescribe>
        <htmlContent>HTML ENCODE:UTF-8</htmlContent>
        <supplierApplicationCode>HDIC180622578</supplierApplicationCode>
        <payType>3</payType>
        <applyLevel>FGS</applyLevel>
        <startDate>2018-05-01</startDate>
        <payDate>2018-06-04</payDate>
      </applyHead>
    </createApplicationPrivilege>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "createApplicationPrivilege": {
        "areaDetail": [
          {
            "operateAreaCompany": "1020",
            "operateAreaShoper": "4687"
          }
        ],
        "itemDetail": [
          {
            "comments": "商品优惠",
            "favoureAmount": "100.2",
            "chargeItem": "不限",
            "itemCode": "101092731",
            "channel": "99",
            "wareHouse": "0001"
          }
        ],
        "applyHead": {
          "settlementType": "1",
          "areaCompanyCode": "5400",
          "invoiceContent": "3",
          "snCode": "5400",
          "endDate": "2018-05-20",
          "productBrand": "1659",
          "expenseBudgetCode": "HDC0001566",
          "supplierCode": "10000335",
          "actionDescribe": "五一门店促销活动",
          "htmlContent": "HTML ENCODE:UTF-8",
          "supplierApplicationCode": "HDIC180622578",
          "payType": "3",
          "applyLevel": "FGS",
          "startDate": "2018-05-01",
          "payDate": "2018-06-04"
        }
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <createApplicationprivilege>
      <supplierApplicationCode>HDIC18062927</supplierApplicationCode>
      <applicationCode>5400X0021405424424</applicationCode>
    </createApplicationprivilege>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createApplicationprivilege": {
        "supplierApplicationCode": "HDIC18062927",
        "applicationCode": "5400X0021405424424"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.selfmarket.createapplicationprivilege.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.selfmarket.createapplicationprivilege.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.sbc 服务不可用 请联系苏宁技术人员
biz.selfmarket.createapplicationprivilege.invalid-biz:100 操作范围为空 操作范围为空,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:101 商品明细为空 商品明细为空,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:102 苏宁活动函编码生成失败 苏宁活动函编码生成失败,请联系苏宁技术人员处理。
biz.selfmarket.createapplicationprivilege.invalid-biz:103 签章文件保存失败 保存HEML文件失败,请联系苏宁技术人员
biz.selfmarket.createapplicationprivilege.invalid-biz:104 供应商编码不存在或格式错误 供应商编码只能为8位的数字组成,且在苏宁系统存在,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:105 供应商数据不完整 供应商数据不完整,请联系我司人员补充完整。
biz.selfmarket.createapplicationprivilege.invalid-biz:106 苏宁公司代码不存在或格式错误 苏宁公司代码为数字或字母组合,长度为4,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:107 品牌编码不存在或格式错误 品牌编码只能为数字,长度不得超过150,且在苏宁系统中存在,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:108 供应商活动函编号格式错误 供应商活动函编号只能为数字或字母,长度不得超过40,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:109 供应商活动函编号苏宁系统已存在 供应商活动函编号重复,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:110 活动开始日期格式错误 格式类型为yyyy-mm-dd,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:111 活动结束日期格式错误 格式类型为yyyy-mm-dd,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:112 活动结束日期早于活动开始日期 活动结束日期必须晚于活动开始日期,请重新输入
biz.selfmarket.createapplicationprivilege.invalid-biz:113 活动描述长度不能超过200个汉字 活动描述长度不能超过200个汉字,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:114 结算方式格式错误 结算方式只能为"1"或者"2"或者"3",请输入正确的参数
biz.selfmarket.createapplicationprivilege.invalid-biz:115 结算方式不为1时支付方式不可填 当结算方式不为1时,无需填写支付方式,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:116 结算方式为1时支付方式未填写 结算方式为1时,支付方式必填,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:117 结算方式不为1时开票内容不可填 结算方式不为1时开票内容不可填,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:118 开票内容格式错误 开票内容值只能为1,2,3,4
biz.selfmarket.createapplicationprivilege.invalid-biz:119 支付日期格式错误 格式必须为yyyy-mm-dd
biz.selfmarket.createapplicationprivilege.invalid-biz:120 支付日期早于活动开始日期 支付日期必须早于活动开始日期,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:121 生成层次格式错误 生效层次只能为FGS或MD,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:122 活动区域公司不存在或格式错误 活动区域公司为字母或数字组合,且在苏宁系统存在,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:123 费用预算单号格式错误 费用预算单号只能为数字或字母组合,长度不得超过45,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:124 签章文件为空 签章文件为空,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:125 活动操作范围公司不存在或格式错误 活动操作范围公司为字母或数字组合,且在苏宁系统存在,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:126 生效层次为分公司,操作范围门店错误 生效层次为分公司时,操作范围门店填写:所有门店。
biz.selfmarket.createapplicationprivilege.invalid-biz:127 活动操作范围门店不存在或格式错误 活动操作范围门店为字母或数字组合,且在苏宁系统存在,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:128 库位格式错误 库位只能为0001常规机库,0002特价机库,0003包销机库、0007样机库、0008行政用品库。
biz.selfmarket.createapplicationprivilege.invalid-biz:129 渠道格式错误 渠道只能为10、50、99
biz.selfmarket.createapplicationprivilege.invalid-biz:130 渠道错误 只有母婴和文化制品供应商可选择10零售、50团购或99全渠道;其他类供应商只可选择99全渠道
biz.selfmarket.createapplicationprivilege.invalid-biz:131 苏宁商品编码不存在或格式错误 苏宁商品编码只能为数字组成,且在苏宁系统不存在,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:132 数量格式错误 数量只能为大于0的整数
biz.selfmarket.createapplicationprivilege.invalid-biz:133 活动金额格式错误 活动金额只允许带1到2位小数,可以为负数,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:134 备注错误 备注长度只能为200,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:135 保存数据失败 保存数据失败,请联系苏宁技术人员
biz.selfmarket.createapplicationprivilege.invalid-biz:136 支付方式格式错误,只可填3或5 支付方式格式错误,只可填3或5,请修改。
biz.selfmarket.createapplicationprivilege.invalid-biz:137 明细中渠道不一致 明细中渠道不一致,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:138 渠道与品类关系不正确 渠道与品类关系不正确,请修改
biz.selfmarket.createapplicationprivilege.invalid-biz:139 渠道与生效层次关系不正确 渠道与生效层次关系不正确,请修改
公共异常码
API工具
FAQ