@youzan-cloud/zan-saas-cli 0.0.0-stage → 0.1.0-beta.4

package/src/commands/native/aftersale/case/scan/schema.json

@@ -0,0 +1,964 @@
+{
+  "schemaVersion": 1,
+  "input": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "scope": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "kdtId": {
+            "$ref": "#/definitions/shopId"
+          }
+        },
+        "required": [
+          "kdtId"
+        ]
+      },
+      "filters": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "orderNo": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\p{Cc}]+$",
+            "description": "精确交易订单号，一张订单可以关联多笔售后。"
+          },
+          "caseId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\p{Cc}]+$",
+            "description": "精确售后单号，非订单号、资金条目号或物流单号。"
+          },
+          "yzOpenId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\p{Cc}]+$",
+            "description": "有赞客户标识，非员工身份；预览遮盖。"
+          },
+          "buyerPhone": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "pattern": "^[^\\s\\p{Cc}](?:[^\\p{Cc}]*[^\\s\\p{Cc}])?$",
+            "description": "买家电话，无首尾空白或控制字符；预览遮盖。"
+          },
+          "demand": {
+            "type": "integer",
+            "enum": [
+              1,
+              2,
+              3
+            ],
+            "description": "申请诉求：1=仅退款；2=退货退款；3=换货；未知请求值拒绝。"
+          },
+          "status": {
+            "type": "string",
+            "$ref": "#/definitions/caseStatusFilter",
+            "description": "售后状态筛选。WAIT_SELLER_AGREE=等待卖家同意；WAIT_BUYER_RETURN_GOODS=等待买家退货；WAIT_SELLER_CONFIRM_GOODS=等待卖家确认收货；SELLER_REFUSE_BUYER=卖家拒绝退款；CLOSED=退款关闭；SUCCESS=退款成功；SELLER_REFUSE_BUYER_RETURN_GOODS=卖家拒绝收货等待买家处理；SELLER_RETURN_GOODS=商家确认收货并发送换货；CUSTOMER_SERVICE_IN=客满介入。未知请求值拒绝。"
+          },
+          "type": {
+            "type": "integer",
+            "enum": [
+              1,
+              2,
+              3,
+              4,
+              5
+            ],
+            "description": "申请类型：1=买家申请退款；2=商家主动退款；3=一键退款；4=零售门店换货；5=微商城换货。"
+          },
+          "phase": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "阶段：1=售中；2=售后。"
+          },
+          "handlingStatus": {
+            "type": "integer",
+            "enum": [
+              0,
+              1,
+              2
+            ],
+            "description": "待处理方：0=待商家处理；1=待买家处理；2=客服介入中。"
+          },
+          "serviceStatus": {
+            "type": "integer",
+            "enum": [
+              1,
+              2,
+              3
+            ],
+            "description": "客服介入筛选：1=不需要客服介入；2=需要客服介入；3=介入结束；不是响应字典。"
+          },
+          "itemTitle": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[^\\s\\p{Cc}](?:[^\\p{Cc}]*[^\\s\\p{Cc}])?$",
+            "description": "商品名称搜索文本，不保证匹配算法；预览遮盖。"
+          },
+          "skuNo": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[^\\s\\p{Cc}](?:[^\\p{Cc}]*[^\\s\\p{Cc}])?$",
+            "description": "商品规格编码，不是商品ID。"
+          },
+          "deliveryStatus": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "发货筛选：1=未发货；2=已发货，不证明退货物流结果。"
+          },
+          "refundMode": {
+            "type": "integer",
+            "enum": [
+              0,
+              1,
+              2
+            ],
+            "description": "退款方式筛选：0=原路退；1=现金退；2=标记退。"
+          },
+          "returnStockStatus": {
+            "type": "integer",
+            "enum": [
+              0,
+              10,
+              20
+            ],
+            "description": "库存归还筛选：0=无需入库；10=待入库；20=归还库存成功。"
+          },
+          "saleWay": {
+            "type": "integer",
+            "enum": [
+              1,
+              2
+            ],
+            "description": "销售渠道：1=门店；2=网店。"
+          },
+          "payType": {
+            "type": "integer",
+            "enum": [
+              0,
+              1,
+              2,
+              3,
+              4,
+              5,
+              6,
+              7,
+              8
+            ],
+            "description": "支付类型：0=老方式，支付方式与渠道合并；1=无需支付；2=现付；3=部分支付；4=货到付款；5=线下收银；6=单次支付；7=阶段支付；8=外部支付。"
+          }
+        },
+        "required": []
+      },
+      "range": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "created": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "start": {
+                "$ref": "#/definitions/time"
+              },
+              "end": {
+                "$ref": "#/definitions/time"
+              }
+            },
+            "required": [
+              "start",
+              "end"
+            ],
+            "description": "北京时间三位毫秒文本，须为整秒且开始严格早于结束；不承诺端点包含性。"
+          },
+          "updated": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "start": {
+                "$ref": "#/definitions/time"
+              },
+              "end": {
+                "$ref": "#/definitions/time"
+              }
+            },
+            "required": [
+              "start",
+              "end"
+            ],
+            "description": "北京时间三位毫秒文本，须为整秒且开始严格早于结束；不承诺端点包含性。"
+          }
+        },
+        "required": [
+          "created"
+        ]
+      },
+      "limits": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "maxItems": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2000,
+            "description": "唯一摘要数量预算，不裁切整页，不保证返回该数量。"
+          },
+          "maxRequests": {
+            "type": "integer",
+            "minimum": 2,
+            "maximum": 101,
+            "description": "总业务请求预算，包含店铺核验及未提交页，无自动重试。"
+          }
+        },
+        "required": [
+          "maxItems",
+          "maxRequests"
+        ]
+      }
+    },
+    "required": [
+      "scope",
+      "filters",
+      "range",
+      "limits"
+    ]
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "cases": {
+            "type": "array",
+            "maxItems": 2000,
+            "items": {
+              "$ref": "#/definitions/caseSummary"
+            },
+            "description": "已完整提交页中首次出现的售后摘要，按店铺及售后号去重；有限观察，不是全集。"
+          },
+          "pagination": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "maxItems": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 2000,
+                "description": "唯一摘要数量预算，不裁切整页，不保证返回该数量。"
+              },
+              "maxRequests": {
+                "type": "integer",
+                "minimum": 2,
+                "maximum": 101,
+                "description": "总业务请求预算，包含店铺核验及未提交页，无自动重试。"
+              },
+              "requests": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 101,
+                "description": "实际发送次数，含绑定与未提交页。"
+              },
+              "pages": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 100,
+                "description": "已提交整页数。"
+              },
+              "duplicates": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 2000,
+                "description": "已提交页中相对先前结果的重复条目数，保留首次版本。"
+              },
+              "pageSize": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 20,
+                "description": "固定为min(20,maxItems)，不会随剩余预算缩小。"
+              },
+              "total": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991,
+                    "description": "最近校验页观察到的总数，不是快照或本地结果长度。"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "paginationExhausted": {
+                "type": "boolean",
+                "description": "仅range_exhausted为true，不等于无遗漏、永久完成或快照一致。"
+              },
+              "stopReason": {
+                "type": "string",
+                "enum": [
+                  "range_exhausted",
+                  "max_items",
+                  "max_requests",
+                  "page_window",
+                  "total_unknown",
+                  "collection_changed",
+                  "no_progress"
+                ],
+                "description": "range_exhausted=按本次观察总数到达页末，仍不保证完整；max_items=下一整页可能超过数量预算；max_requests=请求预算耗尽；page_window=下一页超过页码或深度限制；total_unknown=未取得或失去总数，不猜末页；collection_changed=总数变化，变化页不提交；no_progress=非空页没有新增ID，停止防止重复翻页。"
+              },
+              "lastRead": {
+                "anyOf": [
+                  {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "pageNo": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 100,
+                        "description": "最近校验页，可能未提交。"
+                      },
+                      "pageSize": {
+                        "type": "integer",
+                        "minimum": 1,
+                        "maximum": 20,
+                        "description": "本次固定页大小。"
+                      }
+                    },
+                    "required": [
+                      "pageNo",
+                      "pageSize"
+                    ]
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "lastCommittedPageNo": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 100,
+                    "description": "最后提交的整页；无则null。不是可靠恢复游标。"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "maxItems",
+              "maxRequests",
+              "requests",
+              "pages",
+              "duplicates",
+              "pageSize",
+              "total",
+              "paginationExhausted",
+              "stopReason",
+              "lastRead",
+              "lastCommittedPageNo"
+            ]
+          }
+        },
+        "required": [
+          "cases",
+          "pagination"
+        ]
+      }
+    },
+    "required": [
+      "data"
+    ]
+  },
+  "preview": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "requests": {
+        "type": "array",
+        "minItems": 2,
+        "maxItems": 2,
+        "items": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "method": {
+                "const": "POST"
+              },
+              "path": {
+                "const": "youzan.shop.basic.get/3.0.0"
+              },
+              "body": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {},
+                "required": []
+              }
+            },
+            "required": [
+              "method",
+              "path",
+              "body"
+            ]
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "method": {
+                "const": "POST"
+              },
+              "path": {
+                "const": "youzan.trade.refund.search/3.0.1"
+              },
+              "body": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "page_no": {
+                    "type": "integer",
+                    "const": 1,
+                    "description": "首个列表请求从第1页开始。"
+                  },
+                  "page_size": {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 20,
+                    "description": "固定页大小。"
+                  },
+                  "tid": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[^\\s\\p{Cc}]+$",
+                    "description": "精确交易订单号，一张订单可以关联多笔售后。"
+                  },
+                  "refund_id": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[^\\s\\p{Cc}]+$",
+                    "description": "精确售后单号，非订单号、资金条目号或物流单号。"
+                  },
+                  "yz_open_id": {
+                    "type": "string",
+                    "const": "***",
+                    "description": "本地预览的遮盖值，真实请求使用原值。"
+                  },
+                  "buyer_phone": {
+                    "type": "string",
+                    "const": "***",
+                    "description": "本地预览的遮盖值，真实请求使用原值。"
+                  },
+                  "demand": {
+                    "type": "integer",
+                    "enum": [
+                      1,
+                      2,
+                      3
+                    ],
+                    "description": "申请诉求：1=仅退款；2=退货退款；3=换货；未知请求值拒绝。"
+                  },
+                  "status": {
+                    "type": "string",
+                    "$ref": "#/definitions/caseStatusFilter",
+                    "description": "售后状态筛选。WAIT_SELLER_AGREE=等待卖家同意；WAIT_BUYER_RETURN_GOODS=等待买家退货；WAIT_SELLER_CONFIRM_GOODS=等待卖家确认收货；SELLER_REFUSE_BUYER=卖家拒绝退款；CLOSED=退款关闭；SUCCESS=退款成功；SELLER_REFUSE_BUYER_RETURN_GOODS=卖家拒绝收货等待买家处理；SELLER_RETURN_GOODS=商家确认收货并发送换货；CUSTOMER_SERVICE_IN=客满介入。未知请求值拒绝。"
+                  },
+                  "type": {
+                    "type": "integer",
+                    "enum": [
+                      1,
+                      2,
+                      3,
+                      4,
+                      5
+                    ],
+                    "description": "申请类型：1=买家申请退款；2=商家主动退款；3=一键退款；4=零售门店换货；5=微商城换货。"
+                  },
+                  "phase": {
+                    "type": "integer",
+                    "enum": [
+                      1,
+                      2
+                    ],
+                    "description": "阶段：1=售中；2=售后。"
+                  },
+                  "search_tag": {
+                    "type": "integer",
+                    "enum": [
+                      0,
+                      1,
+                      2
+                    ],
+                    "description": "待处理方：0=待商家处理；1=待买家处理；2=客服介入中。"
+                  },
+                  "cs_status": {
+                    "type": "integer",
+                    "enum": [
+                      1,
+                      2,
+                      3
+                    ],
+                    "description": "客服介入筛选：1=不需要客服介入；2=需要客服介入；3=介入结束；不是响应字典。"
+                  },
+                  "goods_title": {
+                    "type": "string",
+                    "const": "***",
+                    "description": "本地预览的遮盖值，真实请求使用原值。"
+                  },
+                  "sku_no": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 128,
+                    "pattern": "^[^\\s\\p{Cc}](?:[^\\p{Cc}]*[^\\s\\p{Cc}])?$",
+                    "description": "商品规格编码，不是商品ID。"
+                  },
+                  "delivery_status": {
+                    "type": "integer",
+                    "enum": [
+                      1,
+                      2
+                    ],
+                    "description": "发货筛选：1=未发货；2=已发货，不证明退货物流结果。"
+                  },
+                  "refund_mode": {
+                    "type": "integer",
+                    "enum": [
+                      0,
+                      1,
+                      2
+                    ],
+                    "description": "退款方式筛选：0=原路退；1=现金退；2=标记退。"
+                  },
+                  "return_stock_status": {
+                    "type": "integer",
+                    "enum": [
+                      0,
+                      10,
+                      20
+                    ],
+                    "description": "库存归还筛选：0=无需入库；10=待入库；20=归还库存成功。"
+                  },
+                  "sale_way": {
+                    "type": "integer",
+                    "enum": [
+                      1,
+                      2
+                    ],
+                    "description": "销售渠道：1=门店；2=网店。"
+                  },
+                  "pay_type": {
+                    "type": "integer",
+                    "enum": [
+                      0,
+                      1,
+                      2,
+                      3,
+                      4,
+                      5,
+                      6,
+                      7,
+                      8
+                    ],
+                    "description": "支付类型：0=老方式，支付方式与渠道合并；1=无需支付；2=现付；3=部分支付；4=货到付款；5=线下收银；6=单次支付；7=阶段支付；8=外部支付。"
+                  },
+                  "create_time_start": {
+                    "type": "integer",
+                    "minimum": -62135625600,
+                    "maximum": 253402271999,
+                    "description": "北京时间输入编码的整秒时间戳；不承诺端点包含性。"
+                  },
+                  "create_time_end": {
+                    "type": "integer",
+                    "minimum": -62135625600,
+                    "maximum": 253402271999,
+                    "description": "北京时间输入编码的整秒时间戳；不承诺端点包含性。"
+                  },
+                  "update_time_start": {
+                    "type": "integer",
+                    "minimum": -62135625600,
+                    "maximum": 253402271999,
+                    "description": "北京时间输入编码的整秒时间戳；不承诺端点包含性。"
+                  },
+                  "update_time_end": {
+                    "type": "integer",
+                    "minimum": -62135625600,
+                    "maximum": 253402271999,
+                    "description": "北京时间输入编码的整秒时间戳；不承诺端点包含性。"
+                  }
+                },
+                "required": [
+                  "page_no",
+                  "page_size",
+                  "create_time_start",
+                  "create_time_end"
+                ]
+              }
+            },
+            "required": [
+              "method",
+              "path",
+              "body"
+            ]
+          }
+        ],
+        "additionalItems": false,
+        "description": "绑定与首个列表请求，仅描述确定计划，不表示只读一页。"
+      },
+      "strategy": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "min(20,maxItems)，全程固定。"
+          },
+          "startPageNo": {
+            "const": 1
+          },
+          "maxPageNo": {
+            "const": 100
+          },
+          "maxDepth": {
+            "const": 3000
+          },
+          "maxItems": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2000,
+            "description": "唯一摘要数量预算，不裁切整页，不保证返回该数量。"
+          },
+          "maxRequests": {
+            "type": "integer",
+            "minimum": 2,
+            "maximum": 101,
+            "description": "总业务请求预算，包含店铺核验及未提交页，无自动重试。"
+          },
+          "autoSplit": {
+            "const": false
+          },
+          "autoRetry": {
+            "const": false
+          }
+        },
+        "required": [
+          "pageSize",
+          "startPageNo",
+          "maxPageNo",
+          "maxDepth",
+          "maxItems",
+          "maxRequests",
+          "autoSplit",
+          "autoRetry"
+        ]
+      }
+    },
+    "required": [
+      "requests",
+      "strategy"
+    ]
+  },
+  "error": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "success": {
+        "const": false
+      },
+      "code": {
+        "const": -10001
+      },
+      "message": {
+        "type": "string",
+        "minLength": 1,
+        "description": "受控错误说明，不回显上游自由文本。"
+      },
+      "details": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "category": {
+            "type": "string",
+            "enum": [
+              "validation",
+              "configuration",
+              "authentication",
+              "permission",
+              "scope_unresolved",
+              "http",
+              "business_rejected",
+              "not_found",
+              "protocol",
+              "transport",
+              "limit"
+            ],
+            "description": "失败分类；正常预算停止不是错误。"
+          },
+          "stage": {
+            "type": "string",
+            "enum": [
+              "input",
+              "context",
+              "configuration",
+              "shop-binding",
+              "case",
+              "cases",
+              "refunds",
+              "output-model",
+              "transport",
+              "response"
+            ],
+            "description": "失败阶段。"
+          },
+          "command": {
+            "const": "aftersale.case.scan"
+          },
+          "targetScope": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "kdtId": {
+                "$ref": "#/definitions/shopId"
+              }
+            },
+            "required": []
+          },
+          "requestState": {
+            "type": "string",
+            "enum": [
+              "not_sent",
+              "sent",
+              "unknown"
+            ],
+            "description": "not_sent=尚未发送当前阶段请求；sent=已发送并取得响应；unknown=请求结果不明，不自动重放。"
+          },
+          "nextStep": {
+            "type": "string",
+            "minLength": 1,
+            "description": "在原范围停止核查，不自动重试或切换身份。"
+          },
+          "api": {
+            "type": "string",
+            "minLength": 1,
+            "description": "准确API名与版本，不含URL或凭据。"
+          },
+          "httpStatus": {
+            "type": "integer",
+            "minimum": 100,
+            "maximum": 599,
+            "description": "已观察HTTP状态。"
+          },
+          "businessCode": {
+            "$ref": "#/definitions/diagnosticCode"
+          },
+          "gatewayCode": {
+            "$ref": "#/definitions/diagnosticCode"
+          },
+          "trace_id": {
+            "$ref": "#/definitions/diagnosticId"
+          },
+          "request_id": {
+            "$ref": "#/definitions/diagnosticId"
+          },
+          "progress": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "requests": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 101,
+                "description": "已发送次数，含绑定。"
+              },
+              "pages": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 100,
+                "description": "已提交页数。"
+              },
+              "lastCommittedPageNo": {
+                "anyOf": [
+                  {
+                    "type": "integer",
+                    "minimum": 1,
+                    "maximum": 100,
+                    "description": "最后提交页，不是恢复游标。"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "requests",
+              "pages",
+              "lastCommittedPageNo"
+            ]
+          }
+        },
+        "required": [
+          "category",
+          "stage",
+          "command",
+          "targetScope",
+          "requestState",
+          "nextStep"
+        ]
+      }
+    },
+    "required": [
+      "success",
+      "code",
+      "message"
+    ]
+  },
+  "definitions": {
+    "shopId": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991,
+      "description": "目标店铺ID，正安全整数，必须与当前店铺及凭证绑定一致。"
+    },
+    "time": {
+      "type": "string",
+      "format": "beijing-date-time-ms",
+      "description": "北京时间YYYY-MM-DD HH:mm:ss.SSS；输出保留三位毫秒，输入范围只接受整秒。"
+    },
+    "caseStatusFilter": {
+      "type": "string",
+      "enum": [
+        "WAIT_SELLER_AGREE",
+        "WAIT_BUYER_RETURN_GOODS",
+        "WAIT_SELLER_CONFIRM_GOODS",
+        "SELLER_REFUSE_BUYER",
+        "CLOSED",
+        "SUCCESS",
+        "CUSTOMER_SERVICE_IN",
+        "SELLER_REFUSE_BUYER_RETURN_GOODS",
+        "SELLER_RETURN_GOODS"
+      ],
+      "description": "售后状态筛选。WAIT_SELLER_AGREE=等待卖家同意；WAIT_BUYER_RETURN_GOODS=等待买家退货；WAIT_SELLER_CONFIRM_GOODS=等待卖家确认收货；SELLER_REFUSE_BUYER=卖家拒绝退款；CLOSED=退款关闭；SUCCESS=退款成功；SELLER_REFUSE_BUYER_RETURN_GOODS=卖家拒绝收货等待买家处理；SELLER_RETURN_GOODS=商家确认收货并发送换货；CUSTOMER_SERVICE_IN=客满介入。未知请求值拒绝。"
+    },
+    "caseSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "caseId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[^\\s\\p{Cc}]+$",
+          "description": "店铺范围内售后单号，非资金条目号。"
+        },
+        "orderNo": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[^\\s\\p{Cc}]+$",
+          "description": "关联交易订单号，不按订单号去重。"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        },
+        "nodeKdtId": {
+          "$ref": "#/definitions/shopId"
+        },
+        "status": {
+          "type": "string",
+          "minLength": 1,
+          "description": "售后状态。WAIT_SELLER_AGREE=等待卖家同意；WAIT_BUYER_RETURN_GOODS=等待买家退货；WAIT_SELLER_CONFIRM_GOODS=等待卖家确认收货；SELLER_REFUSE_BUYER=卖家拒绝退款；CLOSED=退款关闭；SUCCESS=退款成功；SELLER_REFUSE_BUYER_RETURN_GOODS=卖家拒绝收货等待买家处理；SELLER_RETURN_GOODS=商家确认收货并发送换货；CUSTOMER_SERVICE_IN=客满介入。未来非空文本保留，不猜含义。"
+        },
+        "amount": {
+          "type": "string",
+          "pattern": "^(0|[1-9]\\d*)\\.\\d{2}$",
+          "description": "申请退款金额，CNY元，两位小数。精确分值0..9223372036854775807，不代表已退款或到账。"
+        },
+        "hasReturnGoods": {
+          "type": "boolean",
+          "description": "上游是否有退货的事实，可选，false保留。"
+        },
+        "createdAt": {
+          "$ref": "#/definitions/time"
+        },
+        "updatedAt": {
+          "$ref": "#/definitions/time"
+        },
+        "serviceStatus": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "客服响应状态：1=客满未介入；2=客满介入中；未知安全整数保留，不套请求字典。"
+        },
+        "deliveryStatus": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "发货状态：1=未发货；2=已发货；未知安全整数保留。"
+        }
+      },
+      "required": [
+        "caseId",
+        "orderNo",
+        "kdtId",
+        "status",
+        "amount"
+      ],
+      "description": "售后摘要；可选字段缺失时省略，显式null或错型失败。"
+    },
+    "diagnosticCode": {
+      "anyOf": [
+        {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        {
+          "type": "string",
+          "pattern": "^-?\\d{1,12}$"
+        }
+      ],
+      "description": "已观察的安全诊断码。"
+    },
+    "diagnosticId": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9_-]{1,128}$",
+      "description": "通过安全白名单的诊断标识。"
+    }
+  },
+  "notes": [
+    "--kdt-id 省略时使用本次有效上下文 shopId；显式提供的非法值不回退。两者都缺失时拒绝；目标范围、同店核验和服务端权限仍按本命令校验。",
+    "本命令仅限orgType=shop且目标与context.shopId一致；缺上下文只允许显式店铺本地预览，无效上下文仍拒绝。",
+    "规范化input是业务模型，不是JSON入参；format与dry-run不进入该模型。",
+    "创建时间对与两个预算必填，更新时间对可选且仍受创建范围限定。未知枚举、重复单值选项及多余参数拒绝。",
+    "每页整页验证、整页提交，按店铺及售后号保留首次版本；total缺失不猜末页，total变化页不提交。",
+    "停止优先级：协议或范围错误；total变化、缺失、无进展；观察总数页末；数量预算；请求预算；页窗。",
+    "响应累计10MiB，最终JSON含换行5MiB；失败丢弃已读结果，stdout为空，stderr错误JSON且非零退出。",
+    "分页走完不等于无遗漏；不承诺快照、可靠增量或可恢复游标，不自动二分、持久化、重试或换店。"
+  ]
+}