文档中心 > 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
  • 追溯码【多个码时用逗号拼接的字符串。要求数量在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 可选 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);
    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("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");
    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>
    </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

    FAQ

    返回
    顶部