qimen.alibaba.uni.trade.create (全域收单交易创建接口)

全域收单下单接口,可通过该接口创建订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
storeId String 必须 100004 门店ID
outTradeNo String 必须 OT93475435 业务方订单号
userId String 可选 353434 用户ID,当userIdType为ANONYMOU时可为空,其他必填
userIdType String 必须 TAOBAO 用户类型。TAOBAO:淘宝用户; ALIPAY:支付宝用户; WECHAT:微信用户; MOBILE:手机用户; CUSTOM:自有商户; ANONYMOUS:无标识的用户;
goodsList RcGoodsParam [] 必须
  • 最大列表长度:99
  • 待交易商品
    • └ goodsId
    • String
    • 必须
    • 69534523423
    • 商品标识
    • └ quantity
    • String
    • 必须
    • 1
    • 商品数量,支持浮点。唯一码模式下固定为1
    • └ price
    • Number
    • 必须
    • 13850
    • 商品价格,单位:分(人民币)
    • └ idType
    • String
    • 必须
    • CUSTOM
    • 商品标识类型。UNIQUE:唯一码;ITEM_SKU:sku模式;CUSTOM商家自有编码
    • └ guider
    • String
    • 可选
    • 9527
    • 导购员编号
    • └ outSubTradeNo
    • String
    • 可选
    • OTS5435643
    • 商品所属外部子单号
    salesId String 可选 9527 收银员编号
    body String 必须 可大可小 订单描述
    expireTime String 必须 2018-12-31 23:59:59 订单过期时间,在此之前如果未支付则会主动关闭订单,请合理设置,当前默认创建订单后10min钟
    tradeBizType Number 必须 0
  • 默认值:0
  • 业务类型
    pickingUpType String 必须 SELF_DELIVERY 提货方式,SELF_DELIVERY:自提;LOGISTICS:物流发货
    deliverAddressDO DeliverAddressDO 必须 物流信息
    • └ province
    • String
    • 必须
    • 浙江省
    • 行政省
    • └ provinceCode
    • Number
    • 可选
    • 330000
    • 行政区 省 代码(国标)
    • └ city
    • String
    • 必须
    • 杭州市
    • 城市
    • └ cityCode
    • Number
    • 可选
    • 330100
    • 行政区 城市 代码(国标)
    • └ area
    • String
    • 必须
    • 余杭区
    • 区县
    • └ areaCode
    • Number
    • 可选
    • 330110
    • 行政区 区县 代码(国标)
    • └ town
    • String
    • 必须
    • 仓前街道
    • 乡镇·街道
    • └ townCode
    • Number
    • 可选
    • 330110012
    • 行政区 乡镇·街道 代码(国标)
    • └ postCode
    • String
    • 可选
    • 311121
    • 邮编
    • └ fullName
    • String
    • 必须
    • 孙行者
    • 收货人
    • └ mobilePhone
    • String
    • 必须
    • 13812345678
    • 移动电话
    • └ phone
    • String
    • 可选
    • 057185022088
    • 联系电话
    • └ addressDetail
    • String
    • 必须
    • 文一西路969号阿里巴巴西溪园区
    • 详细地址
    promotionList RcPromotion [] 可选
  • 最大列表长度:999
  • 本次订单使用的权益
    • └ promotionId
    • String
    • 可选
    • 45346547
    • 权益标识
    • └ deductedAmount
    • Number
    • 可选
    • 1000
    • 对应权益扣减的金额,单位:分(人民币)
    • └ promotionTitle
    • String
    • 可选
    • 满100减10
    • 权益标题
    • └ promotionDesc
    • String
    • 可选
    • 满100立减10元 不可叠加
    • 权益描述
    • └ type
    • Number
    • 可选
    • 1
    • 权益类型。0:零售核心优惠;1:外部优惠
    needAssembly Boolean 必须 false
  • 默认值:false
  • 能现场拿货的定义为false,其他诸如需要调拨或者发货的定义为true
    storeIdType String 必须 CUSTOM 门店Id类型,RPLUS:零售+门店ID; PLACE:商户中心门店ID; CUSTOM:自有门店ID,须在商户中心有映射关系
    outCardNo String 可选 34564578658 会员标识
    extendParams String 可选 {"k1":"v1","k2":"v2"} 扩展参数JSON字符串

    响应参数

    名称 类型 示例值 描述
    success Boolean true 业务成功标识 true|false
    errCode String 601 错误代码
    errMsg String 无效参数 错误信息
    data RcTradeCreateDTO 业务数据
    • └ tradeNo
    • String
    • 201801108372954645
    • 零售核心订单号

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlibabaUniTradeCreateRequest req = new AlibabaUniTradeCreateRequest();
    req.setStoreId("100004");
    req.setOutTradeNo("OT93475435");
    req.setUserId("353434");
    req.setUserIdType("TAOBAO");
    List<AlibabaUniTradeCreateRequest.RcGoodsParam> list2 = new ArrayList<AlibabaUniTradeCreateRequest.RcGoodsParam>();
    AlibabaUniTradeCreateRequest.RcGoodsParam obj3 = new AlibabaUniTradeCreateRequest.RcGoodsParam();
    list2.add(obj3);
    obj3.setGoodsId("69534523423");
    obj3.setQuantity("1");
    obj3.setPrice(13850L);
    obj3.setIdType("CUSTOM");
    obj3.setGuider("9527");
    obj3.setOutSubTradeNo("OTS5435643");
    req.setGoodsList(list2);
    req.setSalesId("9527");
    req.setBody("可大可小");
    req.setExpireTime("2018-12-31 23:59:59");
    req.setTradeBizType(0L);
    req.setPickingUpType("SELF_DELIVERY");
    AlibabaUniTradeCreateRequest.DeliverAddressDO obj4 = new AlibabaUniTradeCreateRequest.DeliverAddressDO();
    obj4.setProvince("浙江省");
    obj4.setProvinceCode(330000L);
    obj4.setCity("杭州市");
    obj4.setCityCode(330100L);
    obj4.setArea("余杭区");
    obj4.setAreaCode(330110L);
    obj4.setTown("仓前街道");
    obj4.setTownCode(330110012L);
    obj4.setPostCode("311121");
    obj4.setFullName("孙行者");
    obj4.setMobilePhone("13812345678");
    obj4.setPhone("057185022088");
    obj4.setAddressDetail("文一西路969号阿里巴巴西溪园区");
    req.setDeliverAddressDO(obj4);
    List<AlibabaUniTradeCreateRequest.RcPromotion> list6 = new ArrayList<AlibabaUniTradeCreateRequest.RcPromotion>();
    AlibabaUniTradeCreateRequest.RcPromotion obj7 = new AlibabaUniTradeCreateRequest.RcPromotion();
    list6.add(obj7);
    obj7.setPromotionId("45346547");
    obj7.setDeductedAmount(1000L);
    obj7.setPromotionTitle("满100减10");
    obj7.setPromotionDesc("满100立减10元 不可叠加");
    obj7.setType(1L);
    req.setPromotionList(list6);
    req.setNeedAssembly(false);
    req.setStoreIdType("CUSTOM");
    req.setOutCardNo("34564578658");
    req.setExtendParams("{\"k1\":\"v1\",\"k2\":\"v2\"}");
    AlibabaUniTradeCreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <success>true</success>
    <errCode>601</errCode>
    <errMsg>无效参数</errMsg>
    <data>
        <tradeNo>201801108372954645</tradeNo>
    </data>
    

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部