淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
ref_ent_id	String	必须	关联出库单对应的ref_ent_id	关联出库单编号对应的单据所有者
license_token	String	必须	license_token	用于身份校验，由getlicense获得
transport_code	String	必须	具体配送单号自定义	配送单号，用于唯一标识每个单据中的明细项
transport_order_date	String	必须	2025-05-25 12:30:30	运输配送单创建时间
version_number	Number	必须	1	版本号
bill_code	String	必须	具体出库单编号	关联出库单编号
bill_detail_code	String	可选	具体出库单明细编号	关联出库单明细编号
from_warehouse_no	String	可选	123xxxxxx89	发货仓库编号
from_warehouse_name	String	可选	测试发货仓库	发货仓库名称
from_warehouse_address	String	可选	测试发货仓库地址	发货仓库地址
estimated_departure_date	String	可选	2025-05-26 12:30:30	预计配送起运日期
estimated_arrival_date	String	可选	2025-05-27 12:30:30	预计配送达到日期
actual_departure_date	String	可选	2025-05-26 12:30:30	实际配送起运日期
actual_arrival_date	String	可选	2025-05-27 12:30:30	实际配送到达日期
transport_ref_ent_id	String	必须	refentidxxxxxxx	配送单位REF_ENT_ID
par_id	String	必须	自定义xxxx	配送单位自定义编码
par_name	String	必须	测试配送单位	配送单位自定义名称
route_sn	String	可选	测试配送路线	配送路线编码
route_name	String	可选	北京xx到上海xx	配送路线名称
staff_sn	String	可选	测试配送人员编号	配送人员编号
staff_name	String	可选	测试配送人	配送人员姓名
staff_phone	String	可选	18888888888	配送人员联系电话
staff_id_card	String	可选	123123199212126789	配送人员身份证号
transport_vehicle	String	可选	京A88888	配送车辆信息
departure_temperature	String	可选	15.4℃	起运温度
arrival_temperature	String	可选	15.5℃	到货温度
confirm_receipt_time	String	可选	2025-05-27 12:30:30	确认收货时间
confirm_receiver	String	可选	测试收货人	确认收货人
custom_field_one	String	必须	扩展字段1	扩展字段1
custom_field_two	String	必须	扩展字段2	扩展字段2
custom_field_three	String	必须	扩展字段3	扩展字段3
custom_field_four	String	必须	扩展字段4	扩展字段4
custom_field_five	String	必须	扩展字段5	扩展字段5

名称	类型	示例值	描述
response_success	Boolean	true	是否成功
model	String	上传成功	返回结果
msg_info	String	SUCCESS	返回编码示描述
msg_code	String	SUCCESS	返回编码
sub_msg_code	String	SUCCESS	返回子编码
operation	String	无需操作	后续操作描述

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthDrugSccUploadscctransportorderinfoRequest req = new AlibabaAlihealthDrugSccUploadscctransportorderinfoRequest();
req.setRefEntId("关联出库单对应的ref_ent_id");
req.setLicenseToken("license_token");
req.setTransportCode("具体配送单号自定义");
req.setTransportOrderDate("2025-05-25 12:30:30");
req.setVersionNumber(1L);
req.setBillCode("具体出库单编号");
req.setBillDetailCode("具体出库单明细编号");
req.setFromWarehouseNo("123xxxxxx89");
req.setFromWarehouseName("测试发货仓库");
req.setFromWarehouseAddress("测试发货仓库地址");
req.setEstimatedDepartureDate("2025-05-26 12:30:30");
req.setEstimatedArrivalDate("2025-05-27 12:30:30");
req.setActualDepartureDate("2025-05-26 12:30:30");
req.setActualArrivalDate("2025-05-27 12:30:30");
req.setTransportRefEntId("refentidxxxxxxx");
req.setParId("自定义xxxx");
req.setParName("测试配送单位");
req.setRouteSn("测试配送路线");
req.setRouteName("北京xx到上海xx");
req.setStaffSn("测试配送人员编号");
req.setStaffName("测试配送人");
req.setStaffPhone("18888888888");
req.setStaffIdCard("123123199212126789");
req.setTransportVehicle("京A88888");
req.setDepartureTemperature("15.4℃");
req.setArrivalTemperature("15.5℃");
req.setConfirmReceiptTime("2025-05-27 12:30:30");
req.setConfirmReceiver("测试收货人");
req.setCustomFieldOne("扩展字段1");
req.setCustomFieldTwo("扩展字段2");
req.setCustomFieldThree("扩展字段3");
req.setCustomFieldFour("扩展字段4");
req.setCustomFieldFive("扩展字段5");
AlibabaAlihealthDrugSccUploadscctransportorderinfoResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlihealthDrugSccUploadscctransportorderinfoRequest req = new AlibabaAlihealthDrugSccUploadscctransportorderinfoRequest();
req.RefEntId = "关联出库单对应的ref_ent_id";
req.LicenseToken = "license_token";
req.TransportCode = "具体配送单号自定义";
req.TransportOrderDate = "2025-05-25 12:30:30";
req.VersionNumber = 1L;
req.BillCode = "具体出库单编号";
req.BillDetailCode = "具体出库单明细编号";
req.FromWarehouseNo = "123xxxxxx89";
req.FromWarehouseName = "测试发货仓库";
req.FromWarehouseAddress = "测试发货仓库地址";
req.EstimatedDepartureDate = "2025-05-26 12:30:30";
req.EstimatedArrivalDate = "2025-05-27 12:30:30";
req.ActualDepartureDate = "2025-05-26 12:30:30";
req.ActualArrivalDate = "2025-05-27 12:30:30";
req.TransportRefEntId = "refentidxxxxxxx";
req.ParId = "自定义xxxx";
req.ParName = "测试配送单位";
req.RouteSn = "测试配送路线";
req.RouteName = "北京xx到上海xx";
req.StaffSn = "测试配送人员编号";
req.StaffName = "测试配送人";
req.StaffPhone = "18888888888";
req.StaffIdCard = "123123199212126789";
req.TransportVehicle = "京A88888";
req.DepartureTemperature = "15.4℃";
req.ArrivalTemperature = "15.5℃";
req.ConfirmReceiptTime = "2025-05-27 12:30:30";
req.ConfirmReceiver = "测试收货人";
req.CustomFieldOne = "扩展字段1";
req.CustomFieldTwo = "扩展字段2";
req.CustomFieldThree = "扩展字段3";
req.CustomFieldFour = "扩展字段4";
req.CustomFieldFive = "扩展字段5";
AlibabaAlihealthDrugSccUploadscctransportorderinfoResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlihealthDrugSccUploadscctransportorderinfoRequest;
$req->setRefEntId("关联出库单对应的ref_ent_id");
$req->setLicenseToken("license_token");
$req->setTransportCode("具体配送单号自定义");
$req->setTransportOrderDate("2025-05-25 12:30:30");
$req->setVersionNumber("1");
$req->setBillCode("具体出库单编号");
$req->setBillDetailCode("具体出库单明细编号");
$req->setFromWarehouseNo("123xxxxxx89");
$req->setFromWarehouseName("测试发货仓库");
$req->setFromWarehouseAddress("测试发货仓库地址");
$req->setEstimatedDepartureDate("2025-05-26 12:30:30");
$req->setEstimatedArrivalDate("2025-05-27 12:30:30");
$req->setActualDepartureDate("2025-05-26 12:30:30");
$req->setActualArrivalDate("2025-05-27 12:30:30");
$req->setTransportRefEntId("refentidxxxxxxx");
$req->setParId("自定义xxxx");
$req->setParName("测试配送单位");
$req->setRouteSn("测试配送路线");
$req->setRouteName("北京xx到上海xx");
$req->setStaffSn("测试配送人员编号");
$req->setStaffName("测试配送人");
$req->setStaffPhone("18888888888");
$req->setStaffIdCard("123123199212126789");
$req->setTransportVehicle("京A88888");
$req->setDepartureTemperature("15.4℃");
$req->setArrivalTemperature("15.5℃");
$req->setConfirmReceiptTime("2025-05-27 12:30:30");
$req->setConfirmReceiver("测试收货人");
$req->setCustomFieldOne("扩展字段1");
$req->setCustomFieldTwo("扩展字段2");
$req->setCustomFieldThree("扩展字段3");
$req->setCustomFieldFour("扩展字段4");
$req->setCustomFieldFive("扩展字段5");
$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.alihealth.drug.scc.uploadscctransportorderinfo' \
-d 'partner_id=apidoc' \
-d 'sign=C928CB07242170F626A7A3C7B355610E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-08-01+09%3A10%3A59' \
-d 'v=2.0' \
-d 'actual_arrival_date=2025-05-27+12%3A30%3A30' \
-d 'actual_departure_date=2025-05-26+12%3A30%3A30' \
-d 'arrival_temperature=15.5%E2%84%83' \
-d 'bill_code=%E5%85%B7%E4%BD%93%E5%87%BA%E5%BA%93%E5%8D%95%E7%BC%96%E5%8F%B7' \
-d 'bill_detail_code=%E5%85%B7%E4%BD%93%E5%87%BA%E5%BA%93%E5%8D%95%E6%98%8E%E7%BB%86%E7%BC%96%E5%8F%B7' \
-d 'confirm_receipt_time=2025-05-27+12%3A30%3A30' \
-d 'confirm_receiver=%E6%B5%8B%E8%AF%95%E6%94%B6%E8%B4%A7%E4%BA%BA' \
-d 'custom_field_five=%E6%89%A9%E5%B1%95%E5%AD%97%E6%AE%B55' \
-d 'custom_field_four=%E6%89%A9%E5%B1%95%E5%AD%97%E6%AE%B54' \
-d 'custom_field_one=%E6%89%A9%E5%B1%95%E5%AD%97%E6%AE%B51' \
-d 'custom_field_three=%E6%89%A9%E5%B1%95%E5%AD%97%E6%AE%B53' \
-d 'custom_field_two=%E6%89%A9%E5%B1%95%E5%AD%97%E6%AE%B52' \
-d 'departure_temperature=15.4%E2%84%83' \
-d 'estimated_arrival_date=2025-05-27+12%3A30%3A30' \
-d 'estimated_departure_date=2025-05-26+12%3A30%3A30' \
-d 'from_warehouse_address=%E6%B5%8B%E8%AF%95%E5%8F%91%E8%B4%A7%E4%BB%93%E5%BA%93%E5%9C%B0%E5%9D%80' \
-d 'from_warehouse_name=%E6%B5%8B%E8%AF%95%E5%8F%91%E8%B4%A7%E4%BB%93%E5%BA%93' \
-d 'from_warehouse_no=123xxxxxx89' \
-d 'license_token=license_token' \
-d 'par_id=%E8%87%AA%E5%AE%9A%E4%B9%89xxxx' \
-d 'par_name=%E6%B5%8B%E8%AF%95%E9%85%8D%E9%80%81%E5%8D%95%E4%BD%8D' \
-d 'ref_ent_id=%E5%85%B3%E8%81%94%E5%87%BA%E5%BA%93%E5%8D%95%E5%AF%B9%E5%BA%94%E7%9A%84ref_ent_id' \
-d 'route_name=%E5%8C%97%E4%BA%ACxx%E5%88%B0%E4%B8%8A%E6%B5%B7xx' \
-d 'route_sn=%E6%B5%8B%E8%AF%95%E9%85%8D%E9%80%81%E8%B7%AF%E7%BA%BF' \
-d 'staff_id_card=123123199212126789' \
-d 'staff_name=%E6%B5%8B%E8%AF%95%E9%85%8D%E9%80%81%E4%BA%BA' \
-d 'staff_phone=18888888888' \
-d 'staff_sn=%E6%B5%8B%E8%AF%95%E9%85%8D%E9%80%81%E4%BA%BA%E5%91%98%E7%BC%96%E5%8F%B7' \
-d 'transport_code=%E5%85%B7%E4%BD%93%E9%85%8D%E9%80%81%E5%8D%95%E5%8F%B7%E8%87%AA%E5%AE%9A%E4%B9%89' \
-d 'transport_order_date=2025-05-25+12%3A30%3A30' \
-d 'transport_ref_ent_id=refentidxxxxxxx' \
-d 'transport_vehicle=%E4%BA%ACA88888' \
-d 'version_number=1'

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

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

req.ref_ent_id="关联出库单对应的ref_ent_id"
req.license_token="license_token"
req.transport_code="具体配送单号自定义"
req.transport_order_date="2025-05-25 12:30:30"
req.version_number=1
req.bill_code="具体出库单编号"
req.bill_detail_code="具体出库单明细编号"
req.from_warehouse_no="123xxxxxx89"
req.from_warehouse_name="测试发货仓库"
req.from_warehouse_address="测试发货仓库地址"
req.estimated_departure_date="2025-05-26 12:30:30"
req.estimated_arrival_date="2025-05-27 12:30:30"
req.actual_departure_date="2025-05-26 12:30:30"
req.actual_arrival_date="2025-05-27 12:30:30"
req.transport_ref_ent_id="refentidxxxxxxx"
req.par_id="自定义xxxx"
req.par_name="测试配送单位"
req.route_sn="测试配送路线"
req.route_name="北京xx到上海xx"
req.staff_sn="测试配送人员编号"
req.staff_name="测试配送人"
req.staff_phone="18888888888"
req.staff_id_card="123123199212126789"
req.transport_vehicle="京A88888"
req.departure_temperature="15.4℃"
req.arrival_temperature="15.5℃"
req.confirm_receipt_time="2025-05-27 12:30:30"
req.confirm_receiver="测试收货人"
req.custom_field_one="扩展字段1"
req.custom_field_two="扩展字段2"
req.custom_field_three="扩展字段3"
req.custom_field_four="扩展字段4"
req.custom_field_five="扩展字段5"
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.alihealth.drug.scc.uploadscctransportorderinfo");
add_param(pRequest,"ref_ent_id","关联出库单对应的ref_ent_id");
add_param(pRequest,"license_token","license_token");
add_param(pRequest,"transport_code","具体配送单号自定义");
add_param(pRequest,"transport_order_date","2025-05-25 12:30:30");
add_param(pRequest,"version_number","1");
add_param(pRequest,"bill_code","具体出库单编号");
add_param(pRequest,"bill_detail_code","具体出库单明细编号");
add_param(pRequest,"from_warehouse_no","123xxxxxx89");
add_param(pRequest,"from_warehouse_name","测试发货仓库");
add_param(pRequest,"from_warehouse_address","测试发货仓库地址");
add_param(pRequest,"estimated_departure_date","2025-05-26 12:30:30");
add_param(pRequest,"estimated_arrival_date","2025-05-27 12:30:30");
add_param(pRequest,"actual_departure_date","2025-05-26 12:30:30");
add_param(pRequest,"actual_arrival_date","2025-05-27 12:30:30");
add_param(pRequest,"transport_ref_ent_id","refentidxxxxxxx");
add_param(pRequest,"par_id","自定义xxxx");
add_param(pRequest,"par_name","测试配送单位");
add_param(pRequest,"route_sn","测试配送路线");
add_param(pRequest,"route_name","北京xx到上海xx");
add_param(pRequest,"staff_sn","测试配送人员编号");
add_param(pRequest,"staff_name","测试配送人");
add_param(pRequest,"staff_phone","18888888888");
add_param(pRequest,"staff_id_card","123123199212126789");
add_param(pRequest,"transport_vehicle","京A88888");
add_param(pRequest,"departure_temperature","15.4℃");
add_param(pRequest,"arrival_temperature","15.5℃");
add_param(pRequest,"confirm_receipt_time","2025-05-27 12:30:30");
add_param(pRequest,"confirm_receiver","测试收货人");
add_param(pRequest,"custom_field_one","扩展字段1");
add_param(pRequest,"custom_field_two","扩展字段2");
add_param(pRequest,"custom_field_three","扩展字段3");
add_param(pRequest,"custom_field_four","扩展字段4");
add_param(pRequest,"custom_field_five","扩展字段5");
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.alihealth.drug.scc.uploadscctransportorderinfo', {
	'ref_ent_id':'关联出库单对应的ref_ent_id',
	'license_token':'license_token',
	'transport_code':'具体配送单号自定义',
	'transport_order_date':'2025-05-25 12:30:30',
	'version_number':'1',
	'bill_code':'具体出库单编号',
	'bill_detail_code':'具体出库单明细编号',
	'from_warehouse_no':'123xxxxxx89',
	'from_warehouse_name':'测试发货仓库',
	'from_warehouse_address':'测试发货仓库地址',
	'estimated_departure_date':'2025-05-26 12:30:30',
	'estimated_arrival_date':'2025-05-27 12:30:30',
	'actual_departure_date':'2025-05-26 12:30:30',
	'actual_arrival_date':'2025-05-27 12:30:30',
	'transport_ref_ent_id':'refentidxxxxxxx',
	'par_id':'自定义xxxx',
	'par_name':'测试配送单位',
	'route_sn':'测试配送路线',
	'route_name':'北京xx到上海xx',
	'staff_sn':'测试配送人员编号',
	'staff_name':'测试配送人',
	'staff_phone':'18888888888',
	'staff_id_card':'123123199212126789',
	'transport_vehicle':'京A88888',
	'departure_temperature':'15.4℃',
	'arrival_temperature':'15.5℃',
	'confirm_receipt_time':'2025-05-27 12:30:30',
	'confirm_receiver':'测试收货人',
	'custom_field_one':'扩展字段1',
	'custom_field_two':'扩展字段2',
	'custom_field_three':'扩展字段3',
	'custom_field_four':'扩展字段4',
	'custom_field_five':'扩展字段5'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alihealth_drug_scc_uploadscctransportorderinfo_response>
    <response_success>true</response_success>
    <model>上传成功</model>
    <msg_info>SUCCESS</msg_info>
    <msg_code>SUCCESS</msg_code>
    <sub_msg_code>SUCCESS</sub_msg_code>
    <operation>无需操作</operation>
</alibaba_alihealth_drug_scc_uploadscctransportorderinfo_response>

{
    "alibaba_alihealth_drug_scc_uploadscctransportorderinfo_response":{
        "response_success":true,
        "model":"上传成功",
        "msg_info":"SUCCESS",
        "msg_code":"SUCCESS",
        "sub_msg_code":"SUCCESS",
        "operation":"无需操作"
    }
}

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下载

开放平台

阿里健康追溯码

alibaba.alihealth.drug.scc.uploadscctransportorderinfo (上传协同运输配送单单据)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ