API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.fmkcasdelivercoupon.create 券前置发券服务代理
¥免费

FMKCAS(金融促销电子券接口代理)系统调SPC发券服务

公共参数
请求参数
名称 类型 是否必须 示例值 描述
requestIdStringY05257b0a296d40439a9ad212da196a84请求号(请求端唯一标识号(UUID),建议各系统加上各自的标识,以防止系统间重复)
invokerStringYossas统一传 ossas
requestNoStringYa018ec2c289e448f8341f07eb3195a37流水号(控制重复调用,相同业务流水和调用方标识会幂等返回)
activityCodeStringYSFZF20290330M011111活动编码(根据活动编码前缀判断券类型)
memberIdStringY1900211111易购会员号(新人券必传)
requestKeyStringNdkjfkdj秘钥
businessSceneStringYUSER_PULL_DOWN业务场景(手工发券:MANUAL_PULL_DOWN用户领取:USER_PULL_DOWN(直接领:001(免息券))兑换:REDEEM_PULL_DOWN满返:FULL_BACK抽奖:002)
terminalTypeStringNAPP终端类型(PC、WAP、APP、TV APP_IOS、APP_ANDROID)
buddleIdStringNabcdefAPP包名(APP包名编码目前仅流量券、话费券必传)
egoTokenStringNTIvRyrNeojpnVnBk63Utga7e3易购token(PC和WAP和APP可获取到则必传,易购二代机器指纹)
appTypeStringN03APP类型(01-金融,02-易购,03-小店,04-红孩子,05-其他)
phoneNoStringN13011111111手机号
couponsAmountStringN1返券金额
clientIpStringN192.168.1.1用户IP(能够获取到必传)
appTokenStringNTIvRyrNeojpnVnBk63Utga7e3APP设备标识(APP必传,用于向风控数据支撑服务查询所有设备信息。)
pcTokenStringNTIvRyrNeojpnVnBk63Utga7e3PC设备标识(PC和WAP(包括微信)必传)
idNoStringN333333333333333333用户实名身份证号码(新人券必传)
realNameStringN你好S用户实名姓名(新人券必传)
deliverSourceStringYECOUPON-0003发券来源
响应参数
名称 类型 示例值 描述
responseCodeString0000返回响应码(可选值:0000 - 成功,9999 - 系统异常,9998 - 参数校验不通过,9701 - 参数校验不通过,9711 - 调用会员系统出错,9766 - 风控提醒[交易有风险],9714 - 调用风控异常[调风控系统出错],9781 - 活动过期,9782 - 活动非生效,9783 - 终端规则不匹配,9784 - 调用电子券系统失败,9785 - 电子券系统发券失败,9787 - 参数非json格式数据,9788 - 该活动编码对应的活动不存在,9789 - 该活动当前发券时间不允许发券,9790 - 该app类型不符合活动规则要求,9791 - 该账号未实名,9792 - 该账号注册时间不符合活动要求,9793 - 流水号不可重复,9801 - 活动资源不够,9803 - 活动总次数用完,9804 - 活动每天次数用完,9805 - 活动每周次数用完,9806 - 会员号活动期间总次数用完,9807 - 会员号活动每天次数用完,9808 - 会员号活动每周次数用完,9809 - 身份证活动期间总次数用完,9810 - 身份证活动每天次数用完,9811 - 身份证活动每周次数用完,9812 - 手机号活动期间总次数用完,9813 - 手机号活动每天次数用完,9814 - 手机号活动每周次数用完,9815 - 终端号活动期间总次数用完,9816 - 终端号活动每天次数用完,9817 - 终端号活动每周次数用完,9967 - 您的签约手机号已享受过优惠,9968 - 您的签约手机号本日享受过优惠,9969 - 您的签约手机号本周已享受过优惠,9970 - 您的签约银行卡号已享受过优惠,9971 - 您的签约银行卡号本日已享受过优惠,9972 - 您的签约银行卡号本周已享受过优惠,9873 - 会员等级不满足本活动规则要求,9724 - 调用消息平台发短信异常,9768 - 连接消息平台系统超时,10010001 - 活动时间未到,10010002 - 活动时间已结束,10010003 - 无绑定易购会员编号,10010004 - 非super正式会员,10010005 - 非super试用期会员 ,10010006 - 非super会员,10010007 - 调用付费会员等级接口失败 ,F410 - 非super新会员,F411 - 非super新会员或试用期会员,F417 - 您不是未激活会员,无法领取,F418 - 您还不是已激活未实名会员,无法领取,F419 - 您已经实名,无法领取,F420 - 您还不是初级实名会员,无法领取,F421 - 您已经高级实名,无法领取,F422 - 您还不是高级实名会员,无法领取,F423 - 您还不是实名会员,无法领取,F424 - 您还不是激活会员,无法领取,F425 - 连接PLPPPS系统超时,F426 - 连接PLPPPS系统出错,F427 - 任性付已开通,F428 - 您的账户状态异常,暂无法领券,如有疑问请联系客服95177转5。(任性付资格已注销),F429 - 您的账户状态异常,暂无法领券,如有疑问请联系客服95177转5。(任性付资格已失效),F430 - 您的账户状态异常,暂无法领券,如有疑问请联系客服95177转5。(任性付资格已冻结),9840 - 任性付未申请,F432 - 您已拥有免息资格,无需领券,直接下单体验吧!,F433 - 实名来源[%s]不满足,F434 - 实名时间段[%s]不满足,F435 - 调用会员系统出错[%s],F436 - 当前活动时间段内发券总次数已用完,F437 - 任性付资格开通时间段[%s]不满足,F439 - 未开通任性贷 该券仅限开通任性贷的用户领取,F440 - 连接PLPLMS系统超时 领券人数太多,请稍后再试,F441 - 连接PLPLMS系统异常 领券人数太多,请稍后再试,F442 - 任性贷资格开通时间段[%s]不满足 任性贷开通时间不满足活动的要求,F443 - 拦截高危会员,任性付高危用户拦截。)
responseMsgStringdkjdfk你好返回错误消息
couponTypeString11 –免息券 2 –众筹券 3 –流量券 4 –话费券 5 –理财券 6 –特权券 7 –支付券 8 –基金券 9 –购物免息券 10 –借款免息券 11 –还款免息券
couponNoStringSNLCLJ201711020000944266券号
valueTypeString1券面值类型(1-定额;2-折扣;3-加息)
couponAmountString5券金额\券上限金额(单位为分,与券折扣不共存 券面值类型为3时非空。)
couponDiscountString80券折扣(如 80即为0.8%,与券金额不共存 券面值类型为3时非空。任性付免息券是百分位,其他券时万分位)
couponStatusString02券状态(01:发券新建;02:发券成功;03:发券失败;04:发券异常)
startTimeString2020409195812券有效期开始日期(格式:yyyyMMddHHmmss)
endTimeString2020409195904券有效期结束日期(格式:yyyyMMddHHmmss)
couponDescString仅限平台使用券使用规则
pcLinkStringhttp://www.suning.compc活动链接
wapLinkStringhttp://www.suning.comwap活动链接
appLinkStringhttp://www.suning.comapp活动链接
yfbLinkStringhttp://www.suning.com易付宝链接
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createFmkcasdelivercoupon>
      <buddleId>abcdef</buddleId>
      <requestKey>dkjfkdj</requestKey>
      <appToken>TIvRyrNeojpnVnBk63Utga7e3</appToken>
      <invoker>ossas</invoker>
      <requestNo>a018ec2c289e448f8341f07eb3195a37</requestNo>
      <idNo>333333333333333333</idNo>
      <phoneNo>13011111111</phoneNo>
      <terminalType>APP</terminalType>
      <activityCode>SFZF20290330M011111</activityCode>
      <businessScene>USER_PULL_DOWN</businessScene>
      <realName>你好S</realName>
      <requestId>05257b0a296d40439a9ad212da196a84</requestId>
      <appType>03</appType>
      <couponsAmount>1</couponsAmount>
      <clientIp>192.168.1.1</clientIp>
      <egoToken>TIvRyrNeojpnVnBk63Utga7e3</egoToken>
      <pcToken>TIvRyrNeojpnVnBk63Utga7e3</pcToken>
      <deliverSource>ECOUPON-0003</deliverSource>
      <memberId>1900211111</memberId>
    </createFmkcasdelivercoupon>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createFmkcasdelivercoupon": {
        "buddleId": "abcdef",
        "requestKey": "dkjfkdj",
        "appToken": "TIvRyrNeojpnVnBk63Utga7e3",
        "invoker": "ossas",
        "requestNo": "a018ec2c289e448f8341f07eb3195a37",
        "idNo": "333333333333333333",
        "phoneNo": "13011111111",
        "terminalType": "APP",
        "activityCode": "SFZF20290330M011111",
        "businessScene": "USER_PULL_DOWN",
        "realName": "你好S",
        "requestId": "05257b0a296d40439a9ad212da196a84",
        "appType": "03",
        "couponsAmount": "1",
        "clientIp": "192.168.1.1",
        "egoToken": "TIvRyrNeojpnVnBk63Utga7e3",
        "pcToken": "TIvRyrNeojpnVnBk63Utga7e3",
        "deliverSource": "ECOUPON-0003",
        "memberId": "1900211111"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createFmkcasdelivercoupon>
      <yfbLink>http://www.suning.com</yfbLink>
      <couponNo>SNLCLJ201711020000944266</couponNo>
      <responseCode>0000</responseCode>
      <couponDiscount>80</couponDiscount>
      <couponAmount>5</couponAmount>
      <appLink>http://www.suning.com</appLink>
      <couponType>1</couponType>
      <valueType>1</valueType>
      <couponStatus>02</couponStatus>
      <couponDesc>仅限平台使用</couponDesc>
      <startTime>2020409195812</startTime>
      <wapLink>http://www.suning.com</wapLink>
      <endTime>2020409195904</endTime>
      <pcLink>http://www.suning.com</pcLink>
      <responseMsg>dkjdfk你好</responseMsg>
    </createFmkcasdelivercoupon>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createFmkcasdelivercoupon": {
        "yfbLink": "http://www.suning.com",
        "couponNo": "SNLCLJ201711020000944266",
        "responseCode": "0000",
        "couponDiscount": "80",
        "couponAmount": "5",
        "appLink": "http://www.suning.com",
        "couponType": "1",
        "valueType": "1",
        "couponStatus": "02",
        "couponDesc": "仅限平台使用",
        "startTime": "2020409195812",
        "wapLink": "http://www.suning.com",
        "endTime": "2020409195904",
        "pcLink": "http://www.suning.com",
        "responseMsg": "dkjdfk你好"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.createfmkcasdelivercoupon.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
biz.custom.createfmkcasdelivercoupon.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.custom.createfmkcasdelivercoupon.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.custom.createfmkcasdelivercoupon.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.fmkcas 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ