淘宝开放平台 - 文档中心

请求地址：

环境	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_shopping_cart_param	GroupedShoppingCartParam	必须			套票分组之后再次提交的购物车参数对象
cart_goods_param_list GroupedShoppingCartGoodsParam [] 可选已经分组的商品列表 └ event_id String 可选 30009991 场次ID └ price_id String 可选 400012111 票档ID └ goods_id String 可选 4001111231 商品ID └ goods_count Number 可选 10 商品数量 └ coupon_group_id String 可选 983111 套票组ID child_list ChildGroupedShoppingCartGoodsParam [] 可选组合之后的子票档列表 └ price_id String 可选 41211123 票档ID └ goods_id String 可选 331211123 商品ID └ goods_count Number 可选 10 商品数量 └ shopping_cart_id String 可选 131411112 当前购物车ID，服务器后台随机生成 └ user_id String 可选 34324351 会员ID └ quick_buy Boolean 可选 false 是否是快速购买：true=快速购买，false=购物车购买，如果选择限购商品，只能传递true order_receive_param OrderReceiveParam 可选订单收货人信息 └ receive_type Number 可选 0 收货类型，0=不确定，1=上门自取，2=现场取票，3=配送，4=大麦配送 └ ticket_type Number 可选 0 票品类型，0=不确定、1=纸质票、2=身份证票、3=短信票、4=邮件、5=身份证票&短信票、6=联票卡、7=有纸化二维码、8=无纸化二维码 └ address_id String 可选 799123 收货人地址ID └ receive_name String 可选赢川收货人姓名 └ receive_email String 可选 xxxx@sina.com 收货人邮箱 └ receive_phone String 可选 15001234567 收货人手机号 └ receive_identity_code String 可选 110xxxxx131 收货人证件号码 └ order_discount_id String 可选 2441 选中的订单优惠ID └ order_discount_rule_id String 可选 3131413 选中的订单优惠规则ID └ order_discount_event_ids String 可选 11312,2414 选中的订单优惠关联场次id列表,以逗号(,)隔开 └ coupon_code String 可选 asa1d13 订单使用的优惠码 └ coupon_code_rule_id String 可选 3141212 使用的优惠码对应优惠规则ID └ coupon_code_event_ids String 可选 31241341 使用的优惠码关联场次id列表,以逗号(,)隔开 └ use_point Number 可选 10 订单使用的积分数 └ use_point_money String 可选 1000 订单使用积分抵扣的金额(元) └ gift_card_no String 可选 ddee131 使用礼品卡支付的卡号 └ gift_card_pay_password String 可选 erd1341 礼品卡支付密码 └ use_gift_card_money String 可选 1000 订单使用礼品卡抵扣的金额(元) └ use_account_money String 可选 1000 订单使用账户余额支付的金额(元) └ pay_discount_id String 可选 431413 选中的支付优惠ID └ lang_type Number 可选 1 语言类型：1=中文，2=英文 └ tenant_token String 必须 9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5i 向api服务提供商获取 └ ptnr_token String 必须 t5dnxCv1KtwpNaDzuE459yus3m6 向api服务提供商获取 └ channel_token String 必须 t5dnxCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5 向api服务提供商获取 └ user_token String 可选 321321411 userId

名称	类型	示例值	描述
result_data	ResultData		统一返回值对象
└ success Boolean true 是否成功 └ result_code Number 200 状态码 └ result_msg String 成功提示信息 shopping_cart_vo ShoppingCartVo 返回数据 └ shopping_cart_id String 23241123 当前购物车ID，服务器后台随机生成 └ order_id String 100002111 如果已成订单，返回订单ID cart_goods_list CartGoodsVo [] 购物车商品信息列表 child_list CartGoodInfo [] 子商品列表 └ project_id String 324141 项目ID └ project_name String 周杰伦演出会项目名称 └ project_img_url String http:www.maitix.com/img.jpg 项目图片地址 └ project_seat_type Number 1 项目座位类型 1=有座、2=无座 └ event_id String 32414111 场次ID └ event_name String 周杰伦演出会20190101 场次名称 └ site_name String 北京展览馆场馆名称 └ site_version_id String 543333 场馆版本号ID └ event_show_start_time String 2019-04-03 20:17:40 场次演出开始时间 └ event_show_end_time String 2019-04-03 20:17:40 场次演出结束时间 └ price_id String 1242141 票档ID └ price_name String 180元票档名称 └ goods_count Number 10 商品数量:如果单票，代表单票的个数，如果是套票，代表套票的数量,如果是有座，数量固定为1，否则代表无座或者实物商品的个数 └ margin_count Number 10211 剩余库存数量 └ is_coupon_ticket Number 1 是否套票 └ price String 18000 票档价格，如果单票，代表单票的价格，如果是套票，代表套票的价格 └ goods_id String 221421 商品ID └ coupon_group_id String 411121 套票组ID └ coupon_price_id String 233124 套票票档ID └ stock_state Number 1 库存状态：1=有库存，2=无库存 └ floor_name String 一层楼层名称 └ bound_name String vip区区域名称 └ row_name String 1排排名称 └ seat_id String 313141 座位ID └ seat_name String 8座座位名称 └ original_price String 18000 票档原始价格，如果是单票，代表单票的价格，如果是套票，代表套票包含的子票档的所有商品的价格 └ coupon_discount_money String 17000 套票优惠金额 └ money_discount_money String 10000 金钱优惠金额(减免或折扣的一种) └ real_money String 10000 购物车商品实际金额=原价-扣除各种优惠 └ present_goods_count Number 3 赠送商品总数量 money_selected_discount GoodsDiscountVo 选中的现金优惠金额(减免或折扣) └ discount_id String 24143141 优惠ID └ discount_money String 100 优惠金额 └ discount_name String 满2-1 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1203 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 满2-1 优惠规则名称 present_selected_discount_list GoodsDiscountVo [] 赠送优惠对象列表 └ discount_id String 123113 优惠ID └ discount_money String 200 优惠金额 └ discount_name String 满100-2 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1203 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 满100-2 优惠规则名称 └ discount_total_money String 1000 所有商品（赠送）优惠总金额套票优惠+现金优惠 cart_good_info CartGoodInfo cartGoodInfo └ project_id String 3213111 项目ID └ project_name String 周杰伦演出会项目名称 └ project_img_url String http:www.maitix.com/img.jpg 项目图片地址 └ project_seat_type Number 1 项目座位类型 1=有座、2=无座 └ event_id String 121455241 场次ID └ event_name String 周杰伦201190101 场次名称 └ site_name String 北京展览馆场馆名称 └ site_version_id String 2421421 场馆版本号ID └ event_show_start_time String 2019-04-03 20:17:40 场次演出开始时间 └ event_show_end_time String 2019-04-03 20:17:40 场次演出结束时间 └ price_id String 43242 票档ID └ price_name String 180元票档名称 └ goods_count Number 10 商品数量:如果单票，代表单票的个数，如果是套票，代表套票的数量,如果是有座，数量固定为1，否则代表无座或者实物商品的个数 └ margin_count Number 10321 剩余库存数量 └ is_coupon_ticket Number 1 是否套票 └ price String 18000 票档价格，如果单票，代表单票的价格，如果是套票，代表套票的价格 └ goods_id String 52523 商品ID └ coupon_group_id String 3123141 套票组ID └ coupon_price_id String 3123123 套票票档ID └ stock_state Number 1 库存状态：1=有库存，2=无库存 └ floor_name String 一层楼层名称 └ bound_name String vip 区域名称 └ row_name String 3排排名称 └ seat_id String 432423 座位ID └ seat_name String 8座座位名称 └ original_price String 1000 票档原始价格，如果是单票，代表单票的价格，如果是套票，代表套票包含的子票档的所有商品的价格 └ coupon_discount_money String 100 套票优惠金额 └ money_discount_money String 19900 金钱优惠金额(减免或折扣的一种) └ real_money String 19900 购物车商品实际金额=原价-扣除各种优惠 └ present_goods_count Number 10 赠送商品总数量 money_selected_discount GoodsDiscountVo 选中的现金优惠金额(减免或折扣) └ discount_id String 4252525 优惠ID └ discount_money String 19900 优惠金额 └ discount_name String 满10000-199 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1203 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 满10000-199 优惠规则名称 present_selected_discount_list GoodsDiscountVo [] 赠送优惠对象列表 └ discount_id String 4324211 优惠ID └ discount_money String 100 优惠金额 └ discount_name String 满100打7折优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1203 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 满100打7折优惠规则名称 └ discount_total_money String 100 所有商品（赠送）优惠总金额套票优惠+现金优惠 └ event_limit_type Number 1 场次购票限制类型：0=不限购,1=实名制购票（一单一证）,2=一票一证 └ goods_total_count Number 10 所有商品总数量(包含赠送的) └ goods_count Number 1013 购买商品总数量 └ goods_original_total_money String 19000 所有商品原价总金额 └ goods_discount_total_money String 19000 所有票品优惠总金额(套票优惠+减免或折扣优惠) order_present_list OrderPresentVo [] 订单赠送的权益列表 └ present_type_name String 优惠码赠送的权益类型名称 └ present_content String 优惠码赠送的权益内容 order_discount_list OrderDiscountVo [] 可用的订单优惠列表 └ discount_id String 4124121 优惠ID └ discount_money String 100 优惠金额(元) └ discount_name String 优惠码优惠名称 └ discount_type Number 4 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；优惠码：5.单次使用；6.多次使用； └ discount_rule_type Number 1 优惠规则类型：1.减免；2.折扣；3.赠送; 4. 加价购；5.自定义减免；6.自定义折扣； └ order_discount_rule_id String 321312 选中的优惠规则ID └ discount_rule_name String 优惠码优惠规则名称 └ coupon_code String 2dsd111 优惠码 └ order_discount_id String 4214131 订单优惠ID └ order_discount_money String 1000 订单优惠金额(不包括票品级别的优惠) coupon_code_discount_list OrderDiscountVo [] 可用的优惠码列表 └ discount_id String 19001321 优惠ID └ discount_money String 1900 优惠金额(元) └ discount_name String 100-30 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；优惠码：5.单次使用；6.多次使用； └ discount_rule_type Number 2 优惠规则类型：1.减免；2.折扣；3.赠送; 4. 加价购；5.自定义减免；6.自定义折扣； └ order_discount_rule_id String 32113 选中的优惠规则ID └ discount_rule_name String 30 优惠规则名称 └ coupon_code String dsdsda11 优惠码 └ coupon_code_discount_id String 3214131 优惠码优惠政策ID └ coupon_code String dssas1231 使用的优惠码 └ coupon_code_discount_money String 1000 优惠码优惠金额 user_point_info UserPointVo 会员积分信息 └ user_point Number 10001110 会员总积分 └ valid_user_point Number 300 可用于抵扣的积分 └ use_able_money String 3000 可抵扣的金额 └ use_point Number 10 使用抵扣的积分数 └ use_point_money String 1900 使用积分抵扣的金额 user_account_info UserAccountVo 会员账户余额信息 └ account_money String 1911900 账户余额 └ use_able_money String 32100 可用于抵扣的余额 └ use_account_money String 100 使用会员账户余额支付的金额 pay_discount_list OrderDiscountVo [] 可用的支付优惠列表 └ discount_id String 323213131 优惠ID └ discount_money String 3000 优惠金额(元) └ discount_name String 30000-3000 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；优惠码：5.单次使用；6.多次使用； └ discount_rule_type Number 2 优惠规则类型：1.减免；2.折扣；3.赠送; 4. 加价购；5.自定义减免；6.自定义折扣； └ order_discount_rule_id String 32312 选中的优惠规则ID └ discount_rule_name String 30000-3000 优惠规则名称 └ coupon_code String dvsd1311 优惠码 └ pay_discount_id String 213131 支付优惠规则id └ pay_discount_money String 100 支付优惠金额 └ discount_total_money String 1000 所有优惠总金额(套票、票品优惠、订单优惠、优惠码优惠、支付优惠) └ goods_receivable_money String 100 所有商品应收金额 └ express_money String 1300 配送费 └ receivable_money String 319000 总的应收金额：所有商品应收金额 + 配送费 └ online_pay_money String 319000 在线支付的金额：总的应收金额 - 积分抵扣的金额 - 使用余额支付的金额 └ ticket_type_list Number [] 4,1 票品类型列表：0=不确定、1=纸质票、2=身份证票、3=短信票、4=邮件、5=身份证票&短信票、6=联票卡、7=有纸化二维码、8=无纸化二维码

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest req = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest();
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartParam obj1 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartParam();
List<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParam> list3 = new ArrayList<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParam>();
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParam obj4 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParam();
list3.add(obj4);
obj4.setEventId("30009991");
obj4.setPriceId("400012111");
obj4.setGoodsId("4001111231");
obj4.setGoodsCount(10L);
obj4.setCouponGroupId("983111");
List<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParam> list7 = new ArrayList<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParam>();
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParam obj8 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParam();
list7.add(obj8);
obj8.setPriceId("41211123");
obj8.setGoodsId("331211123");
obj8.setGoodsCount(10L);
list5.setChildList(list7);
obj1.setCartGoodsParamList(list3);
obj1.setShoppingCartId("131411112");
obj1.setUserId("34324351");
obj1.setQuickBuy(false);
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.OrderReceiveParam obj9 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.OrderReceiveParam();
obj9.setReceiveType(0L);
obj9.setTicketType(0L);
obj9.setAddressId("799123");
obj9.setReceiveName("赢川");
obj9.setReceiveEmail("xxxx@sina.com");
obj9.setReceivePhone("15001234567");
obj9.setReceiveIdentityCode("110xxxxx131");
obj1.setOrderReceiveParam(obj9);
obj1.setOrderDiscountId("2441");
obj1.setOrderDiscountRuleId("3131413");
obj1.setOrderDiscountEventIds("11312,2414");
obj1.setCouponCode("asa1d13");
obj1.setCouponCodeRuleId("3141212");
obj1.setCouponCodeEventIds("31241341");
obj1.setUsePoint(10L);
obj1.setUsePointMoney("1000");
obj1.setGiftCardNo("ddee131");
obj1.setGiftCardPayPassword("erd1341");
obj1.setUseGiftCardMoney("1000");
obj1.setUseAccountMoney("1000");
obj1.setPayDiscountId("431413");
obj1.setLangType(1L);
obj1.setTenantToken("9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5i");
obj1.setPtnrToken("t5dnxCv1KtwpNaDzuE459yus3m6");
obj1.setChannelToken("t5dnxCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5");
obj1.setUserToken("321321411");
req.setGroupedShoppingCartParam(obj1);
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest req = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest();
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartParamDomain obj1 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartParamDomain();
List<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParamDomain> list3 = new List<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParamDomain>();
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParamDomain obj4 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.GroupedShoppingCartGoodsParamDomain();
list3.Add(obj4);
obj4.EventId = "30009991";
obj4.PriceId = "400012111";
obj4.GoodsId = "4001111231";
obj4.GoodsCount = 10L;
obj4.CouponGroupId = "983111";
List<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParamDomain> list6 = new List<AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParamDomain>();
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParamDomain obj7 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.ChildGroupedShoppingCartGoodsParamDomain();
list6.Add(obj7);
obj7.PriceId = "41211123";
obj7.GoodsId = "331211123";
obj7.GoodsCount = 10L;
obj4.ChildList= list6;
obj1.CartGoodsParamList= list3;
obj1.ShoppingCartId = "131411112";
obj1.UserId = "34324351";
obj1.QuickBuy = false;
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.OrderReceiveParamDomain obj8 = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest.OrderReceiveParamDomain();
obj8.ReceiveType = 0L;
obj8.TicketType = 0L;
obj8.AddressId = "799123";
obj8.ReceiveName = "赢川";
obj8.ReceiveEmail = "xxxx@sina.com";
obj8.ReceivePhone = "15001234567";
obj8.ReceiveIdentityCode = "110xxxxx131";
obj1.OrderReceiveParam= obj8;
obj1.OrderDiscountId = "2441";
obj1.OrderDiscountRuleId = "3131413";
obj1.OrderDiscountEventIds = "11312,2414";
obj1.CouponCode = "asa1d13";
obj1.CouponCodeRuleId = "3141212";
obj1.CouponCodeEventIds = "31241341";
obj1.UsePoint = 10L;
obj1.UsePointMoney = "1000";
obj1.GiftCardNo = "ddee131";
obj1.GiftCardPayPassword = "erd1341";
obj1.UseGiftCardMoney = "1000";
obj1.UseAccountMoney = "1000";
obj1.PayDiscountId = "431413";
obj1.LangType = 1L;
obj1.TenantToken = "9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5i";
obj1.PtnrToken = "t5dnxCv1KtwpNaDzuE459yus3m6";
obj1.ChannelToken = "t5dnxCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5";
obj1.UserToken = "321321411";
req.GroupedShoppingCartParam_ = obj1;
AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMaizuoOpenapiTradeShopcartGroupBuildRequest;
$grouped_shopping_cart_param = new GroupedShoppingCartParam;
$cart_goods_param_list = new GroupedShoppingCartGoodsParam;
$cart_goods_param_list->event_id="30009991";
$cart_goods_param_list->price_id="400012111";
$cart_goods_param_list->goods_id="4001111231";
$cart_goods_param_list->goods_count="10";
$cart_goods_param_list->coupon_group_id="983111";
$child_list = new ChildGroupedShoppingCartGoodsParam;
$child_list->price_id="41211123";
$child_list->goods_id="331211123";
$child_list->goods_count="10";
$cart_goods_param_list->child_list = $child_list;
$grouped_shopping_cart_param->cart_goods_param_list = $cart_goods_param_list;
$grouped_shopping_cart_param->shopping_cart_id="131411112";
$grouped_shopping_cart_param->user_id="34324351";
$grouped_shopping_cart_param->quick_buy="false";
$order_receive_param = new OrderReceiveParam;
$order_receive_param->receive_type="0";
$order_receive_param->ticket_type="0";
$order_receive_param->address_id="799123";
$order_receive_param->receive_name="赢川";
$order_receive_param->receive_email="xxxx@sina.com";
$order_receive_param->receive_phone="15001234567";
$order_receive_param->receive_identity_code="110xxxxx131";
$grouped_shopping_cart_param->order_receive_param = $order_receive_param;
$grouped_shopping_cart_param->order_discount_id="2441";
$grouped_shopping_cart_param->order_discount_rule_id="3131413";
$grouped_shopping_cart_param->order_discount_event_ids="11312,2414";
$grouped_shopping_cart_param->coupon_code="asa1d13";
$grouped_shopping_cart_param->coupon_code_rule_id="3141212";
$grouped_shopping_cart_param->coupon_code_event_ids="31241341";
$grouped_shopping_cart_param->use_point="10";
$grouped_shopping_cart_param->use_point_money="1000";
$grouped_shopping_cart_param->gift_card_no="ddee131";
$grouped_shopping_cart_param->gift_card_pay_password="erd1341";
$grouped_shopping_cart_param->use_gift_card_money="1000";
$grouped_shopping_cart_param->use_account_money="1000";
$grouped_shopping_cart_param->pay_discount_id="431413";
$grouped_shopping_cart_param->lang_type="1";
$grouped_shopping_cart_param->tenant_token="9UJj/8SWB5xLq54Tn623qFzG+2u39r5xP5i";
$grouped_shopping_cart_param->ptnr_token="t5dnxCv1KtwpNaDzuE459yus3m6";
$grouped_shopping_cart_param->channel_token="t5dnxCv1KtwpNaDzuE459yus3m6F7FEG+2u39r5";
$grouped_shopping_cart_param->user_token="321321411";
$req->setGroupedShoppingCartParam(json_encode($grouped_shopping_cart_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.trade.shopcart.group.build' \
-d 'partner_id=apidoc' \
-d 'sign=D5561DFF8719704951A791CC862E6D74' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-01+04%3A10%3A28' \
-d 'v=2.0' \
-d 'grouped_shopping_cart_param=null'

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

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

req.grouped_shopping_cart_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.trade.shopcart.group.build");
add_param(pRequest,"grouped_shopping_cart_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.trade.shopcart.group.build', {
	'grouped_shopping_cart_param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_maizuo_openapi_trade_shopcart_group_build_response>
    <result_data>
        <success>true</success>
        <result_code>200</result_code>
        <result_msg>成功</result_msg>
        <shopping_cart_vo>
            <shopping_cart_id>23241123</shopping_cart_id>
            <order_id>100002111</order_id>
            <cart_goods_list>
                <cart_goods_vo>
                    <child_list>
                        <cart_good_info>
                            <project_id>324141</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>32414111</event_id>
                            <event_name>周杰伦演出会20190101</event_name>
                            <site_name>北京展览馆</site_name>
                            <site_version_id>543333</site_version_id>
                            <event_show_start_time>2019-04-03 20:17:40</event_show_start_time>
                            <event_show_end_time>2019-04-03 20:17:40</event_show_end_time>
                            <price_id>1242141</price_id>
                            <price_name>180元</price_name>
                            <goods_count>10</goods_count>
                            <margin_count>10211</margin_count>
                            <is_coupon_ticket>1</is_coupon_ticket>
                            <price>18000</price>
                            <goods_id>221421</goods_id>
                            <coupon_group_id>411121</coupon_group_id>
                            <coupon_price_id>233124</coupon_price_id>
                            <stock_state>1</stock_state>
                            <floor_name>一层</floor_name>
                            <bound_name>vip区</bound_name>
                            <row_name>1排</row_name>
                            <seat_id>313141</seat_id>
                            <seat_name>8座</seat_name>
                            <original_price>18000</original_price>
                            <coupon_discount_money>17000</coupon_discount_money>
                            <money_discount_money>10000</money_discount_money>
                            <real_money>10000</real_money>
                            <present_goods_count>3</present_goods_count>
                            <money_selected_discount>
                                <discount_id>24143141</discount_id>
                                <discount_money>100</discount_money>
                                <discount_name>满2-1</discount_name>
                                <discount_type>1</discount_type>
                                <discount_rule_type>1203</discount_rule_type>
                                <discount_rule_name>满2-1</discount_rule_name>
                            </money_selected_discount>
                            <present_selected_discount_list>
                                <goods_discount_vo>
                                    <discount_id>123113</discount_id>
                                    <discount_money>200</discount_money>
                                    <discount_name>满100-2</discount_name>
                                    <discount_type>1</discount_type>
                                    <discount_rule_type>1203</discount_rule_type>
                                    <discount_rule_name>满100-2</discount_rule_name>
                                </goods_discount_vo>
                            </present_selected_discount_list>
                            <discount_total_money>1000</discount_total_money>
                        </cart_good_info>
                    </child_list>
                    <cart_good_info>
                        <project_id>3213111</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>121455241</event_id>
                        <event_name>周杰伦201190101</event_name>
                        <site_name>北京展览馆</site_name>
                        <site_version_id>2421421</site_version_id>
                        <event_show_start_time>2019-04-03 20:17:40</event_show_start_time>
                        <event_show_end_time>2019-04-03 20:17:40</event_show_end_time>
                        <price_id>43242</price_id>
                        <price_name>180元</price_name>
                        <goods_count>10</goods_count>
                        <margin_count>10321</margin_count>
                        <is_coupon_ticket>1</is_coupon_ticket>
                        <price>18000</price>
                        <goods_id>52523</goods_id>
                        <coupon_group_id>3123141</coupon_group_id>
                        <coupon_price_id>3123123</coupon_price_id>
                        <stock_state>1</stock_state>
                        <floor_name>一层</floor_name>
                        <bound_name>vip</bound_name>
                        <row_name>3排</row_name>
                        <seat_id>432423</seat_id>
                        <seat_name>8座</seat_name>
                        <original_price>1000</original_price>
                        <coupon_discount_money>100</coupon_discount_money>
                        <money_discount_money>19900</money_discount_money>
                        <real_money>19900</real_money>
                        <present_goods_count>10</present_goods_count>
                        <money_selected_discount>
                            <discount_id>4252525</discount_id>
                            <discount_money>19900</discount_money>
                            <discount_name>满10000-199</discount_name>
                            <discount_type>1</discount_type>
                            <discount_rule_type>1203</discount_rule_type>
                            <discount_rule_name>满10000-199</discount_rule_name>
                        </money_selected_discount>
                        <present_selected_discount_list>
                            <goods_discount_vo>
                                <discount_id>4324211</discount_id>
                                <discount_money>100</discount_money>
                                <discount_name>满100打7折</discount_name>
                                <discount_type>1</discount_type>
                                <discount_rule_type>1203</discount_rule_type>
                                <discount_rule_name>满100打7折</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>1013</goods_count>
            <goods_original_total_money>19000</goods_original_total_money>
            <goods_discount_total_money>19000</goods_discount_total_money>
            <order_present_list>
                <order_present_vo>
                    <present_type_name>优惠码</present_type_name>
                    <present_content>优惠码</present_content>
                </order_present_vo>
            </order_present_list>
            <order_discount_list>
                <order_discount_vo>
                    <discount_id>4124121</discount_id>
                    <discount_money>100</discount_money>
                    <discount_name>优惠码</discount_name>
                    <discount_type>4</discount_type>
                    <discount_rule_type>1</discount_rule_type>
                    <order_discount_rule_id>321312</order_discount_rule_id>
                    <discount_rule_name>优惠码</discount_rule_name>
                    <coupon_code>2dsd111</coupon_code>
                </order_discount_vo>
            </order_discount_list>
            <order_discount_id>4214131</order_discount_id>
            <order_discount_money>1000</order_discount_money>
            <coupon_code_discount_list>
                <order_discount_vo>
                    <discount_id>19001321</discount_id>
                    <discount_money>1900</discount_money>
                    <discount_name>100-30</discount_name>
                    <discount_type>1</discount_type>
                    <discount_rule_type>2</discount_rule_type>
                    <order_discount_rule_id>32113</order_discount_rule_id>
                    <discount_rule_name>30</discount_rule_name>
                    <coupon_code>dsdsda11</coupon_code>
                </order_discount_vo>
            </coupon_code_discount_list>
            <coupon_code_discount_id>3214131</coupon_code_discount_id>
            <coupon_code>dssas1231</coupon_code>
            <coupon_code_discount_money>1000</coupon_code_discount_money>
            <user_point_info>
                <user_point>10001110</user_point>
                <valid_user_point>300</valid_user_point>
                <use_able_money>3000</use_able_money>
            </user_point_info>
            <use_point>10</use_point>
            <use_point_money>1900</use_point_money>
            <user_account_info>
                <account_money>1911900</account_money>
                <use_able_money>32100</use_able_money>
            </user_account_info>
            <use_account_money>100</use_account_money>
            <pay_discount_list>
                <order_discount_vo>
                    <discount_id>323213131</discount_id>
                    <discount_money>3000</discount_money>
                    <discount_name>30000-3000</discount_name>
                    <discount_type>1</discount_type>
                    <discount_rule_type>2</discount_rule_type>
                    <order_discount_rule_id>32312</order_discount_rule_id>
                    <discount_rule_name>30000-3000</discount_rule_name>
                    <coupon_code>dvsd1311</coupon_code>
                </order_discount_vo>
            </pay_discount_list>
            <pay_discount_id>213131</pay_discount_id>
            <pay_discount_money>100</pay_discount_money>
            <discount_total_money>1000</discount_total_money>
            <goods_receivable_money>100</goods_receivable_money>
            <express_money>1300</express_money>
            <receivable_money>319000</receivable_money>
            <online_pay_money>319000</online_pay_money>
            <ticket_type_list>
                <number>4</number>
                <number>1</number>
            </ticket_type_list>
        </shopping_cart_vo>
    </result_data>
</alibaba_damai_maizuo_openapi_trade_shopcart_group_build_response>

{
    "alibaba_damai_maizuo_openapi_trade_shopcart_group_build_response":{
        "result_data":{
            "success":true,
            "result_code":200,
            "result_msg":"成功",
            "shopping_cart_vo":{
                "shopping_cart_id":"23241123",
                "order_id":"100002111",
                "cart_goods_list":{
                    "cart_goods_vo":[
                        {
                            "child_list":{
                                "cart_good_info":[
                                    {
                                        "project_id":"324141",
                                        "project_name":"周杰伦演出会",
                                        "project_img_url":"http:www.maitix.com\/img.jpg",
                                        "project_seat_type":1,
                                        "event_id":"32414111",
                                        "event_name":"周杰伦演出会20190101",
                                        "site_name":"北京展览馆",
                                        "site_version_id":"543333",
                                        "event_show_start_time":"2019-04-03 20:17:40",
                                        "event_show_end_time":"2019-04-03 20:17:40",
                                        "price_id":"1242141",
                                        "price_name":"180元",
                                        "goods_count":10,
                                        "margin_count":10211,
                                        "is_coupon_ticket":1,
                                        "price":"18000",
                                        "goods_id":"221421",
                                        "coupon_group_id":"411121",
                                        "coupon_price_id":"233124",
                                        "stock_state":1,
                                        "floor_name":"一层",
                                        "bound_name":"vip区",
                                        "row_name":"1排",
                                        "seat_id":"313141",
                                        "seat_name":"8座",
                                        "original_price":"18000",
                                        "coupon_discount_money":"17000",
                                        "money_discount_money":"10000",
                                        "real_money":"10000",
                                        "present_goods_count":3,
                                        "money_selected_discount":{
                                            "discount_id":"24143141",
                                            "discount_money":"100",
                                            "discount_name":"满2-1",
                                            "discount_type":1,
                                            "discount_rule_type":1203,
                                            "discount_rule_name":"满2-1"
                                        },
                                        "present_selected_discount_list":{
                                            "goods_discount_vo":[
                                                {
                                                    "discount_id":"123113",
                                                    "discount_money":"200",
                                                    "discount_name":"满100-2",
                                                    "discount_type":1,
                                                    "discount_rule_type":1203,
                                                    "discount_rule_name":"满100-2"
                                                }
                                            ]
                                        },
                                        "discount_total_money":"1000"
                                    }
                                ]
                            },
                            "cart_good_info":{
                                "project_id":"3213111",
                                "project_name":"周杰伦演出会",
                                "project_img_url":"http:www.maitix.com\/img.jpg",
                                "project_seat_type":1,
                                "event_id":"121455241",
                                "event_name":"周杰伦201190101",
                                "site_name":"北京展览馆",
                                "site_version_id":"2421421",
                                "event_show_start_time":"2019-04-03 20:17:40",
                                "event_show_end_time":"2019-04-03 20:17:40",
                                "price_id":"43242",
                                "price_name":"180元",
                                "goods_count":10,
                                "margin_count":10321,
                                "is_coupon_ticket":1,
                                "price":"18000",
                                "goods_id":"52523",
                                "coupon_group_id":"3123141",
                                "coupon_price_id":"3123123",
                                "stock_state":1,
                                "floor_name":"一层",
                                "bound_name":"vip",
                                "row_name":"3排",
                                "seat_id":"432423",
                                "seat_name":"8座",
                                "original_price":"1000",
                                "coupon_discount_money":"100",
                                "money_discount_money":"19900",
                                "real_money":"19900",
                                "present_goods_count":10,
                                "money_selected_discount":{
                                    "discount_id":"4252525",
                                    "discount_money":"19900",
                                    "discount_name":"满10000-199",
                                    "discount_type":1,
                                    "discount_rule_type":1203,
                                    "discount_rule_name":"满10000-199"
                                },
                                "present_selected_discount_list":{
                                    "goods_discount_vo":[
                                        {
                                            "discount_id":"4324211",
                                            "discount_money":"100",
                                            "discount_name":"满100打7折",
                                            "discount_type":1,
                                            "discount_rule_type":1203,
                                            "discount_rule_name":"满100打7折"
                                        }
                                    ]
                                },
                                "discount_total_money":"100"
                            }
                        }
                    ]
                },
                "event_limit_type":1,
                "goods_total_count":10,
                "goods_count":1013,
                "goods_original_total_money":"19000",
                "goods_discount_total_money":"19000",
                "order_present_list":{
                    "order_present_vo":[
                        {
                            "present_type_name":"优惠码",
                            "present_content":"优惠码"
                        }
                    ]
                },
                "order_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"4124121",
                            "discount_money":"100",
                            "discount_name":"优惠码",
                            "discount_type":4,
                            "discount_rule_type":1,
                            "order_discount_rule_id":"321312",
                            "discount_rule_name":"优惠码",
                            "coupon_code":"2dsd111"
                        }
                    ]
                },
                "order_discount_id":"4214131",
                "order_discount_money":"1000",
                "coupon_code_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"19001321",
                            "discount_money":"1900",
                            "discount_name":"100-30",
                            "discount_type":1,
                            "discount_rule_type":2,
                            "order_discount_rule_id":"32113",
                            "discount_rule_name":"30",
                            "coupon_code":"dsdsda11"
                        }
                    ]
                },
                "coupon_code_discount_id":"3214131",
                "coupon_code":"dssas1231",
                "coupon_code_discount_money":"1000",
                "user_point_info":{
                    "user_point":10001110,
                    "valid_user_point":300,
                    "use_able_money":"3000"
                },
                "use_point":10,
                "use_point_money":"1900",
                "user_account_info":{
                    "account_money":"1911900",
                    "use_able_money":"32100"
                },
                "use_account_money":"100",
                "pay_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"323213131",
                            "discount_money":"3000",
                            "discount_name":"30000-3000",
                            "discount_type":1,
                            "discount_rule_type":2,
                            "order_discount_rule_id":"32312",
                            "discount_rule_name":"30000-3000",
                            "coupon_code":"dvsd1311"
                        }
                    ]
                },
                "pay_discount_id":"213131",
                "pay_discount_money":"100",
                "discount_total_money":"1000",
                "goods_receivable_money":"100",
                "express_money":"1300",
                "receivable_money":"319000",
                "online_pay_money":"319000",
                "ticket_type_list":{
                    "number":[
                        4,
                        1
                    ]
                }
            }
        }
    }
}

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.trade.shopcart.group.build (创建套票分组之后的购物车)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ