alibaba.damai.mz.order.create (创建订单API)

麦座-自建电商网站-创建订单API; 1、麦座订单成单分为两步操作,分别为“创建订单”、“确认订单售出”。 按顺序调用两个API即可最终完成订单成单功能。 2、调用此API成功后,订单状态为“待支付”,下一步可调用“确认订单API”完成成单。 3、备注:“确认订单API”需传支付类型id。 4、注意:礼品卡只允许全额抵扣;不能只使用单张礼品卡的一部分余额;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param OrderCreateParam 必须 创建订单入参
  • └ order_payment_money_fen
  • Number
  • 可选
  • 16000
  • 消费者实付金额 单位:分
  • goods_list
  • Goods []
  • 必须
  • 购买的商品信息(单票维度);无座或有座下单此项必填;所购买商品的所属场次取票方式、实名制限购方式必须一致(交集);
  • └ card_no
  • String
  • 可选
  • 1107618827341283
  • 一票一证 证件号;所购买商品 实名制类型为一票一证限制时,必传
  • └ seat_id
  • String
  • 可选
  • 91273971413
  • 座位id;有座自助选座下单必传
  • └ price_id
  • String
  • 必须
  • 44281279312
  • 单票票档id;非空
  • └ event_id
  • String
  • 可选
  • 8273719231
  • 场次id;注意:一票一证时必填;
  • └ real_name
  • String
  • 可选
  • 李清雪
  • 一票一证 真实姓名;所购买商品 实名制类型为一票一证限制时,必传
  • └ card_type
  • Number
  • 可选
  • 1
  • 一票一证 证件类型;1=身份证;
  • └ lock_id
  • String
  • 可选
  • 82877218910013
  • 麦座座位锁id;可空;用于先锁座位再下单
  • good_identity_list
  • GoodIdentity4c []
  • 可选
  • 当票档是无座自由组合套票且场次一票一证时,此参数必传。票档下的证件信息 1个套票下有几张票 就传几个证件号
  • └ card_no
  • String
  • 可选
  • 1107618827341283
  • 一票一证 证件号;所购买商品 实名制类型为一票一证限制时,必传
  • └ card_type
  • Number
  • 可选
  • 1
  • 一票一证 证件类型;1=身份证;
  • └ real_name
  • String
  • 可选
  • 李清雪
  • 一票一证 真实姓名;所购买商品 实名制类型为一票一证限制时,必传
  • └ delivery_type
  • Number
  • 必须
  • 3
  • 取票方式;2=身份证自助换票(换纸质票),3=取票码自助换票(换纸质票),4=二维码自助换票(换纸质票),6=二维码电子票(无纸质票),7=快递,11=证件电子票
  • └ remark
  • String
  • 可选
  • xxxx
  • 订单备注
  • └ collector_phone
  • String
  • 必须
  • 15812340123
  • 取票人手机号,11位;非空
  • └ external_order_no
  • String
  • 可选
  • 786631200921
  • 外部order号
  • └ collector_card_type
  • Number
  • 可选
  • 1
  • 取票人证件类型;1=身份证;票类型deliveryType 为 (2=身份证自助换票(换纸质票))或 购买商品为一单一证时,必传
  • └ collector_card_no
  • String
  • 可选
  • 11012281827736721
  • 取票人证件号;票类型deliveryType 为 (2=身份证自助换票(换纸质票))或 购买商品为一单一证时,必传
  • └ order_receive_money_fen
  • Number
  • 必须
  • 18000
  • 麦座订单应收金额;单位:分;麦座订单应收金额=商品应收金额+运费金额-优惠金额;取票方式为快递时,必须计入运费;
  • └ order_promotion_rule_id
  • String
  • 可选
  • 31243
  • 选中的订单优惠规则id;使用订单优惠时必传
  • └ mz_user_id
  • String
  • 必须
  • 981273781441
  • 麦座用户id;
  • └ collector_name
  • String
  • 必须
  • 张起灵
  • 取票人真实姓名;非空;票类型deliveryType 为 (2=身份证自助换票(换纸质票))或 购买商品为一单一证时,必须传证件真实姓名
  • └ coupon_code
  • String
  • 可选
  • tx3671hgsh1734
  • 优惠码code;使用优惠码时必传
  • └ order_promotion_id
  • String
  • 可选
  • 8273661701
  • 选中的订单优惠id;使用订单优惠时必传
  • └ coupon_code_promotion_rule_id
  • String
  • 可选
  • 72178184
  • 订单使用的优惠码规则id;使用优惠码时必传
  • └ address_id
  • String
  • 可选
  • 28377194
  • 收货地址id;deliveryType=7 快递时,非空;收货人以收货地址id对应的收货信息为准;
  • └ express_pay_type
  • Number
  • 可选
  • 1
  • 运费支付类型;1=在线支付;deliveryType=7 快递时,非空;
  • └ third_tag
  • String
  • 可选
  • 726819
  • 订单标签;可空,一般不传即可
  • └ use_point
  • Number
  • 可选
  • 10000
  • 使用积分值;单位:点数
  • └ use_point_money_fen
  • Number
  • 可选
  • 10000
  • 使用积分金额;单位:分;usePoint非空时必填
  • └ use_account_money_fen
  • Number
  • 可选
  • 5000
  • 使用账户余额金额;单位:分
  • └ use_card_id
  • String
  • 可选
  • 476177551891
  • 使用礼品卡支付的卡id;
  • └ use_card_money_fen
  • Number
  • 可选
  • 3000
  • 使用礼品卡支付金额;单位:分;useCardId非空时必填
  • └ asset_biz_key
  • String
  • 可选
  • hgyat6771ttf15614
  • 会员资产使用业务key;

响应参数

名称 类型 示例值 描述
result ResultData api返回结果
  • └ msg
  • String
  • 成功
  • 提示
  • └ code
  • String
  • 200
  • 状态码
  • data
  • OrderCreateVO
  • 创建订单出参
  • └ auto_cancel_order_time
  • String
  • 2019-12-30 19:17:10
  • 麦座超时未支付取消订单时间点,精确到秒,格式:yyyy-MM-dd HH:mm:ss;时区:GMT+8;
  • └ external_order_no
  • String
  • 786631200921
  • 外部订单号
  • └ mz_order_id
  • String
  • 893241912688
  • 麦座订单号
  • good_error_tip_info_list
  • GoodErrorTipInfo []
  • 下单错误提示信息;
  • └ seat_id
  • String
  • 9128018331
  • 麦座座位id;有座时非空
  • └ good_count
  • Number
  • 1
  • 商品数量;
  • └ price_fen
  • Number
  • 18000
  • 麦座票档价格;单位:分
  • └ price_name
  • String
  • 180元
  • 麦座票档名称
  • └ price_id
  • String
  • 12827773771
  • 麦座票档id
  • └ event_name
  • String
  • 2020-05-07 19:00
  • 麦座场次名称
  • └ event_id
  • String
  • 19288313
  • 麦座场次id
  • └ project_name
  • String
  • 周杰伦演唱会
  • 麦座项目名称
  • └ project_id
  • String
  • 313881819
  • 麦座项目id
  • └ error
  • String
  • 该证件已购买此场次,请更换证件购买
  • 错误提示;
  • └ identity_card
  • String
  • 110xxxxxxxx912
  • 证件号;错误的证件信息;脱敏,保留前3后3
  • └ need_online_pay
  • Boolean
  • true
  • 是否需要在线支付,下单时若使用余额、积分、礼品卡抵扣完整单金额则不需要在线支付;
  • └ online_payment_money_fen
  • Number
  • 18000
  • 需在线支付的金额; 订单应收金额(商品原价-各种优惠+运费(若有)) - 积分抵扣的金额 - 使用余额支付的金额 - 礼品卡抵扣金额;单位:分
  • └ success
  • Boolean
  • true
  • api请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzOrderCreateRequest req = new AlibabaDamaiMzOrderCreateRequest();
AlibabaDamaiMzOrderCreateRequest.OrderCreateParam obj1 = new AlibabaDamaiMzOrderCreateRequest.OrderCreateParam();
obj1.setOrderPaymentMoneyFen(16000L);
List<AlibabaDamaiMzOrderCreateRequest.Goods> list3 = new ArrayList<AlibabaDamaiMzOrderCreateRequest.Goods>();
AlibabaDamaiMzOrderCreateRequest.Goods obj4 = new AlibabaDamaiMzOrderCreateRequest.Goods();
list3.add(obj4);
obj4.setCardNo("1107618827341283");
obj4.setSeatId("91273971413");
obj4.setPriceId("44281279312");
obj4.setEventId("8273719231");
obj4.setRealName("李清雪");
obj4.setCardType(1L);
obj4.setLockId("82877218910013");
List<AlibabaDamaiMzOrderCreateRequest.GoodIdentity4c> list7 = new ArrayList<AlibabaDamaiMzOrderCreateRequest.GoodIdentity4c>();
AlibabaDamaiMzOrderCreateRequest.GoodIdentity4c obj8 = new AlibabaDamaiMzOrderCreateRequest.GoodIdentity4c();
list7.add(obj8);
obj8.setCardNo("1107618827341283");
obj8.setCardType(1L);
obj8.setRealName("李清雪");
list5.setGoodIdentityList(list7);
obj1.setGoodsList(list3);
obj1.setDeliveryType(3L);
obj1.setRemark("xxxx");
obj1.setCollectorPhone("15812340123");
obj1.setExternalOrderNo("786631200921");
obj1.setCollectorCardType(1L);
obj1.setCollectorCardNo("11012281827736721");
obj1.setOrderReceiveMoneyFen(18000L);
obj1.setOrderPromotionRuleId("31243");
obj1.setMzUserId("981273781441");
obj1.setCollectorName("张起灵");
obj1.setCouponCode("tx3671hgsh1734");
obj1.setOrderPromotionId("8273661701");
obj1.setCouponCodePromotionRuleId("72178184");
obj1.setAddressId("28377194");
obj1.setExpressPayType(1L);
obj1.setThirdTag("726819");
obj1.setUsePoint(10000L);
obj1.setUsePointMoneyFen(10000L);
obj1.setUseAccountMoneyFen(5000L);
obj1.setUseCardId("476177551891");
obj1.setUseCardMoneyFen(3000L);
obj1.setAssetBizKey("hgyat6771ttf15614");
req.setParam(obj1);
AlibabaDamaiMzOrderCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_order_create_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <auto_cancel_order_time>2019-12-30 19:17:10</auto_cancel_order_time>
            <external_order_no>786631200921</external_order_no>
            <mz_order_id>893241912688</mz_order_id>
            <good_error_tip_info_list>
                <good_error_tip_info>
                    <seat_id>9128018331</seat_id>
                    <good_count>1</good_count>
                    <price_fen>18000</price_fen>
                    <price_name>180元</price_name>
                    <price_id>12827773771</price_id>
                    <event_name>2020-05-07 19:00</event_name>
                    <event_id>19288313</event_id>
                    <project_name>周杰伦演唱会</project_name>
                    <project_id>313881819</project_id>
                    <error>该证件已购买此场次,请更换证件购买</error>
                    <identity_card>110xxxxxxxx912</identity_card>
                </good_error_tip_info>
            </good_error_tip_info_list>
            <need_online_pay>true</need_online_pay>
            <online_payment_money_fen>18000</online_payment_money_fen>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_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>

错误码解释

错误码 错误描述 解决方案
40100000 api未知错误 通用系统异常
40100001 api请求失败 通用业务异常
40100006 请求必须的参数麦座会员id不能为空 请求必须的参数麦座会员id不能为空
15060000 余票不足 余票不足
15060001 已售出 已售出
15060002 已下架 已下架
15060003 渠道未授权 渠道授权
15060004 已锁定,无权限销售 已锁定,无权限销售
15060005 保留票,无权限销售 保留票,无权限销售
40401001 商品信息不能为空 商品信息不能为空
40401002 商品数量超出限制值 商品数量超出限制值
40401003 座位id不能重复 座位id不能重复
40402001 取票类型非法 取票类型非法
40402002 取票人证件信息非法,请输入正确有效的证件信息 取票人证件信息非法,请输入正确有效的证件信息
40402003 一票一证证件信息非法,请输入正确有效的证件信息 一票一证证件信息非法,请输入正确有效的证件信息
40402004 证件信息非法,请输入正确有效的证件信息 证件信息非法,请输入正确有效的证件信息
40402005 订单标签非法 订单标签非法
40403001 积分使用金额非法 积分使用金额非法
40403002 礼品卡使用金额非法 礼品卡使用金额非法
40403003 使用会员资产必须传入assetBizKey 使用会员资产必须传入assetBizKey

API工具

如何获得此API

FAQ

返回
顶部