cbs-4px-merchant-cli 0.0.1 → 0.0.2

package/skill/reference/index.md

@@ -14,10 +14,54 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | `fmc config list` | 查看当前配置 | [config.md](config.md) |
 | `fmc config export-schema` | 导出命令的 JSON tool schema | [config.md](config.md) |
 | `fmc track get` | 查询物流轨迹 | [track.md](track.md) |
+| `fmc track sub order` | 查询轨迹订阅订单 | [track.md](track.md) |
+| `fmc track sub product` | 查询轨迹订阅产品 | [track.md](track.md) |
 | `fmc label get` | 获取面单打印信息（PDF 链接） | [label.md](label.md) |
 | `fmc order get` | 获取订单详情 | [order.md](order.md) |
+| `fmc order list` | 查询订单列表 | [order.md](order.md) |
+| `fmc order address-book` | 查询地址簿列表 | [order.md](order.md) |
+| `fmc order country` | 模糊搜索目的国家 | [order.md](order.md) |
 | `fmc product recommend` | 获取推荐物流产品及报价 | [product.md](product.md) |
-| `fmc claim list` | 查询理赔列表 | [claim.md](claim.md) |
+| `fmc product list` | 查询可用产品列表 | [product.md](product.md) |
+| `fmc product detail` | 查询产品详情 | [product.md](product.md) |
+| `fmc product eta` | 查询预估时效 | [product.md](product.md) |
+| `fmc product search` | 搜索产品 | [product.md](product.md) |
+| `fmc problem list` | 查询问题件列表 | [problem.md](problem.md) |
+| `fmc problem suggest` | 获取异常件 AI 处理建议 | [problem.md](problem.md) |
+| `fmc problem notify list` | 查询通知件列表 | [problem.md](problem.md) |
+| `fmc problem notify type` | 查询尾程异常类型枚举 | [problem.md](problem.md) |
+| `fmc problem lastmile list` | 查询尾程异常列表 | [problem.md](problem.md) |
+| `fmc problem arrear list` | 查询欠费件列表 | [problem.md](problem.md) |
+| `fmc problem intercepted list` | 查询拦截件列表 | [problem.md](problem.md) |
+| `fmc service repair list` | 查询售后工单列表 | [service.md](service.md) |
+| `fmc service check list` | 查询查件列表 | [service.md](service.md) |
+| `fmc service complaint list` | 查询投诉列表 | [service.md](service.md) |
+| `fmc service detail` | 查询服务单详情 | [service.md](service.md) |
+| `fmc service record` | 查询服务单处理记录 | [service.md](service.md) |
+| `fmc service claim list` | 查询理赔列表 | [service.md](service.md) |
+| `fmc service claim detail` | 查询理赔详情 | [service.md](service.md) |
+| `fmc service claim reason` | 查询理赔原因列表 | [service.md](service.md) |
+| `fmc finance balance` | 查询账户余额 | [finance.md](finance.md) |
+| `fmc finance bill list` | 查询账单列表 | [finance.md](finance.md) |
+| `fmc finance daily-fee list` | 查询每日费用 | [finance.md](finance.md) |
+| `fmc finance unbilled list` | 查询未出账汇总及明细 | [finance.md](finance.md) |
+| `fmc finance recharge list` | 查询充值记录（在线及线下） | [finance.md](finance.md) |
+| `fmc finance fee detail` | 查询计费明细 | [finance.md](finance.md) |
+| `fmc finance frozen list` | 查询冻结流水 | [finance.md](finance.md) |
+| `fmc pickup material list` | 查询物料申请单列表 | [pickup.md](pickup.md) |
+| `fmc pickup material detail` | 查询物料申请单详情 | [pickup.md](pickup.md) |
+| `fmc pickup material quota` | 查询本月物料申请额度 | [pickup.md](pickup.md) |
+| `fmc pickup address list` | 查询揽收地址列表 | [pickup.md](pickup.md) |
+| `fmc notice list` | 查询系统公告列表 | [notice.md](notice.md) |
+| `fmc notice detail` | 查询公告详情 | [notice.md](notice.md) |
+| `fmc notice message list` | 查询站内消息列表 | [notice.md](notice.md) |
+| `fmc notice message detail` | 查询站内消息详情 | [notice.md](notice.md) |
+| `fmc notice message unread` | 查询未读消息数量 | [notice.md](notice.md) |
+| `fmc customs cargo list` | 查询申报品列表 | [customs.md](customs.md) |
+| `fmc customs commodity list` | 查询商品备案列表 | [customs.md](customs.md) |
+| `fmc customs commodity detail` | 查询商品备案详情 | [customs.md](customs.md) |
+| `fmc customs hscode search` | 查询海关编码 | [customs.md](customs.md) |
+| `fmc customs registration info` | 查询客户备案信息 | [customs.md](customs.md) |
 | `fmc update` | 升级 CLI 及对应 skill 到最新版本 | [update.md](update.md) |
 
 ## By group
@@ -26,11 +70,16 @@ Command **details** are in sibling `<group>.md` files in this directory.
 | --- | --- | --- |
 | `auth` | `login`, `status` | [auth.md](auth.md) |
 | `config` | `set`, `list`, `export-schema` | [config.md](config.md) |
-| `track` | `get` | [track.md](track.md) |
+| `track` | `get`, `sub order`, `sub product` | [track.md](track.md) |
 | `label` | `get` | [label.md](label.md) |
-| `order` | `get` | [order.md](order.md) |
-| `product` | `recommend` | [product.md](product.md) |
-| `claim` | `list` | [claim.md](claim.md) |
+| `order` | `get`, `list`, `address-book`, `country` | [order.md](order.md) |
+| `product` | `recommend`, `list`, `detail`, `eta`, `search` | [product.md](product.md) |
+| `problem` | `list`, `suggest`, `notify list`, `notify type`, `lastmile list`, `arrear list`, `intercepted list` | [problem.md](problem.md) |
+| `service` | `repair list`, `check list`, `complaint list`, `detail`, `record`, `claim list`, `claim detail`, `claim reason` | [service.md](service.md) |
+| `finance` | `balance`, `bill list`, `daily-fee list`, `unbilled list`, `recharge list`, `fee detail`, `frozen list` | [finance.md](finance.md) |
+| `pickup` | `material list`, `material detail`, `material quota`, `address list` | [pickup.md](pickup.md) |
+| `notice` | `list`, `detail`, `message list`, `message detail`, `message unread` | [notice.md](notice.md) |
+| `customs` | `cargo list`, `commodity list`, `commodity detail`, `hscode search`, `registration info` | [customs.md](customs.md) |
 | `update` | (no subcommand) | [update.md](update.md) |
 
 ## Global flags
@@ -46,6 +95,7 @@ Command **details** are in sibling `<group>.md` files in this directory.
 ## Notes
 
 - `track get` 命令无需认证即可使用。
-- `label get`、`order get`、`product recommend`、`claim list` 命令需要先配置 API Key：`fmc auth login --api-key <SK_xxx>`。
+- 其余大部分命令需要先配置 API Key：`fmc auth login --api-key <SK_xxx>`。
+- 新增的 `problem`、`service`、`finance`、`pickup`、`notice`、`customs` 模块均需要 API Key 认证。`order` 模块下的 `address-book`、`country` 子命令也需要认证。
 - 配置文件位于 `~/.bportal/config.json`；升级状态缓存位于 `~/.bportal/update-state.json`。
 - 当检测到新版本可用时，stderr 会输出 `{"_notice":{"type":"update",...}}`；设置环境变量 `BPORTAL_NO_UPDATE_NOTIFIER=1` 可关闭。

package/skill/reference/notice.md

@@ -0,0 +1,238 @@
+# `fmc notice` command
+
+## Command details
+
+### `fmc notice list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice list` |
+| **Description** | 查询系统公告列表 |
+| **Usage** | `fmc notice list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--category <cat>` | string | no | 公告分类筛选 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice list
+```
+
+```bash
+fmc notice list --category 系统维护
+```
+
+```bash
+fmc notice list --page 2 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+公告列表
+──────────────────────────────────────────────────
+
+  NTC20240115001
+    公告名称    春节假期运营时间调整通知
+    分类        运营通知
+    发布时间    2024-01-15 10:00:00
+
+  NTC20240110001
+    公告名称    系统升级维护公告
+    分类        系统维护
+    发布时间    2024-01-10 09:00:00
+```
+
+---
+
+### `fmc notice detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice detail` |
+| **Description** | 查询公告详情 |
+| **Usage** | `fmc notice detail <code> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<code>` | string | yes | 公告编号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice detail NTC20240115001
+```
+
+```bash
+fmc notice detail NTC20240115001 --output json
+```
+
+#### Output (text mode)
+
+```
+公告详情
+──────────────────────────────────────────────────
+  公告编码    NTC20240115001
+  公告名称    春节假期运营时间调整通知
+  分类        运营通知
+  发布时间    2024-01-15 10:00:00
+
+  公告内容
+  ────────────────────────────────────────
+  尊敬的客户，春节假期期间物流时效可能有所延长，请提前安排发货。
+```
+
+---
+
+### `fmc notice message list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice message list` |
+| **Description** | 查询站内消息列表 |
+| **Usage** | `fmc notice message list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--biz-code <code>` | string | no | 业务编码 |
+| `--read <bool>` | string | no | 是否已读：true / false |
+| `--keyword <word>` | string | no | 搜索关键词 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice message list
+```
+
+```bash
+fmc notice message list --read false
+```
+
+```bash
+fmc notice message list --keyword 运费 --page 1 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+站内消息列表
+────────────────────────────────────────────────────────────
+  [未读] MSG001
+    标题        您的包裹 FPX12345678 已签收
+    业务类型    轨迹通知
+    分类        物流消息
+    发送时间    2024-01-15 10:30:00
+
+  [已读] MSG002
+    标题        账单 BILL-202401 已生成
+    业务类型    财务通知
+    分类        账务消息
+    发送时间    2024-01-10 09:00:00
+
+  共 2 条
+```
+
+---
+
+### `fmc notice message detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice message detail` |
+| **Description** | 查询站内消息详情 |
+| **Usage** | `fmc notice message detail <recordId> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<recordId>` | string | yes | 消息记录ID |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice message detail MSG001
+```
+
+```bash
+fmc notice message detail MSG001 --output json
+```
+
+#### Output (text mode)
+
+```
+消息详情
+──────────────────────────────────────────────────
+  记录ID      MSG001
+  标题        您的包裹 FPX12345678 已签收
+  业务类型    轨迹通知
+  分类        物流消息
+  发送时间    2024-01-15 10:30:00
+  状态        未读
+
+  消息内容
+  ────────────────────────────────────────
+  您好，您的包裹 FPX12345678 已于 2024-01-15 10:30 签收。
+```
+
+---
+
+### `fmc notice message unread`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `notice message unread` |
+| **Description** | 查询未读消息数量 |
+| **Usage** | `fmc notice message unread [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+无额外参数。
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc notice message unread
+```
+
+```bash
+fmc notice message unread --output json
+```
+
+#### Output (text mode)
+
+```
+  未读消息数量: 5
+```

package/skill/reference/order.md

@@ -66,3 +66,175 @@ fmc order get FPX12345678 --verbose
   ────────────────────────────────────────
   合计        30.00 USD
 ```
+
+---
+
+### `fmc order list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `order list` |
+| **Description** | 查询订单列表（支持按状态、单号、时间等筛选） |
+| **Usage** | `fmc order list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--status <status>` | string | no | 订单状态筛选，如 IN_TRANSIT、DELIVERED、CREATED 等 |
+| `--customer-order-no <no>` | string | no | 客户订单号 |
+| `--fpx-track-no <no>` | string | no | FPX 运单号 |
+| `--start-date <date>` | string | no | 起始日期，格式 yyyy-MM-dd |
+| `--end-date <date>` | string | no | 结束日期，格式 yyyy-MM-dd |
+| `--product-code <code>` | string | no | 产品代码 |
+| `--destination-country <code>` | string | no | 目的国家二字码 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc order list
+```
+
+```bash
+fmc order list --status IN_TRANSIT
+```
+
+```bash
+fmc order list --destination-country US --start-date 2024-01-01 --end-date 2024-06-30
+```
+
+```bash
+fmc order list --page 2 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+订单列表
+──────────────────────────────────────────────────
+  页码 1/5  共 48 条
+
+  FPX12345678  IN_TRANSIT
+    客户单号    ORD-20240115-001
+    产品代码    STANDARD
+    目的国      US
+    创建时间    2024-01-15 10:30:00
+
+  FPX12345679  DELIVERED
+    客户单号    ORD-20240114-002
+    产品代码    ECO-PKG
+    目的国      GB
+    创建时间    2024-01-14 08:00:00
+```
+
+---
+
+### `fmc order address-book`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `order address-book` |
+| **Description** | 查询发件地址簿（商家预存的发件/揽收/退件地址） |
+| **Usage** | `fmc order address-book [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+无额外参数。
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc order address-book
+```
+
+```bash
+fmc order address-book --output json
+```
+
+#### Output (text mode)
+
+```
+地址簿列表
+──────────────────────────────────────────────────
+  共 3 条
+
+  深圳仓库
+    联系人      张三
+    电话        13800138000
+    国家        CN
+    城市        深圳
+    地址        广东省深圳市南山区科技园路1号
+    邮编        518000
+
+  广州仓库
+    联系人      李四
+    电话        13900139000
+    国家        CN
+    城市        广州
+    地址        广东省广州市天河区天河路2号
+    邮编        510000
+```
+
+---
+
+### `fmc order country`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `order country` |
+| **Description** | 模糊搜索目的国家 |
+| **Usage** | `fmc order country <keyword> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<keyword>` | string | yes | 搜索关键词（国家名称或代码） |
+| `--product-code <code>` | string | no | 按产品代码筛选支持的国家 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc order country 美国
+```
+
+```bash
+fmc order country US
+```
+
+```bash
+fmc order country united --product-code STD-EXP
+```
+
+```bash
+fmc order country 日本 --output json
+```
+
+#### Output (text mode)
+
+```
+国家搜索结果
+──────────────────────────────────────────────────
+  关键词    美国
+  共 1 个匹配结果
+
+  US
+    中文名称    美国
+    英文名称    United States
+    二字码      US
+    三字码      USA
+```