Skip to content

feat(channel): 新增微信小店质检管理(QIC)5个官方接口支持#4039

Open
Copilot wants to merge 2 commits into
developfrom
copilot/feature-add-quality-inspection-module
Open

feat(channel): 新增微信小店质检管理(QIC)5个官方接口支持#4039
Copilot wants to merge 2 commits into
developfrom
copilot/feature-add-quality-inspection-module

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 31, 2026

当前 weixin-java-channel 缺少质检管理能力,无法覆盖珠宝/奢侈品等需送检场景。该 PR 按微信官方 QIC 文档补齐 5 个接口,并将能力接入 WxChannelService 主服务入口。

  • 接口层:新增质检服务抽象与入口接入

    • 新增 WxChannelQicService,提供以下能力:
      • 查询质检仓配置 getInspectConfig()
      • 查询送检配置模板 getSubmitConfig(String orderId) / getSubmitConfig()
      • 打印质检码 printInspectCode(String orderId)
      • 绑定送检信息 submitInspectInfo(SubmitInspectRequest)
      • 自寄快递送检 registerLogistics(RegisterLogisticsRequest)
    • WxChannelService 增加 getQicService(),并在 BaseWxChannelServiceImpl 中完成懒加载注入。
  • 实现层:新增 QIC 服务实现与官方路径常量

    • 新增 WxChannelQicServiceImpl,按官方路径调用:
      • /channels/ec/qic/inspect/config/get
      • /channels/ec/qic/inspect/submitconfig/get
      • /channels/ec/qic/inspect/code/print
      • /channels/ec/qic/inspect/submit
      • /channels/ec/qic/inspect/register_logistics
    • WxChannelApiUrlConstants 中新增 Qic 常量分组,集中维护路径。
  • 数据模型:补齐请求/响应对象并对齐官方字段

    • 新增响应模型:
      • InspectConfigResponse
      • SubmitConfigResponse
      • InspectCodeResponse
    • 新增请求模型:
      • SubmitInspectRequest
      • RegisterLogisticsRequest
    • 字段映射覆盖质检机构、快递产品、保价信息、沉香机构字段、打印模板信息等文档定义项。
  • 测试:新增质检服务单元测试

    • 新增 WxChannelQicServiceImplTest,覆盖 5 个接口的调用入口与核心请求对象构造。

示例(新增服务调用方式):

WxChannelQicService qicService = channelService.getQicService();

// 1) 查询质检仓配置
InspectConfigResponse inspectConfig = qicService.getInspectConfig();

// 2) 打印质检码
InspectCodeResponse codeResponse = qicService.printInspectCode("37423523451235145");

// 3) 绑定送检信息
SubmitInspectRequest req = new SubmitInspectRequest();
req.setOrderId("37423523451235145");
WxChannelBaseResponse submitResp = qicService.submitInspectInfo(req);

Copilot AI linked an issue May 31, 2026 that may be closed by this pull request
Copilot AI changed the title [WIP] Add quality inspection management module support feat(channel): 新增微信小店质检管理(QIC)5个官方接口支持 May 31, 2026
Copilot AI requested a review from binarywang May 31, 2026 14:36
@binarywang binarywang marked this pull request as ready for review May 31, 2026 14:37
Copilot AI review requested due to automatic review settings May 31, 2026 14:37
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature] 新增质检管理模块支持

3 participants