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

麦座-平台分销-创建订单API; 1、麦座订单成单分为两步操作,分别为“创建订单”、“确认订单”。 按顺序调用两个API即可最终完成订单成单功能。 2、调用此API成功后,订单状态为“待支付”,下一步可调用“确认订单API”完成成单。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param OrderCreateParam 必须 创建订单入参
  • └ event_id
  • String
  • 必须
  • 1380002011588
  • 麦座场次id
  • └ contact_name
  • String
  • 必须
  • 李清雪
  • 联系人/购票人姓名;非空
  • goods_list
  • Goods []
  • 必须
  • 购买的商品信息(单票维度)一单最多6张票;无座或有座下单此项必填
  • └ seat_id
  • String
  • 可选
  • 91273971413
  • 座位id;有座自助选座下单必传
  • └ price_id
  • String
  • 必须
  • 44281279312
  • 单票票档id;非空
  • └ real_name
  • String
  • 可选
  • 李清雪
  • 一票一证 真实姓名;所购买商品 实名制类型为一票一证限制时,必传
  • └ card_type
  • Number
  • 可选
  • 1
  • 一票一证 证件类型;1=身份证,2=护照,3=港澳通行证,4=台湾居民来往大陆通行证,5=中华人民共和国台湾居民居住证,6=香港特别行政区护照,7=澳门特别行政区护照,8=士兵/军官证;所购买商品 实名制类型为一票一证限制时,必传
  • └ seat_group_id
  • String
  • 可选
  • 314971937912
  • 座位组合id;固定座位组合时,例如 1排1座与1排2座 为一个固定座位组合;同一座位组合中的座位必须同时购买,座位为固定座位组合时必传;
  • └ package_price_id
  • String
  • 可选
  • 123197442112
  • 套票票档id;套票时必传
  • └ card_no
  • String
  • 可选
  • 110xxxx1873
  • 一票一证 证件号;所购买商品 实名制类型为一票一证限制时,必传
  • └ rule_id
  • String
  • 可选
  • 1234_12345_12341_14155
  • 麦座优惠规则id;支持使用票品优惠
  • └ delivery_type
  • Number
  • 必须
  • 5
  • 票类型;2=身份证电子票换纸票入场,3=取票码换纸票入场,4=二维码电子票换纸票入场,5=上门取纸票入场,6=二维码电子票直接入场
  • └ remark
  • String
  • 可选
  • xxxx
  • 订单备注
  • └ external_order_no
  • String
  • 必须
  • 786631200921
  • 外部order号
  • └ seat_sale_type
  • Number
  • 必须
  • 1
  • 座位购买类型; 1=有座自助选座,2=无座,3=有座机选(暂不支持)
  • └ order_receive_money_fen
  • Number
  • 必须
  • 18000
  • 麦座订单应收金额;单位:分
  • └ contact_phone
  • String
  • 必须
  • 15801234567
  • 联系人/购票人手机号;非空
  • └ project_id
  • String
  • 必须
  • 1234001011588
  • 麦座项目id
  • └ collector_card_no
  • String
  • 可选
  • 110122xxxxx6721
  • 取票人证件号;票类型deliveryType 为 (2=身份证电子票换纸票入场 或 5=上门取纸票入场)时, 当实名制购买时,以持票人证件信息进行换票,取票人证件号非必填; 当非实名制够买时,以取票人证件信息进行换票,必填。 票类型deliveryType 为 非(2=身份证电子票换纸票入场 或 5=上门取纸票入场)时,非必填。
  • └ collector_name
  • String
  • 可选
  • 张起灵
  • 取票人真实姓名; 票类型deliveryType 为 (2=身份证电子票换纸票入场 或 5=上门取纸票入场)时, 当实名制购买时,以持票人证件信息进行换票,取票人真实姓名非必填; 当非实名制够买时,以取票人证件信息进行换票,必填。 票类型deliveryType 为 非(2=身份证电子票换纸票入场 或 5=上门取纸票入场)时,必填。
  • └ collector_card_type
  • Number
  • 可选
  • 1
  • 取票人证件类型;1=身份证,2=护照,3=港澳通行证,4=台湾居民来往大陆通行证,5=中华人民共和国台湾居民居住证,6=香港特别行政区护照,7=澳门特别行政区护照,8=士兵/军官证; 票类型deliveryType 为 (2=身份证电子票换纸票入场 或 5=上门取纸票入场)时, 当实名制购买时,以持票人证件信息进行换票,取票人证件类型非必填; 当非实名制够买时,以取票人证件信息进行换票,必填。 票类型deliveryType 为 非(2=身份证电子票换纸票入场 或 5=上门取纸票入场)时,非必填。
  • └ order_payment_money_fen
  • Number
  • 必须
  • 16000
  • 消费者实付金额 单位:分
  • └ collector_phone
  • String
  • 必须
  • 15812340123
  • 取票人手机号,11位;非空
  • └ ticket_owner_name
  • String
  • 可选
  • 张起灵
  • 票的实际持有人姓名;实名制购买且为一单一证时必传;
  • └ ticket_owner_card_no
  • String
  • 可选
  • 110xxxx1283
  • 票的实际持有人证件号;实名制购买且为一单一证时必传;
  • └ ticket_owner_card_type
  • Number
  • 可选
  • 1
  • 票的实际持有人证件类型;实名制购买且为一单一证时必传;证件类型,1=身份证,2=护照,3=港澳通行证,4=台湾居民来往大陆通行证,5=中华人民共和国台湾居民居住证,6=香港特别行政区护照,7=澳门特别行政区护照,8=士兵/军官证;
  • └ real_name_buy_limit_type
  • String
  • 可选
  • 1
  • 实名制购买类型,1=一单一证,2=一票一证
  • └ real_name_buy_limit_boolean
  • Boolean
  • 必须
  • true
  • 是否需要实名制购买,true=是,false=否
  • └ total_price_discount_money_fen
  • Number
  • 可选
  • 700
  • 总票品优惠金额(单位:分)

响应参数

名称 类型 示例值 描述
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;
  • └ mz_order_id
  • String
  • 893241912688
  • 麦座订单号
  • └ external_order_no
  • String
  • 786631200921
  • 外部订单号
  • └ success
  • Boolean
  • true
  • api请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzDistributionOrderCreateRequest req = new AlibabaDamaiMzDistributionOrderCreateRequest();
AlibabaDamaiMzDistributionOrderCreateRequest.OrderCreateParam obj1 = new AlibabaDamaiMzDistributionOrderCreateRequest.OrderCreateParam();
obj1.setEventId("1380002011588");
obj1.setContactName("李清雪");
List<AlibabaDamaiMzDistributionOrderCreateRequest.Goods> list3 = new ArrayList<AlibabaDamaiMzDistributionOrderCreateRequest.Goods>();
AlibabaDamaiMzDistributionOrderCreateRequest.Goods obj4 = new AlibabaDamaiMzDistributionOrderCreateRequest.Goods();
list3.add(obj4);
obj4.setSeatId("91273971413");
obj4.setPriceId("44281279312");
obj4.setRealName("李清雪");
obj4.setCardType(1L);
obj4.setSeatGroupId("314971937912");
obj4.setPackagePriceId("123197442112");
obj4.setCardNo("110xxxx1873");
obj4.setRuleId("1234_12345_12341_14155");
obj1.setGoodsList(list3);
obj1.setDeliveryType(5L);
obj1.setRemark("xxxx");
obj1.setExternalOrderNo("786631200921");
obj1.setSeatSaleType(1L);
obj1.setOrderReceiveMoneyFen(18000L);
obj1.setContactPhone("15801234567");
obj1.setProjectId("1234001011588");
obj1.setCollectorCardNo("110122xxxxx6721");
obj1.setCollectorName("张起灵");
obj1.setCollectorCardType(1L);
obj1.setOrderPaymentMoneyFen(16000L);
obj1.setCollectorPhone("15812340123");
obj1.setTicketOwnerName("张起灵");
obj1.setTicketOwnerCardNo("110xxxx1283");
obj1.setTicketOwnerCardType(1L);
obj1.setRealNameBuyLimitType("1");
obj1.setRealNameBuyLimitBoolean(true);
obj1.setTotalPriceDiscountMoneyFen(700L);
req.setParam(obj1);
AlibabaDamaiMzDistributionOrderCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_distribution_order_create_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <auto_cancel_order_time>2019-12-30 19:17:10</auto_cancel_order_time>
            <mz_order_id>893241912688</mz_order_id>
            <external_order_no>786631200921</external_order_no>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_distribution_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请求失败 通用业务异常
40100002 请求必须的参数不能为空 请求必须的参数不能为空
40100003 请求数据不存在 请求数据不存在
40401001 商品信息不能为空 商品信息不能为空
40401002 商品数量超出限制值 商品数量超出限制值
40401003 座位id不能重复 座位id不能重复
40402001 取票类型非法 取票类型非法
40402002 取票人证件信息非法,请输入正确有效的证件信息 取票人证件信息非法,请输入正确有效的证件信息
40402003 一票一证证件信息非法,请输入正确有效的证件信息 一票一证证件信息非法,请输入正确有效的证件信息
40402004 证件信息非法,请输入正确有效的证件信息 证件信息非法,请输入正确有效的证件信息
40402005 订单标签非法 订单标签非法
40403001 积分使用金额非法 积分使用金额非法
40403002 礼品卡使用金额非法 礼品卡使用金额非法
40403003 使用会员资产必须传入assetBizKey 使用会员资产必须传入assetBizKey
15060000 余票不足 余票不足
15060001 已售出 已售出
15060002 已下架 已下架
15060003 渠道未授权 渠道未授权
15060004 已锁定,无权限销售 已锁定,无权限销售
15060005 保留票,无权限销售 保留票,无权限销售
15060013 会员已锁定,请先解锁 会员已锁定,请先解锁

API工具

如何获得此API

FAQ

返回
顶部