API接口目录

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.initmerchantstore.create 零售云门店入驻接口
¥免费

零售云门店入驻接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY111111调用方唯一编码
dyttInitMerchantInfoDTOStringN
acctNoStringN086631易购会员帐号
companyTypeStringN1公司类型(0:商业公司;1:个体工商户)
companyNameStringN苏宁公司名称
licenseNoStringN0265454651544x4营业执照号
licenseUrlStringNhttp://11.jpg营业执照图片
provNameStringN江苏省省名称
provCodeStringN100省编码
cityNameStringN南京市市名称
cityCodeStringN025城市编码
districtNameStringN玄武区区域名称
districtCodeStringN01区域编码
townNameStringN全区镇名称
townCodeStringN99镇编码
companyAddrStringN苏宁大道1号详细地址
legalPersonStringN法人姓名法人姓名
legalIdcardNoStringN3201225546548844法人身份证号
idcardFrontUrlStringNhttp://11.jpg身份证正面
idcardReverseUrlStringNhttp://22.jpg身份证反面
snCustNumStringN7017963441易购会员编码
generalTaxpayerFlagStringN0是否一般纳税人(0:否;1:是)
registPhoneStringN254544注册电话
openingBankNameStringN中国银行开户银行
openingBankAccountStringN6254540546545450开户行账户
dyttInitSotreInfoDTOStringN
storeNameStringN店铺名称店铺名称
snStoreCodeStringN90N3苏宁门编
storeProvNameStringN江苏省省名称
storeProvCodeStringN100省编码
storeCityNameStringN南京市城市名称
storeCityCodeStringN025市编码
storeDistrictNameStringN玄武区区域名称
storeDistrictCodeStringN01区域编码
storeTownNameStringN全区镇名称
storeTownCodeStringN99镇编码
detailAddressStringN苏宁大道1号详细地址
contactPersonStringN张三联系人
contactPhoneStringN16546545联系电话
regionCodeStringN10001大区
companyCodeStringN5016销售公司
businessTypeStringN1经营类型 (1:加盟店; 2:会员店; 3:VIP会员店; 4:合作店;)
storeTypeStringNST5店铺类型(ST5:快消)
storeSourceStringN4店铺来源
zipCodeStringN0250000邮编
areaCodeStringN025区号
contractStartDateStringN2020-02-23合同签约日期
responsiblePersonStringN筹建负责人筹建负责人
responsiblePhoneStringN1654561544121筹建负责人联系方式
storeYtCodeStringN门店业态门店业态
storeLvCodeStringN1门店级别
storeXzCodeStringN1门店性质
isManageStringNY是否管理店(Y:是N:否)
startBusinessDateStringN2020-03-23计划开店日期
storeCodeStringN59021店铺编码(操作类型为1:修改时必传)
platformCodeStringNP6业务平台编码(P6:迪亚天天)
coperatorStringN操作人操作人
operTypeStringN0操作类型(0:新增 1:修改)
响应参数
名称 类型 示例值 描述
respBeanString
storeCodeString59021店铺编码
snStoreCodeString90N1苏宁门编
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <createInitmerchantstore>
      <dyttInitMerchantInfoDTO>
        <licenseUrl>http://11.jpg</licenseUrl>
        <generalTaxpayerFlag>0</generalTaxpayerFlag>
        <openingBankName>中国银行</openingBankName>
        <licenseNo>0265454651544x4</licenseNo>
        <townName>全区</townName>
        <provName>江苏省</provName>
        <districtCode>01</districtCode>
        <provCode>100</provCode>
        <districtName>玄武区</districtName>
        <companyType>1</companyType>
        <townCode>99</townCode>
        <cityCode>025</cityCode>
        <idcardFrontUrl>http://11.jpg</idcardFrontUrl>
        <openingBankAccount>6254540546545450</openingBankAccount>
        <companyName>苏宁</companyName>
        <companyAddr>苏宁大道1号</companyAddr>
        <snCustNum>7017963441</snCustNum>
        <idcardReverseUrl>http://22.jpg</idcardReverseUrl>
        <legalIdcardNo>3201225546548844</legalIdcardNo>
        <acctNo>086631</acctNo>
        <cityName>南京市</cityName>
        <registPhone>254544</registPhone>
        <legalPerson>法人姓名</legalPerson>
      </dyttInitMerchantInfoDTO>
      <dyttInitSotreInfoDTO>
        <zipCode>0250000</zipCode>
        <storeCityName>南京市</storeCityName>
        <responsiblePhone>1654561544121</responsiblePhone>
        <storeLvCode>1</storeLvCode>
        <storeYtCode>门店业态</storeYtCode>
        <startBusinessDate>2020-03-23</startBusinessDate>
        <contactPerson>张三</contactPerson>
        <storeTownName>全区</storeTownName>
        <storeTownCode>99</storeTownCode>
        <storeProvCode>100</storeProvCode>
        <storeDistrictName>玄武区</storeDistrictName>
        <regionCode>10001</regionCode>
        <isManage>Y</isManage>
        <storeName>店铺名称</storeName>
        <storeSource>4</storeSource>
        <storeXzCode>1</storeXzCode>
        <snStoreCode>90N3</snStoreCode>
        <companyCode>5016</companyCode>
        <storeType>ST5</storeType>
        <contractStartDate>2020-02-23</contractStartDate>
        <storeCityCode>025</storeCityCode>
        <responsiblePerson>筹建负责人</responsiblePerson>
        <areaCode>025</areaCode>
        <detailAddress>苏宁大道1号</detailAddress>
        <contactPhone>16546545</contactPhone>
        <businessType>1</businessType>
        <storeProvName>江苏省</storeProvName>
        <storeDistrictCode>01</storeDistrictCode>
        <storeCode>59021</storeCode>
      </dyttInitSotreInfoDTO>
      <coperator>操作人</coperator>
      <appId>111111</appId>
      <operType>0</operType>
      <platformCode>P6</platformCode>
    </createInitmerchantstore>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createInitmerchantstore": {
        "dyttInitMerchantInfoDTO": {
          "licenseUrl": "http://11.jpg",
          "generalTaxpayerFlag": "0",
          "openingBankName": "中国银行",
          "licenseNo": "0265454651544x4",
          "townName": "全区",
          "provName": "江苏省",
          "districtCode": "01",
          "provCode": "100",
          "districtName": "玄武区",
          "companyType": "1",
          "townCode": "99",
          "cityCode": "025",
          "idcardFrontUrl": "http://11.jpg",
          "openingBankAccount": "6254540546545450",
          "companyName": "苏宁",
          "companyAddr": "苏宁大道1号",
          "snCustNum": "7017963441",
          "idcardReverseUrl": "http://22.jpg",
          "legalIdcardNo": "3201225546548844",
          "acctNo": "086631",
          "cityName": "南京市",
          "registPhone": "254544",
          "legalPerson": "法人姓名"
        },
        "dyttInitSotreInfoDTO": {
          "zipCode": "0250000",
          "storeCityName": "南京市",
          "responsiblePhone": "1654561544121",
          "storeLvCode": "1",
          "storeYtCode": "门店业态",
          "startBusinessDate": "2020-03-23",
          "contactPerson": "张三",
          "storeTownName": "全区",
          "storeTownCode": "99",
          "storeProvCode": "100",
          "storeDistrictName": "玄武区",
          "regionCode": "10001",
          "isManage": "Y",
          "storeName": "店铺名称",
          "storeSource": "4",
          "storeXzCode": "1",
          "snStoreCode": "90N3",
          "companyCode": "5016",
          "storeType": "ST5",
          "contractStartDate": "2020-02-23",
          "storeCityCode": "025",
          "responsiblePerson": "筹建负责人",
          "areaCode": "025",
          "detailAddress": "苏宁大道1号",
          "contactPhone": "16546545",
          "businessType": "1",
          "storeProvName": "江苏省",
          "storeDistrictCode": "01",
          "storeCode": "59021"
        },
        "coperator": "操作人",
        "appId": "111111",
        "operType": "0",
        "platformCode": "P6"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <createInitmerchantstore>
      <respBean>
        <snStoreCode>90N1</snStoreCode>
        <storeCode>59021</storeCode>
      </respBean>
    </createInitmerchantstore>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "createInitmerchantstore": {
        "respBean": {
          "snStoreCode": "90N1",
          "storeCode": "59021"
        }
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.retailer.createinitmerchantstore.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.srcdss 服务不可用 请联系苏宁技术人员
公共异常码
API工具
FAQ