cbs-4px-merchant-cli 0.0.1 → 0.0.2

package/skill/SKILL.md

@@ -2,14 +2,14 @@
 name: cbs-4px-merchant-cli
 description: >-
   BPortal Merchant CLI (`fmc`) — 跨境物流商家命令行工具。
-  支持物流轨迹查询、面单打印、订单详情查询、产品推荐、理赔查询。
-  当用户需要查询物流信息、获取面单、查看订单详情、获取产品推荐报价、查询理赔状态时，使用 `fmc` 命令。
+  支持物流轨迹查询、面单打印、订单管理、产品推荐与报价、理赔查询、
+  异常件管理、服务中心、财务管理、揽收管理、系统公告。
   完整命令参考: `reference/index.md` + `reference/<group>.md`。
 ---
 
 # BPortal Merchant CLI (`fmc`)
 
-> 跨境物流商家命令行工具，提供物流轨迹查询、面单打印、订单详情、产品推荐、理赔查询等功能。
+> 跨境物流商家命令行工具，提供物流轨迹查询、面单打印、订单管理、产品推荐与报价、理赔查询、异常件管理、服务中心、财务管理、揽收管理、系统公告等功能。
 
 ## 严格禁止 (NEVER DO)
 
@@ -34,8 +34,15 @@ description: >-
 | 查询物流轨迹 | [`reference/track.md`](reference/track.md) | 确认参数格式 |
 | 获取面单 | [`reference/label.md`](reference/label.md) | 确认参数格式 |
 | 查看订单详情 | [`reference/order.md`](reference/order.md) | 确认参数和输出字段 |
+| 地址簿 | [`reference/order.md`](reference/order.md) | 确认参数格式 |
+| 国家查询 | [`reference/order.md`](reference/order.md) | 确认参数格式 |
 | 产品推荐 | [`reference/product.md`](reference/product.md) | 参数多（国家/重量/电池/邮编等），必须确认 |
 | 理赔查询 | [`reference/claim.md`](reference/claim.md) | 参数多（单号/时间/状态/分页），必须确认 |
+| 异常件管理 | [`reference/problem.md`](reference/problem.md) | 确认子命令和参数格式 |
+| 服务中心 | [`reference/service.md`](reference/service.md) | 确认子命令和参数格式 |
+| 财务管理 | [`reference/finance.md`](reference/finance.md) | 确认子命令和参数格式 |
+| 揽收管理 | [`reference/pickup.md`](reference/pickup.md) | 确认参数格式 |
+| 系统公告 | [`reference/notice.md`](reference/notice.md) | 确认参数格式 |
 | 认证相关 / 首次使用 | [`reference/auth.md`](reference/auth.md) | 了解认证方式和 API Key 获取地址 |
 | 配置管理 | [`reference/config.md`](reference/config.md) | 了解可配置项 |
 | 升级 CLI / skill | [`reference/update.md`](reference/update.md) | 了解升级流程和选项 |
@@ -50,11 +57,16 @@ description: >-
 |------|------|----------|
 | `auth` | 认证管理：配置 API Key、查看认证状态 | [`reference/auth.md`](reference/auth.md) |
 | `config` | 配置管理：查看/设置配置项、导出 tool schema | [`reference/config.md`](reference/config.md) |
-| `track` | 物流轨迹：按单号查询物流全程轨迹 | [`reference/track.md`](reference/track.md) |
+| `track` | 物流轨迹：按单号查询物流全程轨迹、轨迹订阅管理 | [`reference/track.md`](reference/track.md) |
 | `label` | 面单打印：获取面单 PDF 链接 | [`reference/label.md`](reference/label.md) |
-| `order` | 订单详情：查看收件人、费用、状态等完整信息 | [`reference/order.md`](reference/order.md) |
-| `product` | 产品推荐：根据目的地/重量等条件获取推荐物流产品及报价 | [`reference/product.md`](reference/product.md) |
+| `order` | 订单管理：查看订单详情、订单列表、地址簿、目的国搜索 | [`reference/order.md`](reference/order.md) |
+| `product` | 产品推荐：推荐产品、产品列表、产品详情、时效查询、搜索产品 | [`reference/product.md`](reference/product.md) |
 | `claim` | 理赔查询：按单号/时间/状态查询理赔列表 | [`reference/claim.md`](reference/claim.md) |
+| `problem` | 异常件管理：问题件列表、AI处理建议、通知件、尾程异常、欠费件、拦截件 | [`reference/problem.md`](reference/problem.md) |
+| `service` | 服务中心：售后工单、查件、投诉、服务单详情、处理记录、理赔详情 | [`reference/service.md`](reference/service.md) |
+| `finance` | 财务管理：账户余额、账单、每日费用、未出账汇总及明细、充值记录（在线及线下）、计费明细 | [`reference/finance.md`](reference/finance.md) |
+| `pickup` | 揽收管理：物料申请单查询 | [`reference/pickup.md`](reference/pickup.md) |
+| `notice` | 系统公告：公告列表、公告详情 | [`reference/notice.md`](reference/notice.md) |
 | `update` | 升级：检查并升级 CLI 及 skill 到最新版本 | [`reference/update.md`](reference/update.md) |
 
 运行 `fmc <command> --help` 查看命令帮助。
@@ -64,10 +76,37 @@ description: >-
 ## 意图判断决策树
 
 用户提到"包裹到哪了/物流状态/轨迹/在途" → `fmc track get`
+用户提到"轨迹订阅/订阅" → `fmc track sub-order`
 用户提到"面单/运单/打印/标签/label" → `fmc label get`
 用户提到"订单详情/收件人/费用明细/订单信息" → `fmc order get`
+用户提到"订单列表/最近订单/我的订单" → `fmc order list`
 用户提到"推荐产品/选什么物流/报价/寄到XX国" → `fmc product recommend`
+用户提到"可用产品/产品列表" → `fmc product list`
+用户提到"产品详情/产品属性" → `fmc product detail`
+用户提到"试算运费/运费计算" → `fmc product recommend`
+用户提到"时效/预估时效" → `fmc product eta`
+用户提到"搜索产品/找产品" → `fmc product search`
 用户提到"理赔/索赔/赔偿/丢件赔付" → `fmc claim list`
+用户提到"异常件/问题件/异常单/异常订单" → `fmc problem list`
+用户提到"处理建议/异常建议/AI建议" → `fmc problem suggest`
+用户提到"通知件" → `fmc problem notify`
+用户提到"尾程异常" → `fmc problem lastmile`
+用户提到"欠费/欠费件" → `fmc problem arrear`
+用户提到"拦截/拦截件" → `fmc problem intercepted`
+用户提到"工单/售后/报修" → `fmc service repair`
+用户提到"查件/查件进度" → `fmc service check`
+用户提到"投诉" → `fmc service complaint`
+用户提到"服务单详情" → `fmc service detail`
+用户提到"余额/账户余额" → `fmc finance balance`
+用户提到"账单" → `fmc finance bill`
+用户提到"每日费用/日费" → `fmc finance daily-fee`
+用户提到"未出账/未结算" → `fmc finance unbilled`
+用户提到"充值记录" → `fmc finance recharge`
+用户提到"计费明细" → `fmc finance fee-detail`
+用户提到"地址簿/地址列表" → `fmc order address-book`
+用户提到"目的国/国家查询/搜索国家" → `fmc order country`
+用户提到"物料/物料申请" → `fmc pickup material`
+用户提到"公告/通知/系统公告" → `fmc notice list`
 用户提到"登录/配置key/认证" → `fmc auth login`
 用户提到"升级/更新/新版本" → `fmc update`
 
@@ -80,6 +119,9 @@ description: >-
 | "我的包裹丢了" | `claim list` | `track get` | 用户意图是理赔而非查轨迹 |
 | "寄快递/发货选什么" | `product recommend` | — | 发货前选品，需要国家参数 |
 | "运费多少" | `product recommend` | `order get` | 发货前询价用 product；已发货查费用用 order |
+| "查理赔" | `claim list` | `service claim-detail` | 前者查列表，后者按理赔单号查详情 |
+| "我的订单" | `order list` | `order get` | 前者是列表，后者按单号查详情 |
+| "运费/多少钱" | `product recommend`（发货前询价） | `order get`（已发货查费用） | 发货前用 product recommend 试算；已发货查费用用 order get |
 
 ---
 
@@ -123,12 +165,24 @@ fmc label get FPX12345678
 # 查看订单详情
 fmc order get FPX12345678
 
+# 查询订单列表
+fmc order list --status IN_TRANSIT
+
 # 获取推荐产品（寄美国）
 fmc product recommend --country US
 
 # 查询理赔列表（按单号）
 fmc claim list --biz-no FPX12345678
 
+# 查询异常件
+fmc problem list
+
+# 查询账户余额
+fmc finance balance
+
+# 搜索目的国家
+fmc order country 美国
+
 # JSON 格式输出
 fmc track get FPX12345678 --output json
 ```
@@ -161,7 +215,12 @@ fmc config set baseUrl https://b.4px.com
 - [`reference/config.md`](reference/config.md) — 配置管理详细参数
 - [`reference/track.md`](reference/track.md) — 物流轨迹查询详细参数
 - [`reference/label.md`](reference/label.md) — 面单打印详细参数
-- [`reference/order.md`](reference/order.md) — 订单详情详细参数
-- [`reference/product.md`](reference/product.md) — 产品推荐详细参数
+- [`reference/order.md`](reference/order.md) — 订单管理详细参数
+- [`reference/product.md`](reference/product.md) — 产品推荐与查询详细参数
 - [`reference/claim.md`](reference/claim.md) — 理赔查询详细参数
+- [`reference/problem.md`](reference/problem.md) — 异常件管理详细参数
+- [`reference/service.md`](reference/service.md) — 服务中心详细参数
+- [`reference/finance.md`](reference/finance.md) — 财务管理详细参数
+- [`reference/pickup.md`](reference/pickup.md) — 揽收管理详细参数
+- [`reference/notice.md`](reference/notice.md) — 系统公告详细参数
 - [`reference/update.md`](reference/update.md) — CLI / skill 升级详细参数

package/skill/reference/customs.md

@@ -0,0 +1,220 @@
+# `fmc customs` command
+
+## Command details
+
+### `fmc customs cargo list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `customs cargo list` |
+| **Description** | 查询申报品列表 |
+| **Usage** | `fmc customs cargo list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--keyword <word>` | string | no | 搜索关键词 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc customs cargo list
+```
+
+```bash
+fmc customs cargo list --keyword 手机壳
+```
+
+```bash
+fmc customs cargo list --page 2 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+申报品列表
+────────────────────────────────────────────────────────────
+  Phone Case
+    中文品名    手机壳
+    配货品名    手机保护壳
+    HS编码      3926909090
+    单价        2.5 USD
+    数量        100
+
+  共 1 条
+```
+
+---
+
+### `fmc customs commodity list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `customs commodity list` |
+| **Description** | 查询商品备案列表 |
+| **Usage** | `fmc customs commodity list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--en-name <name>` | string | no | 英文品名 |
+| `--cn-name <name>` | string | no | 中文品名 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc customs commodity list
+```
+
+```bash
+fmc customs commodity list --en-name phone
+```
+
+```bash
+fmc customs commodity list --cn-name 手机 --output json
+```
+
+#### Output (text mode)
+
+```
+商品备案列表
+────────────────────────────────────────────────────────────
+  SKU001
+    英文名    Phone Case
+    中文名    手机壳
+    HS编码    3926909090 塑料制品
+    价格      2.50 USD
+    重量      50g
+    状态      已审核
+
+  共 1 条
+```
+
+---
+
+### `fmc customs commodity detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `customs commodity detail` |
+| **Description** | 查询商品备案详情 |
+| **Usage** | `fmc customs commodity detail <commodityId> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<commodityId>` | string | yes | 商品备案ID |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc customs commodity detail 12345
+```
+
+```bash
+fmc customs commodity detail 12345 --output json
+```
+
+---
+
+### `fmc customs hscode search`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `customs hscode search` |
+| **Description** | 查询海关编码 |
+| **Usage** | `fmc customs hscode search [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--code <code>` | string | no | 海关编码 |
+| `--name <name>` | string | no | 品名关键词 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc customs hscode search --name 手机
+```
+
+```bash
+fmc customs hscode search --code 3926
+```
+
+```bash
+fmc customs hscode search --name phone --output json
+```
+
+#### Output (text mode)
+
+```
+海关编码查询结果
+──────────────────────────────────────────────────
+  3926909090  其他塑料制品
+  8517120000  手机及便携终端
+
+  共 2 条
+```
+
+---
+
+### `fmc customs registration info`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `customs registration info` |
+| **Description** | 查询客户海关备案信息 |
+| **Usage** | `fmc customs registration info [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+无额外参数。
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc customs registration info
+```
+
+```bash
+fmc customs registration info --output json
+```
+
+#### Output (text mode)
+
+```
+客户备案信息
+────────────────────────────────────────
+  客户编码    CM001234
+  审核状态    已审核
+```

package/skill/reference/finance.md

@@ -0,0 +1,337 @@
+# `fmc finance` command
+
+## Command details
+
+### `fmc finance balance`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance balance` |
+| **Description** | 查询账户余额 |
+| **Usage** | `fmc finance balance [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 DSS |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance balance
+```
+
+```bash
+fmc finance balance --output json
+```
+
+#### Output (text mode)
+
+```
+账户余额
+──────────────────────────────────────────────────
+  付费类型        预付费
+  授信额度        50,000.00
+  可用授信额度    41,800.00
+  可用余额        12,580.50
+  欠费金额        0.00
+
+  账户余额明细
+  ────────────────────────────────────────
+  CNY (DSS)
+    现金余额      10,000.00
+    信用余额      2,580.50
+    账户余额      12,580.50
+```
+
+---
+
+### `fmc finance bill list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance bill list` |
+| **Description** | 查询已出账单列表 |
+| **Usage** | `fmc finance bill list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 GRS |
+| `--bill-no <no>` | string | no | 账单编号 |
+| `--bill-month <month>` | string | no | 账单月份 (yyyy-MM) |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance bill list
+```
+
+```bash
+fmc finance bill list --bill-month 2024-01
+```
+
+```bash
+fmc finance bill list --page 2 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+账单列表
+──────────────────────────────────────────────────
+  共 25 条
+
+  BILL-202401  已结算
+    业务系统    GRS
+    应收金额    5,280.50 CNY
+    账单周期    2024-01-01~2024-01-31
+    还款截止    2024-02-15
+```
+
+---
+
+### `fmc finance daily-fee list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance daily-fee list` |
+| **Description** | 查询每日充值/消费费用 |
+| **Usage** | `fmc finance daily-fee list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 GRS |
+| `--currency-code <code>` | string | no | 币种编码 |
+| `--start-date <date>` | string | no | 起始日期 (yyyy-MM-dd) |
+| `--end-date <date>` | string | no | 结束日期 (yyyy-MM-dd) |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance daily-fee list
+```
+
+```bash
+fmc finance daily-fee list --start-date 2024-01-01 --end-date 2024-01-07
+```
+
+```bash
+fmc finance daily-fee list --output json
+```
+
+#### Output (text mode)
+
+```
+每日费用
+──────────────────────────────────────────────────
+  页码 1/1  共 7 条
+
+  2024-01-07
+    费用金额    680.50
+    收款金额    520.00
+    业务系统    GRS
+```
+
+---
+
+### `fmc finance unbilled list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance unbilled list` |
+| **Description** | 查询未出账单（传 `--business-no` 查明细，不传查列表） |
+| **Usage** | `fmc finance unbilled list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--business-no <no>` | string | no | 业务单号（传入则查该单计费明细） |
+| `--currency-code <code>` | string | no | 币种编码（查明细时必填） |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 GRS |
+| `--bill-no <no>` | string | no | 账单编号（查列表时筛选） |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance unbilled list
+```
+
+```bash
+fmc finance unbilled list --business-no FPX12345678 --currency-code CNY
+```
+
+```bash
+fmc finance unbilled list --output json
+```
+
+---
+
+### `fmc finance recharge list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance recharge list` |
+| **Description** | 查询充值记录（加 `--offline` 查线下水单） |
+| **Usage** | `fmc finance recharge list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--offline` | boolean | no | 查询线下充值记录（水单） |
+| `--business-system <system>` | string | no | 品牌（业务系统），默认 DSS |
+| `--start-date <date>` | string | no | 起始日期 (yyyy-MM-dd) |
+| `--end-date <date>` | string | no | 结束日期 (yyyy-MM-dd) |
+| `--currency <code>` | string | no | 币种（仅线下） |
+| `--trade-no <no>` | string | no | 付款凭证号（仅线下） |
+| `--status <code>` | string | no | 水单状态（仅线下） |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance recharge list
+```
+
+```bash
+fmc finance recharge list --offline
+```
+
+```bash
+fmc finance recharge list --start-date 2024-01-01 --end-date 2024-06-30
+```
+
+```bash
+fmc finance recharge list --output json
+```
+
+---
+
+### `fmc finance fee detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance fee detail` |
+| **Description** | 查询计费明细 |
+| **Usage** | `fmc finance fee detail <businessNo> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<businessNo>` | string | yes | 业务单号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance fee detail FPX12345678
+```
+
+```bash
+fmc finance fee detail FPX12345678 --output json
+```
+
+#### Output (text mode)
+
+```
+费用明细
+──────────────────────────────────────────────────
+  运费
+    计费单号    BIL001
+    应付金额    25.00 CNY
+    计费状态    已计费
+
+  燃油附加费
+    计费单号    BIL002
+    应付金额    5.00 CNY
+    计费状态    已计费
+```
+
+---
+
+### `fmc finance frozen list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `finance frozen list` |
+| **Description** | 查询冻结流水 |
+| **Usage** | `fmc finance frozen list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--brand <brand>` | string | no | 品牌（业务系统） |
+| `--currency <code>` | string | no | 币种编码 |
+| `--business-no <no>` | string | no | 业务单号 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc finance frozen list
+```
+
+```bash
+fmc finance frozen list --currency CNY
+```
+
+```bash
+fmc finance frozen list --business-no FPX12345678 --output json
+```
+
+#### Output (text mode)
+
+```
+冻结流水列表
+────────────────────────────────────────────────────────────
+  FPX12345678
+    品牌        DSS
+    冻结金额    25.00 CNY
+    冻结时间    2024-01-15 10:30:00
+    解冻时间    2024-01-20 09:00:00
+
+  共 1 条
+```