alibaba.omni.saas.order.create (订单创建接口)

服务商利用现有的saas系统和阿里完成交易系统的对接

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
goods_details GoodsDetail [] 必须
  • 最大列表长度:20
  • 商品列表
    • └ goods_id
    • String
    • 必须
    • GD00001
    • 商品标识
    • └ price
    • String
    • 必须
    • 100
    • 商品单价,人民币:分
    • └ quantity
    • String
    • 必须
    • 10.0
    • 商品数量
    • └ id_type
    • String
    • 必须
    • ITEM_SKU
    • 商品ID类型。CUSTOM:外部编码;ITEM_SKU:淘系商品itemId_skuId组合形式。无SKU则为itemId_0
    buyer_id String 可选 79284721321 买家标识,淘系用户或用户手机号。当支付渠道为支付宝时,此字段为淘宝会员码或支付宝付款码。(当前仅支持淘系用户,手机号下单稍后开放)
    buyer_id_type String 必须 TAOBAO ALIPAY:支付宝用户;TAOBAO:淘宝会员码;MOBILE:手机号
    store_id String 必须 1047384 门店ID
    device String 可选 POS 收银设备类型
    device_no String 可选 POS001 收银设备号
    operator_id String 可选 5436457654 收银员标识
    pay_channel String 必须 ALIPAY ALIPAY:支付宝付款;BANK_CARD:刷卡
    coupon_infos CouponInfo [] 可选
  • 最大列表长度:20
  • 商家自有优惠
    • └ name
    • String
    • 可选
    • 满100减10元
    • 优惠名称
    • └ discount
    • Number
    • 可选
    • 100
    • 优惠金额,单位人民币:分
    • └ option_id
    • String
    • 可选
    • YH9527
    • 优惠标识,编号
    store_id_type String 必须 PLACE PLACE:淘宝商户中心门店ID;CUSTOM:商户自有门店编码,需要维护到淘宝商户中心
    request_no String 必须 REQ-3436967 请求号,用于标识一次请求

    响应参数

    名称 类型 示例值 描述
    trade_no Number 10309483976732423 tradeNo
    total_amount Number 10000 totalAmount
    actual_pay_fee Number 9000 actualPayFee

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaOmniSaasOrderCreateRequest req = new AlibabaOmniSaasOrderCreateRequest();
    List<AlibabaOmniSaasOrderCreateRequest.GoodsDetail> list2 = new ArrayList<AlibabaOmniSaasOrderCreateRequest.GoodsDetail>();
    AlibabaOmniSaasOrderCreateRequest.GoodsDetail obj3 = new AlibabaOmniSaasOrderCreateRequest.GoodsDetail();
    list2.add(obj3);
    obj3.setGoodsId("GD00001");
    obj3.setPrice("100");
    obj3.setQuantity("10.0");
    obj3.setIdType("ITEM_SKU");
    req.setGoodsDetails(list2);
    req.setBuyerId("79284721321");
    req.setBuyerIdType("TAOBAO");
    req.setStoreId("1047384");
    req.setDevice("POS");
    req.setDeviceNo("POS001");
    req.setOperatorId("5436457654");
    req.setPayChannel("ALIPAY");
    List<AlibabaOmniSaasOrderCreateRequest.CouponInfo> list5 = new ArrayList<AlibabaOmniSaasOrderCreateRequest.CouponInfo>();
    AlibabaOmniSaasOrderCreateRequest.CouponInfo obj6 = new AlibabaOmniSaasOrderCreateRequest.CouponInfo();
    list5.add(obj6);
    obj6.setName("满100减10元");
    obj6.setDiscount(100L);
    obj6.setOptionId("YH9527");
    req.setCouponInfos(list5);
    req.setStoreIdType("PLACE");
    req.setRequestNo("REQ-3436967");
    AlibabaOmniSaasOrderCreateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_omni_saas_order_create_response>
        <trade_no>10309483976732423</trade_no>
        <total_amount>10000</total_amount>
        <actual_pay_fee>9000</actual_pay_fee>
    </alibaba_omni_saas_order_create_response>

    异常示例

    • 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

    返回
    顶部