API接口目录

零售云业务

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

零售云购物车确认开单接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringYaf99f27da589fbf089103f2f44c9a授权编码
userCodeStringN00000012313销售员编码
merchantCustNoStringY1701014245老板账号编码
storeCodeStringY1232130002店铺编码
buyerNameStringN张三顾客姓名
buyerPhoneStringY15866728686顾客手机号
orderAmountStringY2862.00订单总价
discountAmountStringY0.00优惠金额
discountCodeStringN6833452575344优惠劵编码
payAmountStringY2862.00应付金额
remarkStringN备注信息订单备注信息
posCodeStringN6849451548POS设备编码
createCodeStringN1405648424创建人编码
salesModeStringY1销售方式 ,1:先采后销 2:先销后采
outerOrderNoStringY4343424订单号(外围系统)
orderFromStringY1订单来源 0:pos 1:app
orderItemStringN
cmmdtyCodeStringYE232A1000000157商品编码
cmmdtyNameStringY空调商品名称
unitPriceStringY27800.00参考零售价
sellPriceStringY2800.00实际单价
totalPayAmountStringY2800.00实际应付金额
quantityStringY1数量
orderTypeStringY1订单类型,0:门店现货;1:缺货预定
shipMethodStringY1配送方式,0:自提;1:配送
supplierCodeStringNSN供应商编号
supplierNameStringN苏宁供应商名称
installFlagStringN0安装方式,0-不安装 1-苏宁安装 2-商家安装
bookTimeDetailStringN2018-07-01安装时间
serviceCodeStringN556421389服务安装编码
hopeArrivalTimeStringN2018-07-01预计送达时间
outerOrderItemNoStringY1004654必填,订单行号(外围系统)
distributorCodeStringN0000000000分销商编码
orderDeliveryStringN
receiverNameStringN张三收货人姓名
receiverPhoneStringN18632486868收货人电话
provinceCodeStringN320000省编码
provinceNameStringN江苏省省名称
cityCodeStringN320100城市编码
cityNameStringN南京市城市名称
districtCodeStringN320112区域编码
districtNameStringN江宁区区名称
townCodeStringN320112镇编码
townNameStringN江宁镇名称
buyerAddressStringNXXX路31号XXX大厦A座2楼收货详细地址
installDeliveryStringN
installNameStringN张三收货人姓名
installPhoneStringN18632678623收货人电话
installProvinceCodeStringN320000省编码
installProvinceNameStringN江苏省省名称
installCityCodeStringN320100城市编码
installCityNameStringN南京市城市名称
installDistrictCodeStringN320112区编码
installDistrictNameStringN江宁区区名称
installTownCodeStringN320112镇编码
installTownNameStringN江宁镇名称
installBuyerAddressStringNXXX路31号XXX大厦A座2楼收货详细地址
响应参数
名称 类型 示例值 描述
respBeanString
orderListString
orderNoStringA1456461订单编码
orderItemNoString01112订单行编码
cmmdtyCodeStringE232A1000000157商品编码
purchasePriceString1999.00分销价(先销后采才有值)
purchaseOrderNoStringA1456461采购单号(先销后采才有值)
purchaseOrderItemNoStringA1456461001采购单行号(先销后采才有值)
errorListString
cmmdtyCodeStringE232A1000000157错误商编
errorDescString商品下架错误描述
numString10库存数量
isEnoughString1库存是否足够,0:足够;1:不足; 非库存异常没有数值
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <createShoppingorders>
      <payAmount>2862.00</payAmount>
      <appId>af99f27da589fbf089103f2f44c9a</appId>
      <orderFrom>1</orderFrom>
      <userCode>00000012313</userCode>
      <remark>备注信息</remark>
      <orderItem>
        <cmmdtyCode>E232A1000000157</cmmdtyCode>
        <sellPrice>2800.00</sellPrice>
        <supplierName>苏宁</supplierName>
        <shipMethod>1</shipMethod>
        <orderType>1</orderType>
        <unitPrice>27800.00</unitPrice>
        <supplierCode>SN</supplierCode>
        <distributorCode>0000000000</distributorCode>
        <installFlag>0</installFlag>
        <cmmdtyName>空调</cmmdtyName>
        <hopeArrivalTime>2018-07-01</hopeArrivalTime>
        <serviceCode>556421389</serviceCode>
        <quantity>1</quantity>
        <bookTimeDetail>2018-07-01</bookTimeDetail>
        <totalPayAmount>2800.00</totalPayAmount>
        <outerOrderItemNo>1004654</outerOrderItemNo>
      </orderItem>
      <salesMode>1</salesMode>
      <posCode>6849451548</posCode>
      <discountAmount>0.00</discountAmount>
      <merchantCustNo>1701014245</merchantCustNo>
      <buyerName>张三</buyerName>
      <installDelivery>
        <installTownName>江宁</installTownName>
        <installProvinceCode>320000</installProvinceCode>
        <installTownCode>320112</installTownCode>
        <installDistrictName>江宁区</installDistrictName>
        <installDistrictCode>320112</installDistrictCode>
        <installCityCode>320100</installCityCode>
        <installProvinceName>江苏省</installProvinceName>
        <installPhone>18632678623</installPhone>
        <installBuyerAddress>XXX路31号XXX大厦A座2楼</installBuyerAddress>
        <installCityName>南京市</installCityName>
        <installName>张三</installName>
      </installDelivery>
      <orderAmount>2862.00</orderAmount>
      <buyerPhone>15866728686</buyerPhone>
      <outerOrderNo>4343424</outerOrderNo>
      <orderDelivery>
        <districtName>江宁区</districtName>
        <districtCode>320112</districtCode>
        <townName>江宁</townName>
        <provinceCode>320000</provinceCode>
        <cityName>南京市</cityName>
        <cityCode>320100</cityCode>
        <receiverName>张三</receiverName>
        <provinceName>江苏省</provinceName>
        <buyerAddress>XXX路31号XXX大厦A座2楼</buyerAddress>
        <townCode>320112</townCode>
        <receiverPhone>18632486868</receiverPhone>
      </orderDelivery>
      <createCode>1405648424</createCode>
      <discountCode>6833452575344</discountCode>
      <storeCode>1232130002</storeCode>
    </createShoppingorders>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "createShoppingorders": {
        "payAmount": "2862.00",
        "appId": "af99f27da589fbf089103f2f44c9a",
        "orderFrom": "1",
        "userCode": "00000012313",
        "remark": "备注信息",
        "orderItem": [
          {
            "cmmdtyCode": "E232A1000000157",
            "sellPrice": "2800.00",
            "supplierName": "苏宁",
            "shipMethod": "1",
            "orderType": "1",
            "unitPrice": "27800.00",
            "supplierCode": "SN",
            "distributorCode": "0000000000",
            "installFlag": "0",
            "cmmdtyName": "空调",
            "hopeArrivalTime": "2018-07-01",
            "serviceCode": "556421389",
            "quantity": "1",
            "bookTimeDetail": "2018-07-01",
            "outerOrderItemNo": "1004654",
            "totalPayAmount": "2800.00"
          }
        ],
        "salesMode": "1",
        "posCode": "6849451548",
        "discountAmount": "0.00",
        "merchantCustNo": "1701014245",
        "buyerName": "张三",
        "installDelivery": {
          "installProvinceCode": "320000",
          "installTownName": "江宁",
          "installTownCode": "320112",
          "installDistrictCode": "320112",
          "installDistrictName": "江宁区",
          "installCityCode": "320100",
          "installBuyerAddress": "XXX路31号XXX大厦A座2楼",
          "installPhone": "18632678623",
          "installProvinceName": "江苏省",
          "installCityName": "南京市",
          "installName": "张三"
        },
        "orderAmount": "2862.00",
        "outerOrderNo": "4343424",
        "buyerPhone": "15866728686",
        "orderDelivery": {
          "districtName": "江宁区",
          "districtCode": "320112",
          "townName": "江宁",
          "cityName": "南京市",
          "provinceCode": "320000",
          "cityCode": "320100",
          "receiverName": "张三",
          "provinceName": "江苏省",
          "buyerAddress": "XXX路31号XXX大厦A座2楼",
          "receiverPhone": "18632486868",
          "townCode": "320112"
        },
        "createCode": "1405648424",
        "discountCode": "6833452575344",
        "storeCode": "1232130002"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <createShoppingorders>
      <respBean>
        <errorList>
          <cmmdtyCode>E232A1000000157</cmmdtyCode>
          <num>10</num>
          <errorDesc>商品下架</errorDesc>
          <isEnough>1</isEnough>
        </errorList>
        <orderList>
          <cmmdtyCode>E232A1000000157</cmmdtyCode>
          <orderNo>A1456461</orderNo>
          <purchaseOrderNo>A1456461</purchaseOrderNo>
          <orderItemNo>01112</orderItemNo>
          <purchaseOrderItemNo>A1456461001</purchaseOrderItemNo>
          <purchasePrice>1999.00</purchasePrice>
        </orderList>
      </respBean>
    </createShoppingorders>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "createShoppingorders": {
        "respBean": {
          "errorList": [
            {
              "cmmdtyCode": "E232A1000000157",
              "num": "10",
              "errorDesc": "商品下架",
              "isEnough": "1"
            }
          ],
          "orderList": [
            {
              "cmmdtyCode": "E232A1000000157",
              "orderNo": "A1456461",
              "purchaseOrderNo": "A1456461",
              "orderItemNo": "01112",
              "purchaseOrderItemNo": "A1456461001",
              "purchasePrice": "1999.00"
            }
          ]
        }
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.retailer.createshoppingorders.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.retailer.createshoppingorders.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.retailer.createshoppingorders.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.srcdss 服务不可用 请联系苏宁技术人员
biz.retailer.createshoppingorders.invalid-biz:100 请求参数缺失 请检查请求参数
biz.retailer.createshoppingorders.invalid-biz:101 接口执行返回失败 请检查请求参数
biz.retailer.createshoppingorders.invalid-biz:102 查询结果为空 请检查请求参数
biz.retailer.createshoppingorders.invalid-biz:103 系统异常 请联系苏宁技术人员
biz.retailer.createshoppingorders.invalid-biz:104 创建订单失败 请检查请求参数
biz.retailer.createshoppingorders.invalid-biz:105 无效的AppId请求 请检查请求参数
biz.retailer.createshoppingorders.invalid-biz:106 老板编号与门店不匹配 请检查请求参数
公共异常码
API工具
FAQ