淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
bill_code	String	必须	msc_bc005	单据编号（唯一）
bill_time	Date	必须	2024-10-10 16:57:15	单据时间（一般为药品入出库时间）
bill_type	Number	必须	201	单据类型【102代表采购入库,201代表销售出库，其它单据类型详见文档】
ref_user_id	String	必须	320000000000127971	上传企业（单据的所有者，上传人）【注意：该入参是ref_ent_id，不是ent_id】,可通过“根据企业名称查询企业唯一标识”接口获取
from_user_id	String	必须	00000000000020671792	发货企业【注意：该入参是ent_id,并不是ref_ent_id】
to_user_id	String	必须	d5f5f05c6af04e52ba7894d9bbf8e757	收货企业【注意：该入参是ent_id,并不是ref_ent_id】
dest_user_id	String	可选	d5f5f05c6af04e52ba7894d9bbf8e757	直调企业【注意：该入参是ent_id,并不是ref_ent_id】
oper_ic_code	String	必须	212000345	操作人标识（写appkey编号）
oper_ic_name	String	可选	张三	单据提交者姓名
file_content	String	必须	添写单据文件xml的加密串，加密过程看文档。XmlUtil类的createFileZipContent方法生成	单据文件体【bas64字符串】，看对接文档中的代码示例，示例中有相应说明。
upload_file_name	String	必须	单据文件00001.xml	单据名称
client_type	Number	必须	2	请求端类型【暂定都写2】
from_address	String	可选	发货地址XXX	发货地址
to_address	String	可选	收货地址XXX	收货地址
from_bill_code	String	可选	123456	发货单编号
order_code	String	可选	123456	订货单编号
from_person	String	可选	张某	发货人(特药出单据必填)
to_person	String	可选	李某	收货人(特药入单据必填)
dis_ref_ent_id	String	可选	5069452c34b94a778abaa26c2b40b305	药品配送企业refentid【出库单填写，与dis_ent_id入参选其一添加】
dis_ent_id	String	可选	5069452c34b94a778abaa26c2b40b305	药品配送企业entId【出库单填写】
qu_receivable	Number	可选	10	应收货总数量
xt_is_check	String	可选	未验证通过原因	未验证通过原因【验证未通过时填写】
xt_check_code	String	可选	0	是否验证，0：未通过验证，1：已验证
xt_check_code_desc	String	可选	未通过原因描述	未验证通过原因描述【验证未通过时填写】
drug_list_json	String	可选	[{"codeCount":100,"commDrugId":"testCommDrugId0","exprieDate":1571131734945,"physicInfo":"test0","pkgSpec":"test0","prepnCount":10,"produceBatchNo":"test0","produceDate":1571131734945},{"codeCount":100,"commDrugId":"testCommDrugId1","exprieDate":1571131734945,"physicInfo":"test1","pkgSpec":"test1","prepnCount":10,"produceBatchNo":"test1","produceDate":1571131734945}]	【可不填】药品列表Json："codeCount": 药品数量 "commDrugId": 国家药品唯一标识 "exprieDate": 生产日期 "physicInfo": 药品信息 "pkgSpec": 包状规格 "prepnCount": 制剂数量 "produceBatchNo":生产批次 "produceDate": 生产日期
ass_ref_ent_id	String	可选	5069452c34b94a778abaa26c2b40b305	单据委托企业refEntId
ass_ent_id	String	可选	5069452c34b94a778abaa26c2b40b305	单据委托企业entId
ignore_check	String	可选	1	忽略校验项，1: 代表忽略码重复上传校验 0：代表需要进行码重复上传校验

名称	类型	示例值	描述
model	String	SUCCESS	返回结果
msg_code	String	SUCCESS	返回结果
msg_info	String	调用成功	返回结果
response_success	Boolean	true	是否成功(true 成功 ,false失败)

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthDrugMscUploadcircubillRequest req = new AlibabaAlihealthDrugMscUploadcircubillRequest();
req.setBillCode("msc_bc005");
req.setBillTime(StringUtils.parseDateTime("2024-10-10 16:57:15"));
req.setBillType(201L);
req.setRefUserId("320000000000127971");
req.setFromUserId("00000000000020671792");
req.setToUserId("d5f5f05c6af04e52ba7894d9bbf8e757");
req.setDestUserId("d5f5f05c6af04e52ba7894d9bbf8e757");
req.setOperIcCode("212000345");
req.setOperIcName("张三");
req.setFileContent("添写单据文件xml的加密串，加密过程看文档。XmlUtil类的createFileZipContent方法生成");
req.setUploadFileName("单据文件00001.xml");
req.setClientType(2L);
req.setFromAddress("发货地址XXX");
req.setToAddress("收货地址XXX");
req.setFromBillCode("123456");
req.setOrderCode("123456");
req.setFromPerson("张某");
req.setToPerson("李某");
req.setDisRefEntId("5069452c34b94a778abaa26c2b40b305");
req.setDisEntId("5069452c34b94a778abaa26c2b40b305");
req.setQuReceivable(10L);
req.setXtIsCheck("未验证通过原因");
req.setXtCheckCode("0");
req.setXtCheckCodeDesc("未通过原因描述");
req.setDrugListJson("[{\"codeCount\":100,\"commDrugId\":\"testCommDrugId0\",\"exprieDate\":1571131734945,\"physicInfo\":\"test0\",\"pkgSpec\":\"test0\",\"prepnCount\":10,\"produceBatchNo\":\"test0\",\"produceDate\":1571131734945},{\"codeCount\":100,\"commDrugId\":\"testCommDrugId1\",\"exprieDate\":1571131734945,\"physicInfo\":\"test1\",\"pkgSpec\":\"test1\",\"prepnCount\":10,\"produceBatchNo\":\"test1\",\"produceDate\":1571131734945}]");
req.setAssRefEntId("5069452c34b94a778abaa26c2b40b305");
req.setAssEntId("5069452c34b94a778abaa26c2b40b305");
req.setIgnoreCheck("1");
AlibabaAlihealthDrugMscUploadcircubillResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlihealthDrugMscUploadcircubillRequest req = new AlibabaAlihealthDrugMscUploadcircubillRequest();
req.BillCode = "msc_bc005";
req.BillTime = DateTime.Parse("2024-10-10 16:57:15");
req.BillType = 201L;
req.RefUserId = "320000000000127971";
req.FromUserId = "00000000000020671792";
req.ToUserId = "d5f5f05c6af04e52ba7894d9bbf8e757";
req.DestUserId = "d5f5f05c6af04e52ba7894d9bbf8e757";
req.OperIcCode = "212000345";
req.OperIcName = "张三";
req.FileContent = "添写单据文件xml的加密串，加密过程看文档。XmlUtil类的createFileZipContent方法生成";
req.UploadFileName = "单据文件00001.xml";
req.ClientType = 2L;
req.FromAddress = "发货地址XXX";
req.ToAddress = "收货地址XXX";
req.FromBillCode = "123456";
req.OrderCode = "123456";
req.FromPerson = "张某";
req.ToPerson = "李某";
req.DisRefEntId = "5069452c34b94a778abaa26c2b40b305";
req.DisEntId = "5069452c34b94a778abaa26c2b40b305";
req.QuReceivable = 10L;
req.XtIsCheck = "未验证通过原因";
req.XtCheckCode = "0";
req.XtCheckCodeDesc = "未通过原因描述";
req.DrugListJson = "[{\"codeCount\":100,\"commDrugId\":\"testCommDrugId0\",\"exprieDate\":1571131734945,\"physicInfo\":\"test0\",\"pkgSpec\":\"test0\",\"prepnCount\":10,\"produceBatchNo\":\"test0\",\"produceDate\":1571131734945},{\"codeCount\":100,\"commDrugId\":\"testCommDrugId1\",\"exprieDate\":1571131734945,\"physicInfo\":\"test1\",\"pkgSpec\":\"test1\",\"prepnCount\":10,\"produceBatchNo\":\"test1\",\"produceDate\":1571131734945}]";
req.AssRefEntId = "5069452c34b94a778abaa26c2b40b305";
req.AssEntId = "5069452c34b94a778abaa26c2b40b305";
req.IgnoreCheck = "1";
AlibabaAlihealthDrugMscUploadcircubillResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAlihealthDrugMscUploadcircubillRequest;
$req->setBillCode("msc_bc005");
$req->setBillTime("2024-10-10 16:57:15");
$req->setBillType("201");
$req->setRefUserId("320000000000127971");
$req->setFromUserId("00000000000020671792");
$req->setToUserId("d5f5f05c6af04e52ba7894d9bbf8e757");
$req->setDestUserId("d5f5f05c6af04e52ba7894d9bbf8e757");
$req->setOperIcCode("212000345");
$req->setOperIcName("张三");
$req->setFileContent("添写单据文件xml的加密串，加密过程看文档。XmlUtil类的createFileZipContent方法生成");
$req->setUploadFileName("单据文件00001.xml");
$req->setClientType("2");
$req->setFromAddress("发货地址XXX");
$req->setToAddress("收货地址XXX");
$req->setFromBillCode("123456");
$req->setOrderCode("123456");
$req->setFromPerson("张某");
$req->setToPerson("李某");
$req->setDisRefEntId("5069452c34b94a778abaa26c2b40b305");
$req->setDisEntId("5069452c34b94a778abaa26c2b40b305");
$req->setQuReceivable("10");
$req->setXtIsCheck("未验证通过原因");
$req->setXtCheckCode("0");
$req->setXtCheckCodeDesc("未通过原因描述");
$req->setDrugListJson("[{\"codeCount\":100,\"commDrugId\":\"testCommDrugId0\",\"exprieDate\":1571131734945,\"physicInfo\":\"test0\",\"pkgSpec\":\"test0\",\"prepnCount\":10,\"produceBatchNo\":\"test0\",\"produceDate\":1571131734945},{\"codeCount\":100,\"commDrugId\":\"testCommDrugId1\",\"exprieDate\":1571131734945,\"physicInfo\":\"test1\",\"pkgSpec\":\"test1\",\"prepnCount\":10,\"produceBatchNo\":\"test1\",\"produceDate\":1571131734945}]");
$req->setAssRefEntId("5069452c34b94a778abaa26c2b40b305");
$req->setAssEntId("5069452c34b94a778abaa26c2b40b305");
$req->setIgnoreCheck("1");
$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.msc.uploadcircubill' \
-d 'partner_id=apidoc' \
-d 'sign=3898A9EEE40AF3DB2EF6DEF59E8EAB00' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-02+10%3A31%3A36' \
-d 'v=2.0' \
-d 'ass_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'ass_ref_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'bill_code=msc_bc005' \
-d 'bill_time=2024-10-10+16%3A57%3A15' \
-d 'bill_type=201' \
-d 'client_type=2' \
-d 'dest_user_id=d5f5f05c6af04e52ba7894d9bbf8e757' \
-d 'dis_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'dis_ref_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'drug_list_json=%7B%22codeCount%22%3A100%2C%22commDrugId%22%3A%22testCommDrugId0%22%2C%22exprieDate%22%3A1571131734945%2C%22physicInfo%22%3A%22test0%22%2C%22pkgSpec%22%3A%22test0%22%2C%22prepnCount%22%3A10%2C%22produceBatchNo%22%3A%22test0%22%2C%22produceDate%22%3A1571131734945%7D%2C%7B%22codeCount%22%3A100%2C%22commDrugId%22%3A%22testCommDrugId1%22%2C%22exprieDate%22%3A1571131734945%2C%22physicInfo%22%3A%22test1%22%2C%22pkgSpec%22%3A%22test1%22%2C%22prepnCount%22%3A10%2C%22produceBatchNo%22%3A%22test1%22%2C%22produceDate%22%3A1571131734945%7D' \
-d 'file_content=%E6%B7%BB%E5%86%99%E5%8D%95%E6%8D%AE%E6%96%87%E4%BB%B6xml%E7%9A%84%E5%8A%A0%E5%AF%86%E4%B8%B2%EF%BC%8C%E5%8A%A0%E5%AF%86%E8%BF%87%E7%A8%8B%E7%9C%8B%E6%96%87%E6%A1%A3%E3%80%82XmlUtil%E7%B1%BB%E7%9A%84createFileZipContent%E6%96%B9%E6%B3%95%E7%94%9F%E6%88%90' \
-d 'from_address=%E5%8F%91%E8%B4%A7%E5%9C%B0%E5%9D%80XXX' \
-d 'from_bill_code=123456' \
-d 'from_person=%E5%BC%A0%E6%9F%90' \
-d 'from_user_id=00000000000020671792' \
-d 'ignore_check=1' \
-d 'oper_ic_code=212000345' \
-d 'oper_ic_name=%E5%BC%A0%E4%B8%89' \
-d 'order_code=123456' \
-d 'qu_receivable=10' \
-d 'ref_user_id=320000000000127971' \
-d 'to_address=%E6%94%B6%E8%B4%A7%E5%9C%B0%E5%9D%80XXX' \
-d 'to_person=%E6%9D%8E%E6%9F%90' \
-d 'to_user_id=d5f5f05c6af04e52ba7894d9bbf8e757' \
-d 'upload_file_name=%E5%8D%95%E6%8D%AE%E6%96%87%E4%BB%B600001.xml' \
-d 'xt_check_code=0' \
-d 'xt_check_code_desc=%E6%9C%AA%E9%80%9A%E8%BF%87%E5%8E%9F%E5%9B%A0%E6%8F%8F%E8%BF%B0' \
-d 'xt_is_check=%E6%9C%AA%E9%AA%8C%E8%AF%81%E9%80%9A%E8%BF%87%E5%8E%9F%E5%9B%A0'

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

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

req.bill_code="msc_bc005"
req.bill_time="2024-10-10 16:57:15"
req.bill_type=201
req.ref_user_id="320000000000127971"
req.from_user_id="00000000000020671792"
req.to_user_id="d5f5f05c6af04e52ba7894d9bbf8e757"
req.dest_user_id="d5f5f05c6af04e52ba7894d9bbf8e757"
req.oper_ic_code="212000345"
req.oper_ic_name="张三"
req.file_content="添写单据文件xml的加密串，加密过程看文档。XmlUtil类的createFileZipContent方法生成"
req.upload_file_name="单据文件00001.xml"
req.client_type=2
req.from_address="发货地址XXX"
req.to_address="收货地址XXX"
req.from_bill_code="123456"
req.order_code="123456"
req.from_person="张某"
req.to_person="李某"
req.dis_ref_ent_id="5069452c34b94a778abaa26c2b40b305"
req.dis_ent_id="5069452c34b94a778abaa26c2b40b305"
req.qu_receivable=10
req.xt_is_check="未验证通过原因"
req.xt_check_code="0"
req.xt_check_code_desc="未通过原因描述"
req.drug_list_json="[{\"codeCount\":100,\"commDrugId\":\"testCommDrugId0\",\"exprieDate\":1571131734945,\"physicInfo\":\"test0\",\"pkgSpec\":\"test0\",\"prepnCount\":10,\"produceBatchNo\":\"test0\",\"produceDate\":1571131734945},{\"codeCount\":100,\"commDrugId\":\"testCommDrugId1\",\"exprieDate\":1571131734945,\"physicInfo\":\"test1\",\"pkgSpec\":\"test1\",\"prepnCount\":10,\"produceBatchNo\":\"test1\",\"produceDate\":1571131734945}]"
req.ass_ref_ent_id="5069452c34b94a778abaa26c2b40b305"
req.ass_ent_id="5069452c34b94a778abaa26c2b40b305"
req.ignore_check="1"
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.msc.uploadcircubill");
add_param(pRequest,"bill_code","msc_bc005");
add_param(pRequest,"bill_time","2024-10-10 16:57:15");
add_param(pRequest,"bill_type","201");
add_param(pRequest,"ref_user_id","320000000000127971");
add_param(pRequest,"from_user_id","00000000000020671792");
add_param(pRequest,"to_user_id","d5f5f05c6af04e52ba7894d9bbf8e757");
add_param(pRequest,"dest_user_id","d5f5f05c6af04e52ba7894d9bbf8e757");
add_param(pRequest,"oper_ic_code","212000345");
add_param(pRequest,"oper_ic_name","张三");
add_param(pRequest,"file_content","添写单据文件xml的加密串，加密过程看文档。XmlUtil类的createFileZipContent方法生成");
add_param(pRequest,"upload_file_name","单据文件00001.xml");
add_param(pRequest,"client_type","2");
add_param(pRequest,"from_address","发货地址XXX");
add_param(pRequest,"to_address","收货地址XXX");
add_param(pRequest,"from_bill_code","123456");
add_param(pRequest,"order_code","123456");
add_param(pRequest,"from_person","张某");
add_param(pRequest,"to_person","李某");
add_param(pRequest,"dis_ref_ent_id","5069452c34b94a778abaa26c2b40b305");
add_param(pRequest,"dis_ent_id","5069452c34b94a778abaa26c2b40b305");
add_param(pRequest,"qu_receivable","10");
add_param(pRequest,"xt_is_check","未验证通过原因");
add_param(pRequest,"xt_check_code","0");
add_param(pRequest,"xt_check_code_desc","未通过原因描述");
add_param(pRequest,"drug_list_json","{"codeCount":100,"commDrugId":"testCommDrugId0","exprieDate":1571131734945,"physicInfo":"test0","pkgSpec":"test0","prepnCount":10,"produceBatchNo":"test0","produceDate":1571131734945},{"codeCount":100,"commDrugId":"testCommDrugId1","exprieDate":1571131734945,"physicInfo":"test1","pkgSpec":"test1","prepnCount":10,"produceBatchNo":"test1","produceDate":1571131734945}");
add_param(pRequest,"ass_ref_ent_id","5069452c34b94a778abaa26c2b40b305");
add_param(pRequest,"ass_ent_id","5069452c34b94a778abaa26c2b40b305");
add_param(pRequest,"ignore_check","1");
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.msc.uploadcircubill', {
	'bill_code':'msc_bc005',
	'bill_time':'2024-10-10 16:57:15',
	'bill_type':'201',
	'ref_user_id':'320000000000127971',
	'from_user_id':'00000000000020671792',
	'to_user_id':'d5f5f05c6af04e52ba7894d9bbf8e757',
	'dest_user_id':'d5f5f05c6af04e52ba7894d9bbf8e757',
	'oper_ic_code':'212000345',
	'oper_ic_name':'张三',
	'file_content':'添写单据文件xml的加密串，加密过程看文档。XmlUtil类的createFileZipContent方法生成',
	'upload_file_name':'单据文件00001.xml',
	'client_type':'2',
	'from_address':'发货地址XXX',
	'to_address':'收货地址XXX',
	'from_bill_code':'123456',
	'order_code':'123456',
	'from_person':'张某',
	'to_person':'李某',
	'dis_ref_ent_id':'5069452c34b94a778abaa26c2b40b305',
	'dis_ent_id':'5069452c34b94a778abaa26c2b40b305',
	'qu_receivable':'10',
	'xt_is_check':'未验证通过原因',
	'xt_check_code':'0',
	'xt_check_code_desc':'未通过原因描述',
	'drug_list_json':'{"codeCount":100,"commDrugId":"testCommDrugId0","exprieDate":1571131734945,"physicInfo":"test0","pkgSpec":"test0","prepnCount":10,"produceBatchNo":"test0","produceDate":1571131734945},{"codeCount":100,"commDrugId":"testCommDrugId1","exprieDate":1571131734945,"physicInfo":"test1","pkgSpec":"test1","prepnCount":10,"produceBatchNo":"test1","produceDate":1571131734945}',
	'ass_ref_ent_id':'5069452c34b94a778abaa26c2b40b305',
	'ass_ent_id':'5069452c34b94a778abaa26c2b40b305',
	'ignore_check':'1'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_alihealth_drug_msc_uploadcircubill_response>
    <model>SUCCESS</model>
    <msg_code>SUCCESS</msg_code>
    <msg_info>调 用成功</msg_info>
    <response_success>true</response_success>
</alibaba_alihealth_drug_msc_uploadcircubill_response>

{
    "alibaba_alihealth_drug_msc_uploadcircubill_response":{
        "model":"SUCCESS",
        "msg_code":"SUCCESS",
        "msg_info":"调 用成功",
        "response_success":true
    }
}

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.msc.uploadcircubill (批发企业上传入出库单据接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ