文档中心 > API类目 > 阿里健康追溯码

alibaba.alihealth.drugtrace.top.yljg.uploadinoutbill (出入库单据上传)

医疗机构上传与药品供应商的单据上传接口，本接口不包括医院向患者发药、患者退药的单据上传不包括对个人的零售出库，疫苗接种，领药出库。

公共参数

请求地址：

环境	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	必须	BC001_11235		单据编号（唯一）
bill_time	Date	必须	2024-02-02 02:21:21		单据时间（一般为药品入出库时间）
bill_type	Number	必须	102		单据类型：102代表采购入库、202代表退货出库、205代表销毁出库
physic_type	Number	必须	3		药品类型[2,特药，3,普药]【可以随便填写，单据上传后会以实际为准】
ref_user_id	String	必须	320000000000127971		上传单据的医疗机构在码上放心平台的ref_ent_id，可通过“通过企业名得到唯一标识”接口获取
agent_ref_user_id	String	可选	320000000000127971		代理企业REF标识
from_user_id	String	必须	5069452c34b94a778abaa26c2b40b305		发货企业ent_id，可通过“通过企业名得到唯一标识”接口获取；（102采购入库填药品供应商id、202退货出库填医院id、205销毁出库填医院id）
to_user_id	String	必须	5069452c34b94a778abaa26c2b40b305		收货企业ent_id，可通过“通过企业名得到唯一标识”接口获取；（102采购入库填医院id、202退货出库填药品供应商id、205销毁出库填医院id）
dest_user_id	String	可选	5069452c34b94a778abaa26c2b40b305		直调企业标识
oper_ic_code	String	可选	210000234		单据提交者(appkey编号、可为空)
oper_ic_name	String	可选	张三		单据提交者姓名（可为空）
warehouse_id	String	可选	W001		仓号
drug_id	String	可选	D001		药品ID[企业自已系统的药品ID]
trace_codes	String []	必须	81012350000000157474	最大列表长度：3500	追溯码【多个码时用逗号拼接的字符串。要求数量在3500个码以下，但一般不要传这么多，如果网络不好很容易传输一半报错】注意：在同一张单据里，不能有重复的码；在同一张单据中不能同时上传有关联关系的大、小码
client_type	String	必须	2		客户端类型[必须填2]
return_reason_code	String	可选	1		已废弃，无需填写
return_reason_des	String	可选	退货原因描述		已废弃，无需填写
cancel_reason_code	String	可选	1		已废弃，无需填写
cancel_reason_des	String	可选	注销原因描述		已废弃，无需填写
executer_name	String	可选	执行人		已废弃，无需填写
executer_code	String	可选	11034564321		已废弃，无需填写
superviser_name	String	可选	监督人		已废弃，无需填写
superviser_code	String	可选	11276789342		已废弃，无需填写
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		（协同平台数据合规）药品配送企业【添写ref_ent_id】
dis_ent_id	String	可选	5069452c34b94a778abaa26c2b40b305		（协同平台数据合规）药品配送企业entId【添写ent_id】
qu_receivable	Number	可选	10		（协同平台数据合规）应收货总数量（可为空）
xt_is_check	String	可选	0		（协同平台数据合规）是否验证，0：未通过验证，1：已验证
xt_check_code	String	可选	未验证通过原因		（协同平台数据合规）未验证通过原因【验证未通过时填写】
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[可不填写]
ass_ref_ent_id	String	可选	5069452c34b94a778abaa26c2b40b305		（协同平台数据合规）单据委托企业refEntId【疫苗药品出库单填写】
ass_ent_id	String	可选	5069452c34b94a778abaa26c2b40b305		（协同平台数据合规）单据委托企业entId【疫苗药品出库单填写】

响应参数

名称	类型	示例值	描述
model	String	00f98eb3353a4e2b947a6aafcc46ef79	返回值
msg_code	String	SUCCESS	返回编码(BILL_DECODE_ERROR 单据转码失败 BILL_FILE_NAME_DUPLICATE_UPLOAD 文件名重复)
msg_info	String	调用成功	返回信息
response_success	Boolean	true	是否成功(true 成功 false 失败)

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthDrugtraceTopYljgUploadinoutbillRequest req = new AlibabaAlihealthDrugtraceTopYljgUploadinoutbillRequest();
req.setBillCode("BC001_11235");
req.setBillTime(StringUtils.parseDateTime("2024-02-02 02:21:21"));
req.setBillType(102L);
req.setPhysicType(3L);
req.setRefUserId("320000000000127971");
req.setAgentRefUserId("320000000000127971");
req.setFromUserId("5069452c34b94a778abaa26c2b40b305");
req.setToUserId("5069452c34b94a778abaa26c2b40b305");
req.setDestUserId("5069452c34b94a778abaa26c2b40b305");
req.setOperIcCode("210000234");
req.setOperIcName("张三");
req.setWarehouseId("W001");
req.setDrugId("D001");
req.setTraceCodes("81012350000000157474");
req.setClientType("2");
req.setReturnReasonCode("1");
req.setReturnReasonDes("退货原因描述");
req.setCancelReasonCode("1");
req.setCancelReasonDes("注销原因描述");
req.setExecuterName("执行人");
req.setExecuterCode("11034564321");
req.setSuperviserName("监督人");
req.setSuperviserCode("11276789342");
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("0");
req.setXtCheckCode("未验证通过原因");
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");
AlibabaAlihealthDrugtraceTopYljgUploadinoutbillResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAlihealthDrugtraceTopYljgUploadinoutbillRequest req = new AlibabaAlihealthDrugtraceTopYljgUploadinoutbillRequest();
req.BillCode = "BC001_11235";
req.BillTime = DateTime.Parse("2024-02-02 02:21:21");
req.BillType = 102L;
req.PhysicType = 3L;
req.RefUserId = "320000000000127971";
req.AgentRefUserId = "320000000000127971";
req.FromUserId = "5069452c34b94a778abaa26c2b40b305";
req.ToUserId = "5069452c34b94a778abaa26c2b40b305";
req.DestUserId = "5069452c34b94a778abaa26c2b40b305";
req.OperIcCode = "210000234";
req.OperIcName = "张三";
req.WarehouseId = "W001";
req.DrugId = "D001";
req.TraceCodes = "81012350000000157474";
req.ClientType = "2";
req.ReturnReasonCode = "1";
req.ReturnReasonDes = "退货原因描述";
req.CancelReasonCode = "1";
req.CancelReasonDes = "注销原因描述";
req.ExecuterName = "执行人";
req.ExecuterCode = "11034564321";
req.SuperviserName = "监督人";
req.SuperviserCode = "11276789342";
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 = "0";
req.XtCheckCode = "未验证通过原因";
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";
AlibabaAlihealthDrugtraceTopYljgUploadinoutbillResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

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.drugtrace.top.yljg.uploadinoutbill' \
-d 'partner_id=apidoc' \
-d 'sign=AFECA89D52C9D594B7296DFD881068E0' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-11+19%3A24%3A53' \
-d 'v=2.0' \
-d 'agent_ref_user_id=320000000000127971' \
-d 'ass_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'ass_ref_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'bill_code=BC001_11235' \
-d 'bill_time=2024-02-02+02%3A21%3A21' \
-d 'bill_type=102' \
-d 'cancel_reason_code=1' \
-d 'cancel_reason_des=%E6%B3%A8%E9%94%80%E5%8E%9F%E5%9B%A0%E6%8F%8F%E8%BF%B0' \
-d 'client_type=2' \
-d 'dest_user_id=5069452c34b94a778abaa26c2b40b305' \
-d 'dis_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'dis_ref_ent_id=5069452c34b94a778abaa26c2b40b305' \
-d 'drug_id=D001' \
-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 'executer_code=11034564321' \
-d 'executer_name=%E6%89%A7%E8%A1%8C%E4%BA%BA' \
-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=5069452c34b94a778abaa26c2b40b305' \
-d 'oper_ic_code=210000234' \
-d 'oper_ic_name=%E5%BC%A0%E4%B8%89' \
-d 'order_code=123456' \
-d 'physic_type=3' \
-d 'qu_receivable=10' \
-d 'ref_user_id=320000000000127971' \
-d 'return_reason_code=1' \
-d 'return_reason_des=%E9%80%80%E8%B4%A7%E5%8E%9F%E5%9B%A0%E6%8F%8F%E8%BF%B0' \
-d 'superviser_code=11276789342' \
-d 'superviser_name=%E7%9B%91%E7%9D%A3%E4%BA%BA' \
-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=5069452c34b94a778abaa26c2b40b305' \
-d 'trace_codes=81012350000000157474' \
-d 'warehouse_id=W001' \
-d 'xt_check_code=%E6%9C%AA%E9%AA%8C%E8%AF%81%E9%80%9A%E8%BF%87%E5%8E%9F%E5%9B%A0' \
-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=0'

# -*- coding: utf-8 -*-
import top.api
 
req=top.api.AlibabaAlihealthDrugtraceTopYljgUploadinoutbillRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))
 
req.bill_code="BC001_11235"
req.bill_time="2024-02-02 02:21:21"
req.bill_type=102
req.physic_type=3
req.ref_user_id="320000000000127971"
req.agent_ref_user_id="320000000000127971"
req.from_user_id="5069452c34b94a778abaa26c2b40b305"
req.to_user_id="5069452c34b94a778abaa26c2b40b305"
req.dest_user_id="5069452c34b94a778abaa26c2b40b305"
req.oper_ic_code="210000234"
req.oper_ic_name="张三"
req.warehouse_id="W001"
req.drug_id="D001"
req.trace_codes="81012350000000157474"
req.client_type="2"
req.return_reason_code="1"
req.return_reason_des="退货原因描述"
req.cancel_reason_code="1"
req.cancel_reason_des="注销原因描述"
req.executer_name="执行人"
req.executer_code="11034564321"
req.superviser_name="监督人"
req.superviser_code="11276789342"
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="0"
req.xt_check_code="未验证通过原因"
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"
try:
    resp= req.getResponse()
    print(resp)
except Exception,e:
    print(e)

响应示例

XML示例
JSON示例

<alibaba_alihealth_drugtrace_top_yljg_uploadinoutbill_response>
    <model>00f98eb3353a4e2b947a6aafcc46ef79</model>
    <msg_code>SUCCESS</msg_code>
    <msg_info>调用成功</msg_info>
    <response_success>true</response_success>
</alibaba_alihealth_drugtrace_top_yljg_uploadinoutbill_response>

异常示例

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>

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

阿里健康追溯码

alibaba.alihealth.drugtrace.top.yljg.uploadinoutbill (出入库单据上传)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ