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

alibaba.alihealth.drug.scc.uploadsccbillinfo (上传协同单据)

上传协同单据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ref_ent_id String 必须 cb14553ed7654ff586b87b637ba23e2c 单据所有者
license_token String 必须 license_token 用于身份校验,由getlicense获得
bill_code String 必须 0003A 单据编号,业务唯一主键,不允许修改
bill_type Number 必须 201 单据类型【102代表采购入库,201代表销售出库,其它单据类型详见文档】
version Number 必须 1 版本号
bill_time Date 必须 2025-05-01 00:09:08 单据时间
from_ref_ent_id String 必须 cb14553ed7654ff586b87b637ba23e2c 发货企业RefEntId
to_ref_ent_id String 必须 62d67415e4b05691cc769cb4 收货企业refEntId
from_par_id String 可选 0003 发货货主单位自定义编码
from_par_name String 可选 北京测试 发货货主单位自定义名称
from_assed_ref_ent_id String 可选 62d67415e4b05691cc769cb4 受发货方委托的物流企业的ref_ent_id
from_assed_par_id String 可选 002 受发货方委托的物流企业的自定义编码
from_assed_par_name 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
    • 包装大小(件装量)
    from_warehouse_no String 可选 001A 发货方仓库编号
    to_assed_ref_ent_id String 可选 320000000000127970 受收货方委托的物流企业的ref_ent_id
    from_warehouse_name String 可选 北京仓 发货方仓库名称
    original_bill_code String 可选 003 原指令单据号,用于受委托企业上传单据绑定指令单据
    from_business_depart String 可选 销售部 发货方业务部门
    to_person String 可选 张三 收货人
    encry_type String 可选 0 加密方式
    to_par_name String 可选 北京测试 收货企业自定义名称
    to_assed_par_name String 可选 上海测试 受收货方委托的物流企业的自定义名称
    from_warehouse_address String 可选 北京大兴 发货方仓库地址
    from_bill_code String 可选 00004B 发货单编号
    to_warehouse_name String 可选 辽宁2仓 收货方仓库名称
    to_par_id String 可选 0009N 收货货主单位自定义编码
    to_warehouse_no String 可选 0009D 收货方仓库编号
    to_assed_par_id String 可选 0008D 受收货方委托的物流企业的自定义编码
    to_tel String 可选 15809090909 收货方电话
    order_code String 可选 hh887 订货单编号
    from_business_person String 可选 张三 发货方业务人员
    to_warehouse_address String 可选 武汉1仓 收货方仓库地址
    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 String 无需操作 后续操作描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAlihealthDrugSccUploadsccbillinfoRequest req = new AlibabaAlihealthDrugSccUploadsccbillinfoRequest();
    req.setRefEntId("cb14553ed7654ff586b87b637ba23e2c");
    req.setLicenseToken("license_token");
    req.setBillCode("0003A");
    req.setBillType(201L);
    req.setVersion(1L);
    req.setBillTime(StringUtils.parseDateTime("2025-05-01 00:09:08"));
    req.setFromRefEntId("cb14553ed7654ff586b87b637ba23e2c");
    req.setToRefEntId("62d67415e4b05691cc769cb4");
    req.setFromParId("0003");
    req.setFromParName("北京测试");
    req.setFromAssedRefEntId("62d67415e4b05691cc769cb4");
    req.setFromAssedParId("002");
    req.setFromAssedParName("辽宁测试物流");
    List<AlibabaAlihealthDrugSccUploadsccbillinfoRequest.UploadBillDetailRequestDTO> list2 = new ArrayList<AlibabaAlihealthDrugSccUploadsccbillinfoRequest.UploadBillDetailRequestDTO>();
    AlibabaAlihealthDrugSccUploadsccbillinfoRequest.UploadBillDetailRequestDTO obj3 = new AlibabaAlihealthDrugSccUploadsccbillinfoRequest.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.setFromWarehouseNo("001A");
    req.setToAssedRefEntId("320000000000127970");
    req.setFromWarehouseName("北京仓");
    req.setOriginalBillCode("003");
    req.setFromBusinessDepart("销售部");
    req.setToPerson("张三");
    req.setEncryType("0");
    req.setToParName("北京测试");
    req.setToAssedParName("上海测试");
    req.setFromWarehouseAddress("北京大兴");
    req.setFromBillCode("00004B");
    req.setToWarehouseName("辽宁2仓");
    req.setToParId("0009N");
    req.setToWarehouseNo("0009D");
    req.setToAssedParId("0008D");
    req.setToTel("15809090909");
    req.setOrderCode("hh887");
    req.setFromBusinessPerson("张三");
    req.setToWarehouseAddress("武汉1仓");
    req.setOperIcCode("210000234");
    req.setOperIcName("张三");
    req.setRemarks("备注123");
    AlibabaAlihealthDrugSccUploadsccbillinfoResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_alihealth_drug_scc_uploadsccbillinfo_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>无需操作</operation>
    </alibaba_alihealth_drug_scc_uploadsccbillinfo_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

    返回
    顶部