@optima-chat/tiktok-cli 0.4.0 → 0.6.0

package/dist/index.js

@@ -135,6 +135,171 @@ var COMMANDS = [
     summary: "\u8BA2\u5355\u8BE6\u60C5\uFF08--id \u5FC5\u586B\uFF09",
     run: ({ shop, args: args2 }) => proxy("GET", shop, "/order/202309/orders/detail", { query: { ids: args2.id } })
   },
+  // ── 售后（退货/取消）只读 ──
+  {
+    name: "orders cancellations",
+    summary: "\u53D6\u6D88\u5355\u5217\u8868\uFF08--status \u53EF\u9009\uFF0C--page-size\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/return_refund/202309/cancellations/search", {
+      query: { page_size: String(args2["page-size"] ?? 20) },
+      body: args2.status ? { cancel_status: args2.status } : {}
+    })
+  },
+  {
+    name: "orders returns",
+    summary: "\u9000\u8D27\u5355\u5217\u8868\uFF08--status \u53EF\u9009\uFF0C--page-size\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/return_refund/202309/returns/search", {
+      query: { page_size: String(args2["page-size"] ?? 20) },
+      body: args2.status ? { return_status: args2.status } : {}
+    })
+  },
+  {
+    name: "orders return-records",
+    summary: "\u9000\u8D27\u5355\u5904\u7406\u8BB0\u5F55\uFF08--id return_id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/return_refund/202309/returns/${args2.id}/records`, {})
+  },
+  {
+    name: "orders aftersale-eligibility",
+    summary: "\u8BA2\u5355\u552E\u540E\u8D44\u683C\uFF08--order id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/return_refund/202512/orders/${args2.order}/aftersale_eligibility`, {})
+  },
+  {
+    name: "orders reject-reasons",
+    summary: "\u9A73\u56DE\u53D6\u6D88/\u9000\u8D27\u7684\u5408\u6CD5\u7406\u7531\uFF08--id return_or_cancel_id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, "/return_refund/202309/reject_reasons", {
+      query: { return_or_cancel_id: args2.id }
+    })
+  },
+  {
+    name: "orders refund-calculate",
+    summary: "\u8BA1\u7B97\u9000\u6B3E\u989D\uFF08--body-file calc.json\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/return_refund/202309/refunds/calculate", {
+      body: readBodyFile(args2["body-file"])
+    })
+  },
+  // ── 履约可见性 只读 ──
+  {
+    name: "orders tracking",
+    summary: "\u8BA2\u5355\u7269\u6D41\u8DDF\u8E2A\uFF08--order id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/fulfillment/202309/orders/${args2.order}/tracking`, {})
+  },
+  {
+    name: "orders shipping-services",
+    summary: "\u8BA2\u5355\u53EF\u7528\u627F\u8FD0/\u914D\u9001\u670D\u52A1\uFF08--order id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, `/fulfillment/202309/orders/${args2.order}/shipping_services/query`, {
+      body: {}
+    })
+  },
+  {
+    name: "packages search",
+    summary: "\u5305\u88F9\u5217\u8868\uFF08--page-size\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/fulfillment/202309/packages/search", {
+      query: { page_size: String(args2["page-size"] ?? 20) },
+      body: {}
+    })
+  },
+  {
+    name: "packages get",
+    summary: "\u5305\u88F9\u8BE6\u60C5\uFF08--package id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/fulfillment/202309/packages/${args2.package}`, {})
+  },
+  {
+    name: "packages documents",
+    summary: "\u5305\u88F9\u7269\u6D41\u9762\u5355\uFF08--package id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/fulfillment/202309/packages/${args2.package}/shipping_documents`, {})
+  },
+  // ── 售后审批 / 发货 写（不可逆，默认 dry-run，--apply 才提交）──
+  {
+    name: "orders cancel-approve",
+    summary: "\u6279\u51C6\u53D6\u6D88\u5355\uFF08--id cancel_id\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u6279\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u6279\u51C6\u53D6\u6D88\u5355",
+      method: "POST",
+      path: `/return_refund/202309/cancellations/${args2.id}/approve`,
+      body: {}
+    }],
+    run: ({ shop, args: args2 }) => proxy("POST", shop, `/return_refund/202309/cancellations/${args2.id}/approve`, { body: {} })
+  },
+  {
+    name: "orders cancel-reject",
+    summary: "\u9A73\u56DE\u53D6\u6D88\u5355\uFF08--id --reason\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u9A73\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u9A73\u56DE\u53D6\u6D88\u5355",
+      method: "POST",
+      path: `/return_refund/202309/cancellations/${args2.id}/reject`,
+      body: { reject_reason: args2.reason }
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/return_refund/202309/cancellations/${args2.id}/reject`,
+      { body: { reject_reason: args2.reason } }
+    )
+  },
+  {
+    name: "orders return-approve",
+    summary: "\u6279\u51C6\u9000\u8D27\u5355\uFF08--id return_id\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u6279\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u6279\u51C6\u9000\u8D27\u5355",
+      method: "POST",
+      path: `/return_refund/202309/returns/${args2.id}/approve`,
+      body: {}
+    }],
+    run: ({ shop, args: args2 }) => proxy("POST", shop, `/return_refund/202309/returns/${args2.id}/approve`, { body: {} })
+  },
+  {
+    name: "orders return-reject",
+    summary: "\u9A73\u56DE\u9000\u8D27\u5355\uFF08--id --reason\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u9A73\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u9A73\u56DE\u9000\u8D27\u5355",
+      method: "POST",
+      path: `/return_refund/202309/returns/${args2.id}/reject`,
+      body: { reject_reason: args2.reason }
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/return_refund/202309/returns/${args2.id}/reject`,
+      { body: { reject_reason: args2.reason } }
+    )
+  },
+  {
+    name: "orders create-package",
+    summary: "\u4E3A\u8BA2\u5355\u5EFA\u5305\u88F9\uFF08--order id --body-file pkg.json\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u5EFA\u3002\u4EC5\u76F4\u53D1\u5546\u5BB6\uFF08\u7269\u6D41\u9ED8\u8BA4 ERP \u7BA1\uFF09",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u5EFA\u5305\u88F9",
+      method: "POST",
+      path: `/fulfillment/202309/orders/${args2.order}/packages`,
+      body: readBodyFile(args2["body-file"])
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/fulfillment/202309/orders/${args2.order}/packages`,
+      { body: readBodyFile(args2["body-file"]) }
+    )
+  },
+  {
+    name: "packages ship",
+    summary: "\u53D1\u8D27\uFF08--package id --body-file ship.json\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u53D1\u3002\u4E0D\u53EF\u9006\uFF0C\u4EC5\u76F4\u53D1\u5546\u5BB6",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u53D1\u8D27",
+      method: "POST",
+      path: `/fulfillment/202309/packages/${args2.package}/ship`,
+      body: readBodyFile(args2["body-file"])
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/fulfillment/202309/packages/${args2.package}/ship`,
+      { body: readBodyFile(args2["body-file"]) }
+    )
+  },
   {
     name: "analytics shop",
     summary: "\u5E97\u94FA\u7ECF\u8425\u6570\u636E\uFF08--from --to\uFF0C\u9ED8\u8BA4\u8FD130\u5929\uFF09",
@@ -167,6 +332,18 @@ var COMMANDS = [
       body: {}
     })
   },
+  {
+    name: "products get",
+    summary: "\u5355\u4E2A\u5546\u54C1\u5B8C\u6574\u8BE6\u60C5\uFF08--product id\uFF1B\u9010\u5B57\u6BB5\u56DE\u8BFB\u7528\uFF1A\u6807\u9898/\u63CF\u8FF0/\u56FE/SKU/\u4EF7/\u5E93\u5B58/\u91CD\u91CF/\u5C3A\u5BF8/\u5C5E\u6027\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/product/202309/products/${args2.product}`, {})
+  },
+  {
+    name: "products diagnose",
+    summary: "\u5546\u54C1\u5B98\u65B9\u95EE\u9898\u8BCA\u65AD\uFF08--product \u9017\u53F7\u5206\u9694\u672C\u5E97\u81EA\u6709\u5546\u54C1 id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, "/product/202405/products/diagnoses", {
+      query: { product_ids: String(args2.product ?? "") }
+    })
+  },
   {
     name: "promotions list",
     summary: "\u4FC3\u9500\u6D3B\u52A8\u5217\u8868\uFF08--status ONGOING/NOT_START/EXPIRED\uFF09",
@@ -185,6 +362,17 @@ var COMMANDS = [
       }
     })
   },
+  // ===== 账号状态只读命令 =====
+  {
+    name: "seller status",
+    summary: "\u8D26\u53F7/\u5E97\u94FA\u72B6\u6001\uFF08seller_status/shop_statuses/tax_form_status\uFF09",
+    run: ({ shop }) => proxy("GET", shop, "/seller/202508/status", {})
+  },
+  {
+    name: "seller permissions",
+    summary: "\u5DF2\u6388\u6743\u6743\u9650\u5217\u8868",
+    run: ({ shop }) => proxy("GET", shop, "/seller/202309/permissions", {})
+  },
   // ===== 建品前置只读辅助命令 =====
   {
     name: "products prerequisites",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/tiktok-cli",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "TikTok Shop CLI for Optima agents — 经 tiktok-backend 操作店铺",
   "type": "module",
   "bin": {