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

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

@@ -0,0 +1,1363 @@
+{
+  "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": {
+            "$ref": "#/definitions/orderNo",
+            "description": "精确交易订单号。"
+          },
+          "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": {
+          "created": {
+            "$ref": "#/definitions/timeRange"
+          },
+          "updated": {
+            "$ref": "#/definitions/timeRange"
+          },
+          "paid": {
+            "$ref": "#/definitions/timeRange"
+          },
+          "succeeded": {
+            "$ref": "#/definitions/timeRange"
+          },
+          "delivery": {
+            "$ref": "#/definitions/timeRange"
+          }
+        },
+        "minProperties": 0,
+        "description": "时间区间由 --created-at/--updated-at/--paid-at/--succeeded-at/--delivery-at \"START..END\" 解析；每组必须两端，生命周期最多一组。配送时间要求 LOCAL_DELIVERY，不承诺端点包含性。"
+      },
+      "pagination": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "pageNo": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          }
+        },
+        "required": [
+          "pageNo",
+          "pageSize"
+        ]
+      },
+      "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"
+      }
+    },
+    "required": [
+      "scope",
+      "filters",
+      "range",
+      "pagination",
+      "include",
+      "format",
+      "dryRun"
+    ]
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "orders": {
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/orderRow"
+            }
+          },
+          "pagination": {
+            "$ref": "#/definitions/pagination"
+          }
+        },
+        "required": [
+          "orders",
+          "pagination"
+        ]
+      }
+    },
+    "required": [
+      "data"
+    ]
+  },
+  "preview": {
+    "type": "object",
+    "description": "纯本地两步请求计划；receiver_phone、receiver_name、keywords 若存在均替换为 ***。不读取凭证、不联网，不修改规范化输入或实际请求筛选。",
+    "additionalProperties": false,
+    "properties": {
+      "requests": {
+        "type": "array",
+        "minItems": 2,
+        "maxItems": 2,
+        "items": [
+          {
+            "$ref": "#/definitions/bindingRequest"
+          },
+          {
+            "$ref": "#/definitions/listRequest"
+          }
+        ]
+      }
+    },
+    "required": [
+      "requests"
+    ]
+  },
+  "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.list"
+          },
+          "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": "北京时间成对范围，结束严格晚于开始，最长三日历月，月末夹到目标月末并保留时分秒；结束至多晚于固定当前时刻7天。秒接口拒绝非零毫秒。 CLI 使用 START..END，必须有分隔符和两端；不补边界，不承诺端点包含性。"
+    },
+    "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,
+      "properties": {
+        "pageNo": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "本次结果对应的页码。"
+        },
+        "pageSize": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "本次生效的每页容量，由请求指定。"
+        },
+        "returned": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "本次响应中 data.orders 的数组长度，不是匹配总数、累计条数或嵌套记录数。"
+        },
+        "hasMore": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "true 表示还有后续页，false 表示已确认没有后续页；无法确定时为 null，不以空页或短页推算。"
+        },
+        "total": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "匹配本次查询条件的总记录数，不是当前页返回条数；上游未提供可确认总数时省略。"
+        },
+        "nextPageNo": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1,
+          "maximum": 100,
+          "description": "已确认且未超过页码上限的下一页；无法确认或到达上限时为 null。"
+        },
+        "windowLimitReached": {
+          "type": "boolean",
+          "description": "true表示已到100页CLI窗口且尚未确认取完；保留原筛选并缩小范围，不请求第101页，不表示已读全集。"
+        }
+      },
+      "required": [
+        "pageNo",
+        "pageSize",
+        "returned",
+        "hasMore",
+        "nextPageNo",
+        "windowLimitReached"
+      ],
+      "description": "本次返回页面的页码、容量、记录数和后页信号。"
+    },
+    "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"
+            },
+            "tid": {
+              "$ref": "#/definitions/orderNo",
+              "description": "精确交易订单号。"
+            },
+            "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_update": {
+              "type": "string",
+              "format": "beijing-date-time",
+              "description": "秒精度北京时间文本。"
+            },
+            "end_update": {
+              "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": "秒精度北京时间文本。"
+            },
+            "start_success": {
+              "type": "string",
+              "format": "beijing-date-time",
+              "description": "秒精度北京时间文本。"
+            },
+            "end_success": {
+              "type": "string",
+              "format": "beijing-date-time",
+              "description": "秒精度北京时间文本。"
+            },
+            "delivery_start_time": {
+              "type": "string",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}-\\d{2}-\\d{2}-\\d{2}$",
+              "description": "配送时间按字段定义显式编码为 yyyy-MM-dd-HH-mm-ss。"
+            },
+            "delivery_end_time": {
+              "type": "string",
+              "pattern": "^\\d{4}-\\d{2}-\\d{2}-\\d{2}-\\d{2}-\\d{2}$",
+              "description": "配送时间按字段定义显式编码为 yyyy-MM-dd-HH-mm-ss。"
+            }
+          },
+          "required": [
+            "node_kdt_id",
+            "page_no",
+            "page_size"
+          ]
+        }
+      },
+      "required": [
+        "method",
+        "path",
+        "body"
+      ]
+    },
+    "nonemptyText": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S",
+      "description": "非空文本标识或状态；保留业务空格，不解密。"
+    },
+    "sku_id": {
+      "type": "string",
+      "pattern": "^\\d+$",
+      "description": "规格 ID 字符串，可为 0；统一规格与渠道规格不可互换。"
+    },
+    "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": "必需字段缺失、字段错型、不安全数字、非零额外金额精度或非零毫秒整体失败；paidAt 未取得时省略，其余 null 按字段契约拒绝。未知字段不进入校验。不猜订单不存在，不自动重试或换店；失败 stdout 为空，安全 stderr，传输中断 unknown。",
+    "diagnosticsVersion": 2
+  },
+  "notes": [
+    "基础 order 可返回 paidAt、isPaid。paidAt 未取得、空文本或 null 时省略，不证明未支付；非空错型、非法日期或非零毫秒失败。isPaid 未取得时省略，false 原样保留，非 boolean 失败；两者不从状态或金额推算。",
+    "订单号通常为 E/V/C 开头加 23 位数字，仅供核对，不限定前缀、数字组合或 24 位长度；按原值传递。仅保留非空、无空白或控制字符和最多 128 字符的文本保护；服务端仍判断支持范围和对象归属。",
+    "省略 --kdt-id 时使用当前上下文店铺；显式目标须满足当前店铺范围约束。至少一个明确筛选；include仅投影，最多一次店铺核验加一次列表请求。不自动重试、翻页、换身份或逐单详情补齐。",
+    "本批默认以 CNY 计价，源为元的金额无损补齐两位十进制字符串，不新增币种字段、不换汇或跨币种汇总；这是用户确认的批次约定，不是官方币种保证。",
+    "payment保留列表应付/支付价格含义，不提供详情realPayment、优惠或独立退款集合。",
+    "累计响应10MiB、最终UTF-8输出含换行5MiB，超限整体失败；非流式内存保证。",
+    "未知字段不扩大模型；未请求模块不校验；请求模块缺失、null或错型整体失败，合法零、false、空文本及实际空数组保留。",
+    "应用凭证实测不证明店铺员工身份授权与权限隔离。",
+    "商品行 item_id/sku_id 为OneID，channel_item_id/channel_sku_id 为历史渠道身份；oid仍为交易行，不用当前档案重写历史。",
+    "历史统一商品或规格字段为空字符串时，省略对应OneID并保留明确渠道身份，不用渠道ID补造；null和其他错型仍失败。",
+    "时间区间必须包含 .. 并显式两端；不接受旧成对参数或裸时间等值，非零毫秒在请求前拒绝。"
+  ]
+}