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

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

@@ -0,0 +1,1167 @@
+{
+  "schemaVersion": 1,
+  "input": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "scope": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "kdtId": {
+            "$ref": "#/definitions/shopId"
+          },
+          "orderNo": {
+            "$ref": "#/definitions/orderNo"
+          }
+        },
+        "required": [
+          "kdtId",
+          "orderNo"
+        ]
+      },
+      "include": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": [
+            "buyer",
+            "address",
+            "remark",
+            "source",
+            "promotion",
+            "aftersale",
+            "fulfillment"
+          ]
+        },
+        "uniqueItems": true,
+        "description": "逗号分隔输入裁首尾空白、去重；空值、空项或未知模块拒绝。仅影响投影。"
+      },
+      "format": {
+        "type": "string",
+        "enum": [
+          "json",
+          "pretty"
+        ],
+        "description": "仅 JSON 缩进不同。"
+      },
+      "decrypt": {
+        "$ref": "#/definitions/decryptFields"
+      },
+      "reason": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 200,
+        "pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029]+$",
+        "description": "仅 decrypt 时必需，裁首尾空白后 1 至 200 个 Unicode 码点，无换行或控制字符；不填写个人信息。用途不授予权限。"
+      },
+      "dryRun": {
+        "type": "boolean",
+        "description": "只校验和预览，不读凭证、不联网。"
+      }
+    },
+    "dependencies": {
+      "decrypt": [
+        "reason"
+      ],
+      "reason": [
+        "decrypt"
+      ]
+    },
+    "allOf": [
+      {
+        "if": {
+          "required": [
+            "decrypt"
+          ],
+          "properties": {
+            "decrypt": {
+              "$ref": "#/definitions/decryptFields"
+            }
+          }
+        },
+        "then": {
+          "properties": {
+            "include": {
+              "type": "array",
+              "contains": {
+                "const": "address"
+              }
+            }
+          }
+        }
+      }
+    ],
+    "required": [
+      "scope",
+      "include",
+      "format",
+      "dryRun"
+    ]
+  },
+  "output": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "order": {
+            "$ref": "#/definitions/order"
+          },
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/orderItem"
+            },
+            "description": "保留交易行顺序和重复商品，不展开套餐子品；实际空数组才输出空数组。"
+          },
+          "payment": {
+            "$ref": "#/definitions/payment"
+          },
+          "buyer": {
+            "$ref": "#/definitions/buyer"
+          },
+          "address": {
+            "$ref": "#/definitions/address"
+          },
+          "remark": {
+            "$ref": "#/definitions/remark"
+          },
+          "source": {
+            "$ref": "#/definitions/source"
+          },
+          "promotion": {
+            "$ref": "#/definitions/promotion"
+          },
+          "aftersale": {
+            "$ref": "#/definitions/aftersale"
+          },
+          "fulfillment": {
+            "$ref": "#/definitions/fulfillment"
+          }
+        },
+        "required": [
+          "order",
+          "items",
+          "payment"
+        ]
+      }
+    },
+    "required": [
+      "data"
+    ]
+  },
+  "preview": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "privacy": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "fields": {
+            "$ref": "#/definitions/decryptFields"
+          },
+          "maximumApiRequests": {
+            "const": 4
+          },
+          "requiresSensitiveAuthorization": {
+            "const": true
+          }
+        },
+        "required": [
+          "fields",
+          "maximumApiRequests",
+          "requiresSensitiveAuthorization"
+        ],
+        "description": "仅显式解密时出现。只列字段和调用上限，不含用途、凭证或密文，不表示权限已通过。"
+      },
+      "requests": {
+        "type": "array",
+        "minItems": 2,
+        "maxItems": 2,
+        "additionalItems": false,
+        "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.get/4.0.2"
+              },
+              "body": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "tid": {
+                    "$ref": "#/definitions/orderNo"
+                  }
+                },
+                "required": [
+                  "tid"
+                ]
+              }
+            },
+            "required": [
+              "method",
+              "path",
+              "body"
+            ]
+          }
+        ]
+      }
+    },
+    "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",
+              "sensitive-authorization",
+              "source",
+              "ciphertext-verification",
+              "decryption",
+              "sensitive-audit",
+              "output-model"
+            ]
+          },
+          "command": {
+            "const": "order.order.get"
+          },
+          "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": {
+    "decryptFields": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 3,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "enum": [
+          "address.receiverName",
+          "address.receiverPhone",
+          "address.address"
+        ],
+        "description": "address.receiverName 为收货姓名；address.receiverPhone 为收货联系方式；address.address 为详细收货地址。"
+      },
+      "description": "逗号分隔字段路径，去首尾空白及去重；拒绝空项、未知字段、通配和数组路径，必须 include address。"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^(?=.*[1-9])\\d+$",
+      "description": "十进制正整数 ID 字符串；上游 number 仅接受安全整数，字符串不经浮点转换。"
+    },
+    "sku_id": {
+      "type": "string",
+      "pattern": "^\\d+$",
+      "description": "规格 ID 字符串，可为 0；统一规格与渠道规格不可互换。"
+    },
+    "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 字符，不含空白或控制字符；不按前缀或位数判断有效性，不改写原值。"
+    },
+    "nonemptyText": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "\\S",
+      "description": "非空文本标识或状态；保留业务空格，不解密。"
+    },
+    "time": {
+      "type": "string",
+      "format": "beijing-date-time-ms",
+      "$comment": "upstream-time:text",
+      "description": "固定北京时间 YYYY-MM-DD HH:mm:ss.SSS；来源为文本且仅秒精度，拒绝非零毫秒、非法日历、时区及数字时间戳。"
+    },
+    "money": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d{2}$",
+      "$comment": "upstream-money:yuan",
+      "description": "元金额字符串，无损补齐两位，不再次除以100；不接受负数、科学计数法、非零额外小数位或非字符串。不计算汇总；本命令默认以 CNY 计价，不新增币种字段或作汇率换算。"
+    },
+    "signedMoney": {
+      "type": "string",
+      "pattern": "^-?\\d+\\.\\d{2}$",
+      "$comment": "upstream-money:yuan",
+      "description": "改价元字符串，保留符号：负数涨价，正数减价。本命令默认以 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": "整单应付金额 payment，不是实付或到账。"
+        },
+        "realPayment": {
+          "$ref": "#/definitions/money",
+          "description": "整单实付价格，不扣退款，不当作净收入。"
+        }
+      },
+      "required": [
+        "totalFee",
+        "postFee",
+        "payment",
+        "realPayment"
+      ]
+    },
+    "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
+    },
+    "promotion": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "itemDiscountFee": {
+          "$ref": "#/definitions/money"
+        },
+        "orderDiscountFee": {
+          "$ref": "#/definitions/money"
+        },
+        "adjustFee": {
+          "$ref": "#/definitions/signedMoney"
+        }
+      },
+      "required": [
+        "itemDiscountFee",
+        "orderDiscountFee",
+        "adjustFee"
+      ]
+    },
+    "caseSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "caseId": {
+          "$ref": "#/definitions/nonemptyText",
+          "description": "售后引用标识，不是退款资金流水号。"
+        },
+        "type": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "售后类型：1买家申请退款、2商家主动退款、3一键退款、4零售门店换货、5网店换货；未知安全整数保留。"
+        },
+        "state": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "摘要售后状态：1买家申请退款等待卖家同意、10卖家拒绝退款、20卖家同意退货等待买家退货、30买家已退货等待卖家确认收货、40卖家未收到货拒绝退款、45商家已发货等待买家确认收货、60退款成功；未知安全整数保留，不与售后详情码混用。"
+        },
+        "refundFee": {
+          "$ref": "#/definitions/money",
+          "description": "本售后引用金额，不等于确认到账金额。"
+        },
+        "appliedAt": {
+          "$ref": "#/definitions/time"
+        },
+        "oids": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/nonemptyText"
+          },
+          "description": "上游对象数组仅投影每个非空 oid，保持顺序，不以下标代替身份。"
+        }
+      },
+      "required": [
+        "caseId",
+        "type",
+        "state"
+      ]
+    },
+    "aftersale": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "refundState": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "订单退款金额状态：0未退款、1部分退款中瞬态、2部分退款成功、11全额退款中瞬态、12全额退款成功；未知安全整数保留，不表示售后处理状态。"
+        },
+        "cases": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/caseSummary"
+          },
+          "description": "仅本详情响应所选售后引用，不承诺全部退换货或资金到账。"
+        }
+      },
+      "required": [
+        "refundState",
+        "cases"
+      ]
+    },
+    "fulfillment": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "deliveryType": {
+          "type": "string",
+          "enum": [
+            "EXPRESS",
+            "SELF_FETCH",
+            "LOCAL_DELIVERY",
+            "VIRTUAL"
+          ],
+          "description": "EXPRESS=快递、SELF_FETCH=自提、LOCAL_DELIVERY=同城配送、VIRTUAL=无需发货；无法识别的配送方式整体失败。"
+        },
+        "consignTime": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/time"
+            },
+            {
+              "const": ""
+            }
+          ],
+          "$comment": "upstream-time:text:empty",
+          "description": "可选全商品发货时间，空串保留但不能解释为未发货。"
+        }
+      },
+      "required": [
+        "deliveryType"
+      ]
+    },
+    "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": "data.full_order_info.order_info",
+      "required": true,
+      "description": "固定订单标识及状态时间；返回所属总部时校验总部。"
+    },
+    "items": {
+      "base": true,
+      "upstreamPath": "data.full_order_info.orders",
+      "required": true,
+      "description": "固定交易商品行有限视图；缺失或错型失败。"
+    },
+    "payment": {
+      "base": true,
+      "upstreamPath": "data.full_order_info.pay_info",
+      "required": true,
+      "description": "固定应付与实付分离的元金额视图；本命令默认以 CNY 计价，不新增币种字段或作汇率换算。"
+    },
+    "buyer": {
+      "base": false,
+      "upstreamPath": "data.full_order_info.buyer_info",
+      "required": true,
+      "description": "buyer 仅主响应投影，选定才校验；缺失或无表列字段失败，不补空对象。"
+    },
+    "address": {
+      "base": false,
+      "upstreamPath": "data.full_order_info.address_info",
+      "required": true,
+      "description": "address 仅主响应投影，选定才校验；缺失或无表列字段失败，不补空对象。"
+    },
+    "remark": {
+      "base": false,
+      "upstreamPath": "data.full_order_info.remark_info",
+      "required": true,
+      "description": "remark 仅主响应投影，选定才校验；缺失或无表列字段失败，不补空对象。"
+    },
+    "source": {
+      "base": false,
+      "upstreamPath": "data.full_order_info.source_info",
+      "required": true,
+      "description": "source 仅主响应投影，选定才校验；缺失或无表列字段失败，不补空对象。"
+    },
+    "promotion": {
+      "base": false,
+      "upstreamPath": "data.order_promotion",
+      "required": true,
+      "description": "promotion 仅主响应投影，选定才校验；缺失或无表列字段失败，不补空对象。"
+    },
+    "aftersale": {
+      "base": false,
+      "upstreamPath": "data.refund_order",
+      "required": true,
+      "description": "aftersale 仅主响应投影，选定才校验；缺失或无表列字段失败，不补空对象。"
+    },
+    "fulfillment": {
+      "base": false,
+      "upstreamPath": "data.full_order_info.order_info",
+      "required": true,
+      "description": "fulfillment 仅主响应投影，选定才校验；缺失或无表列字段失败，不补空对象。"
+    }
+  },
+  "api": {
+    "method": "POST",
+    "path": "youzan.trade.get/4.0.2"
+  },
+  "success": {
+    "description": "同一凭证先核验目标店铺，再读取订单。订单号与店铺必须匹配，返回的总部须匹配当前上下文；选定模块及递归模型全部通过才输出。"
+  },
+  "errors": {
+    "description": "必需字段缺失、字段错型、不安全数字、非零额外金额精度或非零毫秒整体失败；paidAt 未取得时省略，其余 null 按字段契约拒绝。未知字段不进入校验。不猜订单不存在，不自动重试或换店；失败 stdout 为空，安全 stderr，传输中断 unknown。 错误诊断第二版保留字段问题、恢复说明和整次请求观察；本地输入修正不授权重放已发送请求。不自动初始化应用或重发。",
+    "diagnosticsVersion": 2
+  },
+  "notes": [
+    "--kdt-id 省略时使用本次有效上下文 shopId；显式提供的非法值不回退。两者都缺失时拒绝；目标范围、同店核验和服务端权限仍按本命令校验。",
+    "订单号通常为 E/V/C 开头加 23 位数字，仅供核对，不限定前缀、数字组合或 24 位长度；按原值传递。仅保留非空、无空白或控制字符和最多 128 字符的文本保护；服务端仍判断支持范围和对象归属。",
+    "必须提供 --order-no；--kdt-id 省略时使用当前上下文店铺，显式非法值不回退；非总部目标须等于 context.shopId；总部也限定 当前调用所绑定的目标店铺，at:all 不表示跨店读取。",
+    "输出 ID 是字符串；只有请求适配在安全范围转为 number。include 仅投影，普通读取所有组合最多两请求，无关联详情、跨店或重试。显式 decrypt 时最多四次有赞业务请求，禁用 1106 自动初始化及重发。",
+    "累计业务响应 10MiB、最终序列化 UTF-8 输出含换行 5MiB，超限整体失败；不承诺全链路恒定内存。",
+    "默认不主动解密。decrypt 仅收货姓名、联系方式和详细地址，必须 include address 并提供 reason。打星值不能恢复；字段缺失、空值或平台未确认为密文均整体拒绝。所有选定字段和可靠审计完成后才原位输出；失败 stdout 为空。",
+    "当前安装版尚未接通可信员工字段授权、来源绑定和可靠审计服务，实际解密拒绝，不能以应用 token、订单读取成功或本地上下文代替；普通读取与离线预览不受影响。",
+    "可选字段缺失省略，null 或错型失败；paidAt 未取得、空文本或 null 时省略，不证明未支付，非空错型、非法日期或非零毫秒失败。isPaid 未取得时省略，false 原样保留，非 boolean 失败；两者不从状态或金额推算。已选对象至少有一个已知字段。false、零、合法空文本和实际空数组保留。",
+    "本地上下文与查询成功不替代服务端业务授权或权限隔离验证。",
+    "本批默认以 CNY 计价，金额保留两位小数字符串，不新增币种字段或换汇；该默认不用于确认上游逐订单币种或跨币种结算事实。",
+    "商品行 item_id/sku_id 为OneID，channel_item_id/channel_sku_id 为历史渠道身份；oid仍为交易行，不用当前档案重写历史。",
+    "历史统一商品或规格字段为空字符串时，省略对应OneID并保留明确渠道身份，不用渠道ID补造；null和其他错型仍失败。"
+  ]
+}