淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
shopping_cart_param	ShoppingCartParam	必须			购物车参数对象
cart_goods_param_list ShoppingCartGoodsParam [] 必须购物车商品列表 └ price_id String 可选 10011001 票档ID └ goods_count Number 可选 10 商品数量 └ goods_id_list String [] 可选 10011001,13423113 有座商品ID列表，当有座时必填 └ need_coupon_recommend Boolean 可选 false 是否需要套票推荐，默认不需要 └ shopping_cart_id String 可选 79379111 当前购物车ID，服务器后台随机生成 └ user_id String 可选 13423112 会员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 可选 523523 收货人地址ID └ receive_name String 可选赢川收货人姓名 └ receive_email String 可选 xxxx@sina.com 收货人邮箱 └ receive_phone String 可选 13601234567 收货人手机号 └ receive_identity_code String 可选 110110xxxxx1211 收货人证件号码 └ order_discount_id String 可选 4111231 选中的订单优惠ID └ order_discount_rule_id String 可选 1311311 选中的订单优惠规则ID └ order_discount_event_ids String 可选 312221,131233 选中的订单优惠关联场次id列表,以逗号(,)隔开 └ coupon_code String 可选 1312a1 订单使用的优惠码 └ coupon_code_rule_id String 可选 1313121 使用的优惠码对应优惠规则ID └ coupon_code_event_ids String 可选 1213123 使用的优惠码关联场次id列表,以逗号(,)隔开 └ use_point Number 可选 10 订单使用的积分数 └ use_point_money String 可选 1000 订单使用积分抵扣的金额(元) └ gift_card_no String 可选 xjs12311 使用礼品卡支付的卡号 └ gift_card_pay_password String 可选 132q12 礼品卡支付密码 └ use_gift_card_money String 可选 100 订单使用礼品卡抵扣的金额(元) └ use_account_money String 可选 10 订单使用账户余额支付的金额(元) └ pay_discount_id String 可选 12311 选中的支付优惠ID └ lang_type Number 可选 1 语言类型：1=中文，2=英文 └ tenant_token String 可选 rZIAxcXYJ72Idfk1231+mCzqSXZLWtCn 向api服务提供商获取" └ ptnr_token String 可选 Fbq3A9UJj/8SWB5xLq54Tn623qFzG+2u 向api服务提供商获取" └ channel_token String 可选 St5dnxCv1KtwpNaDzuE459yus3m6F 向api服务提供商获取" └ user_token String 可选 123121 userId

名称	类型	示例值	描述
result_data	ResultData		统一返回值对象
└ success Boolean true 是否成功 └ result_code Number 200 状态码 └ result_msg String 成功提示信息 shopping_cart_vo ShoppingCartVo 返回数据 └ shopping_cart_id String 121311231 当前购物车ID，服务器后台随机生成 └ order_id String 10002121 如果已成订单，返回订单ID cart_goods_list CartGoodsVo [] 购物车商品信息列表 child_list CartGoodInfo [] 子商品列表 └ project_id String 12131121 项目ID └ project_name String 周杰伦演唱会项目名称 └ project_img_url String http:www.maitix.com/img.jpg 项目图片地址 └ project_seat_type Number 1 项目座位类型 1=有座、2=无座 └ event_id String 43143211 场次ID └ event_name String 周杰伦20190101 场次名称 └ site_name String 北京体育馆场馆名称 └ site_version_id String 3422112 场馆版本号ID └ event_show_start_time String 20190413 11:11:11 场次演出开始时间 └ event_show_end_time String 20190413 11:11:11 场次演出结束时间 └ price_id String 1241312321 票档ID └ price_name String 180元票档名称 └ goods_count Number 311 商品数量:如果单票，代表单票的个数，如果是套票，代表套票的数量,如果是有座，数量固定为1，否则代表无座或者实物商品的个数 └ margin_count Number 8881 剩余库存数量 └ is_coupon_ticket Number 6 是否套票 └ price String 19000 票档价格，如果单票，代表单票的价格，如果是套票，代表套票的价格 └ goods_id String 1213121 商品ID └ coupon_group_id String 213411 套票组ID └ coupon_price_id String 324111 套票票档ID └ stock_state Number 1 库存状态：1=有库存，2=无库存 └ floor_name String 一层楼层名称 └ bound_name String vip区区域名称 └ row_name String 1排排名称 └ seat_id String 79792131 座位ID └ seat_name String 8座座位名称 └ original_price String 18000 票档原始价格，如果是单票，代表单票的价格，如果是套票，代表套票包含的子票档的所有商品的价格 └ coupon_discount_money String 17000 套票优惠金额 └ money_discount_money String 100 金钱优惠金额(减免或折扣的一种) └ real_money String 18000 购物车商品实际金额=原价-扣除各种优惠 └ present_goods_count Number 10 赠送商品总数量 money_selected_discount GoodsDiscountVo 选中的现金优惠金额(减免或折扣) └ discount_id String 14141 优惠ID └ discount_money String 1000 优惠金额 └ discount_name String 满100-50 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1206 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 满100-50 优惠规则名称 present_selected_discount_list GoodsDiscountVo [] 赠送优惠对象列表 └ discount_id String 2414112 优惠ID └ discount_money String 100 优惠金额 └ discount_name String 优惠码优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1207 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 优惠码赠送优惠规则名称 └ discount_total_money String 优惠码赠送所有商品（赠送）优惠总金额套票优惠+现金优惠 cart_good_info CartGoodInfo cartGoodInfo └ project_id String 321312312 项目ID └ project_name String 周杰伦演出项目名称 └ project_img_url String http:www.maitix.com/img.jpg 项目图片地址 └ project_seat_type Number 1 项目座位类型 1=有座、2=无座 └ event_id String 231231321 场次ID └ event_name String 20190111 场次名称 └ site_name String 北京体育馆场馆名称 └ site_version_id String 124141 场馆版本号ID └ event_show_start_time String 20190413 11:11:11 场次演出开始时间 └ event_show_end_time String 20190413 11:11:11 场次演出结束时间 └ price_id String 232321 票档ID └ price_name String 180元票档名称 └ goods_count Number 10 商品数量:如果单票，代表单票的个数，如果是套票，代表套票的数量,如果是有座，数量固定为1，否则代表无座或者实物商品的个数 └ margin_count Number 3231 剩余库存数量 └ is_coupon_ticket Number 1 是否套票 └ price String 18000 票档价格，如果单票，代表单票的价格，如果是套票，代表套票的价格 └ goods_id String 3179392 商品ID └ coupon_group_id String 213124 套票组ID └ coupon_price_id String 3131 套票票档ID └ stock_state Number 1 库存状态：1=有库存，2=无库存 └ floor_name String 一层楼层名称 └ bound_name String vvip 区域名称 └ row_name String 1 排名称 └ seat_id String 2 座位ID └ seat_name String 2座座位名称 └ original_price String 18000 票档原始价格，如果是单票，代表单票的价格，如果是套票，代表套票包含的子票档的所有商品的价格 └ coupon_discount_money String 1800 套票优惠金额 └ money_discount_money String 1800 金钱优惠金额(减免或折扣的一种) └ real_money String 18000 购物车商品实际金额=原价-扣除各种优惠 └ present_goods_count Number 10 赠送商品总数量 money_selected_discount GoodsDiscountVo 选中的现金优惠金额(减免或折扣) └ discount_id String 32131 优惠ID └ discount_money String 1000 优惠金额 └ discount_name String 优惠码112 优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1203 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 优惠码112 优惠规则名称 present_selected_discount_list GoodsDiscountVo [] 赠送优惠对象列表 └ discount_id String 32131 优惠ID └ discount_money String 100210 优惠金额 └ discount_name String 优惠码优惠名称 └ discount_type Number 1 优惠类型：1.票品优惠；2.订单优惠；3.支付优惠；优惠权益:4.票品权益；5.单次使用优惠码；6.多次使用优惠码； └ discount_rule_type Number 1201 优惠规则类型：1201=减免,1202=折扣,1203=赠送,1205=自定义减免,1206=自定义折扣 └ discount_rule_name String 优惠码优惠规则名称 └ discount_total_money String 199900 所有商品（赠送）优惠总金额套票优惠+现金优惠 └ event_limit_type Number 1 场次购票限制类型：0=不限购,1=实名制购票（一单一证）,2=一票一证 └ goods_total_count Number 10 所有商品总数量(包含赠送的) └ goods_count Number 10 购买商品总数量 └ goods_original_total_money String 199900 所有商品原价总金额 └ goods_discount_total_money String 199900 所有票品优惠总金额(套票优惠+减免或折扣优惠) order_present_list OrderPresentVo [] 订单赠送的权益列表 └ present_type_name String 优惠码赠送的权益类型名称 └ present_content String 优惠码赠送的权益内容 order_discount_list OrderDiscountVo [] 可用的订单优惠列表 └ discount_id String 32131231 优惠ID └ discount_money String 300 优惠金额(元) └ discount_name String 满100打8折优惠名称 └ 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 满2000-320 优惠规则名称 └ coupon_code String jojoo111 优惠码 └ order_discount_id String 23231 订单优惠ID └ order_discount_money String 1000 订单优惠金额(不包括票品级别的优惠) coupon_code_discount_list OrderDiscountVo [] 可用的优惠码列表 └ discount_id String 32432432 优惠ID └ discount_money String 1000 优惠金额(元) └ 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 321312 选中的优惠规则ID └ discount_rule_name String 满100-30 优惠规则名称 └ coupon_code String xeew11 优惠码 └ coupon_code_discount_id String 231312 优惠码优惠政策ID └ coupon_code String jjsa12121 使用的优惠码 └ coupon_code_discount_money String 100 优惠码优惠金额 user_point_info UserPointVo 会员积分信息 └ user_point Number 1020 会员总积分 └ valid_user_point Number 100 可用于抵扣的积分 └ use_able_money String 1000 可抵扣的金额 └ use_point Number 100 使用抵扣的积分数 └ use_point_money String 18800 使用积分抵扣的金额 user_account_info UserAccountVo 会员账户余额信息 └ account_money String 180000 账户余额 └ use_able_money String 1800 可用于抵扣的余额 └ use_account_money String 1800 使用会员账户余额支付的金额 pay_discount_list OrderDiscountVo [] 可用的支付优惠列表 └ discount_id String 321321 优惠ID └ discount_money String 1000 优惠金额(元) └ discount_name String 满2－1 优惠名称 └ 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 3214141 选中的优惠规则ID └ discount_rule_name String 优惠码优惠规则名称 └ coupon_code String sdd1123 优惠码 └ pay_discount_id String 31231 支付优惠规则id └ pay_discount_money String 18000 支付优惠金额 └ discount_total_money String 18000 所有优惠总金额(套票、票品优惠、订单优惠、优惠码优惠、支付优惠) └ goods_receivable_money String 18000 所有商品应收金额 └ express_money String 1800 配送费 └ receivable_money String 1800 总的应收金额：所有商品应收金额 + 配送费 └ online_pay_money String 18000 在线支付的金额：总的应收金额 - 积分抵扣的金额 - 使用余额支付的金额 └ 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);
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest req = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest();
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartParam obj1 = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartParam();
List<AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParam> list3 = new ArrayList<AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParam>();
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParam obj4 = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParam();
list3.add(obj4);
obj4.setPriceId("10011001");
obj4.setGoodsCount(10L);
obj4.setGoodsIdList("10011001,13423113");
obj1.setCartGoodsParamList(list3);
obj1.setNeedCouponRecommend(false);
obj1.setShoppingCartId("79379111");
obj1.setUserId("13423112");
obj1.setQuickBuy(false);
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.OrderReceiveParam obj5 = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.OrderReceiveParam();
obj5.setReceiveType(0L);
obj5.setTicketType(0L);
obj5.setAddressId("523523");
obj5.setReceiveName("赢川");
obj5.setReceiveEmail("xxxx@sina.com");
obj5.setReceivePhone("13601234567");
obj5.setReceiveIdentityCode("110110xxxxx1211");
obj1.setOrderReceiveParam(obj5);
obj1.setOrderDiscountId("4111231");
obj1.setOrderDiscountRuleId("1311311");
obj1.setOrderDiscountEventIds("312221,131233");
obj1.setCouponCode("1312a1");
obj1.setCouponCodeRuleId("1313121");
obj1.setCouponCodeEventIds("1213123");
obj1.setUsePoint(10L);
obj1.setUsePointMoney("1000");
obj1.setGiftCardNo("xjs12311");
obj1.setGiftCardPayPassword("132q12");
obj1.setUseGiftCardMoney("100");
obj1.setUseAccountMoney("10");
obj1.setPayDiscountId("12311");
obj1.setLangType(1L);
obj1.setTenantToken("rZIAxcXYJ72Idfk1231+mCzqSXZLWtCn");
obj1.setPtnrToken("Fbq3A9UJj/8SWB5xLq54Tn623qFzG+2u");
obj1.setChannelToken("St5dnxCv1KtwpNaDzuE459yus3m6F");
obj1.setUserToken("123121");
req.setShoppingCartParam(obj1);
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest req = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest();
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartParamDomain obj1 = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartParamDomain();
List<AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParamDomain> list3 = new List<AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParamDomain>();
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParamDomain obj4 = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.ShoppingCartGoodsParamDomain();
list3.Add(obj4);
obj4.PriceId = "10011001";
obj4.GoodsCount = 10L;
obj4.GoodsIdList = "10011001,13423113";
obj1.CartGoodsParamList= list3;
obj1.NeedCouponRecommend = false;
obj1.ShoppingCartId = "79379111";
obj1.UserId = "13423112";
obj1.QuickBuy = false;
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.OrderReceiveParamDomain obj5 = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest.OrderReceiveParamDomain();
obj5.ReceiveType = 0L;
obj5.TicketType = 0L;
obj5.AddressId = "523523";
obj5.ReceiveName = "赢川";
obj5.ReceiveEmail = "xxxx@sina.com";
obj5.ReceivePhone = "13601234567";
obj5.ReceiveIdentityCode = "110110xxxxx1211";
obj1.OrderReceiveParam= obj5;
obj1.OrderDiscountId = "4111231";
obj1.OrderDiscountRuleId = "1311311";
obj1.OrderDiscountEventIds = "312221,131233";
obj1.CouponCode = "1312a1";
obj1.CouponCodeRuleId = "1313121";
obj1.CouponCodeEventIds = "1213123";
obj1.UsePoint = 10L;
obj1.UsePointMoney = "1000";
obj1.GiftCardNo = "xjs12311";
obj1.GiftCardPayPassword = "132q12";
obj1.UseGiftCardMoney = "100";
obj1.UseAccountMoney = "10";
obj1.PayDiscountId = "12311";
obj1.LangType = 1L;
obj1.TenantToken = "rZIAxcXYJ72Idfk1231+mCzqSXZLWtCn";
obj1.PtnrToken = "Fbq3A9UJj/8SWB5xLq54Tn623qFzG+2u";
obj1.ChannelToken = "St5dnxCv1KtwpNaDzuE459yus3m6F";
obj1.UserToken = "123121";
req.ShoppingCartParam_ = obj1;
AlibabaDamaiMaizuoOpenapiTradeShopcartBuildResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMaizuoOpenapiTradeShopcartBuildRequest;
$shopping_cart_param = new ShoppingCartParam;
$cart_goods_param_list = new ShoppingCartGoodsParam;
$cart_goods_param_list->price_id="10011001";
$cart_goods_param_list->goods_count="10";
$cart_goods_param_list->goods_id_list="10011001,13423113";
$shopping_cart_param->cart_goods_param_list = $cart_goods_param_list;
$shopping_cart_param->need_coupon_recommend="false";
$shopping_cart_param->shopping_cart_id="79379111";
$shopping_cart_param->user_id="13423112";
$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="523523";
$order_receive_param->receive_name="赢川";
$order_receive_param->receive_email="xxxx@sina.com";
$order_receive_param->receive_phone="13601234567";
$order_receive_param->receive_identity_code="110110xxxxx1211";
$shopping_cart_param->order_receive_param = $order_receive_param;
$shopping_cart_param->order_discount_id="4111231";
$shopping_cart_param->order_discount_rule_id="1311311";
$shopping_cart_param->order_discount_event_ids="312221,131233";
$shopping_cart_param->coupon_code="1312a1";
$shopping_cart_param->coupon_code_rule_id="1313121";
$shopping_cart_param->coupon_code_event_ids="1213123";
$shopping_cart_param->use_point="10";
$shopping_cart_param->use_point_money="1000";
$shopping_cart_param->gift_card_no="xjs12311";
$shopping_cart_param->gift_card_pay_password="132q12";
$shopping_cart_param->use_gift_card_money="100";
$shopping_cart_param->use_account_money="10";
$shopping_cart_param->pay_discount_id="12311";
$shopping_cart_param->lang_type="1";
$shopping_cart_param->tenant_token="rZIAxcXYJ72Idfk1231+mCzqSXZLWtCn";
$shopping_cart_param->ptnr_token="Fbq3A9UJj/8SWB5xLq54Tn623qFzG+2u";
$shopping_cart_param->channel_token="St5dnxCv1KtwpNaDzuE459yus3m6F";
$shopping_cart_param->user_token="123121";
$req->setShoppingCartParam(json_encode($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.build' \
-d 'partner_id=apidoc' \
-d 'sign=41CFE833FCE3558038D5E2BCC4AFD5D6' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+15%3A23%3A00' \
-d 'v=2.0' \
-d 'shopping_cart_param=null'

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

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

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

XML示例
JSON示例

<alibaba_damai_maizuo_openapi_trade_shopcart_build_response>
    <result_data>
        <success>true</success>
        <result_code>200</result_code>
        <result_msg>成功</result_msg>
        <shopping_cart_vo>
            <shopping_cart_id>121311231</shopping_cart_id>
            <order_id>10002121</order_id>
            <cart_goods_list>
                <cart_goods_vo>
                    <child_list>
                        <cart_good_info>
                            <project_id>12131121</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>43143211</event_id>
                            <event_name>周杰伦20190101</event_name>
                            <site_name>北京体育馆</site_name>
                            <site_version_id>3422112</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>1241312321</price_id>
                            <price_name>180元</price_name>
                            <goods_count>311</goods_count>
                            <margin_count>8881</margin_count>
                            <is_coupon_ticket>6</is_coupon_ticket>
                            <price>19000</price>
                            <goods_id>1213121</goods_id>
                            <coupon_group_id>213411</coupon_group_id>
                            <coupon_price_id>324111</coupon_price_id>
                            <stock_state>1</stock_state>
                            <floor_name>一层</floor_name>
                            <bound_name>vip区</bound_name>
                            <row_name>1排</row_name>
                            <seat_id>79792131</seat_id>
                            <seat_name>8座</seat_name>
                            <original_price>18000</original_price>
                            <coupon_discount_money>17000</coupon_discount_money>
                            <money_discount_money>100</money_discount_money>
                            <real_money>18000</real_money>
                            <present_goods_count>10</present_goods_count>
                            <money_selected_discount>
                                <discount_id>14141</discount_id>
                                <discount_money>1000</discount_money>
                                <discount_name>满100-50</discount_name>
                                <discount_type>1</discount_type>
                                <discount_rule_type>1206</discount_rule_type>
                                <discount_rule_name>满100-50</discount_rule_name>
                            </money_selected_discount>
                            <present_selected_discount_list>
                                <goods_discount_vo>
                                    <discount_id>2414112</discount_id>
                                    <discount_money>100</discount_money>
                                    <discount_name>优惠码</discount_name>
                                    <discount_type>1</discount_type>
                                    <discount_rule_type>1207</discount_rule_type>
                                    <discount_rule_name>优惠码赠送</discount_rule_name>
                                </goods_discount_vo>
                            </present_selected_discount_list>
                            <discount_total_money>优惠码赠送</discount_total_money>
                        </cart_good_info>
                    </child_list>
                    <cart_good_info>
                        <project_id>321312312</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>231231321</event_id>
                        <event_name>20190111</event_name>
                        <site_name>北京体育馆</site_name>
                        <site_version_id>124141</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>232321</price_id>
                        <price_name>180元</price_name>
                        <goods_count>10</goods_count>
                        <margin_count>3231</margin_count>
                        <is_coupon_ticket>1</is_coupon_ticket>
                        <price>18000</price>
                        <goods_id>3179392</goods_id>
                        <coupon_group_id>213124</coupon_group_id>
                        <coupon_price_id>3131</coupon_price_id>
                        <stock_state>1</stock_state>
                        <floor_name>一层</floor_name>
                        <bound_name>vvip</bound_name>
                        <row_name>1</row_name>
                        <seat_id>2</seat_id>
                        <seat_name>2座</seat_name>
                        <original_price>18000</original_price>
                        <coupon_discount_money>1800</coupon_discount_money>
                        <money_discount_money>1800</money_discount_money>
                        <real_money>18000</real_money>
                        <present_goods_count>10</present_goods_count>
                        <money_selected_discount>
                            <discount_id>32131</discount_id>
                            <discount_money>1000</discount_money>
                            <discount_name>优惠码112</discount_name>
                            <discount_type>1</discount_type>
                            <discount_rule_type>1203</discount_rule_type>
                            <discount_rule_name>优惠码112</discount_rule_name>
                        </money_selected_discount>
                        <present_selected_discount_list>
                            <goods_discount_vo>
                                <discount_id>32131</discount_id>
                                <discount_money>100210</discount_money>
                                <discount_name>优惠码</discount_name>
                                <discount_type>1</discount_type>
                                <discount_rule_type>1201</discount_rule_type>
                                <discount_rule_name>优惠码</discount_rule_name>
                            </goods_discount_vo>
                        </present_selected_discount_list>
                        <discount_total_money>199900</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>10</goods_count>
            <goods_original_total_money>199900</goods_original_total_money>
            <goods_discount_total_money>199900</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>32131231</discount_id>
                    <discount_money>300</discount_money>
                    <discount_name>满100打8折</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>满2000-320</discount_rule_name>
                    <coupon_code>jojoo111</coupon_code>
                </order_discount_vo>
            </order_discount_list>
            <order_discount_id>23231</order_discount_id>
            <order_discount_money>1000</order_discount_money>
            <coupon_code_discount_list>
                <order_discount_vo>
                    <discount_id>32432432</discount_id>
                    <discount_money>1000</discount_money>
                    <discount_name>满100-30</discount_name>
                    <discount_type>1</discount_type>
                    <discount_rule_type>1</discount_rule_type>
                    <order_discount_rule_id>321312</order_discount_rule_id>
                    <discount_rule_name>满100-30</discount_rule_name>
                    <coupon_code>xeew11</coupon_code>
                </order_discount_vo>
            </coupon_code_discount_list>
            <coupon_code_discount_id>231312</coupon_code_discount_id>
            <coupon_code>jjsa12121</coupon_code>
            <coupon_code_discount_money>100</coupon_code_discount_money>
            <user_point_info>
                <user_point>1020</user_point>
                <valid_user_point>100</valid_user_point>
                <use_able_money>1000</use_able_money>
            </user_point_info>
            <use_point>100</use_point>
            <use_point_money>18800</use_point_money>
            <user_account_info>
                <account_money>180000</account_money>
                <use_able_money>1800</use_able_money>
            </user_account_info>
            <use_account_money>1800</use_account_money>
            <pay_discount_list>
                <order_discount_vo>
                    <discount_id>321321</discount_id>
                    <discount_money>1000</discount_money>
                    <discount_name>满2－1</discount_name>
                    <discount_type>1</discount_type>
                    <discount_rule_type>1</discount_rule_type>
                    <order_discount_rule_id>3214141</order_discount_rule_id>
                    <discount_rule_name>优惠码</discount_rule_name>
                    <coupon_code>sdd1123</coupon_code>
                </order_discount_vo>
            </pay_discount_list>
            <pay_discount_id>31231</pay_discount_id>
            <pay_discount_money>18000</pay_discount_money>
            <discount_total_money>18000</discount_total_money>
            <goods_receivable_money>18000</goods_receivable_money>
            <express_money>1800</express_money>
            <receivable_money>1800</receivable_money>
            <online_pay_money>18000</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_build_response>

{
    "alibaba_damai_maizuo_openapi_trade_shopcart_build_response":{
        "result_data":{
            "success":true,
            "result_code":200,
            "result_msg":"成功",
            "shopping_cart_vo":{
                "shopping_cart_id":"121311231",
                "order_id":"10002121",
                "cart_goods_list":{
                    "cart_goods_vo":[
                        {
                            "child_list":{
                                "cart_good_info":[
                                    {
                                        "project_id":"12131121",
                                        "project_name":"周杰伦演唱会",
                                        "project_img_url":"http:www.maitix.com\/img.jpg",
                                        "project_seat_type":1,
                                        "event_id":"43143211",
                                        "event_name":"周杰伦20190101",
                                        "site_name":"北京体育馆",
                                        "site_version_id":"3422112",
                                        "event_show_start_time":"20190413 11:11:11",
                                        "event_show_end_time":"20190413 11:11:11",
                                        "price_id":"1241312321",
                                        "price_name":"180元",
                                        "goods_count":311,
                                        "margin_count":8881,
                                        "is_coupon_ticket":6,
                                        "price":"19000",
                                        "goods_id":"1213121",
                                        "coupon_group_id":"213411",
                                        "coupon_price_id":"324111",
                                        "stock_state":1,
                                        "floor_name":"一层",
                                        "bound_name":"vip区",
                                        "row_name":"1排",
                                        "seat_id":"79792131",
                                        "seat_name":"8座",
                                        "original_price":"18000",
                                        "coupon_discount_money":"17000",
                                        "money_discount_money":"100",
                                        "real_money":"18000",
                                        "present_goods_count":10,
                                        "money_selected_discount":{
                                            "discount_id":"14141",
                                            "discount_money":"1000",
                                            "discount_name":"满100-50",
                                            "discount_type":1,
                                            "discount_rule_type":1206,
                                            "discount_rule_name":"满100-50"
                                        },
                                        "present_selected_discount_list":{
                                            "goods_discount_vo":[
                                                {
                                                    "discount_id":"2414112",
                                                    "discount_money":"100",
                                                    "discount_name":"优惠码",
                                                    "discount_type":1,
                                                    "discount_rule_type":1207,
                                                    "discount_rule_name":"优惠码赠送"
                                                }
                                            ]
                                        },
                                        "discount_total_money":"优惠码赠送"
                                    }
                                ]
                            },
                            "cart_good_info":{
                                "project_id":"321312312",
                                "project_name":"周杰伦演出",
                                "project_img_url":"http:www.maitix.com\/img.jpg",
                                "project_seat_type":1,
                                "event_id":"231231321",
                                "event_name":"20190111",
                                "site_name":"北京体育馆",
                                "site_version_id":"124141",
                                "event_show_start_time":"20190413 11:11:11",
                                "event_show_end_time":"20190413 11:11:11",
                                "price_id":"232321",
                                "price_name":"180元",
                                "goods_count":10,
                                "margin_count":3231,
                                "is_coupon_ticket":1,
                                "price":"18000",
                                "goods_id":"3179392",
                                "coupon_group_id":"213124",
                                "coupon_price_id":"3131",
                                "stock_state":1,
                                "floor_name":"一层",
                                "bound_name":"vvip",
                                "row_name":"1",
                                "seat_id":"2",
                                "seat_name":"2座",
                                "original_price":"18000",
                                "coupon_discount_money":"1800",
                                "money_discount_money":"1800",
                                "real_money":"18000",
                                "present_goods_count":10,
                                "money_selected_discount":{
                                    "discount_id":"32131",
                                    "discount_money":"1000",
                                    "discount_name":"优惠码112",
                                    "discount_type":1,
                                    "discount_rule_type":1203,
                                    "discount_rule_name":"优惠码112"
                                },
                                "present_selected_discount_list":{
                                    "goods_discount_vo":[
                                        {
                                            "discount_id":"32131",
                                            "discount_money":"100210",
                                            "discount_name":"优惠码",
                                            "discount_type":1,
                                            "discount_rule_type":1201,
                                            "discount_rule_name":"优惠码"
                                        }
                                    ]
                                },
                                "discount_total_money":"199900"
                            }
                        }
                    ]
                },
                "event_limit_type":1,
                "goods_total_count":10,
                "goods_count":10,
                "goods_original_total_money":"199900",
                "goods_discount_total_money":"199900",
                "order_present_list":{
                    "order_present_vo":[
                        {
                            "present_type_name":"优惠码",
                            "present_content":"优惠码"
                        }
                    ]
                },
                "order_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"32131231",
                            "discount_money":"300",
                            "discount_name":"满100打8折",
                            "discount_type":1,
                            "discount_rule_type":1,
                            "order_discount_rule_id":"32131",
                            "discount_rule_name":"满2000-320",
                            "coupon_code":"jojoo111"
                        }
                    ]
                },
                "order_discount_id":"23231",
                "order_discount_money":"1000",
                "coupon_code_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"32432432",
                            "discount_money":"1000",
                            "discount_name":"满100-30",
                            "discount_type":1,
                            "discount_rule_type":1,
                            "order_discount_rule_id":"321312",
                            "discount_rule_name":"满100-30",
                            "coupon_code":"xeew11"
                        }
                    ]
                },
                "coupon_code_discount_id":"231312",
                "coupon_code":"jjsa12121",
                "coupon_code_discount_money":"100",
                "user_point_info":{
                    "user_point":1020,
                    "valid_user_point":100,
                    "use_able_money":"1000"
                },
                "use_point":100,
                "use_point_money":"18800",
                "user_account_info":{
                    "account_money":"180000",
                    "use_able_money":"1800"
                },
                "use_account_money":"1800",
                "pay_discount_list":{
                    "order_discount_vo":[
                        {
                            "discount_id":"321321",
                            "discount_money":"1000",
                            "discount_name":"满2－1",
                            "discount_type":1,
                            "discount_rule_type":1,
                            "order_discount_rule_id":"3214141",
                            "discount_rule_name":"优惠码",
                            "coupon_code":"sdd1123"
                        }
                    ]
                },
                "pay_discount_id":"31231",
                "pay_discount_money":"18000",
                "discount_total_money":"18000",
                "goods_receivable_money":"18000",
                "express_money":"1800",
                "receivable_money":"1800",
                "online_pay_money":"18000",
                "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.build (创建购物车)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ