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

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

零售企业上传出入库信息,包括102, "采购入库";103, "退货入库";104, "调拨入库";107, "供应入库";108, "召回入库";110,"赠品入库";111,"盘盈入库";112,"报废入库";113,"其他入库" 201, "销售出库";202, "退货出库";203, "调拨出库";204, "返工出库";205, "销毁出库";206, "抽检出库";207, "直调出库";209, "供应出库";211, "召回出库";212,"赠品出库";214,"盘亏出库";215,"损坏出库";216,"报废出库";217,"其他出库";237, "直调退货"。 不包括对个人的零售出库,疫苗接种,领药出库。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bill_code String 必须 BC001_11235 单据编码(每个单据号只能上传一次)
bill_time Date 必须 2025-02-02 02:21:21 单据时间(一般为药品入出库时间)
bill_type Number 必须 102 单据类型【102代表采购入库】
physic_type Number 必须 3 药品类型【3普药2特药】可不填
ref_user_id String 必须 320000000000127971 上传单据企业的单位编码【注意:该入参是ref_ent_id,不是ent_id】可通过“通过企业名得到唯一标识”接口获取
agent_ref_user_id String 可选 320000000000127971 代理企业【注意:该入参是ref_ent_id,不是ent_id】,该字段兼容之前接口逻辑,后期将不允许使用,不要填值。
from_user_id String 必须 5069452c34b94a778abaa26c2b40b305 发货企业entId,可通过“通过企业名得到唯一标识”接口获取
to_user_id String 必须 5069452c34b94a778abaa26c2b40b305 收货企业entId,可通过“通过企业名得到唯一标识”接口获取
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 (协同平台数据合规)药品配送企业【出库单,收货方为医疗机构时填写】
    dis_ent_id String 可选 5069452c34b94a778abaa26c2b40b305 (协同平台数据合规)药品配送企业entId【出库单,收货方为医疗机构时填写】
    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:"codeCount": 药品数量 "commDrugId": 国家药品唯一标识 "exprieDate": 生产日期 "physicInfo": 药品信息 "pkgSpec": 包状规格 "prepnCount": 制剂数量 "produceBatchNo":生产批次 "produceDate": 生产日期
    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);
    AlibabaAlihealthDrugtraceTopLsydUploadinoutbillRequest req = new AlibabaAlihealthDrugtraceTopLsydUploadinoutbillRequest();
    req.setBillCode("BC001_11235");
    req.setBillTime(StringUtils.parseDateTime("2025-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");
    AlibabaAlihealthDrugtraceTopLsydUploadinoutbillResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_alihealth_drugtrace_top_lsyd_uploadinoutbill_response>
        <model>00f98eb3353a4e2b947a6aafcc46ef79</model>
        <msg_code>SUCCESS</msg_code>
        <msg_info>调用成功</msg_info>
        <response_success>true</response_success>
    </alibaba_alihealth_drugtrace_top_lsyd_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

    返回
    顶部