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

package/src/commands/native/order/order/scan/schema.json

@@ -0,0 +1,1445 @@
+{
+  "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": {
+          "yzOpenId": {
+            "type": "string",
+            "minLength": 1,
+            "description": "客户统一标识，非员工ID或手机号，非空文本。"
+          },
+          "status": {
+            "type": "string",
+            "minLength": 1,
+            "enum": [
+              "WAIT_BUYER_PAY",
+              "WAIT_SELLER_SEND_GOODS",
+              "WAIT_BUYER_CONFIRM_GOODS",
+              "TRADE_SUCCESS",
+              "TRADE_CLOSED",
+              "TRADE_REFUND"
+            ],
+            "description": "WAIT_BUYER_PAY=等待买家付款，含适用预售定金或尾款；WAIT_SELLER_SEND_GOODS=等待卖家发货；WAIT_BUYER_CONFIRM_GOODS=等待买家确认收货；TRADE_SUCCESS=交易完成；TRADE_CLOSED=交易关闭；TRADE_REFUND=退款中，仅搜索条件，不是已知交易状态响应值。请求字符串，与响应字典分开，未知值拒绝。"
+          },
+          "type": {
+            "type": "string",
+            "minLength": 1,
+            "enum": [
+              "NORMAL",
+              "PEERPAY",
+              "GIFT",
+              "FX_CAIGOUDAN",
+              "PRESENT",
+              "WISH",
+              "QRCODE",
+              "QRCODE_3RD",
+              "FX_MERGED",
+              "VERIFIED",
+              "PINJIAN",
+              "REBATE",
+              "FX_QUANYUANDIAN",
+              "FX_DEPOSIT",
+              "PF",
+              "GROUP",
+              "HOTEL",
+              "TAKE_AWAY",
+              "CATERING_OFFLINE",
+              "CATERING_QRCODE",
+              "BEAUTY_APPOINTMENT",
+              "BEAUTY_SERVICE",
+              "KNOWLEDGE_PAY",
+              "GIFT_CARD"
+            ],
+            "description": "NORMAL=普通订单；PEERPAY=代付；GIFT=我要送人；FX_CAIGOUDAN=分销供货单；PRESENT=赠品；WISH=心愿单；QRCODE=二维码订单；QRCODE_3RD=线下收银台；FX_MERGED=合并付货款；VERIFIED=1分钱实名认证；PINJIAN=品鉴；REBATE=返利；FX_QUANYUANDIAN=全员开店；FX_DEPOSIT=分销保证金；PF=批发；GROUP=拼团；HOTEL=酒店；TAKE_AWAY=外卖；CATERING_OFFLINE=堂食点餐；CATERING_QRCODE=外卖买单；BEAUTY_APPOINTMENT=美业预约；BEAUTY_SERVICE=美业服务；KNOWLEDGE_PAY=知识付费；GIFT_CARD=礼品卡。请求字符串，与响应字典分开，未知值拒绝。"
+          },
+          "item_id": {
+            "$ref": "#/definitions/id",
+            "description": "OneID商品ID，沿用统一商品筛选；当前仅接受正安全整数范围。"
+          },
+          "itemTitle": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "商品名称模糊搜索，最长200字符为CLI预算。"
+          },
+          "receiverPhone": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 20,
+            "description": "收货人电话，非买家手机号，最长20字符。"
+          },
+          "receiverName": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 50,
+            "description": "收货人姓名，最长50字符。"
+          },
+          "deliveryType": {
+            "type": "string",
+            "minLength": 1,
+            "enum": [
+              "EXPRESS",
+              "SELF_FETCH",
+              "LOCAL_DELIVERY"
+            ],
+            "description": "EXPRESS=快递发货；SELF_FETCH=到店自提；LOCAL_DELIVERY=同城配送。请求字符串，与响应字典分开，未知值拒绝。"
+          },
+          "keyword": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200,
+            "description": "订单号、收货人手机或后四位，最长200字符为CLI预算。"
+          }
+        },
+        "description": "可选非时间筛选，每个区间及翻页保持全部已指定条件，不补默认状态或类型。"
+      },
+      "range": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "start": {
+            "$ref": "#/definitions/time"
+          },
+          "end": {
+            "$ref": "#/definitions/time"
+          }
+        },
+        "required": [
+          "start",
+          "end"
+        ],
+        "description": "所选时间轴的显式范围，开始不早于2020年，结束严格晚于开始、不晚于固定当前时刻，跨度最多一日历年。仅接收秒精度，非零毫秒拒绝。--created-at 与 --paid-at 必须二选一，START..END 必须包含分隔符和两端，不补边界。"
+      },
+      "timeField": {
+        "type": "string",
+        "enum": [
+          "createdAt",
+          "paidAt"
+        ],
+        "description": "由所选 --created-at 或 --paid-at 派生的时间轴，不是额外CLI参数。所有切窗、二分、翻页、预览与停止范围沿用此轴；支付轴不附加创建约束。"
+      },
+      "include": {
+        "type": "array",
+        "uniqueItems": true,
+        "items": {
+          "type": "string",
+          "enum": [
+            "items",
+            "payment",
+            "buyer",
+            "address",
+            "remark",
+            "source",
+            "aftersale",
+            "fulfillment"
+          ]
+        }
+      },
+      "format": {
+        "type": "string",
+        "enum": [
+          "json",
+          "pretty"
+        ]
+      },
+      "dryRun": {
+        "type": "boolean"
+      },
+      "limits": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "maxItems": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10000,
+            "description": "去重结果上限，默认1000；剩余预算不足下一整页时不再发送，不裁切整页。"
+          },
+          "maxRequests": {
+            "type": "integer",
+            "minimum": 2,
+            "maximum": 500,
+            "description": "总请求上限，默认100；包括一次店铺核验、全部探测和翻页，不自动重试。"
+          }
+        },
+        "required": [
+          "maxItems",
+          "maxRequests"
+        ]
+      }
+    },
+    "required": [
+      "scope",
+      "filters",
+      "range",
+      "timeField",
+      "limits",
+      "include",
+      "format",
+      "dryRun"
+    ]
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "orders": {
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/orderRow"
+            },
+            "maxItems": 10000
+          },
+          "pagination": {
+            "$ref": "#/definitions/pagination"
+          }
+        },
+        "required": [
+          "orders",
+          "pagination"
+        ]
+      }
+    },
+    "required": [
+      "data"
+    ]
+  },
+  "preview": {
+    "type": "object",
+    "description": "仅本地计划，不读取凭证或发送请求；requestTemplate.body 中 receiver_phone、receiver_name、keywords 全部遮盖为 ***，不修改规范化输入或真实请求筛选。",
+    "additionalProperties": false,
+    "properties": {
+      "requests": {
+        "type": "array",
+        "minItems": 1,
+        "maxItems": 1,
+        "items": {
+          "$ref": "#/definitions/bindingRequest"
+        }
+      },
+      "initialRanges": {
+        "type": "array",
+        "minItems": 1,
+        "maxItems": 5,
+        "items": {
+          "$ref": "#/definitions/timeRange"
+        },
+        "description": "全部本地初始区间，按开始时间升序，未执行远端探测。"
+      },
+      "requestTemplate": {
+        "$ref": "#/definitions/listRequest"
+      },
+      "limits": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "maxItems": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10000,
+            "description": "去重结果上限，默认1000；剩余预算不足下一整页时不再发送，不裁切整页。"
+          },
+          "maxRequests": {
+            "type": "integer",
+            "minimum": 2,
+            "maximum": 500,
+            "description": "总请求上限，默认100；包括一次店铺核验、全部探测和翻页，不自动重试。"
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "整个扫描固定 min(100,maxItems)。"
+          }
+        },
+        "required": [
+          "maxItems",
+          "maxRequests",
+          "pageSize"
+        ]
+      }
+    },
+    "required": [
+      "requests",
+      "initialRanges",
+      "requestTemplate",
+      "limits"
+    ]
+  },
+  "error": {
+    "type": "object",
+    "required": [
+      "success",
+      "code",
+      "message",
+      "details"
+    ],
+    "additionalProperties": false,
+    "properties": {
+      "success": {
+        "const": false
+      },
+      "code": {
+        "const": -10001
+      },
+      "message": {
+        "type": "string",
+        "minLength": 1
+      },
+      "details": {
+        "type": "object",
+        "required": [
+          "category",
+          "stage",
+          "command",
+          "targetScope",
+          "requestState",
+          "nextStep",
+          "errorVersion",
+          "recovery",
+          "execution"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "category": {
+            "type": "string",
+            "enum": [
+              "validation",
+              "configuration",
+              "authentication",
+              "permission",
+              "scope_unresolved",
+              "http",
+              "business_rejected",
+              "transport",
+              "protocol",
+              "limit"
+            ]
+          },
+          "stage": {
+            "type": "string",
+            "enum": [
+              "input",
+              "context",
+              "configuration",
+              "shop-binding",
+              "order",
+              "orders",
+              "scan",
+              "output-model"
+            ]
+          },
+          "command": {
+            "const": "order.order.scan"
+          },
+          "targetScope": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "kdtId": {
+                "$ref": "#/definitions/shopId"
+              }
+            },
+            "required": []
+          },
+          "requestState": {
+            "enum": [
+              "not_sent",
+              "sent",
+              "unknown"
+            ]
+          },
+          "nextStep": {
+            "type": "string",
+            "minLength": 1
+          },
+          "api": {
+            "type": "string"
+          },
+          "httpStatus": {
+            "type": "integer"
+          },
+          "businessCode": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              {
+                "type": "string",
+                "pattern": "^-?\\d{1,12}$"
+              }
+            ]
+          },
+          "gatewayCode": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991
+              },
+              {
+                "type": "string",
+                "pattern": "^-?\\d{1,12}$"
+              }
+            ]
+          },
+          "trace_id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,128}$"
+          },
+          "request_id": {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9_-]{1,128}$"
+          },
+          "errorVersion": {
+            "const": 2,
+            "description": "本命令采用错误诊断协议第二版。"
+          },
+          "issues": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 16,
+            "items": {
+              "$ref": "#/definitions/diagnosticIssue"
+            },
+            "description": "最多十六个已定位问题，不包含收到的原值。"
+          },
+          "issuesTruncated": {
+            "const": true,
+            "description": "问题超过返回上限，当前列表没有穷尽全部问题。"
+          },
+          "recovery": {
+            "$ref": "#/definitions/diagnosticRecovery",
+            "description": "受限的恢复说明，不会自动执行。"
+          },
+          "execution": {
+            "$ref": "#/definitions/diagnosticExecution",
+            "description": "整次调用的请求观察，独立于失败阶段的 requestState。"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "id": {
+      "type": "string",
+      "pattern": "^(?=.*[1-9])\\d+$",
+      "description": "十进制正整数 ID 字符串；上游 number 仅接受安全整数，字符串不经浮点转换。"
+    },
+    "shopId": {
+      "type": "string",
+      "pattern": "^[1-9]\\d*$",
+      "description": "显式目标店铺 ID，输入仅正安全整数；成功输出为实际订单所属店铺。"
+    },
+    "orderNo": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\s\\u0000-\\u001f\\u007f-\\u009f]+$(?![\\s\\S])",
+      "maxLength": 128,
+      "description": "原始交易订单号，最多 128 字符，不含空白或控制字符；不按前缀或位数判断有效性，不改写原值。"
+    },
+    "time": {
+      "type": "string",
+      "format": "beijing-date-time-ms",
+      "$comment": "upstream-time:text",
+      "description": "固定北京时间 YYYY-MM-DD HH:mm:ss.SSS；来源为文本且仅秒精度，拒绝非零毫秒、非法日历、时区及数字时间戳。"
+    },
+    "timeRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "start": {
+          "$ref": "#/definitions/time"
+        },
+        "end": {
+          "$ref": "#/definitions/time"
+        }
+      },
+      "required": [
+        "start",
+        "end"
+      ],
+      "description": "北京时间区间，按 input.timeField 解释为创建或支付时间。结束严格晚于开始，初始分片最多三日历月，相邻分片共享端点；未核实端点开闭。"
+    },
+    "money": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d{2}$",
+      "$comment": "upstream-money:yuan",
+      "description": "元金额字符串，无损补齐两位，不再次除以100；不接受负数、科学计数法、非零额外小数位或非字符串。不计算汇总；本命令默认以 CNY 计价，不新增币种字段或作汇率换算。"
+    },
+    "order": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "orderNo": {
+          "$ref": "#/definitions/nonemptyText",
+          "description": "交易订单号，不是退款单号或支付流水号。"
+        },
+        "kdtId": {
+          "$ref": "#/definitions/shopId"
+        },
+        "rootKdtId": {
+          "$ref": "#/definitions/id",
+          "description": "订单所属总部 ID；返回时须等于本次 context.hq，不以本地值补造。"
+        },
+        "status": {
+          "$ref": "#/definitions/nonemptyText",
+          "description": "状态字符串。WAIT_BUYER_PAY=待支付，TRADE_PAID=支付成功瞬态，WAIT_CONFIRM=待确认，WAIT_SELLER_SEND_GOODS=待发货，WAIT_BUYER_CONFIRM_GOODS=待收货，TRADE_SUCCESS=交易完成，TRADE_CLOSED=关闭；未来非空字符串原样保留，不编造标签。"
+        },
+        "statusText": {
+          "type": "string",
+          "description": "上游展示状态文案，不反推状态码。"
+        },
+        "type": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "业务类型。0普通、1老送礼、2代付、3分销供货、4赠品、5心愿、6二维码、7合并付货款、8一分钱实名、9品鉴、10拼团、15返利、35酒店、40外卖、41堂食、46外卖买单、51全员开店、61线下收银、71美业预约、72美业服务、75知识付费、81礼品卡、85爱逛直播、89样品、100批发。未知安全整数保留。"
+        },
+        "createdAt": {
+          "$ref": "#/definitions/time"
+        },
+        "paidAt": {
+          "$ref": "#/definitions/time",
+          "description": "可选订单支付时间，北京时间三位毫秒；未取得时省略，不证明未支付。不保证首笔、末笔或结清时间，也不是逐笔资金事件。"
+        },
+        "isPaid": {
+          "type": "boolean",
+          "description": "可选订单支付标记；true 表示已支付，false 表示未支付，未知时省略。不从状态、金额或支付时间推算。"
+        },
+        "updatedAt": {
+          "$ref": "#/definitions/time",
+          "description": "可选更新时间，不是快照版本。"
+        },
+        "shopName": {
+          "type": "string",
+          "description": "订单记录的店铺名，不作店铺归属锚点。"
+        }
+      },
+      "required": [
+        "orderNo",
+        "kdtId",
+        "status",
+        "type",
+        "createdAt"
+      ]
+    },
+    "orderItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "oid": {
+          "$ref": "#/definitions/nonemptyText",
+          "description": "交易明细 ID，不是商品或 SKU ID。"
+        },
+        "title": {
+          "type": "string",
+          "description": "成交商品名称，允许空文本。"
+        },
+        "quantity": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "本交易行商品数量，不是库存。"
+        },
+        "item_id": {
+          "$ref": "#/definitions/id",
+          "description": "OneID商品 ID；同一商品在分店及渠道间保持一致。"
+        },
+        "sku_id": {
+          "$ref": "#/definitions/sku_id",
+          "description": "OneID商品规格 ID，与所属商品一起解释。"
+        },
+        "channel_item_id": {
+          "$ref": "#/definitions/id",
+          "description": "历史交易的店铺渠道商品 ID，不能代替OneID。"
+        },
+        "channel_sku_id": {
+          "$ref": "#/definitions/sku_id",
+          "description": "历史交易的店铺渠道规格 ID，不能代替统一规格。"
+        },
+        "unitPrice": {
+          "$ref": "#/definitions/money"
+        },
+        "payment": {
+          "$ref": "#/definitions/money",
+          "description": "交易明细分摊应付/支付价格，不推导到账。"
+        },
+        "isPresent": {
+          "type": "boolean",
+          "description": "true 为赠品，false 为非赠品，缺失不补 false。"
+        },
+        "isCombo": {
+          "type": "boolean",
+          "description": "true 是套餐主行，false 不是；不表示已取得全部套餐子品。"
+        }
+      },
+      "required": [
+        "oid",
+        "title",
+        "quantity"
+      ]
+    },
+    "payment": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "totalFee": {
+          "$ref": "#/definitions/money",
+          "description": "商品总价，元；不从其他金额推算。"
+        },
+        "postFee": {
+          "$ref": "#/definitions/money",
+          "description": "运费，元。"
+        },
+        "payment": {
+          "$ref": "#/definitions/money",
+          "description": "列表返回的应付/支付价格，元；不补成详情 realPayment，不推导到账、净收入或退款。"
+        }
+      },
+      "required": [
+        "totalFee",
+        "postFee",
+        "payment"
+      ]
+    },
+    "buyer": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "yzOpenId": {
+          "type": "string",
+          "description": "有赞客户开放标识，不是手机号、微信 openId 或员工 ID。"
+        }
+      },
+      "required": [],
+      "minProperties": 1
+    },
+    "address": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "receiverName": {
+          "type": "string",
+          "description": "接口实际返回的收货人姓名，不主动解密。"
+        },
+        "receiverPhone": {
+          "type": "string",
+          "description": "接口实际返回的收货电话，不保证明文。"
+        },
+        "province": {
+          "type": "string",
+          "description": "省。"
+        },
+        "city": {
+          "type": "string",
+          "description": "市。"
+        },
+        "district": {
+          "type": "string",
+          "description": "区。"
+        },
+        "address": {
+          "type": "string",
+          "description": "订单收货要求中的详细地址，不是运单实时目的地。"
+        },
+        "postalCode": {
+          "type": "string",
+          "description": "邮政编码。"
+        }
+      },
+      "required": [],
+      "minProperties": 1
+    },
+    "remark": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "buyerMessage": {
+          "type": "string",
+          "description": "买家留言，空文本保留。"
+        },
+        "tradeMemo": {
+          "type": "string",
+          "description": "商家备注，空文本保留。"
+        }
+      },
+      "required": [],
+      "minProperties": 1
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "isOfflineOrder": {
+          "type": "boolean",
+          "description": "true 是线下来源，false 是非线下来源。"
+        },
+        "bookKey": {
+          "type": "string",
+          "description": "订单识别码，与交易订单号不同。"
+        }
+      },
+      "required": [],
+      "minProperties": 1
+    },
+    "aftersale": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "refundState": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "订单退款金额状态：0未退款、1部分退款中瞬态、2部分退款成功、11全额退款中瞬态、12全额退款成功；未知安全整数保留，不表示售后处理状态。"
+        }
+      },
+      "required": [
+        "refundState"
+      ]
+    },
+    "fulfillment": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "deliveryType": {
+          "type": "string",
+          "enum": [
+            "EXPRESS",
+            "SELF_FETCH",
+            "LOCAL_DELIVERY",
+            "VIRTUAL"
+          ],
+          "description": "EXPRESS=快递、SELF_FETCH=自提、LOCAL_DELIVERY=同城配送、VIRTUAL=无需发货；无法识别的配送方式整体失败。"
+        }
+      },
+      "required": [
+        "deliveryType"
+      ]
+    },
+    "orderRow": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "order": {
+          "$ref": "#/definitions/order"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/orderItem"
+          }
+        },
+        "payment": {
+          "$ref": "#/definitions/payment"
+        },
+        "buyer": {
+          "$ref": "#/definitions/buyer"
+        },
+        "address": {
+          "$ref": "#/definitions/address"
+        },
+        "remark": {
+          "$ref": "#/definitions/remark"
+        },
+        "source": {
+          "$ref": "#/definitions/source"
+        },
+        "aftersale": {
+          "$ref": "#/definitions/aftersale"
+        },
+        "fulfillment": {
+          "$ref": "#/definitions/fulfillment"
+        }
+      },
+      "required": [
+        "order"
+      ]
+    },
+    "pagination": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "stopReason"
+      ],
+      "properties": {
+        "stopReason": {
+          "type": "string",
+          "enum": [
+            "range_exhausted",
+            "max_items",
+            "max_requests",
+            "density_limit",
+            "page_window"
+          ],
+          "description": "range_exhausted=本次声明范围队列走完；max_items=剩余结果预算不足下一整页；max_requests=请求预算耗尽；density_limit=最小时间片仍超过页窗口；page_window=翻页中总数超过当前页窗口。"
+        },
+        "pendingRanges": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 512,
+          "items": {
+            "$ref": "#/definitions/pendingRange"
+          },
+          "description": "仅在提前成功停止时返回的未完成范围；不是稳定恢复游标。"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "stopReason": {
+                "const": "range_exhausted"
+              }
+            },
+            "required": [
+              "stopReason"
+            ]
+          },
+          "then": {
+            "properties": {
+              "pendingRanges": false
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "stopReason": {
+                "enum": [
+                  "max_items",
+                  "max_requests",
+                  "density_limit",
+                  "page_window"
+                ]
+              }
+            },
+            "required": [
+              "stopReason"
+            ]
+          },
+          "then": {
+            "required": [
+              "pendingRanges"
+            ],
+            "properties": {
+              "pendingRanges": true
+            }
+          }
+        }
+      ]
+    },
+    "bindingRequest": {
+      "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"
+      ]
+    },
+    "listRequest": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "method": {
+          "const": "POST"
+        },
+        "path": {
+          "const": "youzan.trades.sold.get/4.0.4"
+        },
+        "body": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "node_kdt_id": {
+              "type": "integer"
+            },
+            "page_no": {
+              "type": "integer"
+            },
+            "page_size": {
+              "type": "integer"
+            },
+            "yz_open_id": {
+              "type": "string",
+              "minLength": 1,
+              "description": "客户统一标识，非员工ID或手机号，非空文本。"
+            },
+            "status": {
+              "type": "string",
+              "minLength": 1,
+              "enum": [
+                "WAIT_BUYER_PAY",
+                "WAIT_SELLER_SEND_GOODS",
+                "WAIT_BUYER_CONFIRM_GOODS",
+                "TRADE_SUCCESS",
+                "TRADE_CLOSED",
+                "TRADE_REFUND"
+              ],
+              "description": "WAIT_BUYER_PAY=等待买家付款，含适用预售定金或尾款；WAIT_SELLER_SEND_GOODS=等待卖家发货；WAIT_BUYER_CONFIRM_GOODS=等待买家确认收货；TRADE_SUCCESS=交易完成；TRADE_CLOSED=交易关闭；TRADE_REFUND=退款中，仅搜索条件，不是已知交易状态响应值。请求字符串，与响应字典分开，未知值拒绝。"
+            },
+            "type": {
+              "type": "string",
+              "minLength": 1,
+              "enum": [
+                "NORMAL",
+                "PEERPAY",
+                "GIFT",
+                "FX_CAIGOUDAN",
+                "PRESENT",
+                "WISH",
+                "QRCODE",
+                "QRCODE_3RD",
+                "FX_MERGED",
+                "VERIFIED",
+                "PINJIAN",
+                "REBATE",
+                "FX_QUANYUANDIAN",
+                "FX_DEPOSIT",
+                "PF",
+                "GROUP",
+                "HOTEL",
+                "TAKE_AWAY",
+                "CATERING_OFFLINE",
+                "CATERING_QRCODE",
+                "BEAUTY_APPOINTMENT",
+                "BEAUTY_SERVICE",
+                "KNOWLEDGE_PAY",
+                "GIFT_CARD"
+              ],
+              "description": "NORMAL=普通订单；PEERPAY=代付；GIFT=我要送人；FX_CAIGOUDAN=分销供货单；PRESENT=赠品；WISH=心愿单；QRCODE=二维码订单；QRCODE_3RD=线下收银台；FX_MERGED=合并付货款；VERIFIED=1分钱实名认证；PINJIAN=品鉴；REBATE=返利；FX_QUANYUANDIAN=全员开店；FX_DEPOSIT=分销保证金；PF=批发；GROUP=拼团；HOTEL=酒店；TAKE_AWAY=外卖；CATERING_OFFLINE=堂食点餐；CATERING_QRCODE=外卖买单；BEAUTY_APPOINTMENT=美业预约；BEAUTY_SERVICE=美业服务；KNOWLEDGE_PAY=知识付费；GIFT_CARD=礼品卡。请求字符串，与响应字典分开，未知值拒绝。"
+            },
+            "goods_id": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "goods_title": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200,
+              "description": "商品名称模糊搜索，最长200字符为CLI预算。"
+            },
+            "receiver_phone": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 20,
+              "description": "收货人电话，非买家手机号，最长20字符。"
+            },
+            "receiver_name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 50,
+              "description": "收货人姓名，最长50字符。"
+            },
+            "express_type": {
+              "type": "string",
+              "minLength": 1,
+              "enum": [
+                "EXPRESS",
+                "SELF_FETCH",
+                "LOCAL_DELIVERY"
+              ],
+              "description": "EXPRESS=快递发货；SELF_FETCH=到店自提；LOCAL_DELIVERY=同城配送。请求字符串，与响应字典分开，未知值拒绝。"
+            },
+            "keywords": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200,
+              "description": "订单号、收货人手机或后四位，最长200字符为CLI预算。"
+            },
+            "start_created": {
+              "type": "string",
+              "format": "beijing-date-time",
+              "description": "秒精度北京时间文本。"
+            },
+            "end_created": {
+              "type": "string",
+              "format": "beijing-date-time",
+              "description": "秒精度北京时间文本。"
+            },
+            "start_pay": {
+              "type": "string",
+              "format": "beijing-date-time",
+              "description": "支付轴开始，秒精度北京时间文本。"
+            },
+            "end_pay": {
+              "type": "string",
+              "format": "beijing-date-time",
+              "description": "支付轴结束，秒精度北京时间文本。"
+            }
+          },
+          "required": [
+            "node_kdt_id",
+            "page_no",
+            "page_size"
+          ],
+          "oneOf": [
+            {
+              "properties": {
+                "start_created": true,
+                "end_created": true,
+                "start_pay": false,
+                "end_pay": false
+              },
+              "required": [
+                "start_created",
+                "end_created"
+              ]
+            },
+            {
+              "properties": {
+                "start_pay": true,
+                "end_pay": true,
+                "start_created": false,
+                "end_created": false
+              },
+              "required": [
+                "start_pay",
+                "end_pay"
+              ]
+            }
+          ]
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body"
+      ]
+    },
+    "nonemptyText": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S",
+      "description": "非空文本标识或状态；保留业务空格，不解密。"
+    },
+    "sku_id": {
+      "type": "string",
+      "pattern": "^\\d+$",
+      "description": "规格 ID 字符串，可为 0；统一规格与渠道规格不可互换。"
+    },
+    "pendingRange": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "start": {
+          "$ref": "#/definitions/time"
+        },
+        "end": {
+          "$ref": "#/definitions/time"
+        },
+        "pageNo": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "description": "下一未读页；密度或分页窗口停止时为1，须缩小范围重新读取，不是恢复游标。"
+        }
+      },
+      "required": [
+        "start",
+        "end",
+        "pageNo"
+      ]
+    },
+    "diagnosticExpected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {
+        "type": {
+          "anyOf": [
+            {
+              "type": "string",
+              "description": "预期的 JSON 类型。"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "description": "预期的 JSON 类型。"
+              }
+            }
+          ],
+          "description": "同版模型允许的类型。"
+        },
+        "enum": {
+          "type": "array",
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "number"
+              },
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "契约声明的静态标量约束。"
+          },
+          "description": "同版模型允许的静态值。"
+        },
+        "const": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "契约声明的静态标量约束。"
+        },
+        "minimum": {
+          "type": "number",
+          "description": "包含的最小值。"
+        },
+        "maximum": {
+          "type": "number",
+          "description": "包含的最大值。"
+        },
+        "exclusiveMinimum": {
+          "type": "number",
+          "description": "不包含的最小值。"
+        },
+        "exclusiveMaximum": {
+          "type": "number",
+          "description": "不包含的最大值。"
+        },
+        "minLength": {
+          "type": "integer",
+          "description": "最少字符数。"
+        },
+        "maxLength": {
+          "type": "integer",
+          "description": "最多字符数。"
+        },
+        "minItems": {
+          "type": "integer",
+          "description": "最少元素数。"
+        },
+        "maxItems": {
+          "type": "integer",
+          "description": "最多元素数。"
+        },
+        "format": {
+          "type": "string",
+          "description": "同版模型声明的格式。"
+        },
+        "pattern": {
+          "type": "string",
+          "description": "同版模型声明的字符约束。"
+        },
+        "additionalProperties": {
+          "const": false,
+          "description": "对象拒绝契约以外的属性。"
+        },
+        "contains": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "const"
+          ],
+          "properties": {
+            "const": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                },
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "契约声明的静态标量约束。"
+            }
+          }
+        },
+        "items": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "enum"
+          ],
+          "properties": {
+            "enum": {
+              "type": "array",
+              "items": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "契约声明的静态标量约束。"
+              },
+              "description": "元素允许的静态值。"
+            }
+          }
+        }
+      }
+    },
+    "diagnosticIssue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source",
+        "reason"
+      ],
+      "properties": {
+        "source": {
+          "enum": [
+            "argv",
+            "input",
+            "context",
+            "output",
+            "preview"
+          ],
+          "description": "问题所属的参数、输入、上下文、结果或预览模型。"
+        },
+        "path": {
+          "type": "string",
+          "description": "对应模型中的 JSON Pointer；不含原始输入或动态字典键。"
+        },
+        "option": {
+          "type": "string",
+          "description": "可定位时给出的已注册 CLI 选项。"
+        },
+        "reason": {
+          "enum": [
+            "required",
+            "invalid_type",
+            "invalid_choice",
+            "out_of_range",
+            "invalid_format",
+            "conditional_required",
+            "constraint",
+            "unexpected_property",
+            "unknown_option",
+            "unknown_command",
+            "excess_arguments",
+            "missing_value"
+          ],
+          "description": "字段违反的约束类型，原始值不回显。"
+        },
+        "expected": {
+          "$ref": "#/definitions/diagnosticExpected",
+          "description": "同版契约的静态预期。"
+        },
+        "relatedPaths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "关联字段的 JSON Pointer。"
+          },
+          "description": "触发条件约束的关联字段。"
+        }
+      }
+    },
+    "diagnosticRecovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "action",
+        "automaticBusinessRetry"
+      ],
+      "properties": {
+        "action": {
+          "enum": [
+            "correct_input",
+            "complete_authentication",
+            "request_access_review",
+            "stop_and_inspect"
+          ],
+          "description": "依次表示修正本地输入、补认证、核对权限或停止核查；仅是说明，不执行操作或授予权限。"
+        },
+        "automaticBusinessRetry": {
+          "const": false,
+          "description": "不据此自动重放业务请求。"
+        }
+      }
+    },
+    "diagnosticExecution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requestState",
+        "coverage",
+        "observedAttempts"
+      ],
+      "properties": {
+        "requestState": {
+          "enum": [
+            "not_sent",
+            "sent",
+            "unknown"
+          ],
+          "description": "整次调用尚未发送、已有发送记录或无法排除未知请求；不代表业务完成。"
+        },
+        "coverage": {
+          "enum": [
+            "complete",
+            "partial"
+          ],
+          "description": "请求观察覆盖全部已接入路径，或存在未观测路径；部分覆盖不能声明零请求。"
+        },
+        "observedAttempts": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991,
+          "description": "本地已进入发送边界的观测次数下界，不是服务端执行次数。"
+        }
+      }
+    }
+  },
+  "modules": {
+    "order": {
+      "base": true,
+      "upstreamPath": "full_order_info_list[].full_order_info.order_info",
+      "required": true,
+      "description": "订单锚点、状态、业务类型与时间。"
+    },
+    "items": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.orders",
+      "required": false,
+      "description": "交易商品行。"
+    },
+    "payment": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.pay_info",
+      "required": false,
+      "description": "列表金额有限视图。"
+    },
+    "buyer": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.buyer_info",
+      "required": false,
+      "description": "客户统一标识。"
+    },
+    "address": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.address_info",
+      "required": false,
+      "description": "订单收货要求。"
+    },
+    "remark": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.remark_info",
+      "required": false,
+      "description": "买家留言与商家备注。"
+    },
+    "source": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.source_info",
+      "required": false,
+      "description": "线下来源标记。"
+    },
+    "aftersale": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.order_info.refund_state",
+      "required": false,
+      "description": "有限退款状态摘要。"
+    },
+    "fulfillment": {
+      "base": false,
+      "upstreamPath": "full_order_info_list[].full_order_info.order_info.express_type",
+      "required": false,
+      "description": "交付方式。"
+    }
+  },
+  "api": {
+    "method": "POST",
+    "path": "youzan.trades.sold.get/4.0.4"
+  },
+  "success": {
+    "description": "同一凭证核验目标店铺后在显式创建或支付时间和预算内串行扫描；全部已选行及锚点校验成功才一次性输出。预算和密度停止是成功但未读完。"
+  },
+  "errors": {
+    "description": "任一请求、锚点、模块或字节限制错误整体失败，stdout为空，不将真实错误伪装成正常预算停止，不重试或换店。",
+    "diagnosticsVersion": 2
+  },
+  "notes": [
+    "--kdt-id 省略时使用本次有效上下文 shopId；显式提供的非法值不回退。两者都缺失时拒绝；目标范围、同店核验和服务端权限仍按本命令校验。",
+    "基础 order 可返回 paidAt、isPaid。paidAt 未取得、空文本或 null 时省略，不证明未支付；非空错型、非法日期或非零毫秒失败。isPaid 未取得时省略，false 原样保留，非 boolean 失败；两者不从状态或金额推算。",
+    "订单号通常为 E/V/C 开头加 23 位数字，仅供核对，不限定前缀、数字组合或 24 位长度；按原值传递。仅保留非空、无空白或控制字符和最多 128 字符的文本保护；服务端仍判断支持范围和对象归属。",
+    "必须显式目标，--created-at 与 --paid-at 完整范围二选一，缺轴或同时两轴为 validation/input 且零请求。不提供 time-axis、单号精确查询、页码参数、旧分片参数或恢复游标。",
+    "支付轴的初始窗口、二分、后续页、预览及 pendingRanges 始终是支付时间，不附加创建约束。不从窗口补造 paidAt/isPaid；缺失只表示未取得，不能静默排除后宣称全集。支付索引延迟和非快照响应仍可能遗漏。",
+    "payment 模块仍为列表金额，不含 realPayment，不逐单读取详情，不用 payment 求实付、扣退款净额或商家到账。paidAt 不是逐笔资金事件时间。",
+    "并发1，固定每页 min(100,maxItems)。本地先按三日历月拆分；第1页total超过100页容量时不提交父页，按整数秒二分并共享端点，所有非时间筛选保持。",
+    "请求预算包括一次店铺核验、所有探测和翻页。发送前检查预算，剩余结果预算不足下一整页时停止；可能少于maxItems。成功结果只公开 stopReason，提前停止时附带 pendingRanges。",
+    "去重键为店铺和订单号，保留首次提交版本。不相加各区间total、不输出全集total或服务端cursor；不发送第101页。",
+    "后续页total越窗时保留此前已提交结果，但不提交越窗页，pendingRanges当前区间pageNo重置1；缩小范围后由调用方重读及去重。pendingRanges 不是恢复游标。",
+    "range_exhausted仅表示本次观测的队列走完。时间端点开闭、同秒唯一次序和快照均未保证；可能受索引延迟与动态分页影响，不承诺无遗漏。",
+    "累计响应20MiB，扫描请求适配边界逐块有界读取；最终UTF-8输出含换行10MiB。超限整体失败，不裁切模块或订单。",
+    "本批默认以 CNY 计价，源为元的金额无损补齐两位十进制字符串，不新增币种字段、不换汇或跨币种汇总；这是用户确认的批次约定，不是官方币种保证。",
+    "payment保留列表应付/支付价格含义，不提供详情realPayment、优惠或独立退款集合。",
+    "未知字段不扩大模型；未请求模块不校验；请求模块缺失、null或错型整体失败，合法零、false、空文本及实际空数组保留。",
+    "应用凭证实测不证明店铺员工身份授权与权限隔离。",
+    "商品行 item_id/sku_id 为OneID，channel_item_id/channel_sku_id 为历史渠道身份；oid仍为交易行，不用当前档案重写历史。",
+    "历史统一商品或规格字段为空字符串时，省略对应OneID并保留明确渠道身份，不用渠道ID补造；null和其他错型仍失败。",
+    "时间区间必须包含 .. 并显式两端；不接受旧成对参数或裸时间等值，非零毫秒在请求前拒绝。"
+  ]
+}