淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
mc_settlement_meta_data_dto	McSettlementMetaDataDTO	可选			结算元数据
└ service_item_id String 可选 5000000017698 结算侧的服务产品 weight_volume DicAcWeightVolumeDTO 必须重量体积 └ check_package_height String 可选 10.0 分拨称重:高cm └ cp_weight String 可选 10.0 cp重量, 单位克 └ collect_weight String 可选 10.0 揽收重量，单位克 └ check_package_weight String 可选 10.0 分拨称重:重量g └ check_package_width String 可选 10.0 分拨称重:宽cm └ check_package_volume String 可选 10.0 分拨称重:体积cm^3 └ weight_updated String 可选 10.0 商家推重，单位克 └ sms_collect_weight String 可选 10.0 小件员揽收取整重量g（取整） └ dms_volume String 可选 10.0 分拨量方体积cm^3 └ sms_collect_volume String 可选 10.0 小件员揽收体积cm^3 └ seller_height String 必须 10.0 商家高cm └ dms_weight String 可选 10.0 分拨称重重量g └ sms_collect_un_round_weight String 可选 10.0 小件员揽收精确重量g（未取整，原始重量与抛重取大） └ sms_collect_width String 可选 10.0 小件员揽收宽cm └ check_package_length String 可选 10.0 分拨称重:长cm └ sms_collect_length String 可选 10.0 小件员揽收长cm └ seller_weight String 必须 10.0 商家重量g └ dms_width String 可选 10.0 分拨量方宽cm └ dms_length String 可选 10.0 分拨量方长cm └ seller_width String 必须 10.0 商家宽cm └ cne_weight String 可选 10.0 速递计费重量, 单位克 └ dms_height String 可选 10.0 分拨量方高cm └ seller_volume String 必须 10.0 商家体积cm^3 └ seller_length String 必须 10.0 商家长cm └ cne_income_weight String 可选 10.0 速递收入计费重量, 单位克 └ sms_collect_height String 可选 10.0 小件员揽收高cm └ cp_volume String 可选 10.0 cp体积, 单位立方厘米 └ sms_original_goods_weight String 可选 10.0 小件员揽收原始重量g（没有任何加工逻辑） └ charged_weight String 可选 10.0 计费重量g（协同基于计费侧逻辑加工生成） └ feature_map String 必须 {"outProvinceId": "440000", "outCity": "深圳市", "outTown": "南湾街道", "outProvince": "广东省", "outTownId": "440307012", "mobileType": "real", "preCleanInfo": "{\"p\":\"广东省\",\"c\":\"深圳市\",\"d\":\"龙岗区\",\"t\":\"南湾街道\",\"divisionId\":440307012}", "outDistrict": "龙岗区", "outCityId": "440300", "deliverySiteId": "84495", "bizId": "LP008003186111", "cleaned": "1", "outDistrictId": "440307", "deliverySiteName": "深圳沙湾站Z"} 扩展信息 └ waybill_num String 必须 61167004281545421 运单号 └ biz_province String 可选广东省业务省份 └ product_solution String 可选 {"version": 1} 产品中心服务解决方案 └ storage_order_num String 必须 LBX03299423599900019 仓储订单号 goods_list CpcGoodsDTO [] 可选 [] 商品列表 └ goods_unique_id String 可选 537377509999 商品来源方唯一识别号 └ feature_map String 可选 {} 扩展信息 └ quantity Number 可选 1 商品数量 └ sn_code String 可选 aaaa sn码 └ length Number 可选 2 长 └ weight Number 可选 2 重量，克 └ owner_id String 可选 aaa 货主id └ goods_spec String 可选好商品描述 └ goods_bar_code String 可选 698738782374 商品条码 └ goods_type String 可选 GOOD 商品类型 └ operation_order_code String 可选 1 作业单号 └ volume Number 可选 1 体积,立方厘米 └ goods_unit_price String 可选 1 商品单价 └ out_biz_code String 可选 23232 外部业务单号 └ owner_name String 可选测试货主货主名称 └ width Number 可选 22 宽 └ id Number 可选 22 主键 └ goods_code String 可选 22 商品Code └ goods_name String 可选好商品名称 └ waybill_no String 可选 33333 运单号 └ height Number 可选 1 高 customer_info DicAcCustomerDTO 必须商家信息 └ cn_user_id String 可选 111 商家菜鸟会员Id └ main_user_id String 可选 2323 主账号Id └ seller_id String 可选 2323 卖家ID └ customer_code String 必须好商家编码 └ sub_user_id String 可选 2323 子账号Id └ customer_name String 可选好商家名称 └ biz_time Date 必须 2026-03-12 00:00:00 业务时间 set_off_address DicAcAddressDTO 必须出发地址 └ country String 可选中国国家 └ feature_map String 可选 {} 扩展信息 └ town String 必须闲林镇乡、镇、街道行政区划级别名称 └ city String 必须杭州地级市、地区、盟、自治州名称 └ contact_name String 可选张三联系人姓名 └ latitude String 可选 20.9897899 纬度 └ telephone String 可选 13000000000 联系人电话 └ city_id Number 必须 23 地级市、地区、盟、自治州名称 Id └ town_id Number 必须 23 乡、镇、街道行政区划级别名称 Id └ province_id Number 必须 23 省、自治区、直辖市、特别行政区名称 Id └ country_id Number 可选 23 国家 Id └ district_id Number 必须 23 县、区、自治县、旗名称 Id └ mobile_phone String 可选 13000000000 联系人手机 └ province String 必须浙江省省、自治区、直辖市、特别行政区名称 └ district String 必须余杭区县、区、自治县、旗名称 └ detail_address String 可选幸福小区详细地址 └ division_id Number 可选 22323 末级地址 Id └ longitude String 可选 20.3333 经度 └ waybill_type Number 可选 1 运单类型 com.cainiao.dts.practice.collaboration.client.constant.WaybillTypeEnum └ collection_number String 可选 232323 集包号 arrive_address DicAcAddressDTO 必须到达地址 └ country String 可选中国国家 └ feature_map String 可选 {} 扩展信息 └ town String 必须闲林镇乡、镇、街道行政区划级别名称 └ city String 必须杭州地级市、地区、盟、自治州名称 └ contact_name String 可选张阿安联系人姓名 └ latitude String 可选 40.3343 纬度 └ telephone String 可选 13000000000 联系人电话 └ city_id Number 必须 23 地级市、地区、盟、自治州名称 Id └ town_id Number 必须 23 乡、镇、街道行政区划级别名称 Id └ province_id Number 必须 23 省、自治区、直辖市、特别行政区名称 Id └ country_id Number 可选 23 国家 Id └ district_id Number 必须 23 县、区、自治县、旗名称 Id └ mobile_phone String 可选 13000000000 联系人手机 └ province String 必须浙江省省、自治区、直辖市、特别行政区名称 └ district String 必须闲林区县、区、自治县、旗名称 └ detail_address String 可选幸福小区详细地址 └ division_id Number 可选 23 末级地址 Id └ longitude String 可选 22 经度 └ waybill_status String 可选 2 运单状态 com.cainiao.dts.practice.collaboration.client.constant.CpcGuoPeiDicAcActionEnum └ meter_packages Number 可选 2 包裹数量

名称	类型	示例值	描述
sys_code	String	PARAM_IS_NULL	错误编码
biz_success	Boolean	true	是否成功
message	String	参数为空	错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMcTmsSettlementMetadataUploadRequest req = new AlibabaMcTmsSettlementMetadataUploadRequest();
AlibabaMcTmsSettlementMetadataUploadRequest.McSettlementMetaDataDTO obj1 = new AlibabaMcTmsSettlementMetadataUploadRequest.McSettlementMetaDataDTO();
obj1.setServiceItemId("5000000017698");
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcWeightVolumeDTO obj2 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcWeightVolumeDTO();
obj2.setCheckPackageHeight("10.0");
obj2.setCpWeight("10.0");
obj2.setCollectWeight("10.0");
obj2.setCheckPackageWeight("10.0");
obj2.setCheckPackageWidth("10.0");
obj2.setCheckPackageVolume("10.0");
obj2.setWeightUpdated("10.0");
obj2.setSmsCollectWeight("10.0");
obj2.setDmsVolume("10.0");
obj2.setSmsCollectVolume("10.0");
obj2.setSellerHeight("10.0");
obj2.setDmsWeight("10.0");
obj2.setSmsCollectUnRoundWeight("10.0");
obj2.setSmsCollectWidth("10.0");
obj2.setCheckPackageLength("10.0");
obj2.setSmsCollectLength("10.0");
obj2.setSellerWeight("10.0");
obj2.setDmsWidth("10.0");
obj2.setDmsLength("10.0");
obj2.setSellerWidth("10.0");
obj2.setCneWeight("10.0");
obj2.setDmsHeight("10.0");
obj2.setSellerVolume("10.0");
obj2.setSellerLength("10.0");
obj2.setCneIncomeWeight("10.0");
obj2.setSmsCollectHeight("10.0");
obj2.setCpVolume("10.0");
obj2.setSmsOriginalGoodsWeight("10.0");
obj2.setChargedWeight("10.0");
obj1.setWeightVolume(obj2);
obj1.setFeatureMap("{\"outProvinceId\": \"440000\",       \"outCity\": \"深圳市\",       \"outTown\": \"南湾街道\",       \"outProvince\": \"广东省\",       \"outTownId\": \"440307012\",       \"mobileType\": \"real\",       \"preCleanInfo\": \"{\\"p\\":\\"广东省\\",\\"c\\":\\"深圳市\\",\\"d\\":\\"龙岗区\\",\\"t\\":\\"南湾街道\\",\\"divisionId\\":440307012}\",       \"outDistrict\": \"龙岗区\",       \"outCityId\": \"440300\",       \"deliverySiteId\": \"84495\",       \"bizId\": \"LP008003186111\",       \"cleaned\": \"1\",       \"outDistrictId\": \"440307\",       \"deliverySiteName\": \"深圳沙湾站Z\"}");
obj1.setWaybillNum("61167004281545421");
obj1.setBizProvince("广东省");
obj1.setProductSolution("{\"version\": 1}");
obj1.setStorageOrderNum("LBX03299423599900019");
List<AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTO> list4 = new ArrayList<AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTO>();
AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTO obj5 = new AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTO();
list4.add(obj5);
obj5.setGoodsUniqueId("537377509999");
obj5.setFeatureMap("{}");
obj5.setQuantity(1L);
obj5.setSnCode("aaaa");
obj5.setLength(2L);
obj5.setWeight(2L);
obj5.setOwnerId("aaa");
obj5.setGoodsSpec("好");
obj5.setGoodsBarCode("698738782374");
obj5.setGoodsType("GOOD");
obj5.setOperationOrderCode("1");
obj5.setVolume(1L);
obj5.setGoodsUnitPrice("1");
obj5.setOutBizCode("23232");
obj5.setOwnerName("测试货主");
obj5.setWidth(22L);
obj5.setId(22L);
obj5.setGoodsCode("22");
obj5.setGoodsName("好");
obj5.setWaybillNo("33333");
obj5.setHeight(1L);
obj1.setGoodsList(list4);
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcCustomerDTO obj6 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcCustomerDTO();
obj6.setCnUserId("111");
obj6.setMainUserId("2323");
obj6.setSellerId("2323");
obj6.setCustomerCode("好");
obj6.setSubUserId("2323");
obj6.setCustomerName("好");
obj1.setCustomerInfo(obj6);
obj1.setBizTime(StringUtils.parseDateTime("2026-03-12 00:00:00"));
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTO obj7 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTO();
obj7.setCountry("中国");
obj7.setFeatureMap("{}");
obj7.setTown("闲林镇");
obj7.setCity("杭州");
obj7.setContactName("张三");
obj7.setLatitude("20.9897899");
obj7.setTelephone("13000000000");
obj7.setCityId(23L);
obj7.setTownId(23L);
obj7.setProvinceId(23L);
obj7.setCountryId(23L);
obj7.setDistrictId(23L);
obj7.setMobilePhone("13000000000");
obj7.setProvince("浙江省");
obj7.setDistrict("余杭区");
obj7.setDetailAddress("幸福小区");
obj7.setDivisionId(22323L);
obj7.setLongitude("20.3333");
obj1.setSetOffAddress(obj7);
obj1.setWaybillType(1L);
obj1.setCollectionNumber("232323");
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTO obj8 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTO();
obj8.setCountry("中国");
obj8.setFeatureMap("{}");
obj8.setTown("闲林镇");
obj8.setCity("杭州");
obj8.setContactName("张阿安");
obj8.setLatitude("40.3343");
obj8.setTelephone("13000000000");
obj8.setCityId(23L);
obj8.setTownId(23L);
obj8.setProvinceId(23L);
obj8.setCountryId(23L);
obj8.setDistrictId(23L);
obj8.setMobilePhone("13000000000");
obj8.setProvince("浙江省");
obj8.setDistrict("闲林区");
obj8.setDetailAddress("幸福小区");
obj8.setDivisionId(23L);
obj8.setLongitude("22");
obj1.setArriveAddress(obj8);
obj1.setWaybillStatus("2");
obj1.setMeterPackages(2L);
req.setMcSettlementMetaDataDto(obj1);
AlibabaMcTmsSettlementMetadataUploadResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaMcTmsSettlementMetadataUploadRequest req = new AlibabaMcTmsSettlementMetadataUploadRequest();
AlibabaMcTmsSettlementMetadataUploadRequest.McSettlementMetaDataDTODomain obj1 = new AlibabaMcTmsSettlementMetadataUploadRequest.McSettlementMetaDataDTODomain();
obj1.ServiceItemId = "5000000017698";
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcWeightVolumeDTODomain obj2 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcWeightVolumeDTODomain();
obj2.CheckPackageHeight = "10.0";
obj2.CpWeight = "10.0";
obj2.CollectWeight = "10.0";
obj2.CheckPackageWeight = "10.0";
obj2.CheckPackageWidth = "10.0";
obj2.CheckPackageVolume = "10.0";
obj2.WeightUpdated = "10.0";
obj2.SmsCollectWeight = "10.0";
obj2.DmsVolume = "10.0";
obj2.SmsCollectVolume = "10.0";
obj2.SellerHeight = "10.0";
obj2.DmsWeight = "10.0";
obj2.SmsCollectUnRoundWeight = "10.0";
obj2.SmsCollectWidth = "10.0";
obj2.CheckPackageLength = "10.0";
obj2.SmsCollectLength = "10.0";
obj2.SellerWeight = "10.0";
obj2.DmsWidth = "10.0";
obj2.DmsLength = "10.0";
obj2.SellerWidth = "10.0";
obj2.CneWeight = "10.0";
obj2.DmsHeight = "10.0";
obj2.SellerVolume = "10.0";
obj2.SellerLength = "10.0";
obj2.CneIncomeWeight = "10.0";
obj2.SmsCollectHeight = "10.0";
obj2.CpVolume = "10.0";
obj2.SmsOriginalGoodsWeight = "10.0";
obj2.ChargedWeight = "10.0";
obj1.WeightVolume= obj2;
obj1.FeatureMap = "{\"outProvinceId\": \"440000\",       \"outCity\": \"深圳市\",       \"outTown\": \"南湾街道\",       \"outProvince\": \"广东省\",       \"outTownId\": \"440307012\",       \"mobileType\": \"real\",       \"preCleanInfo\": \"{\\"p\\":\\"广东省\\",\\"c\\":\\"深圳市\\",\\"d\\":\\"龙岗区\\",\\"t\\":\\"南湾街道\\",\\"divisionId\\":440307012}\",       \"outDistrict\": \"龙岗区\",       \"outCityId\": \"440300\",       \"deliverySiteId\": \"84495\",       \"bizId\": \"LP008003186111\",       \"cleaned\": \"1\",       \"outDistrictId\": \"440307\",       \"deliverySiteName\": \"深圳沙湾站Z\"}";
obj1.WaybillNum = "61167004281545421";
obj1.BizProvince = "广东省";
obj1.ProductSolution = "{\"version\": 1}";
obj1.StorageOrderNum = "LBX03299423599900019";
List<AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTODomain> list4 = new List<AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTODomain>();
AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTODomain obj5 = new AlibabaMcTmsSettlementMetadataUploadRequest.CpcGoodsDTODomain();
list4.Add(obj5);
obj5.GoodsUniqueId = "537377509999";
obj5.FeatureMap = "{}";
obj5.Quantity = 1L;
obj5.SnCode = "aaaa";
obj5.Length = 2L;
obj5.Weight = 2L;
obj5.OwnerId = "aaa";
obj5.GoodsSpec = "好";
obj5.GoodsBarCode = "698738782374";
obj5.GoodsType = "GOOD";
obj5.OperationOrderCode = "1";
obj5.Volume = 1L;
obj5.GoodsUnitPrice = "1";
obj5.OutBizCode = "23232";
obj5.OwnerName = "测试货主";
obj5.Width = 22L;
obj5.Id = 22L;
obj5.GoodsCode = "22";
obj5.GoodsName = "好";
obj5.WaybillNo = "33333";
obj5.Height = 1L;
obj1.GoodsList= list4;
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcCustomerDTODomain obj6 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcCustomerDTODomain();
obj6.CnUserId = "111";
obj6.MainUserId = "2323";
obj6.SellerId = "2323";
obj6.CustomerCode = "好";
obj6.SubUserId = "2323";
obj6.CustomerName = "好";
obj1.CustomerInfo= obj6;
obj1.BizTime = DateTime.Parse(2026-03-12 00:00:00");
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTODomain obj7 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTODomain();
obj7.Country = "中国";
obj7.FeatureMap = "{}";
obj7.Town = "闲林镇";
obj7.City = "杭州";
obj7.ContactName = "张三";
obj7.Latitude = "20.9897899";
obj7.Telephone = "13000000000";
obj7.CityId = 23L;
obj7.TownId = 23L;
obj7.ProvinceId = 23L;
obj7.CountryId = 23L;
obj7.DistrictId = 23L;
obj7.MobilePhone = "13000000000";
obj7.Province = "浙江省";
obj7.District = "余杭区";
obj7.DetailAddress = "幸福小区";
obj7.DivisionId = 22323L;
obj7.Longitude = "20.3333";
obj1.SetOffAddress= obj7;
obj1.WaybillType = 1L;
obj1.CollectionNumber = "232323";
AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTODomain obj8 = new AlibabaMcTmsSettlementMetadataUploadRequest.DicAcAddressDTODomain();
obj8.Country = "中国";
obj8.FeatureMap = "{}";
obj8.Town = "闲林镇";
obj8.City = "杭州";
obj8.ContactName = "张阿安";
obj8.Latitude = "40.3343";
obj8.Telephone = "13000000000";
obj8.CityId = 23L;
obj8.TownId = 23L;
obj8.ProvinceId = 23L;
obj8.CountryId = 23L;
obj8.DistrictId = 23L;
obj8.MobilePhone = "13000000000";
obj8.Province = "浙江省";
obj8.District = "闲林区";
obj8.DetailAddress = "幸福小区";
obj8.DivisionId = 23L;
obj8.Longitude = "22";
obj1.ArriveAddress= obj8;
obj1.WaybillStatus = "2";
obj1.MeterPackages = 2L;
req.McSettlementMetaDataDto_ = obj1;
AlibabaMcTmsSettlementMetadataUploadResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaMcTmsSettlementMetadataUploadRequest;
$mc_settlement_meta_data_dto = new McSettlementMetaDataDTO;
$mc_settlement_meta_data_dto->service_item_id="5000000017698";
$weight_volume = new DicAcWeightVolumeDTO;
$weight_volume->check_package_height="10.0";
$weight_volume->cp_weight="10.0";
$weight_volume->collect_weight="10.0";
$weight_volume->check_package_weight="10.0";
$weight_volume->check_package_width="10.0";
$weight_volume->check_package_volume="10.0";
$weight_volume->weight_updated="10.0";
$weight_volume->sms_collect_weight="10.0";
$weight_volume->dms_volume="10.0";
$weight_volume->sms_collect_volume="10.0";
$weight_volume->seller_height="10.0";
$weight_volume->dms_weight="10.0";
$weight_volume->sms_collect_un_round_weight="10.0";
$weight_volume->sms_collect_width="10.0";
$weight_volume->check_package_length="10.0";
$weight_volume->sms_collect_length="10.0";
$weight_volume->seller_weight="10.0";
$weight_volume->dms_width="10.0";
$weight_volume->dms_length="10.0";
$weight_volume->seller_width="10.0";
$weight_volume->cne_weight="10.0";
$weight_volume->dms_height="10.0";
$weight_volume->seller_volume="10.0";
$weight_volume->seller_length="10.0";
$weight_volume->cne_income_weight="10.0";
$weight_volume->sms_collect_height="10.0";
$weight_volume->cp_volume="10.0";
$weight_volume->sms_original_goods_weight="10.0";
$weight_volume->charged_weight="10.0";
$mc_settlement_meta_data_dto->weight_volume = $weight_volume;
$mc_settlement_meta_data_dto->feature_map="{\"outProvinceId\": \"440000\",       \"outCity\": \"深圳市\",       \"outTown\": \"南湾街道\",       \"outProvince\": \"广东省\",       \"outTownId\": \"440307012\",       \"mobileType\": \"real\",       \"preCleanInfo\": \"{\\"p\\":\\"广东省\\",\\"c\\":\\"深圳市\\",\\"d\\":\\"龙岗区\\",\\"t\\":\\"南湾街道\\",\\"divisionId\\":440307012}\",       \"outDistrict\": \"龙岗区\",       \"outCityId\": \"440300\",       \"deliverySiteId\": \"84495\",       \"bizId\": \"LP008003186111\",       \"cleaned\": \"1\",       \"outDistrictId\": \"440307\",       \"deliverySiteName\": \"深圳沙湾站Z\"}";
$mc_settlement_meta_data_dto->waybill_num="61167004281545421";
$mc_settlement_meta_data_dto->biz_province="广东省";
$mc_settlement_meta_data_dto->product_solution="{\"version\": 1}";
$mc_settlement_meta_data_dto->storage_order_num="LBX03299423599900019";
$goods_list = new CpcGoodsDTO;
$goods_list->goods_unique_id="537377509999";
$goods_list->feature_map="{}";
$goods_list->quantity="1";
$goods_list->sn_code="aaaa";
$goods_list->length="2";
$goods_list->weight="2";
$goods_list->owner_id="aaa";
$goods_list->goods_spec="好";
$goods_list->goods_bar_code="698738782374";
$goods_list->goods_type="GOOD";
$goods_list->operation_order_code="1";
$goods_list->volume="1";
$goods_list->goods_unit_price="1";
$goods_list->out_biz_code="23232";
$goods_list->owner_name="测试货主";
$goods_list->width="22";
$goods_list->id="22";
$goods_list->goods_code="22";
$goods_list->goods_name="好";
$goods_list->waybill_no="33333";
$goods_list->height="1";
$mc_settlement_meta_data_dto->goods_list = $goods_list;
$customer_info = new DicAcCustomerDTO;
$customer_info->cn_user_id="111";
$customer_info->main_user_id="2323";
$customer_info->seller_id="2323";
$customer_info->customer_code="好";
$customer_info->sub_user_id="2323";
$customer_info->customer_name="好";
$mc_settlement_meta_data_dto->customer_info = $customer_info;
$mc_settlement_meta_data_dto->biz_time="2026-03-12 00:00:00";
$set_off_address = new DicAcAddressDTO;
$set_off_address->country="中国";
$set_off_address->feature_map="{}";
$set_off_address->town="闲林镇";
$set_off_address->city="杭州";
$set_off_address->contact_name="张三";
$set_off_address->latitude="20.9897899";
$set_off_address->telephone="13000000000";
$set_off_address->city_id="23";
$set_off_address->town_id="23";
$set_off_address->province_id="23";
$set_off_address->country_id="23";
$set_off_address->district_id="23";
$set_off_address->mobile_phone="13000000000";
$set_off_address->province="浙江省";
$set_off_address->district="余杭区";
$set_off_address->detail_address="幸福小区";
$set_off_address->division_id="22323";
$set_off_address->longitude="20.3333";
$mc_settlement_meta_data_dto->set_off_address = $set_off_address;
$mc_settlement_meta_data_dto->waybill_type="1";
$mc_settlement_meta_data_dto->collection_number="232323";
$arrive_address = new DicAcAddressDTO;
$arrive_address->country="中国";
$arrive_address->feature_map="{}";
$arrive_address->town="闲林镇";
$arrive_address->city="杭州";
$arrive_address->contact_name="张阿安";
$arrive_address->latitude="40.3343";
$arrive_address->telephone="13000000000";
$arrive_address->city_id="23";
$arrive_address->town_id="23";
$arrive_address->province_id="23";
$arrive_address->country_id="23";
$arrive_address->district_id="23";
$arrive_address->mobile_phone="13000000000";
$arrive_address->province="浙江省";
$arrive_address->district="闲林区";
$arrive_address->detail_address="幸福小区";
$arrive_address->division_id="23";
$arrive_address->longitude="22";
$mc_settlement_meta_data_dto->arrive_address = $arrive_address;
$mc_settlement_meta_data_dto->waybill_status="2";
$mc_settlement_meta_data_dto->meter_packages="2";
$req->setMcSettlementMetaDataDto(json_encode($mc_settlement_meta_data_dto));
$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.mc.tms.settlement.metadata.upload' \
-d 'partner_id=apidoc' \
-d 'sign=487A370E2F015B1991AD35A50FE6765C' \
-d 'sign_method=hmac' \
-d 'timestamp=2026-04-03+05%3A25%3A06' \
-d 'v=2.0' \
-d 'mc_settlement_meta_data_dto=null'

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

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

req.mc_settlement_meta_data_dto="数据结构示例JSON格式"
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.mc.tms.settlement.metadata.upload");
add_param(pRequest,"mc_settlement_meta_data_dto","数据结构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',
	'url': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.mc.tms.settlement.metadata.upload', {
	'mc_settlement_meta_data_dto':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_mc_tms_settlement_metadata_upload_response>
    <sys_code>PARAM_IS_NULL</sys_code>
    <biz_success>true</biz_success>
    <message>参数为空</message>
</alibaba_mc_tms_settlement_metadata_upload_response>

{
    "alibaba_mc_tms_settlement_metadata_upload_response":{
        "sys_code":"PARAM_IS_NULL",
        "biz_success":true,
        "message":"参数为空"
    }
}

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.mc.tms.settlement.metadata.upload (猫超运输（丹鸟）结算元数据上传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ