feat(firstleg): count actionable customer customs cabinets

2026-10-09 18:14:17 +08:00
parent d11abb78ac
commit 1202cafadf
7 changed files with 161 additions and 0 deletions
@@ -1,6 +1,28 @@
 openapi: 3.0.3
 info: {title: Firstleg Container Customs API, version: 2.0.0}
 paths:
+  /api/merchant/v1/customs/pending-summary:
+    get:
+      summary: 当前客户报关资料待处理柜次数量
+      description: >-
+        权限merchant:order:view，客户范围仅来自认证上下文。只读COUNT，不创建报关记录。
+        最新实际已装柜的退税货物尚未被本客户有效资料覆盖，或DECLARING阶段本客户冻结资料的当前回执为PENDING，均计入。
+        同柜多票、多份资料只计一次；已打回等待平台重做、已确认、已完成及其他客户的待办不计入。
+      x-permission: merchant:order:view
+      responses:
+        '200':
+          description: ApiResponse，code为200时才成功；失败不能解释为零待办
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string}
+                  data:
+                    type: object
+                    required: [pendingCount]
+                    properties:
+                      pendingCount: {type: string, pattern: '^[0-9]+$'}
  /api/platform/v1/customs/loading-plans/{planId}:
    get:
      summary: 查询整柜报关状态、缺资料票及文件映射