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

alibaba.alihealth.drug.scc.bill.detail.codes (协同单据追溯码明细查询)

协同单据追溯码明细查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ref_ent_id String 必须 12345 refEntId
license_token String 必须 1234566 获取licenseToken,通过alibaba.alihealth.drug.scc.getlicense
bill_code String 必须 单据号 单据号
page Number 必须 1 页数
page_size Number 必须 10 每页条数
upload_ref_user_id String 必须 单据上传ref 单据上传ref
bill_detail_code String 可选 明细单号 明细单号

响应参数

名称 类型 示例值 描述
response_success Boolean true 返回成功失败
model PageInfoDto 返回对象
  • result_list
  • CodeInfoShowDTO []
  • list列表
  • └ code
  • String
  • 815555
  • 追溯码
  • └ bill_code
  • String
  • 单据号
  • 单据号
  • └ bill_detail_code
  • String
  • 单据明细编号
  • 单据明细编号
  • └ exception_flags
  • String
  • 1,2
  • 异常标记,多个异常直接用英文逗号分割.:1:存在未激;活的码;2:存在未通过码制校验的码;3:存在重复的码;4:存在注销的码;5:存在注销的码;6:存在有上下级关联的码;7:单据明细中的【批号/生产日期/有效期】与扫码解析结果不符
  • └ exception_message
  • String
  • 正常
  • 具体异常原因:1:存在未激;活的码;2:存在未通过码制校验的码;3:存在重复的码;4:存在注销的码;5:存在注销的码;6:存在有上下级关联的码;7:单据明细中的【批号/生产日期/有效期】与扫码解析结果不符
  • └ drug_info
  • String
  • 药品信息
  • 药品信息
  • └ mah_name
  • String
  • 药品的mah
  • 药品的mah
  • └ pkg_spec
  • String
  • 包装规格
  • └ produce_name
  • String
  • 生产厂商
  • 生产厂商
  • └ drug_ent_base_info_id
  • String
  • 123
  • 药品id
  • └ trans_flag
  • String
  • 1
  • 是否需要生成追溯单;1需要
  • └ trace_process_flag
  • String
  • 5
  • 生成追溯单是否成功;5:成功;4:失败
  • └ approval_licence_no
  • String
  • 国药准字
  • 批准文号
  • batch_no_inner_dto_list
  • BatchNoDTO []
  • 码的批次信息
  • └ exprie_date
  • String
  • 20250731
  • 有效期至
  • └ min_code_count
  • Number
  • 1
  • 最小码数量
  • └ pkg_level
  • Number
  • 1
  • 码包装层级,1代表最小包装。如:申请的包装比例是1:5:10, 对应的包装等级就是 3、2、1,代表大包装、中包装、小包装
  • └ produce_batch_no
  • String
  • 产品批号
  • 产品批号
  • └ produce_date
  • Date
  • 2025-07-01 00:00:00
  • 生产日期
  • └ pkg_ratio
  • String
  • 包装比例
  • 包装比例
msg_info String 处理成功 返回成功失败
msg_code String SUCCESS 返回成功失败
sub_msg_code String SUCCESS 返回子编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthDrugSccBillDetailCodesRequest req = new AlibabaAlihealthDrugSccBillDetailCodesRequest();
req.setRefEntId("12345");
req.setLicenseToken("1234566");
req.setBillCode("单据号");
req.setPage(1L);
req.setPageSize(10L);
req.setUploadRefUserId("单据上传ref");
req.setBillDetailCode("明细单号");
AlibabaAlihealthDrugSccBillDetailCodesResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihealth_drug_scc_bill_detail_codes_response>
    <response_success>true</response_success>
    <model>
        <result_list>
            <code_info_show_d_t_o>
                <code>815555</code>
                <bill_code>单据号</bill_code>
                <bill_detail_code>单据明细编号</bill_detail_code>
                <exception_flags>1,2</exception_flags>
                <exception_message>正常</exception_message>
                <drug_info>药品信息</drug_info>
                <mah_name>药品的mah</mah_name>
                <pkg_spec>盒</pkg_spec>
                <produce_name>生产厂商</produce_name>
                <drug_ent_base_info_id>123</drug_ent_base_info_id>
                <trans_flag>1</trans_flag>
                <trace_process_flag>5</trace_process_flag>
                <approval_licence_no>国药准字</approval_licence_no>
                <batch_no_inner_dto_list>
                    <batch_no_d_t_o>
                        <exprie_date>20250731</exprie_date>
                        <min_code_count>1</min_code_count>
                        <pkg_level>1</pkg_level>
                        <produce_batch_no>产品批号</produce_batch_no>
                        <produce_date>2025-07-01 00:00:00</produce_date>
                        <pkg_ratio>包装比例</pkg_ratio>
                    </batch_no_d_t_o>
                </batch_no_inner_dto_list>
            </code_info_show_d_t_o>
        </result_list>
    </model>
    <msg_info>处理成功</msg_info>
    <msg_code>SUCCESS</msg_code>
    <sub_msg_code>SUCCESS</sub_msg_code>
</alibaba_alihealth_drug_scc_bill_detail_codes_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

返回
顶部