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

麦座-门店-创建订单API; 1、麦座订单成单分为两步操作(特殊票、0元票或订单应收为0除外),分别为“创建订单”、“确认订单售出”。 按顺序调用两个API即可最终完成订单成单功能。 2、调用此API成功后,订单状态为“待支付”,下一步可调用“确认订单API”完成成单。 3、备注:“确认订单API”需传支付类型id。 4、备注:特殊票下单订单应收需传0元。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param OrderCreateParam 必须 创建订单入参
  • goods_list
  • Goods []
  • 必须
  • 购买的商品信息(单票维度);无座或有座下单此项必填;所购买商品的所属场次取票方式、实名制限购方式必须一致(交集);
  • └ seat_id
  • String
  • 可选
  • 91273971413
  • 座位id;有座自助选座下单必传
  • └ price_id
  • String
  • 必须
  • 44281279312
  • 单票票档id;非空
  • └ event_id
  • String
  • 可选
  • 8273719231
  • 场次id;注意:一票一证时必填;
  • └ delivery_type
  • Number
  • 必须
  • 11
  • 取票类型;3=取票码自助换票(换纸质票),4=二维码自助换票(换纸质票),11=打纸质票;
  • └ remark
  • String
  • 可选
  • xxxx
  • 订单备注
  • └ collector_phone
  • String
  • 必须
  • 15812340123
  • 取票人手机号,11位;非空
  • └ external_order_no
  • String
  • 可选
  • 786631200921
  • 外部order号
  • └ collector_card_type
  • Number
  • 可选
  • 1
  • 取票人证件类型;购买商品为一单一证时,必传;1=身份证
  • └ collector_card_no
  • String
  • 可选
  • 11012281827736721
  • 取票人证件号; 购买商品为一单一证时,必传
  • └ order_receive_money_fen
  • Number
  • 必须
  • 18000
  • 麦座订单应收金额;单位:分;麦座订单应收金额=商品应收金额+运费金额-优惠金额;取票方式为快递时,必须计入运费;
  • └ collector_name
  • String
  • 必须
  • 张起灵
  • 取票人真实姓名;非空;购买商品为一单一证时,必须传证件真实姓名
  • └ operator_id
  • String
  • 必须
  • 3810831241
  • 麦座操作员id;门店出票必须;由麦座小二提供
  • └ channel_id
  • String
  • 必须
  • 31434243777
  • 麦座二级渠道id;门店;由麦座小二提供
  • └ free_ticket_mark
  • Boolean
  • 可选
  • false
  • 是否特殊票下单;true=是,默认=否;
  • └ free_ticket_type
  • Number
  • 可选
  • 3
  • 特殊票下单类型;2=工作票,3=赠票,4=注册票,5=保留票,6=体验票,7=合同票,8=抵值票,9=提票;暂只支持8种特殊票;
  • └ mz_user_id
  • String
  • 可选
  • 18923971113
  • 麦座会员id;deliveryType=3=取票码自助换票(换纸质票),4=二维码自助换票(换纸质票)时必传;即电子票时必传会员id;

响应参数

名称 类型 示例值 描述
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);
AlibabaDamaiMzBOrderCreateRequest req = new AlibabaDamaiMzBOrderCreateRequest();
AlibabaDamaiMzBOrderCreateRequest.OrderCreateParam obj1 = new AlibabaDamaiMzBOrderCreateRequest.OrderCreateParam();
List<AlibabaDamaiMzBOrderCreateRequest.Goods> list3 = new ArrayList<AlibabaDamaiMzBOrderCreateRequest.Goods>();
AlibabaDamaiMzBOrderCreateRequest.Goods obj4 = new AlibabaDamaiMzBOrderCreateRequest.Goods();
list3.add(obj4);
obj4.setSeatId("91273971413");
obj4.setPriceId("44281279312");
obj4.setEventId("8273719231");
obj1.setGoodsList(list3);
obj1.setDeliveryType(11L);
obj1.setRemark("xxxx");
obj1.setCollectorPhone("15812340123");
obj1.setExternalOrderNo("786631200921");
obj1.setCollectorCardType(1L);
obj1.setCollectorCardNo("11012281827736721");
obj1.setOrderReceiveMoneyFen(18000L);
obj1.setCollectorName("张起灵");
obj1.setOperatorId("3810831241");
obj1.setChannelId("31434243777");
obj1.setFreeTicketMark(false);
obj1.setFreeTicketType(3L);
obj1.setMzUserId("18923971113");
req.setParam(obj1);
AlibabaDamaiMzBOrderCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_b_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_b_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

返回
顶部