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

alibaba.alihealth.drug.scc.uploadsccretailbillinfo (供应链协同零售单据上传)

上传协同零售单据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
version Number 必须 1 版本号
bill_type Number 必须 321 单据类型【321代表使用出库,116消费者退货入库】
medic_doctor String 可选 李四 处方医师
ref_ent_id String 必须 cb14553ed7654ff586b87b637ba23e2c 单据所有者
license_token String 必须 license_token 用于身份校验,由getlicense获得
user_agent String 可选 代理领药人 代理领药人
upload_bill_detail_request_d_t_o_list UploadBillDetailRequestDTO [] 必须
  • 最大列表长度:30
  • 明细数据
    • └ bill_detail_code
    • String
    • 必须
    • 002a
    • 单据明细编码,一个单据内唯一
    • └ up_bill_detail_code
    • String
    • 可选
    • 001
    • 上游单据明细编码
    • └ product_no
    • String
    • 可选
    • 000012
    • 产品编码
    • └ product_name
    • String
    • 可选
    • 感冒通
    • 产品名称
    • └ produce_batch_no
    • String
    • 可选
    • 123445P
    • 批次号
    • └ produce_date
    • Date
    • 可选
    • 2024-01-01 12:00:30
    • 生产日期
    • └ exprie_date
    • String
    • 可选
    • 20280331
    • 有效期至
    • └ exprie_month_flag
    • String
    • 可选
    • 1
    • 有效期到月标记 0不到月 1到月
    • └ produce_ent_name
    • String
    • 可选
    • 北京测试生产企业
    • 产品生产厂家
    • └ mah_ent_name
    • String
    • 可选
    • 北京测试生产企业
    • 上市许可持有人名称
    • └ pkg_spec
    • String
    • 可选
    • 5支每盒
    • 包装规格
    • └ prod_code
    • String
    • 可选
    • 9888
    • 产品条码,产品的69码
    • └ yb_drug_code
    • String
    • 可选
    • 972463451
    • 医保编码
    • └ sale_unit
    • String
    • 可选
    • 销售单位
    • └ sale_count
    • Number
    • 可选
    • 2000
    • 销售数量
    • └ unit_price
    • String
    • 可选
    • 23.4
    • 单价
    • └ all_price
    • String
    • 可选
    • 460030.08
    • 总价金额
    • └ invoice_no
    • String
    • 可选
    • 835430
    • 发票号
    • └ invoice_all_price
    • String
    • 可选
    • 460030.09
    • 发票号的总金额
    • └ codes
    • String
    • 可选
    • 001,86092470000000045784,86092470000000045783
    • 包含的追溯码,英文逗号隔开
    • └ up_bill_code
    • String
    • 可选
    • 123A
    • 上游单据编码
    • └ trans_flag
    • String
    • 可选
    • 1
    • 是否根据码生成追溯系统单据 0或者空:否 1:是
    • └ code_pkg_ratio
    • Number
    • 可选
    • 10
    • 包装大小(件装量)
    bill_code String 必须 001A 单据编号,业务唯一主键,不允许修改
    bill_time Date 必须 2025-05-01 00:09:08 单据时间
    customer_id_type String 可选 5 购买人证件类型【1身份证2护照3 军官证4 医保卡5接种卡6学生证9其它】
    customer_id String 可选 60123456789 购买人证件编号
    user_tel String 可选 15800001111 用药人电话
    network_bill_flag String 可选 0 互联标识 1是 0否
    medic_dispenser String 可选 王五 发药人
    user_name String 可选 刘巴 患者(姓名、院内患者ID均可)
    oper_ic_code String 必须 210000234 单据提交者(调用接口时的appkey编号)
    oper_ic_name String 必须 张三 单据提交者姓名(出入库单上传人的名子)
    remarks String 可选 备注123 备注

    响应参数

    名称 类型 示例值 描述
    response_success Boolean teue 是否成功
    model String 上传成功 返回结果
    msg_info String SUCCESS 返回编码示描述
    msg_code String SUCCESS 返回编码
    sub_msg_code String SUCCESS 返回子编码
    operation_info_map OperationInfoMap {"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);
    AlibabaAlihealthDrugSccUploadsccretailbillinfoRequest req = new AlibabaAlihealthDrugSccUploadsccretailbillinfoRequest();
    req.setVersion(1L);
    req.setBillType(321L);
    req.setMedicDoctor("李四");
    req.setRefEntId("cb14553ed7654ff586b87b637ba23e2c");
    req.setLicenseToken("license_token");
    req.setUserAgent("代理领药人");
    List<AlibabaAlihealthDrugSccUploadsccretailbillinfoRequest.UploadBillDetailRequestDTO> list2 = new ArrayList<AlibabaAlihealthDrugSccUploadsccretailbillinfoRequest.UploadBillDetailRequestDTO>();
    AlibabaAlihealthDrugSccUploadsccretailbillinfoRequest.UploadBillDetailRequestDTO obj3 = new AlibabaAlihealthDrugSccUploadsccretailbillinfoRequest.UploadBillDetailRequestDTO();
    list2.add(obj3);
    obj3.setBillDetailCode("002a");
    obj3.setUpBillDetailCode("001");
    obj3.setProductNo("000012");
    obj3.setProductName("感冒通");
    obj3.setProduceBatchNo("123445P");
    obj3.setProduceDate(StringUtils.parseDateTime("2024-01-01 12:00:30"));
    obj3.setExprieDate("20280331");
    obj3.setExprieMonthFlag("1");
    obj3.setProduceEntName("北京测试生产企业");
    obj3.setMahEntName("北京测试生产企业");
    obj3.setPkgSpec("5支每盒");
    obj3.setProdCode("9888");
    obj3.setYbDrugCode("972463451");
    obj3.setSaleUnit("盒");
    obj3.setSaleCount(2000L);
    obj3.setUnitPrice("23.4");
    obj3.setAllPrice("460030.08");
    obj3.setInvoiceNo("835430");
    obj3.setInvoiceAllPrice("460030.09");
    obj3.setCodes("001,86092470000000045784,86092470000000045783");
    obj3.setUpBillCode("123A");
    obj3.setTransFlag("1");
    obj3.setCodePkgRatio(10L);
    req.setUploadBillDetailRequestDTOList(list2);
    req.setBillCode("001A");
    req.setBillTime(StringUtils.parseDateTime("2025-05-01 00:09:08"));
    req.setCustomerIdType("5");
    req.setCustomerId("60123456789");
    req.setUserTel("15800001111");
    req.setNetworkBillFlag("0");
    req.setMedicDispenser("王五");
    req.setUserName("刘巴");
    req.setOperIcCode("210000234");
    req.setOperIcName("张三");
    req.setRemarks("备注123");
    AlibabaAlihealthDrugSccUploadsccretailbillinfoResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_alihealth_drug_scc_uploadsccretailbillinfo_response>
        <response_success>teue</response_success>
        <model>上传成功</model>
        <msg_info>SUCCESS</msg_info>
        <msg_code>SUCCESS</msg_code>
        <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_scc_uploadsccretailbillinfo_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

    返回
    顶部