淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
grouped_submit_order_param	SubmitOrderParam	必须			提交订单参数对象
cart_goods_param_list GroupedShoppingCartGoodsParam [] 可选套票分组后的商品列表 └ event_id String 可选 1802131 麦座场次ID └ price_id String 可选 1280121 票档ID； └ goods_id String 可选 809921 商品ID；有座套票时可空，无座时可空；有座单票时必传 └ goods_count Number 可选 2131 商品数量； └ coupon_group_id String 可选 231213 套票组ID；一般为固定套票组id child_list ChildGroupedShoppingCartGoodsParam [] 可选组合之后的子票档列表 └ price_id String 可选 432131 票档ID └ goods_id String 可选 421311 商品ID └ goods_count Number 可选 1 子商品数量；子商品数量默认1 order_bearer_param OrderBearerParam 可选订单观演人信息；一单一证限制时必传，一个订单对应一条记录； └ bearer_id String 可选 653231 观演人ID └ receivable_money String 可选 180 要验证的应收金额，如果不一致，则提交订单失败；单位：元 └ remark String 可选金牌订单备注 └ shopping_cart_id String 可选 3213131 当前购物车ID，服务器后台随机生成 └ user_id String 可选 5775654 会员ID └ quick_buy Boolean 可选 false 是否是快速购买：true=快速购买，false=购物车购买，如果选择限购商品，只能传递true order_receive_param OrderReceiveParam 可选订单收货人信息 └ receive_type Number 可选 2 收货类型；0=不确定，2=现场取票； └ ticket_type Number 可选 7 出票类型；2=身份证票、3=换票码、7=有纸化二维码、8=无纸化二维码 └ address_id String 可选 688665 收货人地址ID；暂不支持，可空 └ receive_name String 可选李晴雪取票人真实姓名；必传 └ receive_phone String 可选 13901234567 取票人手机号；必传 └ receive_identity_code String 可选 110102190010109921 取票人证件号码；ticketType=2 时必传，且会进行姓名证件号实名制校验； └ receive_card_type Number 可选 1 取票人证件类型；目前只支持身份证号类型；1=身份证；ticketType=2 时必传，且会进行姓名证件号实名制校验； └ use_point Number 可选 200 订单使用的积分数 └ use_point_money String 可选 20 订单使用积分抵扣的金额(元) └ lang_type Number 可选 1 语言类型：1=中文，2=英文 └ tenant_token String 必须 3A9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5icqyWfw 向api服务提供商获取 └ ptnr_token String 必须 t5dnxCv1KtwpNaDzuE459yus3m 向api服务提供商获取 └ channel_token String 必须 AxcXYJ72Idfk1231+mCzqSXZLWtCnikX/ 向api服务提供商获取 └ user_token String 可选 32132131 userId order_bearer_param_list OrderBearerParam [] 可选持票人信息；一票一证时必传，一张票对应一条记录 └ bearer_id String 可选 32313441 观演人ID； └ goods_id String 可选 2121312321 商品ID，一票一证时必填 └ price_id String 可选 3214121 票档ID； └ receivable_money_fen Number 可选 180 要验证的应收金额，如果不一致，则提交订单失败；单位：分

名称	类型	示例值	描述
result_data	ResultData		统一返回值对象
└ success Boolean false 是否成功 └ result_code Number 10112 状态码 └ result_msg String 失败提示信息 shopping_cart_vo ShoppingCartVo 返回数据 └ partner_id String 43241312 商户ID（用于区分麦座系统各商户） └ shopping_cart_id String 312121 当前购物车ID，服务器后台随机生成 └ order_id String 3114312211 如果已成订单，返回订单ID cart_goods_list CartGoodsVo [] 购物车商品信息列表 child_list CartGoodInfo [] 子商品列表 └ project_id String 343113 项目ID └ project_name String 周杰伦演唱会项目名称 └ project_img_url String http:www.maitix.com/img.jpg 项目图片地址 └ project_seat_type Number 1 项目座位类型 1=有座、2=无座 └ event_id String 432423423 场次ID └ event_name String 周杰伦演唱会20190101 场次名称 └ site_name String 北京展览馆场馆名称 └ site_version_id String 321313 场馆版本号ID └ event_show_start_time String 20190413 11:11:11 场次演出开始时间 └ event_show_end_time String 20190413 11:11:11 场次演出结束时间 └ price_id String 32321 票档ID └ price_name String 180元票档名称 └ goods_count Number 102 商品数量:如果单票，代表单票的个数，如果是套票，代表套票的数量,如果是有座，数量固定为1，否则代表无座或者实物商品的个数 └ margin_count Number 31331 剩余库存数量 └ is_coupon_ticket Number 1 是否套票 └ price String 18000 票档价格，如果单票，代表单票的价格，如果是套票，代表套票的价格 └ goods_id String 33131 商品ID └ coupon_group_id String 434112 套票组ID └ coupon_price_id String 3131 套票票档ID └ stock_state Number 1 库存状态：1=有库存，2=无库存 └ floor_name String 1层楼层名称 └ bound_name String vip 区域名称 └ row_name String 1排排名称 └ seat_id String 214141 座位ID └ seat_name String 1座座位名称 └ original_price String 18000 票档原始价格，如果是单票，代表单票的价格，如果是套票，代表套票包含的子票档的所有商品的价格 └ coupon_discount_money String 300 套票优惠金额 └ money_discount_money String 300 金钱优惠金额(减免或折扣的一种) └ real_money String 200 购物车商品实际金额=原价-扣除各种优惠 └ present_goods_count Number 10 赠送商品总数量 money_selected_discount GoodsDiscountVo 选中的现金优惠金额(减免或折扣) └ discount_id String 9398231 优惠ID └ discount_money String 800 优惠金额 └ discount_name String 800-30 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1203 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 800-30 优惠规则名称 present_selected_discount_list GoodsDiscountVo [] 赠送优惠对象列表 └ discount_id String 3213 优惠ID └ discount_money String 800 优惠金额 └ discount_name String 800-30 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1201 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 800-30 优惠规则名称 └ discount_total_money String 300 所有商品（赠送）优惠总金额套票优惠+现金优惠 cart_good_info CartGoodInfo cartGoodInfo └ project_id String 41341 项目ID └ project_name String 周杰伦演出项目名称 └ project_img_url String http:www.maitix.com/img.jpg 项目图片地址 └ project_seat_type Number 1 项目座位类型 1=有座、2=无座 └ event_id String 3231 场次ID └ event_name String 周杰伦演出20190101 场次名称 └ site_name String 北京展览馆场馆名称 └ site_version_id String 321312 场馆版本号ID └ event_show_start_time String 20190413 11:11:11 场次演出开始时间 └ event_show_end_time String 20190413 11:11:11 场次演出结束时间 └ price_id String 321312 票档ID └ price_name String 180元票档名称 └ goods_count Number 10 商品数量:如果单票，代表单票的个数，如果是套票，代表套票的数量,如果是有座，数量固定为1，否则代表无座或者实物商品的个数 └ margin_count Number 1023 剩余库存数量 └ is_coupon_ticket Number 1 是否套票 └ price String 18000 票档价格，如果单票，代表单票的价格，如果是套票，代表套票的价格 └ goods_id String 3241312 商品ID └ coupon_group_id String 21213 套票组ID └ coupon_price_id String 31312 套票票档ID └ stock_state Number 1 库存状态：1=有库存，2=无库存 └ floor_name String 1层楼层名称 └ bound_name String vip 区域名称 └ row_name String 1排排名称 └ seat_id String 32131 座位ID └ seat_name String 1座座位名称 └ original_price String 18000 票档原始价格，如果是单票，代表单票的价格，如果是套票，代表套票包含的子票档的所有商品的价格 └ coupon_discount_money String 18000 套票优惠金额 └ money_discount_money String 2000 金钱优惠金额(减免或折扣的一种) └ real_money String 3000 购物车商品实际金额=原价-扣除各种优惠 └ present_goods_count Number 10 赠送商品总数量 money_selected_discount GoodsDiscountVo 选中的现金优惠金额(减免或折扣) └ discount_id String 313121 优惠ID └ discount_money String 300 优惠金额 └ discount_name String 300-30 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1201 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 300-30 优惠规则名称 present_selected_discount_list GoodsDiscountVo [] 赠送优惠对象列表 └ discount_id String 3213121 优惠ID └ discount_money String 30 优惠金额 └ discount_name String 100-30 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1201 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 100-30 优惠规则名称 └ discount_total_money String 100 所有商品（赠送）优惠总金额套票优惠+现金优惠 └ event_limit_type Number 1 场次购票限制类型：0=不限购,1=实名制购票（一单一证）,2=一票一证 └ goods_total_count Number 10 所有商品总数量(包含赠送的) └ goods_count Number 1039 购买商品总数量 └ goods_original_total_money String 1000 所有商品原价总金额 └ goods_discount_total_money String 1000 所有票品优惠总金额(套票优惠+减免或折扣优惠) order_present_list OrderPresentVo [] 订单赠送的权益列表 └ present_type_name String 优惠码赠送的权益类型名称 └ present_content String 优惠码30 赠送的权益内容 order_discount_list OrderDiscountVo [] 可用的订单优惠列表 └ discount_id String 321312 优惠ID └ discount_money String 100 优惠金额(元) └ discount_name String 1000-100 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；优惠码：5.单次使用；6.多次使用； └ discount_rule_type Number 1 优惠规则类型：1.减免；2.折扣；3.赠送; 4. 加价购；5.自定义减免；6.自定义折扣； └ order_discount_rule_id String 32131 选中的优惠规则ID └ discount_rule_name String 1000-100 优惠规则名称 └ coupon_code String sdsa122 优惠码 └ order_discount_id String 31312 订单优惠ID └ order_discount_money String 100 订单优惠金额(不包括票品级别的优惠) coupon_code_discount_list OrderDiscountVo [] 可用的优惠码列表 └ discount_id String 4131 优惠ID └ discount_money String 100 优惠金额(元) └ discount_name String 100-30 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；优惠码：5.单次使用；6.多次使用； └ discount_rule_type Number 1 优惠规则类型：1.减免；2.折扣；3.赠送; 4. 加价购；5.自定义减免；6.自定义折扣； └ order_discount_rule_id String 32131 选中的优惠规则ID └ discount_rule_name String 100-30 优惠规则名称 └ coupon_code String sassa121 优惠码 └ coupon_code_discount_id String 321341 优惠码优惠政策ID └ coupon_code String yshxn12 使用的优惠码 └ coupon_code_discount_money String 30 优惠码优惠金额 user_point_info UserPointVo 会员积分信息 └ user_point Number 102000 会员总积分 └ valid_user_point Number 300 可用于抵扣的积分 └ use_able_money String 30 可抵扣的金额 └ use_point Number 10 使用抵扣的积分数 └ use_point_money String 100 使用积分抵扣的金额 user_account_info UserAccountVo 会员账户余额信息 └ account_money String 318011 账户余额 └ use_able_money String 10 可用于抵扣的余额 └ use_account_money String 10 使用会员账户余额支付的金额 pay_discount_list OrderDiscountVo [] 可用的支付优惠列表 └ discount_id String 213123 优惠ID └ discount_money String 100 优惠金额(元) └ discount_name String 300-100 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；优惠码：5.单次使用；6.多次使用； └ discount_rule_type Number 1 优惠规则类型：1.减免；2.折扣；3.赠送; 4. 加价购；5.自定义减免；6.自定义折扣； └ order_discount_rule_id String 3231 选中的优惠规则ID └ discount_rule_name String 300-100 优惠规则名称 └ coupon_code String safqd1 优惠码 └ pay_discount_id String 321313 支付优惠规则id └ pay_discount_money String 100 支付优惠金额 └ discount_total_money String 2300 所有优惠总金额(套票、票品优惠、订单优惠、优惠码优惠、支付优惠) └ goods_receivable_money String 180 所有商品应收金额；单位：元 └ express_money String 1500 配送费 └ receivable_money String 180 总的应收金额；所有商品应收金额 + 配送费；单位：元 └ online_pay_money String 30000 在线支付的金额：总的应收金额 - 积分抵扣的金额 - 使用余额支付的金额

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest req = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.SubmitOrderParam obj1 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.SubmitOrderParam();
List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParam> list3 = new ArrayList<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParam>();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParam obj4 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParam();
list3.add(obj4);
obj4.setEventId("1802131");
obj4.setPriceId("1280121");
obj4.setGoodsId("809921");
obj4.setGoodsCount(2131L);
obj4.setCouponGroupId("231213");
List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParam> list7 = new ArrayList<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParam>();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParam obj8 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParam();
list7.add(obj8);
obj8.setPriceId("432131");
obj8.setGoodsId("421311");
obj8.setGoodsCount(1L);
list5.setChildList(list7);
obj1.setCartGoodsParamList(list3);
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParam obj9 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParam();
obj9.setBearerId("653231");
obj1.setOrderBearerParam(obj9);
obj1.setReceivableMoney("180");
obj1.setRemark("金牌");
obj1.setShoppingCartId("3213131");
obj1.setUserId("5775654");
obj1.setQuickBuy(false);
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderReceiveParam obj10 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderReceiveParam();
obj10.setReceiveType(2L);
obj10.setTicketType(7L);
obj10.setAddressId("688665");
obj10.setReceiveName("李晴雪");
obj10.setReceivePhone("13901234567");
obj10.setReceiveIdentityCode("110102190010109921");
obj10.setReceiveCardType(1L);
obj1.setOrderReceiveParam(obj10);
obj1.setOrderDiscountId("3131231");
obj1.setOrderDiscountRuleId("41321");
obj1.setOrderDiscountEventIds("313121");
obj1.setCouponCode("sjkaxhh0921");
obj1.setCouponCodeRuleId("31211");
obj1.setCouponCodeEventIds("413344");
obj1.setUsePoint(200L);
obj1.setUsePointMoney("20");
obj1.setPayDiscountId("4324231");
obj1.setLangType(1L);
obj1.setTenantToken("3A9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5icqyWfw");
obj1.setPtnrToken("t5dnxCv1KtwpNaDzuE459yus3m");
obj1.setChannelToken("AxcXYJ72Idfk1231+mCzqSXZLWtCnikX/");
obj1.setUserToken("32132131");
List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParam> list12 = new ArrayList<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParam>();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParam obj13 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParam();
list12.add(obj13);
obj13.setBearerId("32313441");
obj13.setGoodsId("2121312321");
obj13.setPriceId("3214121");
obj1.setOrderBearerParamList(list12);
obj1.setReceivableMoneyFen(180L);
req.setGroupedSubmitOrderParam(obj1);
AlibabaDamaiMaizuoOpenapiOrderSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest req = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.SubmitOrderParamDomain obj1 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.SubmitOrderParamDomain();
List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParamDomain> list3 = new List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParamDomain>();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParamDomain obj4 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.GroupedShoppingCartGoodsParamDomain();
list3.Add(obj4);
obj4.EventId = "1802131";
obj4.PriceId = "1280121";
obj4.GoodsId = "809921";
obj4.GoodsCount = 2131L;
obj4.CouponGroupId = "231213";
List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParamDomain> list6 = new List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParamDomain>();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParamDomain obj7 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.ChildGroupedShoppingCartGoodsParamDomain();
list6.Add(obj7);
obj7.PriceId = "432131";
obj7.GoodsId = "421311";
obj7.GoodsCount = 1L;
obj4.ChildList= list6;
obj1.CartGoodsParamList= list3;
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParamDomain obj8 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParamDomain();
obj8.BearerId = "653231";
obj1.OrderBearerParam= obj8;
obj1.ReceivableMoney = "180";
obj1.Remark = "金牌";
obj1.ShoppingCartId = "3213131";
obj1.UserId = "5775654";
obj1.QuickBuy = false;
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderReceiveParamDomain obj9 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderReceiveParamDomain();
obj9.ReceiveType = 2L;
obj9.TicketType = 7L;
obj9.AddressId = "688665";
obj9.ReceiveName = "李晴雪";
obj9.ReceivePhone = "13901234567";
obj9.ReceiveIdentityCode = "110102190010109921";
obj9.ReceiveCardType = 1L;
obj1.OrderReceiveParam= obj9;
obj1.OrderDiscountId = "3131231";
obj1.OrderDiscountRuleId = "41321";
obj1.OrderDiscountEventIds = "313121";
obj1.CouponCode = "sjkaxhh0921";
obj1.CouponCodeRuleId = "31211";
obj1.CouponCodeEventIds = "413344";
obj1.UsePoint = 200L;
obj1.UsePointMoney = "20";
obj1.PayDiscountId = "4324231";
obj1.LangType = 1L;
obj1.TenantToken = "3A9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5icqyWfw";
obj1.PtnrToken = "t5dnxCv1KtwpNaDzuE459yus3m";
obj1.ChannelToken = "AxcXYJ72Idfk1231+mCzqSXZLWtCnikX/";
obj1.UserToken = "32132131";
List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParamDomain> list11 = new List<AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParamDomain>();
AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParamDomain obj12 = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest.OrderBearerParamDomain();
list11.Add(obj12);
obj12.BearerId = "32313441";
obj12.GoodsId = "2121312321";
obj12.PriceId = "3214121";
obj1.OrderBearerParamList= list11;
obj1.ReceivableMoneyFen = 180L;
req.GroupedSubmitOrderParam_ = obj1;
AlibabaDamaiMaizuoOpenapiOrderSubmitResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMaizuoOpenapiOrderSubmitRequest;
$grouped_submit_order_param = new SubmitOrderParam;
$cart_goods_param_list = new GroupedShoppingCartGoodsParam;
$cart_goods_param_list->event_id="1802131";
$cart_goods_param_list->price_id="1280121";
$cart_goods_param_list->goods_id="809921";
$cart_goods_param_list->goods_count="2131";
$cart_goods_param_list->coupon_group_id="231213";
$child_list = new ChildGroupedShoppingCartGoodsParam;
$child_list->price_id="432131";
$child_list->goods_id="421311";
$child_list->goods_count="1";
$cart_goods_param_list->child_list = $child_list;
$grouped_submit_order_param->cart_goods_param_list = $cart_goods_param_list;
$order_bearer_param = new OrderBearerParam;
$order_bearer_param->bearer_id="653231";
$grouped_submit_order_param->order_bearer_param = $order_bearer_param;
$grouped_submit_order_param->receivable_money="180";
$grouped_submit_order_param->remark="金牌";
$grouped_submit_order_param->shopping_cart_id="3213131";
$grouped_submit_order_param->user_id="5775654";
$grouped_submit_order_param->quick_buy="false";
$order_receive_param = new OrderReceiveParam;
$order_receive_param->receive_type="2";
$order_receive_param->ticket_type="7";
$order_receive_param->address_id="688665";
$order_receive_param->receive_name="李晴雪";
$order_receive_param->receive_phone="13901234567";
$order_receive_param->receive_identity_code="110102190010109921";
$order_receive_param->receive_card_type="1";
$grouped_submit_order_param->order_receive_param = $order_receive_param;
$grouped_submit_order_param->order_discount_id="3131231";
$grouped_submit_order_param->order_discount_rule_id="41321";
$grouped_submit_order_param->order_discount_event_ids="313121";
$grouped_submit_order_param->coupon_code="sjkaxhh0921";
$grouped_submit_order_param->coupon_code_rule_id="31211";
$grouped_submit_order_param->coupon_code_event_ids="413344";
$grouped_submit_order_param->use_point="200";
$grouped_submit_order_param->use_point_money="20";
$grouped_submit_order_param->pay_discount_id="4324231";
$grouped_submit_order_param->lang_type="1";
$grouped_submit_order_param->tenant_token="3A9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5icqyWfw";
$grouped_submit_order_param->ptnr_token="t5dnxCv1KtwpNaDzuE459yus3m";
$grouped_submit_order_param->channel_token="AxcXYJ72Idfk1231+mCzqSXZLWtCnikX/";
$grouped_submit_order_param->user_token="32132131";
$order_bearer_param_list = new OrderBearerParam;
$order_bearer_param_list->bearer_id="32313441";
$order_bearer_param_list->goods_id="2121312321";
$order_bearer_param_list->price_id="3214121";
$grouped_submit_order_param->order_bearer_param_list = $order_bearer_param_list;
$grouped_submit_order_param->receivable_money_fen="180";
$req->setGroupedSubmitOrderParam(json_encode($grouped_submit_order_param));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.damai.maizuo.openapi.order.submit' \
-d 'partner_id=apidoc' \
-d 'sign=7EB17B71466A1D81E1F8BB0BB31061EB' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-01+04%3A30%3A31' \
-d 'v=2.0' \
-d 'grouped_submit_order_param=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaDamaiMaizuoOpenapiOrderSubmitRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.grouped_submit_order_param=""
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.damai.maizuo.openapi.order.submit");
add_param(pRequest,"grouped_submit_order_param","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.damai.maizuo.openapi.order.submit', {
	'grouped_submit_order_param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_maizuo_openapi_order_submit_response>
    <result_data>
        <success>false</success>
        <result_code>10112</result_code>
        <result_msg>失败</result_msg>
        <shopping_cart_vo>
            <partner_id>43241312</partner_id>
            <shopping_cart_id>312121</shopping_cart_id>
            <order_id>3114312211</order_id>
            <cart_goods_list>
                <cart_goods_vo>
                    <child_list>
                        <cart_good_info>
                            <project_id>343113</project_id>
                            <project_name>周杰伦演唱会</project_name>
                            <project_img_url>http:www.maitix.com/img.jpg</project_img_url>
                            <project_seat_type>1</project_seat_type>
                            <event_id>432423423</event_id>
                            <event_name>周杰伦演唱会20190101</event_name>
                            <site_name>北京展览馆</site_name>
                            <site_version_id>321313</site_version_id>
                            <event_show_start_time>20190413 11:11:11</event_show_start_time>
                            <event_show_end_time>20190413 11:11:11</event_show_end_time>
                            <price_id>32321</price_id>
                            <price_name>180元</price_name>
                            <goods_count>102</goods_count>
                            <margin_count>31331</margin_count>
                            <is_coupon_ticket>1</is_coupon_ticket>
                            <price>18000</price>
                            <goods_id>33131</goods_id>
                            <coupon_group_id>434112</coupon_group_id>
                            <coupon_price_id>3131</coupon_price_id>
                            <stock_state>1</stock_state>
                            <floor_name>1层</floor_name>
                            <bound_name>vip</bound_name>
                            <row_name>1排</row_name>
                            <seat_id>214141</seat_id>
                            <seat_name>1座</seat_name>
                            <original_price>18000</original_price>
                            <coupon_discount_money>300</coupon_discount_money>
                            <money_discount_money>300</money_discount_money>
                            <real_money>200</real_money>
                            <present_goods_count>10</present_goods_count>
                            <money_selected_discount>
                                <discount_id>9398231</discount_id>
                                <discount_money>800</discount_money>
                                <discount_name>800-30</discount_name>
                                <discount_type>1</discount_type>
                                <discount_rule_type>1203</discount_rule_type>
                                <discount_rule_name>800-30</discount_rule_name>
                            </money_selected_discount>
                            <present_selected_discount_list>
                                <goods_discount_vo>
                                    <discount_id>3213</discount_id>
                                    <discount_money>800</discount_money>
                                    <discount_name>800-30</discount_name>
                                    <discount_type>1</discount_type>
                                    <discount_rule_type>1201</discount_rule_type>
                                    <discount_rule_name>800-30</discount_rule_name>
                                </goods_discount_vo>
                            </present_selected_discount_list>
                            <discount_total_money>300</discount_total_money>
                        </cart_good_info>
                    </child_list>
                    <cart_good_info>
                        <project_id>41341</project_id>
                        <project_name>周杰伦演出</project_name>
                        <project_img_url>http:www.maitix.com/img.jpg</project_img_url>
                        <project_seat_type>1</project_seat_type>
                        <event_id>3231</event_id>
                        <event_name>周杰伦演出20190101</event_name>
                        <site_name>北京展览馆</site_name>
                        <site_version_id>321312</site_version_id>
                        <event_show_start_time>20190413 11:11:11</event_show_start_time>
                        <event_show_end_time>20190413 11:11:11</event_show_end_time>
                        <price_id>321312</price_id>
                        <price_name>180元</price_name>
                        <goods_count>10</goods_count>
                        <margin_count>1023</margin_count>
                        <is_coupon_ticket>1</is_coupon_ticket>
                        <price>18000</price>
                        <goods_id>3241312</goods_id>
                        <coupon_group_id>21213</coupon_group_id>
                        <coupon_price_id>31312</coupon_price_id>
                        <stock_state>1</stock_state>
                        <floor_name>1层</floor_name>
                        <bound_name>vip</bound_name>
                        <row_name>1排</row_name>
                        <seat_id>32131</seat_id>
                        <seat_name>1座</seat_name>
                        <original_price>18000</original_price>
                        <coupon_discount_money>18000</coupon_discount_money>
                        <money_discount_money>2000</money_discount_money>
                        <real_money>3000</real_money>
                        <present_goods_count>10</present_goods_count>
                        <money_selected_discount>
                            <discount_id>313121</discount_id>
                            <discount_money>300</discount_money>
                            <discount_name>300-30</discount_name>
                            <discount_type>1</discount_type>
                            <discount_rule_type>1201</discount_rule_type>
                            <discount_rule_name>300-30</discount_rule_name>
                        </money_selected_discount>
                        <present_selected_discount_list>
                            <goods_discount_vo>
                                <discount_id>3213121</discount_id>
                                <discount_money>30</discount_money>
                                <discount_name>100-30</discount_name>
                                <discount_type>1</discount_type>
                                <discount_rule_type>1201</discount_rule_type>
                                <discount_rule_name>100-30</discount_rule_name>
                            </goods_discount_vo>
                        </present_selected_discount_list>
                        <discount_total_money>100</discount_total_money>
                    </cart_good_info>
                </cart_goods_vo>
            </cart_goods_list>
            <event_limit_type>1</event_limit_type>
            <goods_total_count>10</goods_total_count>
            <goods_count>1039</goods_count>
            <goods_original_total_money>1000</goods_original_total_money>
            <goods_discount_total_money>1000</goods_discount_total_money>
            <order_present_list>
                <order_present_vo>
                    <present_type_name>优惠码</present_type_name>
                    <present_content>优惠码30</present_content>
                </order_present_vo>
            </order_present_list>
            <order_discount_list>
                <order_discount_vo>
                    <discount_id>321312</discount_id>
                    <discount_money>100</discount_money>
                    <discount_name>1000-100</discount_name>
                    <discount_type>1</discount_type>
                    <discount_rule_type>1</discount_rule_type>
                    <order_discount_rule_id>32131</order_discount_rule_id>
                    <discount_rule_name>1000-100</discount_rule_name>
                    <coupon_code>sdsa122</coupon_code>
                </order_discount_vo>
            </order_discount_list>
            <order_discount_id>31312</order_discount_id>
            <order_discount_money>100</order_discount_money>
            <coupon_code_discount_list>
                <order_discount_vo>
                    <discount_id>4131</discount_id>
                    <discount_money>100</discount_money>
                    <discount_name>100-30</discount_name>
                    <discount_type>1</discount_type>
                    <discount_rule_type>1</discount_rule_type>
                    <order_discount_rule_id>32131</order_discount_rule_id>
                    <discount_rule_name>100-30</discount_rule_name>
                    <coupon_code>sassa121</coupon_code>
                </order_discount_vo>
            </coupon_code_discount_list>
            <coupon_code_discount_id>321341</coupon_code_discount_id>
            <coupon_code>yshxn12</coupon_code>
            <coupon_code_discount_money>30</coupon_code_discount_money>
            <user_point_info>
                <user_point>102000</user_point>
                <valid_user_point>300</valid_user_point>
                <use_able_money>30</use_able_money>
            </user_point_info>
            <use_point>10</use_point>
            <use_point_money>100</use_point_money>
            <user_account_info>
                <account_money>318011</account_money>
                <use_able_money>10</use_able_money>
            </user_account_info>
            <use_account_money>10</use_account_money>
            <pay_discount_list>
                <order_discount_vo>
                    <discount_id>213123</discount_id>
                    <discount_money>100</discount_money>
                    <discount_name>300-100</discount_name>
                    <discount_type>1</discount_type>
                    <discount_rule_type>1</discount_rule_type>
                    <order_discount_rule_id>3231</order_discount_rule_id>
                    <discount_rule_name>300-100</discount_rule_name>
                    <coupon_code>safqd1</coupon_code>
                </order_discount_vo>
            </pay_discount_list>
            <pay_discount_id>321313</pay_discount_id>
            <pay_discount_money>100</pay_discount_money>
            <discount_total_money>2300</discount_total_money>
            <goods_receivable_money>180</goods_receivable_money>
            <express_money>1500</express_money>
            <receivable_money>180</receivable_money>
            <online_pay_money>30000</online_pay_money>
        </shopping_cart_vo>
    </result_data>
</alibaba_damai_maizuo_openapi_order_submit_response>

{
    "alibaba_damai_maizuo_openapi_order_submit_response":{
        "result_data":{
            "success":false,
            "result_code":10112,
            "result_msg":"失败",
            "shopping_cart_vo":{
                "partner_id":"43241312",
                "shopping_cart_id":"312121",
                "order_id":"3114312211",
                "cart_goods_list":{
                    "cart_goods_vo":[
                        {
                            "child_list":{
                                "cart_good_info":[
                                    {
                                        "project_id":"343113",
                                        "project_name":"周杰伦演唱会",
                                        "project_img_url":"http:www.maitix.com\/img.jpg",
                                        "project_seat_type":1,
                                        "event_id":"432423423",
                                        "event_name":"周杰伦演唱会20190101",
                                        "site_name":"北京展览馆",
                                        "site_version_id":"321313",
                                        "event_show_start_time":"20190413 11:11:11",
                                        "event_show_end_time":"20190413 11:11:11",
                                        "price_id":"32321",
                                        "price_name":"180元",
                                        "goods_count":102,
                                        "margin_count":31331,
                                        "is_coupon_ticket":1,
                                        "price":"18000",
                                        "goods_id":"33131",
                                        "coupon_group_id":"434112",
                                        "coupon_price_id":"3131",
                                        "stock_state":1,
                                        "floor_name":"1层",
                                        "bound_name":"vip",
                                        "row_name":"1排",
                                        "seat_id":"214141",
                                        "seat_name":"1座",
                                        "original_price":"18000",
                                        "coupon_discount_money":"300",
                                        "money_discount_money":"300",
                                        "real_money":"200",
                                        "present_goods_count":10,
                                        "money_selected_discount":{
                                            "discount_id":"9398231",
                                            "discount_money":"800",
                                            "discount_name":"800-30",
                                            "discount_type":1,
                                            "discount_rule_type":1203,
                                            "discount_rule_name":"800-30"
                                        },
                                        "present_selected_discount_list":{
                                            "goods_discount_vo":[
                                                {
                                                    "discount_id":"3213",
                                                    "discount_money":"800",
                                                    "discount_name":"800-30",
                                                    "discount_type":1,
                                                    "discount_rule_type":1201,
                                                    "discount_rule_name":"800-30"
                                                }
                                            ]
                                        },
                                        "discount_total_money":"300"
                                    }
                                ]
                            },
                            "cart_good_info":{
                                "project_id":"41341",
                                "project_name":"周杰伦演出",
                                "project_img_url":"http:www.maitix.com\/img.jpg",
                                "project_seat_type":1,
                                "event_id":"3231",
                                "event_name":"周杰伦演出20190101",
                                "site_name":"北京展览馆",
                                "site_version_id":"321312",
                                "event_show_start_time":"20190413 11:11:11",
                                "event_show_end_time":"20190413 11:11:11",
                                "price_id":"321312",
                                "price_name":"180元",
                                "goods_count":10,
                                "margin_count":1023,
                                "is_coupon_ticket":1,
                                "price":"18000",
                                "goods_id":"3241312",
                                "coupon_group_id":"21213",
                                "coupon_price_id":"31312",
                                "stock_state":1,
                                "floor_name":"1层",
                                "bound_name":"vip",
                                "row_name":"1排",
                                "seat_id":"32131",
                                "seat_name":"1座",
                                "original_price":"18000",
                                "coupon_discount_money":"18000",
                                "money_discount_money":"2000",
                                "real_money":"3000",
                                "present_goods_count":10,
                                "money_selected_discount":{
                                    "discount_id":"313121",
                                    "discount_money":"300",
                                    "discount_name":"300-30",
                                    "discount_type":1,
                                    "discount_rule_type":1201,
                                    "discount_rule_name":"300-30"
                                },
                                "present_selected_discount_list":{
                                    "goods_discount_vo":[
                                        {
                                            "discount_id":"3213121",
                                            "discount_money":"30",
                                            "discount_name":"100-30",
                                            "discount_type":1,
                                            "discount_rule_type":1201,
                                            "discount_rule_name":"100-30"
                                        }
                                    ]
                                },
                                "discount_total_money":"100"
                            }
                        }
                    ]
                },
                "event_limit_type":1,
                "goods_total_count":10,
                "goods_count":1039,
                "goods_original_total_money":"1000",
                "goods_discount_total_money":"1000",
                "order_present_list":{
                    "order_present_vo":[
                        {
                            "present_type_name":"优惠码",
                            "present_content":"优惠码30"
                        }
                    ]
                },
                "order_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"321312",
                            "discount_money":"100",
                            "discount_name":"1000-100",
                            "discount_type":1,
                            "discount_rule_type":1,
                            "order_discount_rule_id":"32131",
                            "discount_rule_name":"1000-100",
                            "coupon_code":"sdsa122"
                        }
                    ]
                },
                "order_discount_id":"31312",
                "order_discount_money":"100",
                "coupon_code_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"4131",
                            "discount_money":"100",
                            "discount_name":"100-30",
                            "discount_type":1,
                            "discount_rule_type":1,
                            "order_discount_rule_id":"32131",
                            "discount_rule_name":"100-30",
                            "coupon_code":"sassa121"
                        }
                    ]
                },
                "coupon_code_discount_id":"321341",
                "coupon_code":"yshxn12",
                "coupon_code_discount_money":"30",
                "user_point_info":{
                    "user_point":102000,
                    "valid_user_point":300,
                    "use_able_money":"30"
                },
                "use_point":10,
                "use_point_money":"100",
                "user_account_info":{
                    "account_money":"318011",
                    "use_able_money":"10"
                },
                "use_account_money":"10",
                "pay_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"213123",
                            "discount_money":"100",
                            "discount_name":"300-100",
                            "discount_type":1,
                            "discount_rule_type":1,
                            "order_discount_rule_id":"3231",
                            "discount_rule_name":"300-100",
                            "coupon_code":"safqd1"
                        }
                    ]
                },
                "pay_discount_id":"321313",
                "pay_discount_money":"100",
                "discount_total_money":"2300",
                "goods_receivable_money":"180",
                "express_money":"1500",
                "receivable_money":"180",
                "online_pay_money":"30000"
            }
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

麦座API

alibaba.damai.maizuo.openapi.order.submit (订单创建API)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ