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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bill_code String 必须 BC001_11235 单据编码
bill_time Date 必须 2018-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标识
from_user_id String 必须 5069452c34b94a778abaa26c2b40b305 发货企业entId
to_user_id String 必须 5069452c34b94a778abaa26c2b40b305 收货企业entId【注意:该入参是ent_id,并不是ref_ent_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 追溯码[多个时用逗号分开]
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【疫苗药品出库单填写】
remarks String 可选 备注 备注
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);
AlibabaAlihealthDrugKytDrUploadinoutbillRequest req = new AlibabaAlihealthDrugKytDrUploadinoutbillRequest();
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");
req.setRemarks("备注");
req.setIgnorePartSuccessFlag("0");
AlibabaAlihealthDrugKytDrUploadinoutbillResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihealth_drug_kyt_dr_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_drug_kyt_dr_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

返回
顶部