程序包 com.infilake.openapi.bidding

类 BiddingApiClient

java.lang.Object
com.infilake.openapi.bidding.ApiClient
com.infilake.openapi.bidding.BiddingApiClient
public class BiddingApiClient extends ApiClient
采购平台Open API客户端 (v1.5.3) 封装了所有采购平台API接口，提供类型安全的方法调用

版本说明:

从本版本开始，采用新的版本号规则：主版本号固定为1，功能迭代体现在次版本号。

旧版本 v4.0.0 对应新版本 v1.4.0

版本变更 (v1.5.2 → v1.5.3):

  • BREAKING CHANGE: 返回类型变更
  • getOrderByClientApplicationNoChecked() 返回类型从 Order 改为 OrderInfoDetailClient
  • getOrderFulfillmentByClientApplicationNoChecked() 返回类型从 OrderFulfillment 改为 OrderFulfillmentDetailClient
  • 新增 OrderInfoDetailClient, OrderFulfillmentDetailClient, OrderItemDetail, OrderFulfillmentItem 模型类

版本变更 (v1.3.0 → v1.4.0，原v3.0.3 → v4.0.0):

  • BREAKING CHANGE: 包名重构
  • 包名从 com.infilake.openapi 更改为 com.infilake.openapi.bidding
  • 所有 import 语句需要更新为新的包名
  • 更清晰的包结构，明确标识为 Bidding SDK
  • 避免与其他 OpenAPI SDK 的包名冲突

版本变更 (v1.2.2 → v1.3.0，原v3.0.2 → v3.0.3):

  • 新增 Builder 模式 - 为所有模型对象提供链式构建方法
  • Category.builder() - 链式构建Category对象
  • Product.builder() - 链式构建Product对象
  • ApplicationItem.builder() - 链式构建ApplicationItem对象
  • PurchaseApplication.builder() - 链式构建PurchaseApplication对象
  • Builder 自动验证必填字段 - build() 时检查必填字段，缺失时抛出 IllegalStateException
  • 更流畅的 API 使用体验 - 支持 .builder().field1(val1).field2(val2).build()

版本变更 (v3.0.1 → v3.0.2):

  • 新增重载方法 - 支持直接传入对象参数，无需手动构造JSON
  • createCategoryChecked(Category) - 使用Category对象创建类别
  • updateCategoryChecked(Category) - 使用Category对象更新类别
  • createProductChecked(Product) - 使用Product对象创建物料
  • updateProductChecked(String, Product) - 使用Product对象更新物料
  • importPurchaseApplicationChecked(PurchaseApplication) - 使用对象导入采购申请
  • updatePurchaseApplicationChecked(String, PurchaseApplication) - 使用对象更新采购申请
  • 新增 JsonUtils.toJsonString() - 对象序列化为JSON

版本变更 (v3.0.0 → v3.0.1):

  • 新增 Profile API - getProfileChecked() 获取用户档案信息
  • 新增订单收货入库 API - createOrderFulfillmentInChecked() 创建收货入库记录
  • 新增商品类别管理 APIs - 4个类别相关方法
  • 新增模型类: Profile, Organization, Purchaser, Category

版本变更 (v2.0.0 → v3.0.0):

  • 所有方法现在返回类型化的对象 (ApiResult<T>) 而不是JSON字符串
  • 提供完整的POJO模型支持
  • 零外部依赖的JSON解析
  • 编译时类型安全

使用示例:

 BiddingApiClient client = new BiddingApiClient(
     "https://api.example.com",
     "your-access-key",
     "your-secret-key"
 );

 // 方式1: 使用JSON字符串
 String json = "{\"categoryName\":\"办公用品\",\"categoryCode\":\"CAT001\"}";
 ApiResult<Boolean> result1 = client.createCategoryChecked(json);

 // 方式2: 使用对象（推荐）
 Category category = new Category();
 category.setCategoryName("办公用品");
 category.setCategoryCode("CAT001");
 ApiResult<Boolean> result2 = client.createCategoryChecked(category);
从以下版本开始:
3.0.2

  • 构造器详细资料

    • BiddingApiClient

      public BiddingApiClient(String baseUrl, String accessKey, String secretKey)
      创建采购平台API客户端
      参数:
      baseUrl - API服务器地址，如 https://api.example.com
      accessKey - 访问密钥标识
      secretKey - 访问密钥密码

  • 方法详细资料

    • getProfileChecked

      public ApiResult<Profile> getProfileChecked() throws BiddingApiException
      获取Profile信息
      返回:
      ApiResult containing Profile object with Organization and Purchaser info
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderPageChecked

      public ApiResult<PageResult<Order>> getOrderPageChecked(Integer pageNo, Integer pageSize, String status, String acceptanceStatus, String issueStatus, String start, String end) throws BiddingApiException
      订单信息分页查询
      参数:
      pageNo - 页码，默认值：1
      pageSize - 每页数量，默认值：10
      status - 订单状态：approved/wait/cancel/supplier_cancel/supplier_apply_cancel
      acceptanceStatus - 验收状态：full_accepted/not_accepted/partial_accepted
      issueStatus - 结算状态：unissued/issued/issuing
      start - 开始时间(格式: yyyy-MM-dd)
      end - 结束时间(格式: yyyy-MM-dd)
      返回:
      ApiResult containing PageResult of Order objects
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderDetailChecked

      public ApiResult<Order> getOrderDetailChecked(String orderNo) throws BiddingApiException
      获取订单详情
      参数:
      orderNo - 订单编号
      返回:
      ApiResult containing Order object
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderFulfillmentChecked

      public ApiResult<OrderFulfillment> getOrderFulfillmentChecked(String fulfillmentNo) throws BiddingApiException
      获取订单履约详情
      参数:
      fulfillmentNo - 履约编号
      返回:
      ApiResult containing OrderFulfillment object
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderExpressChecked

      public ApiResult<OrderExpress> getOrderExpressChecked(String fulfillmentNo) throws BiddingApiException
      获取订单履约物流信息
      参数:
      fulfillmentNo - 履约编号
      返回:
      ApiResult containing OrderExpress object
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderByClientApplicationNoChecked

      public ApiResult<List<OrderInfoDetailClient>> getOrderByClientApplicationNoChecked(String clientApplicationNo) throws BiddingApiException
      根据客户端申请单号查询订单

      v1.5.3更新: 返回类型从 Order 更改为 OrderInfoDetailClient， 以匹配API实际返回的数据结构

      参数:
      clientApplicationNo - 客户端申请单号
      返回:
      ApiResult containing List of OrderInfoDetailClient objects
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderFulfillmentByClientApplicationNoChecked

      public ApiResult<List<OrderFulfillmentDetailClient>> getOrderFulfillmentByClientApplicationNoChecked(String clientApplicationNo) throws BiddingApiException
      根据客户端申请单号查询订单履约单

      v1.5.3更新: 返回类型从 OrderFulfillment 更改为 OrderFulfillmentDetailClient， 以匹配API实际返回的数据结构

      参数:
      clientApplicationNo - 客户端申请单号
      返回:
      ApiResult containing List of OrderFulfillmentDetailClient objects
      抛出:
      BiddingApiException - 如果请求失败

    • createOrderFulfillmentInChecked

      public ApiResult<Boolean> createOrderFulfillmentInChecked(String fulfillmentNo, File[] accompanyPics, File[] extraPics, File[] productPics) throws BiddingApiException
      新增收货入库

      通过 multipart/form-data 上传图片文件完成收货入库操作

      参数:
      fulfillmentNo - 履约编号
      accompanyPics - 平台送货单图片文件数组（可为null或空数组）
      extraPics - 供应商送货单图片文件数组（可为null或空数组）
      productPics - 货物图片文件数组（可为null或空数组）
      返回:
      ApiResult containing Boolean (true if successful)
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderReturnItemPageChecked

      public ApiResult<PageResult<OrderReturnItem>> getOrderReturnItemPageChecked(Integer pageNo, Integer pageSize, String status, String search, String start, String end) throws BiddingApiException
      按条件分页查询退货详情
      参数:
      pageNo - 页码
      pageSize - 每页数量
      status - 退货状态：PENDING_APPROVAL/PENDING_SHIPMENT/PENDING_RECEIPT/REJECTED/CANCELLED/CLOSED
      search - 模糊查询参数
      start - 开始时间(格式: yyyy-MM-dd)
      end - 结束时间(格式: yyyy-MM-dd)
      返回:
      ApiResult containing PageResult of OrderReturnItem objects
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderReturnPageChecked

      @Deprecated public ApiResult<PageResult<OrderReturn>> getOrderReturnPageChecked(Integer pageNo, Integer pageSize, String status, String search, String start, String end) throws BiddingApiException
      已过时。
      请使用 getOrderReturnItemPageChecked(Integer, Integer, String, String, String, String) 替代
      按条件分页查询退货详情 (兼容旧版本)
      参数:
      pageNo - 页码
      pageSize - 每页数量
      status - 退货状态：PENDING_APPROVAL/PENDING_SHIPMENT/PENDING_RECEIPT/REJECTED/CANCELLED/CLOSED
      search - 模糊查询参数
      start - 开始时间(格式: yyyy-MM-dd)
      end - 结束时间(格式: yyyy-MM-dd)
      返回:
      ApiResult containing PageResult of OrderReturn objects
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderReturnItemDetailChecked

      public ApiResult<OrderReturnItem> getOrderReturnItemDetailChecked(String returnNo) throws BiddingApiException
      获取退货详情
      参数:
      returnNo - 退货编号
      返回:
      ApiResult containing OrderReturnItem object
      抛出:
      BiddingApiException - 如果请求失败

    • getOrderReturnDetailChecked

      @Deprecated public ApiResult<OrderReturn> getOrderReturnDetailChecked(String returnNo) throws BiddingApiException
      已过时。
      请使用 getOrderReturnItemDetailChecked(String) 替代
      获取退货详情 (兼容旧版本)
      参数:
      returnNo - 退货编号
      返回:
      ApiResult containing OrderReturn object
      抛出:
      BiddingApiException - 如果请求失败

    • getProjectPageChecked

      public ApiResult<PageResult<Project>> getProjectPageChecked(Integer pageNo, Integer pageSize, String start, String end, String name) throws BiddingApiException
      项目分页查询
      参数:
      pageNo - 页码
      pageSize - 每页数量
      start - 开始时间(格式: yyyy-MM-dd)
      end - 结束时间(格式: yyyy-MM-dd)
      name - 项目名称
      返回:
      ApiResult containing PageResult of Project objects
      抛出:
      BiddingApiException - 如果请求失败

    • getProjectDetailChecked

      public ApiResult<Project> getProjectDetailChecked(Integer projectId) throws BiddingApiException
      查询项目详情
      参数:
      projectId - 项目ID
      返回:
      ApiResult containing Project object
      抛出:
      BiddingApiException - 如果请求失败

    • importPurchaseApplicationChecked

      public ApiResult<PurchaseApplicationImportResult> importPurchaseApplicationChecked(String jsonBody) throws BiddingApiException
      导入采购申请
      参数:
      jsonBody - 采购申请JSON数据
      返回:
      ApiResult with PurchaseApplicationImportResult
      抛出:
      BiddingApiException - 如果请求失败

    • importPurchaseApplicationChecked

      public ApiResult<PurchaseApplicationImportResult> importPurchaseApplicationChecked(PurchaseApplication application) throws BiddingApiException
      导入采购申请（使用对象）
      参数:
      application - 采购申请对象
      返回:
      ApiResult with PurchaseApplicationImportResult
      抛出:
      BiddingApiException - 如果请求失败

    • updatePurchaseApplicationChecked

      public ApiResult<PurchaseApplicationImportResult> updatePurchaseApplicationChecked(String clientApplicationNo, String jsonBody) throws BiddingApiException
      更新导入的采购申请
      参数:
      clientApplicationNo - 客户端申请编号
      jsonBody - 采购申请JSON数据
      返回:
      ApiResult with PurchaseApplicationImportResult
      抛出:
      BiddingApiException - 如果请求失败

    • updatePurchaseApplicationChecked

      public ApiResult<PurchaseApplicationImportResult> updatePurchaseApplicationChecked(String clientApplicationNo, PurchaseApplication application) throws BiddingApiException
      更新导入的采购申请（使用对象）
      参数:
      clientApplicationNo - 客户端申请编号
      application - 采购申请对象
      返回:
      ApiResult with PurchaseApplicationImportResult
      抛出:
      BiddingApiException - 如果请求失败

    • createProductChecked

      public ApiResult<Boolean> createProductChecked(String jsonBody) throws BiddingApiException
      创建物料信息
      参数:
      jsonBody - 物料信息JSON数据
      返回:
      ApiResult containing Boolean
      抛出:
      BiddingApiException - 如果请求失败

    • createProductChecked

      public ApiResult<Boolean> createProductChecked(Product product) throws BiddingApiException
      创建物料信息（使用对象）
      参数:
      product - 物料对象
      返回:
      ApiResult containing Boolean
      抛出:
      BiddingApiException - 如果请求失败

    • updateProductChecked

      public ApiResult<Boolean> updateProductChecked(String productCode, String jsonBody) throws BiddingApiException
      修改物料信息
      参数:
      productCode - 产品编码
      jsonBody - 物料信息JSON数据
      返回:
      ApiResult containing Boolean
      抛出:
      BiddingApiException - 如果请求失败

    • updateProductChecked

      public ApiResult<Boolean> updateProductChecked(String productCode, Product product) throws BiddingApiException
      修改物料信息（使用对象）
      参数:
      productCode - 产品编码
      product - 物料对象
      返回:
      ApiResult containing Boolean
      抛出:
      BiddingApiException - 如果请求失败

    • deleteProductChecked

      public ApiResult<Boolean> deleteProductChecked(String productCode) throws BiddingApiException
      删除商品信息
      参数:
      productCode - 产品编码
      返回:
      ApiResult containing Boolean
      抛出:
      BiddingApiException - 如果请求失败

    • getCategoryPageChecked

      public ApiResult<PageResult<Category>> getCategoryPageChecked(Integer page, Integer size, String name, String code, Boolean status) throws BiddingApiException
      按条件分页查询商品分类
      参数:
      page - 页码
      size - 每页数量
      name - 类别名称（可选，用于模糊搜索）
      code - 类别编码（可选）
      status - 状态（可选）
      返回:
      ApiResult containing PageResult of Category objects
      抛出:
      BiddingApiException - 如果请求失败

    • createCategoryChecked

      public ApiResult<Boolean> createCategoryChecked(String jsonBody) throws BiddingApiException
      新增物料类别
      参数:
      jsonBody - 类别信息JSON数据（包含categoryName, categoryCode, parentId等字段）
      返回:
      ApiResult containing Boolean (true if successful)
      抛出:
      BiddingApiException - 如果请求失败

    • createCategoryChecked

      public ApiResult<Boolean> createCategoryChecked(Category category) throws BiddingApiException
      新增物料类别（使用对象）
      参数:
      category - 类别对象
      返回:
      ApiResult containing Boolean (true if successful)
      抛出:
      BiddingApiException - 如果请求失败

    • updateCategoryChecked

      public ApiResult<Boolean> updateCategoryChecked(String jsonBody) throws BiddingApiException
      更新物料类别
      参数:
      jsonBody - 类别信息JSON数据（必须包含id字段）
      返回:
      ApiResult containing Boolean (true if successful)
      抛出:
      BiddingApiException - 如果请求失败

    • updateCategoryChecked

      public ApiResult<Boolean> updateCategoryChecked(Category category) throws BiddingApiException
      更新物料类别（使用对象）
      参数:
      category - 类别对象（必须包含id字段）
      返回:
      ApiResult containing Boolean (true if successful)
      抛出:
      BiddingApiException - 如果请求失败

    • deleteCategoryChecked

      public ApiResult<Boolean> deleteCategoryChecked(Long id) throws BiddingApiException
      删除物料类别
      参数:
      id - 类别ID
      返回:
      ApiResult containing Boolean (true if successful)
      抛出:
      BiddingApiException - 如果请求失败

    • getSettlementPageChecked

      public ApiResult<PageResult<Settlement>> getSettlementPageChecked(Integer pageNo, Integer pageSize, String status, String invoiceStatus, String paymentStatus) throws BiddingApiException
      分页查询结算单
      参数:
      pageNo - 页码
      pageSize - 每页数量
      status - 结算单状态
      invoiceStatus - 发票状态
      paymentStatus - 支付状态
      返回:
      ApiResult containing PageResult of Settlement objects
      抛出:
      BiddingApiException - 如果请求失败

    • downloadInvoiceChecked

      public ApiResult<String> downloadInvoiceChecked(String settlementNo) throws BiddingApiException
      下载发票
      参数:
      settlementNo - 结算单编号
      返回:
      ApiResult containing download URL as String
      抛出:
      BiddingApiException - 如果请求失败

    • queryInvoiceChecked

      public ApiResult<Invoice> queryInvoiceChecked(String settlementNo) throws BiddingApiException
      查询发票
      参数:
      settlementNo - 结算单编号
      返回:
      ApiResult containing Invoice object
      抛出:
      BiddingApiException - 如果请求失败

    • getWarehousePageChecked

      public ApiResult<PageResult<Warehouse>> getWarehousePageChecked(Integer page, Integer size, String name, Boolean status) throws BiddingApiException
      获取仓库列表
      参数:
      page - 页码
      size - 每页数量
      name - 仓库名称
      status - 状态
      返回:
      ApiResult containing PageResult of Warehouse objects
      抛出:
      BiddingApiException - 如果请求失败

    • getProfile

      public ApiResult<Profile> getProfile()
      获取Profile信息（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      返回:
      ApiResult containing Profile object, 或错误信息

    • getOrderPage

      public ApiResult<PageResult<Order>> getOrderPage(Integer pageNo, Integer pageSize, String status, String acceptanceStatus, String issueStatus, String start, String end)
      订单信息分页查询（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      pageNo - 页码，默认值：1
      pageSize - 每页数量，默认值：10
      status - 订单状态
      acceptanceStatus - 验收状态
      issueStatus - 结算状态
      start - 开始时间(格式: yyyy-MM-dd)
      end - 结束时间(格式: yyyy-MM-dd)
      返回:
      ApiResult containing PageResult of Order objects, 或错误信息

    • getOrderDetail

      public ApiResult<Order> getOrderDetail(String orderNo)
      获取订单详情（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      orderNo - 订单编号
      返回:
      ApiResult containing Order object, 或错误信息

    • getOrderFulfillment

      public ApiResult<OrderFulfillment> getOrderFulfillment(String fulfillmentNo)
      获取订单履约详情（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      fulfillmentNo - 履约编号
      返回:
      ApiResult containing OrderFulfillment object, 或错误信息

    • getOrderExpress

      public ApiResult<OrderExpress> getOrderExpress(String fulfillmentNo)
      获取订单履约物流信息（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      fulfillmentNo - 履约编号
      返回:
      ApiResult containing OrderExpress object, 或错误信息

    • getOrderByClientApplicationNo

      public ApiResult<List<OrderInfoDetailClient>> getOrderByClientApplicationNo(String clientApplicationNo)
      根据客户端申请单号查询订单（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      clientApplicationNo - 客户端申请单号
      返回:
      ApiResult containing List of OrderInfoDetailClient objects, 或错误信息

    • getOrderFulfillmentByClientApplicationNo

      public ApiResult<List<OrderFulfillmentDetailClient>> getOrderFulfillmentByClientApplicationNo(String clientApplicationNo)
      根据客户端申请单号查询订单履约单（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      clientApplicationNo - 客户端申请单号
      返回:
      ApiResult containing List of OrderFulfillmentDetailClient objects, 或错误信息

    • createOrderFulfillmentIn

      public ApiResult<Boolean> createOrderFulfillmentIn(String fulfillmentNo, File[] accompanyPics, File[] extraPics, File[] productPics)
      新增收货入库（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      fulfillmentNo - 履约编号
      accompanyPics - 平台送货单图片文件数组
      extraPics - 供应商送货单图片文件数组
      productPics - 货物图片文件数组
      返回:
      ApiResult containing Boolean, 或错误信息

    • getOrderReturnItemPage

      public ApiResult<PageResult<OrderReturnItem>> getOrderReturnItemPage(Integer pageNo, Integer pageSize, String status, String search, String start, String end)
      按条件分页查询退货详情（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      pageNo - 页码
      pageSize - 每页数量
      status - 退货状态
      search - 模糊查询参数
      start - 开始时间
      end - 结束时间
      返回:
      ApiResult containing PageResult of OrderReturnItem objects, 或错误信息

    • getOrderReturnItemDetail

      public ApiResult<OrderReturnItem> getOrderReturnItemDetail(String returnNo)
      获取退货详情（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      returnNo - 退货编号
      返回:
      ApiResult containing OrderReturnItem object, 或错误信息

    • getProjectPage

      public ApiResult<PageResult<Project>> getProjectPage(Integer pageNo, Integer pageSize, String start, String end, String name)
      项目分页查询（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      pageNo - 页码
      pageSize - 每页数量
      start - 开始时间
      end - 结束时间
      name - 项目名称
      返回:
      ApiResult containing PageResult of Project objects, 或错误信息

    • getProjectDetail

      public ApiResult<Project> getProjectDetail(Integer projectId)
      查询项目详情（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      projectId - 项目ID
      返回:
      ApiResult containing Project object, 或错误信息

    • importPurchaseApplication

      public ApiResult<PurchaseApplicationImportResult> importPurchaseApplication(String jsonBody)
      导入采购申请（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      jsonBody - 采购申请JSON数据
      返回:
      ApiResult with PurchaseApplicationImportResult, 或错误信息

    • importPurchaseApplication

      public ApiResult<PurchaseApplicationImportResult> importPurchaseApplication(PurchaseApplication application)
      导入采购申请（Safe版本，使用对象）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      application - 采购申请对象
      返回:
      ApiResult with PurchaseApplicationImportResult, 或错误信息

    • updatePurchaseApplication

      public ApiResult<PurchaseApplicationImportResult> updatePurchaseApplication(String clientApplicationNo, String jsonBody)
      更新导入的采购申请（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      clientApplicationNo - 客户端申请编号
      jsonBody - 采购申请JSON数据
      返回:
      ApiResult with PurchaseApplicationImportResult, 或错误信息

    • updatePurchaseApplication

      public ApiResult<PurchaseApplicationImportResult> updatePurchaseApplication(String clientApplicationNo, PurchaseApplication application)
      更新导入的采购申请（Safe版本，使用对象）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      clientApplicationNo - 客户端申请编号
      application - 采购申请对象
      返回:
      ApiResult with PurchaseApplicationImportResult, 或错误信息

    • createProduct

      public ApiResult<Boolean> createProduct(String jsonBody)
      创建物料信息（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      jsonBody - 物料信息JSON数据
      返回:
      ApiResult containing Boolean, 或错误信息

    • createProduct

      public ApiResult<Boolean> createProduct(Product product)
      创建物料信息（Safe版本，使用对象）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      product - 物料对象
      返回:
      ApiResult containing Boolean, 或错误信息

    • updateProduct

      public ApiResult<Boolean> updateProduct(String productCode, String jsonBody)
      修改物料信息（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      productCode - 产品编码
      jsonBody - 物料信息JSON数据
      返回:
      ApiResult containing Boolean, 或错误信息

    • updateProduct

      public ApiResult<Boolean> updateProduct(String productCode, Product product)
      修改物料信息（Safe版本，使用对象）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      productCode - 产品编码
      product - 物料对象
      返回:
      ApiResult containing Boolean, 或错误信息

    • deleteProduct

      public ApiResult<Boolean> deleteProduct(String productCode)
      删除商品信息（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      productCode - 产品编码
      返回:
      ApiResult containing Boolean, 或错误信息

    • getCategoryPage

      public ApiResult<PageResult<Category>> getCategoryPage(Integer page, Integer size, String name, String code, Boolean status)
      按条件分页查询商品分类（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      page - 页码
      size - 每页数量
      name - 类别名称
      code - 类别编码
      status - 状态
      返回:
      ApiResult containing PageResult of Category objects, 或错误信息

    • createCategory

      public ApiResult<Boolean> createCategory(String jsonBody)
      新增物料类别（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      jsonBody - 类别信息JSON数据
      返回:
      ApiResult containing Boolean, 或错误信息

    • createCategory

      public ApiResult<Boolean> createCategory(Category category)
      新增物料类别（Safe版本，使用对象）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      category - 类别对象
      返回:
      ApiResult containing Boolean, 或错误信息

    • updateCategory

      public ApiResult<Boolean> updateCategory(String jsonBody)
      更新物料类别（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      jsonBody - 类别信息JSON数据
      返回:
      ApiResult containing Boolean, 或错误信息

    • updateCategory

      public ApiResult<Boolean> updateCategory(Category category)
      更新物料类别（Safe版本，使用对象）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      category - 类别对象
      返回:
      ApiResult containing Boolean, 或错误信息

    • deleteCategory

      public ApiResult<Boolean> deleteCategory(Long id)
      删除物料类别（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      id - 类别ID
      返回:
      ApiResult containing Boolean, 或错误信息

    • getSettlementPage

      public ApiResult<PageResult<Settlement>> getSettlementPage(Integer pageNo, Integer pageSize, String status, String invoiceStatus, String paymentStatus)
      分页查询结算单（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      pageNo - 页码
      pageSize - 每页数量
      status - 结算单状态
      invoiceStatus - 发票状态
      paymentStatus - 支付状态
      返回:
      ApiResult containing PageResult of Settlement objects, 或错误信息

    • downloadInvoice

      public ApiResult<String> downloadInvoice(String settlementNo)
      下载发票（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      settlementNo - 结算单编号
      返回:
      ApiResult containing download URL as String, 或错误信息

    • queryInvoice

      public ApiResult<Invoice> queryInvoice(String settlementNo)
      查询发票（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      settlementNo - 结算单编号
      返回:
      ApiResult containing Invoice object, 或错误信息

    • getWarehousePage

      public ApiResult<PageResult<Warehouse>> getWarehousePage(Integer page, Integer size, String name, Boolean status)
      获取仓库列表（Safe版本）

      不抛出checked异常，错误信息封装在ApiResult中

      参数:
      page - 页码
      size - 每页数量
      name - 仓库名称
      status - 状态
      返回:
      ApiResult containing PageResult of Warehouse objects, 或错误信息