cbs-4px-merchant-cli 0.0.1 → 0.0.2

package/skill/reference/product.md

@@ -68,3 +68,206 @@ fmc product recommend --country JP --output json
     总费用(RMB) 58.00
     计费重      1000g
 ```
+
+---
+
+### `fmc product list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `product list` |
+| **Description** | 查询可用产品列表 |
+| **Usage** | `fmc product list --country <code> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--country <code>` | string | yes | 目的国家二字码，如 US、GB、JP |
+| `--start-city <city>` | string | no | 起运城市中文名，默认深圳 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc product list --country US
+```
+
+```bash
+fmc product list --country JP --start-city 广州
+```
+
+```bash
+fmc product list --country GB --output json
+```
+
+#### Output (text mode)
+
+```
+可用产品列表
+──────────────────────────────────────────────────
+  目的国    US (美国)
+
+  共 5 个产品
+
+  ECO-PKG
+    产品名称    4PX经济小包
+    服务等级    经济
+    跟踪类型    全程跟踪
+    时效        7-15工作日
+
+  STD-EXP
+    产品名称    4PX标准快递
+    服务等级    标准
+    跟踪类型    全程跟踪
+    时效        5-8工作日
+```
+
+---
+
+### `fmc product detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `product detail` |
+| **Description** | 查询产品详情（含属性、限制等信息） |
+| **Usage** | `fmc product detail <productCode> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<productCode>` | string | yes | 产品代码 |
+| `--country <code>` | string | no | 目的国家二字码 |
+| `--weight <kg>` | number | no | 重量(kg) |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc product detail STD-EXP
+```
+
+```bash
+fmc product detail STD-EXP --country US --weight 2.5
+```
+
+```bash
+fmc product detail ECO-PKG --output json
+```
+
+#### Output (text mode)
+
+```
+产品详情
+──────────────────────────────────────────────────
+  产品代码    STD-EXP
+  产品名称    4PX标准快递
+  服务等级    标准
+  跟踪类型    全程跟踪
+  时效        5-8工作日
+  最大重量    30kg
+  最大长度    120cm
+  是否支持电池  是
+```
+
+---
+
+### `fmc product eta`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `product eta` |
+| **Description** | 查询预估时效 |
+| **Usage** | `fmc product eta --country-code <code> --product-code <code> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--country-code <code>` | string | yes | 目的国家二字码 |
+| `--product-code <code>` | string | yes | 产品代码 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc product eta --country-code US --product-code STD-EXP
+```
+
+```bash
+fmc product eta --country-code JP --product-code ECO-PKG --output json
+```
+
+#### Output (text mode)
+
+```
+预估时效
+──────────────────────────────────────────────────
+  产品代码    STD-EXP
+  目的国      US
+  预估时效    5-8 工作日
+```
+
+---
+
+### `fmc product search`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `product search` |
+| **Description** | 按关键词搜索产品 |
+| **Usage** | `fmc product search <keyword> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<keyword>` | string | yes | 搜索关键词（产品名称或代码） |
+| `--country-code <code>` | string | no | 目的国家二字码筛选 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc product search 经济
+```
+
+```bash
+fmc product search express --country-code US
+```
+
+```bash
+fmc product search 标准 --output json
+```
+
+#### Output (text mode)
+
+```
+产品搜索结果
+──────────────────────────────────────────────────
+  关键词    经济
+  共 2 个匹配产品
+
+  ECO-PKG
+    产品名称    4PX经济小包
+    服务等级    经济
+    跟踪类型    全程跟踪
+
+  ECO-EXP
+    产品名称    4PX经济快递
+    服务等级    经济
+    跟踪类型    全程跟踪
+```

package/skill/reference/service.md

@@ -0,0 +1,406 @@
+# `fmc service` command
+
+## Command details
+
+### `fmc service repair list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service repair list` |
+| **Description** | 查询售后工单列表 |
+| **Usage** | `fmc service repair list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--order-codes <codes>` | string | no | 业务单号，多个用逗号分隔 |
+| `--business-line-id <id>` | number | no | 业务线ID |
+| `--category-id <id>` | number | no | 反馈类型ID |
+| `--biz-status <status>` | number | 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 service repair list
+```
+
+```bash
+fmc service repair list --order-codes FPX12345678
+```
+
+```bash
+fmc service repair list --biz-status 1 --page 1 --size 20
+```
+
+```bash
+fmc service repair list --output json
+```
+
+#### Output (text mode)
+
+```
+售后工单列表
+──────────────────────────────────────────────────
+  页码 1/2  共 15 条
+
+  SR20240115001  待处理
+    运单号      FPX12345678
+    工单类型    退件
+    问题描述    收件人拒收，申请退回
+    创建时间    2024-01-15 10:30:00
+```
+
+---
+
+### `fmc service check list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service check list` |
+| **Description** | 查询查件服务单列表 |
+| **Usage** | `fmc service check list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--biz-no <no>` | string | no | 业务单号 |
+| `--service-no <no>` | string | no | 服务单号 |
+| `--service-status <status>` | number | no | 状态：0 待受理、1 受理中、2 已退回、3 已解决 |
+| `--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 service check list
+```
+
+```bash
+fmc service check list --biz-no FPX12345678
+```
+
+```bash
+fmc service check list --service-status 1 --output json
+```
+
+#### Output (text mode)
+
+```
+查件列表
+──────────────────────────────────────────────────
+  页码 1/1  共 3 条
+
+  CK20240115001  处理中
+    运单号      FPX12345678
+    查件原因    长时间未更新轨迹
+    创建时间    2024-01-15 10:30:00
+```
+
+---
+
+### `fmc service complaint list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service complaint list` |
+| **Description** | 查询投诉列表 |
+| **Usage** | `fmc service complaint list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--biz-no <no>` | string | no | 业务单号 |
+| `--service-no <no>` | string | no | 服务单号 |
+| `--service-status <status>` | number | no | 状态：0 待受理、1 受理中、2 已退回、3 已解决 |
+| `--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 service complaint list
+```
+
+```bash
+fmc service complaint list --biz-no FPX12345678
+```
+
+```bash
+fmc service complaint list --output json
+```
+
+#### Output (text mode)
+
+```
+投诉列表
+──────────────────────────────────────────────────
+  页码 1/1  共 2 条
+
+  CP20240115001  待处理
+    运单号      FPX12345678
+    投诉类型    服务态度
+    投诉内容    派送员未按约定时间投递
+    创建时间    2024-01-15 10:30:00
+```
+
+---
+
+### `fmc service detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service detail` |
+| **Description** | 查询查件/咨询服务单详情 |
+| **Usage** | `fmc service detail <serviceNo> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<serviceNo>` | string | yes | 服务单号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc service detail SR20240115001
+```
+
+```bash
+fmc service detail SR20240115001 --output json
+```
+
+#### Output (text mode)
+
+```
+服务单详情
+──────────────────────────────────────────────────
+  服务单号    SR20240115001
+  运单号      FPX12345678
+  工单类型    退件
+  状态        处理中
+  问题描述    收件人拒收，申请退回
+  创建时间    2024-01-15 10:30:00
+  更新时间    2024-01-16 09:00:00
+```
+
+---
+
+### `fmc service record`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service record` |
+| **Description** | 查询服务单处理记录 |
+| **Usage** | `fmc service record <serviceNo> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<serviceNo>` | string | yes | 服务单号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc service record SR20240115001
+```
+
+```bash
+fmc service record SR20240115001 --output json
+```
+
+#### Output (text mode)
+
+```
+处理记录
+──────────────────────────────────────────────────
+  服务单号    SR20240115001
+
+  2024-01-16 09:00:00  客服处理
+    操作人    客服A
+    操作内容  已联系仓库安排退件处理
+
+  2024-01-15 10:30:00  客户提交
+    操作人    商家
+    操作内容  收件人拒收，申请退回
+```
+
+---
+
+### `fmc service claim list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service claim list` |
+| **Description** | 查询理赔列表 |
+| **Usage** | `fmc service claim list [flags]` |
+
+需要 API Key 认证。`--biz-no` 与时间范围至少传一项。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--biz-no <nos>` | string | no | 业务单号，多个用英文逗号分隔 |
+| `--start-time <time>` | string | no | 起始创建时间，格式 yyyy-MM-dd HH:mm:ss |
+| `--end-time <time>` | string | no | 结束创建时间，格式 yyyy-MM-dd HH:mm:ss |
+| `--status <code>` | string | no | 理赔状态：0 全部、1 待处理、2 受理中、3 已解决、4 已退回 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10，最大 100 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc service claim list --biz-no FPX12345678
+```
+
+```bash
+fmc service claim list --start-time "2024-01-01 00:00:00" --end-time "2024-12-31 23:59:59"
+```
+
+```bash
+fmc service claim list --status 1 --page 1 --size 20
+```
+
+```bash
+fmc service claim list --biz-no FPX111,FPX222 --output json
+```
+
+#### Output (text mode)
+
+```
+理赔列表
+──────────────────────────────────────────────────
+  页码 1/1  共 2 条
+
+  CLM20240115001  受理中
+    业务单号    FPX12345678
+    索赔原因    包裹丢失
+    货值赔偿    150.00 USD
+    最新反馈    正在核实物流信息
+    创建时间    2024-01-15 10:30:00
+```
+
+---
+
+### `fmc service claim detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service claim detail` |
+| **Description** | 按理赔单号查询理赔详情 |
+| **Usage** | `fmc service claim detail <claimNo> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<claimNo>` | string | yes | 理赔单号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc service claim detail CLM20240115001
+```
+
+```bash
+fmc service claim detail CLM20240115001 --output json
+```
+
+#### Output (text mode)
+
+```
+理赔详情
+──────────────────────────────────────────────────
+  理赔单号    CLM20240115001
+  运单号      FPX12345678
+  理赔状态    受理中
+  理赔原因    包裹丢失
+  索赔金额    150.00 USD
+  创建时间    2024-01-15 10:30:00
+```
+
+---
+
+### `fmc service claim reason`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `service claim reason` |
+| **Description** | 查询理赔原因列表 |
+| **Usage** | `fmc service claim reason [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--level <num>` | number | yes | 理赔原因级别：1 一级、2 二级 |
+| `--dict-type <type>` | string | yes | 字典类型：fb4ClaimType（仓发）或 dssClaimType（直发） |
+| `--dict-code <code>` | string | no | 上级字典code（查二级时必填） |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc service claim reason --level 1 --dict-type dssClaimType
+```
+
+```bash
+fmc service claim reason --level 2 --dict-type fb4ClaimType --dict-code LOST
+```
+
+```bash
+fmc service claim reason --level 1 --dict-type dssClaimType --output json
+```
+
+#### Output (text mode)
+
+```
+理赔原因列表
+──────────────────────────────────────────────────
+  LOST          包裹丢失
+  DAMAGED       包裹破损
+  SHORTAGE      短少
+  DELAY         延误赔偿
+  WRONG_ITEM    错发
+```

package/skill/reference/track.md

@@ -55,3 +55,108 @@ fmc track get FPX12345678 --dry-run
   2024-01-14 08:00  洛杉矶    海关放行
   2024-01-10 14:20  深圳      已发出
 ```
+
+---
+
+### `fmc track sub order`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `track sub order` |
+| **Description** | 查询轨迹订阅订单列表 |
+| **Usage** | `fmc track sub order [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--track-nos <nos>` | string | yes | 运单号，多个用英文逗号分隔 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc track sub order --track-nos FPX12345678
+```
+
+```bash
+fmc track sub order --track-nos FPX111,FPX222 --page 1 --size 20
+```
+
+```bash
+fmc track sub order --track-nos FPX12345678 --output json
+```
+
+#### Output (text mode)
+
+```
+轨迹订阅订单
+──────────────────────────────────────────────────
+  页码 1/1  共 1 条
+
+  FPX12345678
+    订阅状态    已订阅
+    产品代码    STANDARD
+    目的国      US
+    订阅时间    2024-01-10 09:00:00
+```
+
+---
+
+### `fmc track sub product`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `track sub product` |
+| **Description** | 查询轨迹订阅产品列表 |
+| **Usage** | `fmc track sub product [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--product-code <code>` | string | no | 产品代码筛选 |
+| `--country-code <code>` | string | no | 国家二字码筛选 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc track sub product
+```
+
+```bash
+fmc track sub product --product-code STANDARD --country-code US
+```
+
+```bash
+fmc track sub product --output json
+```
+
+#### Output (text mode)
+
+```
+轨迹订阅产品
+──────────────────────────────────────────────────
+  页码 1/1  共 2 条
+
+  STANDARD
+    产品名称    标准快递
+    国家代码    US
+    订阅状态    已启用
+
+  ECO-PKG
+    产品名称    经济小包
+    国家代码    GB
+    订阅状态    已启用
+```