@oomol-lab/open-connector 1.6.5 → 1.8.0

package/assets/open-connector/catalog/apps/weixin_store.json

@@ -294,6 +294,203 @@
         "weixin_store.listing_product"
       ]
     },
+    {
+      "id": "weixin_store.apply_category",
+      "service": "weixin_store",
+      "name": "apply_category",
+      "description": "Apply for permission to sell in a leaf category using the new category tree and certificate groups. Returns an audit id; check the audit and effective permission before publishing products.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "Apply for categories in the connected WeChat Store"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "categoryInfo": {
+            "type": "object",
+            "properties": {
+              "cats_v2": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "cat_id": {
+                      "anyOf": [
+                        {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "The id as a number."
+                        },
+                        {
+                          "type": "string",
+                          "pattern": "^[1-9][0-9]*$",
+                          "description": "The id as a numeric string."
+                        }
+                      ],
+                      "description": "One category id in the path."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "cat_id"
+                  ],
+                  "description": "One category in the path."
+                },
+                "description": "The category path from root to leaf, using cat_id values from list_categories.",
+                "minItems": 1
+              },
+              "license_group_list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "license_group_id": {
+                      "anyOf": [
+                        {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "The id as a number."
+                        },
+                        {
+                          "type": "string",
+                          "pattern": "^[1-9][0-9]*$",
+                          "description": "The id as a numeric string."
+                        }
+                      ],
+                      "description": "The required certificate group id."
+                    },
+                    "license": {
+                      "type": "object",
+                      "properties": {
+                        "license_id": {
+                          "anyOf": [
+                            {
+                              "type": "integer",
+                              "minimum": 1,
+                              "description": "The id as a number."
+                            },
+                            {
+                              "type": "string",
+                              "pattern": "^[1-9][0-9]*$",
+                              "description": "The id as a numeric string."
+                            }
+                          ],
+                          "description": "One permitted license id in the group."
+                        },
+                        "file_id_list": {
+                          "type": "array",
+                          "items": {
+                            "type": "string",
+                            "minLength": 1
+                          },
+                          "description": "Qualification image file ids from upload_qualification_image."
+                        },
+                        "license_field_list": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "key": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "The license field key."
+                              },
+                              "value": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "The license field value."
+                              }
+                            },
+                            "additionalProperties": false,
+                            "required": [
+                              "key",
+                              "value"
+                            ],
+                            "description": "One license field."
+                          },
+                          "description": "The required license fields for this certificate."
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "license_id",
+                        "file_id_list",
+                        "license_field_list"
+                      ],
+                      "description": "The selected license."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "license_group_id",
+                    "license"
+                  ],
+                  "description": "One certificate group selection."
+                },
+                "description": "One selected license for each required certificate group from list_categories; empty when no licenses are required."
+              },
+              "brand_list": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "brand_id": {
+                      "anyOf": [
+                        {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "The id as a number."
+                        },
+                        {
+                          "type": "string",
+                          "pattern": "^[1-9][0-9]*$",
+                          "description": "The id as a numeric string."
+                        }
+                      ],
+                      "description": "An approved brand id from list_valid_brands."
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "brand_id"
+                  ],
+                  "description": "An approved brand."
+                },
+                "description": "Approved brand ids, required when get_category reports attr.is_limit_brand=true.",
+                "minItems": 1
+              }
+            },
+            "additionalProperties": true,
+            "required": [
+              "cats_v2",
+              "license_group_list"
+            ],
+            "description": "The new category application, using WeChat field names."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "categoryInfo"
+        ],
+        "description": "The category application. The new certificate-group protocol is used automatically."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "audit_id": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The audit id to pass to get_category_application."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The created category audit application."
+      },
+      "followUpActions": [
+        "weixin_store.get_category_application"
+      ]
+    },
     {
       "id": "weixin_store.delete_product",
       "service": "weixin_store",
@@ -464,8 +661,18 @@
         "type": "object",
         "properties": {
           "catId": {
-            "type": "integer",
-            "minimum": 1,
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
             "description": "The id of a leaf category from list_categories."
           }
         },
@@ -505,6 +712,166 @@
         "description": "The upstream WeChat category detail."
       }
     },
+    {
+      "id": "weixin_store.get_category_application",
+      "service": "weixin_store",
+      "name": "get_category_application",
+      "description": "Get the status and any rejection reason of a category application by audit id.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "auditId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The audit_id returned by apply_category."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "auditId"
+        ],
+        "description": "The category application to inspect."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "info": {
+            "type": "object",
+            "properties": {
+              "audit_id": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The audit id."
+              },
+              "cat_id": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The leaf category id."
+              },
+              "status": {
+                "type": "integer",
+                "description": "1 = in review, 2 = rejected, 3 = approved, 4 = canceled."
+              },
+              "audit_reason": {
+                "type": "string",
+                "description": "The rejection reason, when rejected."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The audit status and submitted materials."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The category audit application."
+      }
+    },
+    {
+      "id": "weixin_store.get_category_product_rule",
+      "service": "weixin_store",
+      "name": "get_category_product_rule",
+      "description": "Get the category's product attribute, sale attribute, qualification, price, and other publishing rules for the chosen release mode.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "catId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The leaf category id."
+          },
+          "releaseMode": {
+            "anyOf": [
+              {
+                "const": 0,
+                "type": "number"
+              },
+              {
+                "const": 1,
+                "type": "number"
+              }
+            ],
+            "description": "0 = normal, 1 = simplified."
+          },
+          "brandId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "An approved brand id when publishing a branded product."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "catId",
+          "releaseMode"
+        ],
+        "description": "The category publishing rules to retrieve."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "product_attr_list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One product attribute rule."
+            },
+            "description": "Product attribute requirements."
+          },
+          "sale_attr_list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One sale attribute rule."
+            },
+            "description": "SKU attribute requirements."
+          },
+          "product_qua_list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "One qualification rule."
+            },
+            "description": "Product qualification requirements."
+          },
+          "floor_price": {
+            "type": "integer",
+            "description": "The lowest allowed sale price, in cents."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The category's product publishing rules."
+      }
+    },
     {
       "id": "weixin_store.get_freight_template",
       "service": "weixin_store",
@@ -844,6 +1211,66 @@
         "description": "The upstream WeChat category trees."
       }
     },
+    {
+      "id": "weixin_store.list_category_permissions",
+      "service": "weixin_store",
+      "name": "list_category_permissions",
+      "description": "List the store's category permissions. Filter to status 1 to find categories currently allowed for sale.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "anyOf": [
+              {
+                "const": 1,
+                "type": "number"
+              },
+              {
+                "const": 2,
+                "type": "number"
+              }
+            ],
+            "description": "1 = effective, 2 = expired; omit for both."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The category permissions to list."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "The leaf category id."
+                },
+                "status": {
+                  "type": "integer",
+                  "description": "1 = effective, 2 = expired."
+                },
+                "uneffective_reason": {
+                  "type": "string",
+                  "description": "Why an expired permission is no longer effective."
+                }
+              },
+              "additionalProperties": true,
+              "description": "One category permission."
+            },
+            "description": "The category permissions."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The store's current category permissions."
+      }
+    },
     {
       "id": "weixin_store.list_delivery_companies",
       "service": "weixin_store",
@@ -1213,6 +1640,55 @@
         "description": "The upstream WeChat response. It carries no fields on success."
       }
     },
+    {
+      "id": "weixin_store.precheck_product_category",
+      "service": "weixin_store",
+      "name": "precheck_product_category",
+      "description": "Check whether the store may publish in a leaf category, including category permission, deposit, freight insurance, and store restrictions. Omit catId for store-wide checks only.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "catId": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The id as a number."
+              },
+              {
+                "type": "string",
+                "pattern": "^[1-9][0-9]*$",
+                "description": "The id as a numeric string."
+              }
+            ],
+            "description": "The leaf category id to check; omit for a store-wide check."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The category to check before publishing."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "all_pass": {
+            "type": "boolean",
+            "description": "Whether the store may publish in the category."
+          },
+          "fail_reasons": {
+            "type": "array",
+            "items": {
+              "description": "One failure reason."
+            },
+            "description": "Reasons publishing is blocked."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The product publishing readiness check."
+      }
+    },
     {
       "id": "weixin_store.reject_aftersale",
       "service": "weixin_store",
@@ -1784,6 +2260,71 @@
         "additionalProperties": true,
         "description": "The upstream WeChat image upload response."
       }
+    },
+    {
+      "id": "weixin_store.upload_qualification_image",
+      "service": "weixin_store",
+      "name": "upload_qualification_image",
+      "description": "Upload a qualification image (up to 2 MB) and return the file_id required for category and brand applications. Product images from upload_image cannot be used here.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [
+        "Upload qualification images to the connected WeChat Store"
+      ],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "file": {
+            "type": "object",
+            "properties": {
+              "fileId": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The transit file identifier returned by POST /api/files."
+              },
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Optional filename override to send to the provider."
+              },
+              "mimeType": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Optional MIME type override to send to the provider."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "fileId"
+            ],
+            "description": "The qualification image previously uploaded to the local transit file API."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "file"
+        ],
+        "description": "The qualification image to upload."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "file_id": {
+                "type": "string",
+                "minLength": 1,
+                "description": "The file id to use in a category or brand qualification application."
+              }
+            },
+            "additionalProperties": true,
+            "description": "The uploaded file reference."
+          }
+        },
+        "additionalProperties": true,
+        "description": "The uploaded qualification image."
+      }
     }
   ]
 }