淘宝开放平台

请求地址：

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

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

名称	类型	示例值	描述
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.setFromWarehouseNo("123xxxxxx89");
req.setParId("自定义xxxx");
req.setDepartureTemperature("15.4℃");
req.setEstimatedDepartureDate(StringUtils.parseDateTime("2025-05-26 12:30:30"));
req.setTransportRefEntId("refentidxxxxxxx");
req.setBillDetailCode("具体出库单明细编号");
req.setRouteName("北京xx到上海xx");
req.setBillCode("具体出库单编号");
req.setFromWarehouseName("测试发货仓库");
req.setRouteSn("测试配送路线");
req.setStaffName("测试配送人");
req.setStaffPhone("18888888888");
req.setStaffIdCard("110xxxxxxxxxxxx1111");
req.setActualDepartureDate(StringUtils.parseDateTime("2025-05-26 12:30:30"));
req.setFromWarehouseAddress("测试发货仓库地址");
req.setActualArrivalDate(StringUtils.parseDateTime("2025-05-27 12:30:30"));
req.setTransportCode("具体配送单号自定义");
req.setParName("测试配送单位");
req.setConfirmReceiver("测试收货人");
req.setVersionNumber("1");
req.setTransportVehicle("京A88888");
req.setConfirmReceiptTime(StringUtils.parseDateTime("2025-05-27 12:30:30"));
req.setEstimatedArrivalDate(StringUtils.parseDateTime("2025-05-27 12:30:30"));
req.setArrivalTemperature("15.5℃");
req.setStaffSn("测试配送人员编号");
req.setTransportOrderDate(StringUtils.parseDateTime("2025-05-25 12:30:30"));
req.setRefEntId("关联出库单对应的ref_ent_id");
AlibabaAlihealthDrugSccUploadscctransportorderinfoResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

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

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlihealthDrugSccUploadscctransportorderinfoRequest;
$req->setFromWarehouseNo("123xxxxxx89");
$req->setParId("自定义xxxx");
$req->setDepartureTemperature("15.4℃");
$req->setEstimatedDepartureDate("2025-05-26 12:30:30");
$req->setTransportRefEntId("refentidxxxxxxx");
$req->setBillDetailCode("具体出库单明细编号");
$req->setRouteName("北京xx到上海xx");
$req->setBillCode("具体出库单编号");
$req->setFromWarehouseName("测试发货仓库");
$req->setRouteSn("测试配送路线");
$req->setStaffName("测试配送人");
$req->setStaffPhone("18888888888");
$req->setStaffIdCard("110xxxxxxxxxxxx1111");
$req->setActualDepartureDate("2025-05-26 12:30:30");
$req->setFromWarehouseAddress("测试发货仓库地址");
$req->setActualArrivalDate("2025-05-27 12:30:30");
$req->setTransportCode("具体配送单号自定义");
$req->setParName("测试配送单位");
$req->setConfirmReceiver("测试收货人");
$req->setVersionNumber("1");
$req->setTransportVehicle("京A88888");
$req->setConfirmReceiptTime("2025-05-27 12:30:30");
$req->setEstimatedArrivalDate("2025-05-27 12:30:30");
$req->setArrivalTemperature("15.5℃");
$req->setStaffSn("测试配送人员编号");
$req->setTransportOrderDate("2025-05-25 12:30:30");
$req->setRefEntId("关联出库单对应的ref_ent_id");
$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=A9028EB724C48540F150D89DC888BD4E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-01+07%3A12%3A06' \
-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 '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 '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=110xxxxxxxxxxxx1111' \
-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.from_warehouse_no="123xxxxxx89"
req.par_id="自定义xxxx"
req.departure_temperature="15.4℃"
req.estimated_departure_date="2025-05-26 12:30:30"
req.transport_ref_ent_id="refentidxxxxxxx"
req.bill_detail_code="具体出库单明细编号"
req.route_name="北京xx到上海xx"
req.bill_code="具体出库单编号"
req.from_warehouse_name="测试发货仓库"
req.route_sn="测试配送路线"
req.staff_name="测试配送人"
req.staff_phone="18888888888"
req.staff_id_card="110xxxxxxxxxxxx1111"
req.actual_departure_date="2025-05-26 12:30:30"
req.from_warehouse_address="测试发货仓库地址"
req.actual_arrival_date="2025-05-27 12:30:30"
req.transport_code="具体配送单号自定义"
req.par_name="测试配送单位"
req.confirm_receiver="测试收货人"
req.version_number="1"
req.transport_vehicle="京A88888"
req.confirm_receipt_time="2025-05-27 12:30:30"
req.estimated_arrival_date="2025-05-27 12:30:30"
req.arrival_temperature="15.5℃"
req.staff_sn="测试配送人员编号"
req.transport_order_date="2025-05-25 12:30:30"
req.ref_ent_id="关联出库单对应的ref_ent_id"
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,"from_warehouse_no","123xxxxxx89");
add_param(pRequest,"par_id","自定义xxxx");
add_param(pRequest,"departure_temperature","15.4℃");
add_param(pRequest,"estimated_departure_date","2025-05-26 12:30:30");
add_param(pRequest,"transport_ref_ent_id","refentidxxxxxxx");
add_param(pRequest,"bill_detail_code","具体出库单明细编号");
add_param(pRequest,"route_name","北京xx到上海xx");
add_param(pRequest,"bill_code","具体出库单编号");
add_param(pRequest,"from_warehouse_name","测试发货仓库");
add_param(pRequest,"route_sn","测试配送路线");
add_param(pRequest,"staff_name","测试配送人");
add_param(pRequest,"staff_phone","18888888888");
add_param(pRequest,"staff_id_card","110xxxxxxxxxxxx1111");
add_param(pRequest,"actual_departure_date","2025-05-26 12:30:30");
add_param(pRequest,"from_warehouse_address","测试发货仓库地址");
add_param(pRequest,"actual_arrival_date","2025-05-27 12:30:30");
add_param(pRequest,"transport_code","具体配送单号自定义");
add_param(pRequest,"par_name","测试配送单位");
add_param(pRequest,"confirm_receiver","测试收货人");
add_param(pRequest,"version_number","1");
add_param(pRequest,"transport_vehicle","京A88888");
add_param(pRequest,"confirm_receipt_time","2025-05-27 12:30:30");
add_param(pRequest,"estimated_arrival_date","2025-05-27 12:30:30");
add_param(pRequest,"arrival_temperature","15.5℃");
add_param(pRequest,"staff_sn","测试配送人员编号");
add_param(pRequest,"transport_order_date","2025-05-25 12:30:30");
add_param(pRequest,"ref_ent_id","关联出库单对应的ref_ent_id");
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', {
	'from_warehouse_no':'123xxxxxx89',
	'par_id':'自定义xxxx',
	'departure_temperature':'15.4℃',
	'estimated_departure_date':'2025-05-26 12:30:30',
	'transport_ref_ent_id':'refentidxxxxxxx',
	'bill_detail_code':'具体出库单明细编号',
	'route_name':'北京xx到上海xx',
	'bill_code':'具体出库单编号',
	'from_warehouse_name':'测试发货仓库',
	'route_sn':'测试配送路线',
	'staff_name':'测试配送人',
	'staff_phone':'18888888888',
	'staff_id_card':'110xxxxxxxxxxxx1111',
	'actual_departure_date':'2025-05-26 12:30:30',
	'from_warehouse_address':'测试发货仓库地址',
	'actual_arrival_date':'2025-05-27 12:30:30',
	'transport_code':'具体配送单号自定义',
	'par_name':'测试配送单位',
	'confirm_receiver':'测试收货人',
	'version_number':'1',
	'transport_vehicle':'京A88888',
	'confirm_receipt_time':'2025-05-27 12:30:30',
	'estimated_arrival_date':'2025-05-27 12:30:30',
	'arrival_temperature':'15.5℃',
	'staff_sn':'测试配送人员编号',
	'transport_order_date':'2025-05-25 12:30:30',
	'ref_ent_id':'关联出库单对应的ref_ent_id'
}, 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