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

阿里健康追溯码

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bill_code String 必须 BC001_11235 单据编号（唯一）
bill_time Date 必须 2018-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个码以下，但一般不要传这么多，如果网络不好很容易传输一半报错】注意：在同一张单据里，不能有重复的码；在同一张单据中不能同时上传有关联关系的大、小码
client_type String 必须 2 客户端类型[必须填2]
return_reason_code String 可选 1 退货原因代码[退货入出库时填写]（1:破损 2:召回 3:滞销 4:过期失效 5:近效期 6:其他）
return_reason_des String 可选 退货原因描述 退货原因描述[退货入出库时填写]
cancel_reason_code String 可选 1 注销原因代码【销毁出库时填写】（1:破损 2:霉变 3:过期失效 4:其他）
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 可选 123 （协同平台数据合规）发货单编号（可为空）
order_code String 可选 123 （协同平台数据合规）订货单编号（可为空）
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【疫苗药品出库单填写】
ignore_part_success_flag String 可选 0 码解析策略,1代表整单解析成功(任一码解析失败，上传时整单返回错误),传其他值或者不传代表部分解析成功(跳过无法解析的码，其余正常处理并上传)

响应参数

名称 类型 示例值 描述
model String 00f98eb3353a4e2b947a6aafcc46ef79 返回值
msg_code String SUCCESS 返回编码(BILL_DECODE_ERROR 单据转码失败 BILL_FILE_NAME_DUPLICATE_UPLOAD 文件名重复)
msg_info String 调用成功 返回信息
response_success Boolean true 是否成功(true 成功 false 失败)
sub_msg_code String SUCCESS 结果子编码
operation_info_map OperationInfoMap {"codeCheckErrorInfo":"{\"3\":\"86443150000000180533,86443160000000568910,84312420000002824318\",\"6\":\"84312420000002824318（下级）;86443160000000568910（上级）,86443160000000568910（下级）;86443150000000180533（上级）\"}"} 错误信息明细,便于后续操作
  • └ code_check_error_info
  • String
  • {"3":"86443150000000180533,86443160000000568910,84312420000002824318","6":"84312420000002824318（下级）;86443160000000568910（上级）,86443160000000568910（下级）;86443150000000180533（上级）"}
  • json,key是错误类型编码,value是具体得信息,详细参考文档

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthDrugtraceTopZdsmUploadinoutbillRequest req = new AlibabaAlihealthDrugtraceTopZdsmUploadinoutbillRequest();
req.setBillCode("BC001_11235");
req.setBillTime(StringUtils.parseDateTime("2018-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("123");
req.setOrderCode("123");
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");
req.setIgnorePartSuccessFlag("0");
AlibabaAlihealthDrugtraceTopZdsmUploadinoutbillResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihealth_drugtrace_top_zdsm_uploadinoutbill_response>
    <model>00f98eb3353a4e2b947a6aafcc46ef79</model>
    <msg_code>SUCCESS</msg_code>
    <msg_info>调用成功</msg_info>
    <response_success>true</response_success>
    <sub_msg_code>SUCCESS</sub_msg_code>
    <operation_info_map>
        <code_check_error_info>{&quot;3&quot;:&quot;86443150000000180533,86443160000000568910,84312420000002824318&quot;,&quot;6&quot;:&quot;84312420000002824318（下级）;86443160000000568910（上级）,86443160000000568910（下级）;86443150000000180533（上级）&quot;}</code_check_error_info>
    </operation_info_map>
</alibaba_alihealth_drugtrace_top_zdsm_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

我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号