cbs-4px-merchant-cli 0.0.1 → 0.0.2

package/skill/reference/pickup.md

@@ -0,0 +1,222 @@
+# `fmc pickup` command
+
+## Command details
+
+### `fmc pickup material list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `pickup material list` |
+| **Description** | 查询物料申请单列表 |
+| **Usage** | `fmc pickup material list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--order-nos <nos>` | string | no | 申请单号，多个用英文逗号分隔 |
+| `--status <status>` | string | no | 申请状态筛选 |
+| `--material-type <type>` | string | no | 物料类型筛选 |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc pickup material list
+```
+
+```bash
+fmc pickup material list --order-nos MAT20240115001
+```
+
+```bash
+fmc pickup material list --status PENDING --material-type 面单纸
+```
+
+```bash
+fmc pickup material list --page 1 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+物料申请列表
+──────────────────────────────────────────────────
+  页码 1/1  共 2 条
+
+  MAT20240115001  待发货
+    物料类型    面单纸
+    物料描述    热敏面单纸
+    申请总量    500
+    申请人      张三
+    申请时间    2024-01-15 10:30:00
+
+  MAT20240110001  已完成
+    物料类型    包装袋
+    物料描述    快递包装袋
+    申请总量    200
+    申请人      李四
+    申请时间    2024-01-10 09:00:00
+```
+
+---
+
+### `fmc pickup material detail`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `pickup material detail` |
+| **Description** | 查询物料申请单详情 |
+| **Usage** | `fmc pickup material detail <orderNo> [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `<orderNo>` | string | yes | 物料申请单号 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc pickup material detail MAT20240115001
+```
+
+```bash
+fmc pickup material detail MAT20240115001 --output json
+```
+
+#### Output (text mode)
+
+```
+物料申请详情
+──────────────────────────────────────────────────
+  申请单号    MAT20240115001
+  状态        待发货
+  物料类型    热敏面单纸
+  申请类型    首次申请
+  申请人      张三
+  申请数量    5 捆
+  总数量      2500
+  网点        深圳南山网点
+  申请时间    2024-01-15 10:30:00
+
+  联系人
+  ────────────────────────────────────
+    姓名    张三
+    电话    13800138000
+    地址    广东省 深圳市 南山区 科技园路1号
+    邮编    518000
+
+  申请轨迹
+  ────────────────────────────────────
+    2024-01-15 10:30:00  已提交
+      物料申请已提交
+    2024-01-15 14:00:00  已审核
+      审核通过，准备发货
+```
+
+---
+
+### `fmc pickup material quota`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `pickup material quota` |
+| **Description** | 查询本月物料申请额度 |
+| **Usage** | `fmc pickup material quota [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--bundle <num>` | number | yes | 本次拟申请捆数 |
+| `--apply-type <type>` | string | no | 申请类型 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc pickup material quota --bundle 5
+```
+
+```bash
+fmc pickup material quota --bundle 10 --output json
+```
+
+#### Output (text mode)
+
+```
+本月物料申请额度
+──────────────────────────────────────────────────
+  总额度        20 捆
+  已申请        5 捆
+  剩余可申请    15 捆
+  每捆数量      500
+  每包数量      100
+  总数量        10000
+  最大申请次数  5
+```
+
+---
+
+### `fmc pickup address list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `pickup address list` |
+| **Description** | 查询揽收地址列表 |
+| **Usage** | `fmc pickup address 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 pickup address list
+```
+
+```bash
+fmc pickup address list --keyword 深圳
+```
+
+```bash
+fmc pickup address list --page 1 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+揽收地址列表
+──────────────────────────────────────────────────
+  页码 1/1  共 2 条
+
+  张三  13800138000
+    地址    中国 广东省 深圳市 南山区 科技园路1号
+    邮编    518000
+
+  李四  13900139000
+    地址    中国 广东省 广州市 天河区 天河路2号
+    邮编    510000
+```

package/skill/reference/problem.md

@@ -0,0 +1,318 @@
+# `fmc problem` command
+
+## Command details
+
+### `fmc problem list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `problem list` |
+| **Description** | 查询问题件列表 |
+| **Usage** | `fmc problem list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--order-nos <nos>` | string | no | 单号，多个用逗号分隔 |
+| `--abnormal-status <status>` | string | no | 异常状态 |
+| `--abnormal-type <type>` | 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 problem list
+```
+
+```bash
+fmc problem list --order-nos FPX12345678
+```
+
+```bash
+fmc problem list --abnormal-status PENDING --page 1 --size 20
+```
+
+```bash
+fmc problem list --start-date 2024-01-01 --end-date 2024-06-30 --output json
+```
+
+#### Output (text mode)
+
+```
+问题件列表
+──────────────────────────────────────────────────
+  页码 1/3  共 25 条
+
+  FPX12345678  待处理
+    产品名称    标准快递
+    目的国      US
+    创建时间    2024-01-15 10:30:00
+    问题描述    收件地址信息不完整，缺少邮编
+```
+
+---
+
+### `fmc problem suggest`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `problem suggest` |
+| **Description** | 获取异常件 AI 处理建议 |
+| **Usage** | `fmc problem suggest [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--order-nos <nos>` | string | yes | 单号，多个用逗号分隔 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc problem suggest --order-nos FPX12345678
+```
+
+```bash
+fmc problem suggest --order-nos FPX111,FPX222 --output json
+```
+
+---
+
+### `fmc problem notify list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `problem notify list` |
+| **Description** | 查询通知件列表（仓外异常通知） |
+| **Usage** | `fmc problem notify list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc problem notify list
+```
+
+```bash
+fmc problem notify list --page 2 --size 20 --output json
+```
+
+#### Output (text mode)
+
+```
+通知问题件列表
+──────────────────────────────────────────────────
+  页码 1/1  共 3 条
+
+  FPX12345678  待处理
+    通知类型    地址异常
+    通知原因    收件地址不完整
+    产品名称    标准快递
+```
+
+---
+
+### `fmc problem notify type`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `problem notify type` |
+| **Description** | 查询尾程异常类型枚举列表 |
+| **Usage** | `fmc problem notify type [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+无额外参数。
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc problem notify type
+```
+
+```bash
+fmc problem notify type --output json
+```
+
+#### Output (text mode)
+
+```
+尾程异常类型列表
+────────────────────────────────────────
+  ADDR_ERR     地址异常
+  CUSTOMS      海关扣件
+  DELIVERY     派送失败
+  RETURN       退件
+```
+
+---
+
+### `fmc problem lastmile list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `problem lastmile list` |
+| **Description** | 查询尾程异常列表 |
+| **Usage** | `fmc problem lastmile list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--page <num>` | number | no | 页码，默认 1 |
+| `--size <num>` | number | no | 每页数量，默认 10 |
+
+支持全局选项: `--output`, `--verbose`, `--dry-run`
+
+#### Examples
+
+```bash
+fmc problem lastmile list
+```
+
+```bash
+fmc problem lastmile list --page 2 --output json
+```
+
+#### Output (text mode)
+
+```
+通知问题件列表
+──────────────────────────────────────────────────
+  页码 1/1  共 2 条
+
+  FPX12345678  待处理
+    通知类型    派送失败
+    通知描述    收件人不在家，无法投递
+    产品名称    标准快递
+```
+
+---
+
+### `fmc problem arrear list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `problem arrear list` |
+| **Description** | 查询欠费件列表 |
+| **Usage** | `fmc problem arrear 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 problem arrear list
+```
+
+```bash
+fmc problem arrear list --keyword FPX12345678
+```
+
+```bash
+fmc problem arrear list --output json
+```
+
+#### Output (text mode)
+
+```
+欠费订单列表
+──────────────────────────────────────────────────
+  页码 1/1  共 1 条
+
+  FPX12345678
+    产品名称    标准快递
+    欠费金额    15.00 USD
+    发生时间    2024-01-15 10:30:00
+```
+
+---
+
+### `fmc problem intercepted list`
+
+| Field | Value |
+| --- | --- |
+| **Name** | `problem intercepted list` |
+| **Description** | 查询拦截件列表 |
+| **Usage** | `fmc problem intercepted list [flags]` |
+
+需要 API Key 认证。
+
+#### Options
+
+| Flag | Type | Required | Description |
+| --- | --- | --- | --- |
+| `--customer-order-no <no>` | string | no | 客户订单号 |
+| `--fpx-track-no <no>` | 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 problem intercepted list
+```
+
+```bash
+fmc problem intercepted list --fpx-track-no FPX12345678
+```
+
+```bash
+fmc problem intercepted list --output json
+```
+
+#### Output (text mode)
+
+```
+拦截订单列表
+──────────────────────────────────────────────────
+  页码 1/1  共 1 条
+
+  FPX12345678  已拦截
+    客户单号    CUST001
+    产品名称    标准快递
+    目的国      US
+    创建时间    2024-01-15 10:30:00
+```