feat(channel): 新增微信小店质检管理（QIC）5个官方接口支持 by Copilot · Pull Request #4039 · binarywang/WxJava

Copilot · 2026-05-31T14:22:43Z

当前 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

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

binarywang · 2026-07-11T05:06:39Z

@codex auggie review

Copilot

Pull request overview

Copilot reviewed 11 out of 11 changed files in this pull request and generated 2 comments.

+  public SubmitConfigResponse getSubmitConfig(String orderId) throws WxErrorException {
+    String queryParam = StringUtils.isBlank(orderId) ? "" : "order_id=" + orderId;
+    String respJson = shopService.get(GET_SUBMIT_CONFIG_URL, queryParam);
+    return ResponseUtils.decode(respJson, SubmitConfigResponse.class);
+  }


+  public static class DataPayload implements Serializable {
+    private static final long serialVersionUID = 684071509005627272L;
+
+    @JsonProperty("backupDeliveryId")
+    private String backupDeliveryId;
+
+    @JsonProperty("backupDeliveryName")
+    private String backupDeliveryName;
+
+    @JsonProperty("boxDTOList")
+    private List<BoxInfo> boxInfoList;


augmentcode · 2026-07-11T05:10:15Z

🤖 Augment PR Summary

Summary: This PR adds “质检管理（QIC）” support to weixin-java-channel so the SDK can cover jewelry/luxury inspection workflows.

Changes:

Introduced WxChannelQicService with 5 official QIC endpoints (inspect config, submit config, print inspect code, submit inspect info, register logistics).
Exposed the new capability via WxChannelService#getQicService() and added lazy initialization in BaseWxChannelServiceImpl.
Implemented the API calls in WxChannelQicServiceImpl using centralized URL constants.
Added a new WxChannelApiUrlConstants.Qic group to maintain the 5 endpoint URLs.
Added request/response DTOs under me.chanjar.weixin.channel.bean.qic aligned to the official field names.
Added TestNG integration-style tests (WxChannelQicServiceImplTest) to exercise the 5 new service methods.

Technical Notes: Requests are executed through BaseWxChannelServiceImpl which injects access_token, and responses are parsed via ResponseUtils.decode.

_{🤖 Was this summary useful? React with 👍 or 👎}

augmentcode

Review completed. 1 suggestion posted.

Comment augment review to trigger a new review at any time.

augmentcode · 2026-07-11T05:10:16Z

+
+  @Override
+  public SubmitConfigResponse getSubmitConfig(String orderId) throws WxErrorException {
+    String queryParam = StringUtils.isBlank(orderId) ? "" : "order_id=" + orderId;


weixin-java-channel/src/main/java/me/chanjar/weixin/channel/api/impl/WxChannelQicServiceImpl.java:41 — When orderId is blank this sets queryParam to ""; because BaseWxChannelServiceImpl already appends ?access_token=..., the GET executor will append an extra trailing & (e.g. ...access_token=...&). Consider passing null when no optional params are present so the final request URL isn't malformed/ambiguous.

Severity: medium

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0748aa9f0f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-07-11T05:18:33Z

+  public static class DataPayload implements Serializable {
+    private static final long serialVersionUID = 684071509005627272L;
+
+    @JsonProperty("backupDeliveryId")


Map inspect-code fields to the API payload names

The print-inspect-code response DTO starts annotating every returned field with camelCase names such as backupDeliveryId/boxDTOList, unlike the QIC API payload naming used by the other new DTOs. When WeChat returns the documented snake_case response fields, Jackson will silently leave these properties null, so a successful printInspectCode call won't expose the inspection code details to callers. Please align these @JsonProperty values with the actual response field names.

Useful? React with 👍 / 👎.

Initial plan

69ca50a

Copilot AI assigned Copilot and binarywang May 31, 2026

Copilot started work on behalf of binarywang May 31, 2026 14:27 View session

Copilot AI linked an issue May 31, 2026 that may be closed by this pull request

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

Open

feat: 新增视频号小店质检管理模块接口与模型支持

0748aa9

Copilot AI changed the title ~~[WIP] Add quality inspection management module support~~ feat(channel): 新增微信小店质检管理（QIC）5个官方接口支持 May 31, 2026

Copilot finished work on behalf of binarywang May 31, 2026 14:36

Copilot AI requested a review from binarywang May 31, 2026 14:36

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

Copilot started reviewing on behalf of binarywang May 31, 2026 14:37 View session

Copilot AI reviewed May 31, 2026

binarywang force-pushed the develop branch from afba62e to abc9a97 Compare June 1, 2026 13:50

binarywang added this to the 4.8.5 milestone Jun 8, 2026

binarywang requested a review from Copilot July 11, 2026 05:06

Copilot started reviewing on behalf of binarywang July 11, 2026 05:06 View session

Copilot AI reviewed Jul 11, 2026

View reviewed changes

augmentcode Bot reviewed Jul 11, 2026

View reviewed changes

chatgpt-codex-connector Bot reviewed Jul 11, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

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

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

Copilot AI commented May 31, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

binarywang commented Jul 11, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

augmentcode Bot commented Jul 11, 2026

Uh oh!

augmentcode Bot left a comment

Uh oh!

augmentcode Bot Jul 11, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot Jul 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

Copilot AI commented May 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

binarywang commented Jul 11, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

augmentcode Bot commented Jul 11, 2026

Uh oh!

augmentcode Bot left a comment

Choose a reason for hiding this comment

Uh oh!

augmentcode Bot Jul 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jul 11, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented May 31, 2026 •

edited

Loading

augmentcode Bot Jul 11, 2026 •

edited

Loading