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

alibaba.alihealth.drug.kyt.specia.vaccin.uploadinoutbill (疫苗企业出入库上传)

零售企业上传出入库信息,包括采购入库(102),退货入库(103),供应入库(107),退货出库(202),销毁出库(205),抽检出库(206), 供应出库(209), 不包括对个人的零售出库,疫苗接种,领药出库。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bill_code String 必须 BC001_11235 单据编码
bill_time Date 必须 2022-03-15 04:31:15 单据时间
bill_type Number 必须 102 单据类型【102代表采购入库】
physic_type Number 必须 3 药品类型【3普药2特药】
ref_user_id String 必须 320000000000127971 上传企业的单位编码
agent_ref_user_id String 可选 320000000000127971 代理企业REF标识
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
  • 最大列表长度:800
  • 追溯码[多个时用逗号分开]
    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
    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);
    AlibabaAlihealthDrugKytSpeciaVaccinUploadinoutbillRequest req = new AlibabaAlihealthDrugKytSpeciaVaccinUploadinoutbillRequest();
    req.setBillCode("BC001_11235");
    req.setBillTime(StringUtils.parseDateTime("2022-03-15 04:31:15"));
    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");
    AlibabaAlihealthDrugKytSpeciaVaccinUploadinoutbillResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

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

    返回
    顶部