@oomol-lab/open-connector 1.6.3 → 1.6.5

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

@@ -0,0 +1,1785 @@
+{
+  "service": "shopee",
+  "displayName": "Shopee",
+  "description": "Manage Shopee products, orders, logistics, returns, and merchant data.",
+  "categories": [
+    "E-commerce"
+  ],
+  "authTypes": [
+    "oauth2"
+  ],
+  "auth": [
+    {
+      "type": "oauth2",
+      "authorizationUrl": "{+authorizationBaseUrl}/api/v2/shop/auth_partner",
+      "tokenUrl": "{+apiBaseUrl}/api/v2/auth/token/get",
+      "refreshTokenUrl": "{+apiBaseUrl}/api/v2/auth/access_token/get",
+      "scopes": [
+        "all"
+      ],
+      "tokenEndpointAuthMethod": "none",
+      "authorizationParams": {
+        "auth_type": "seller"
+      },
+      "authorizationRequestFields": {
+        "clientId": "partner_id",
+        "scope": false
+      },
+      "clientConfigFields": [
+        {
+          "key": "authorizationBaseUrl",
+          "label": "Authorization Base URL",
+          "required": true,
+          "secret": false,
+          "inputType": "text",
+          "location": "extra",
+          "defaultValue": "https://open.shopee.cn",
+          "description": "Use https://open.shopee.cn for production or https://open.sandbox.test-stable.shopee.cn for sandbox."
+        },
+        {
+          "key": "apiBaseUrl",
+          "label": "API Base URL",
+          "required": true,
+          "secret": false,
+          "inputType": "text",
+          "location": "extra",
+          "defaultValue": "https://partner.shopeemobile.com",
+          "description": "Use https://partner.shopeemobile.com for production or https://openplatform.sandbox.test-stable.shopee.sg for sandbox."
+        }
+      ],
+      "clientSetup": {
+        "docsUrl": "https://open.shopee.com/",
+        "steps": [
+          "Create a Shopee Open Platform app and register the callback URL shown below.",
+          "Copy the Partner ID into Client ID and the Partner Key into Client Secret.",
+          "Keep both endpoint fields on production, or switch both to their documented sandbox values."
+        ]
+      }
+    }
+  ],
+  "homepageUrl": "https://www.shopee.com/",
+  "actions": [
+    {
+      "id": "shopee.create_global_item",
+      "service": "shopee",
+      "name": "create_global_item",
+      "description": "Create a Shopee global product draft for a mainland China CNSC merchant.",
+      "operationType": "write",
+      "requiredScopes": [
+        "shopee.write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          },
+          "categoryId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee global category ID."
+          },
+          "name": {
+            "type": "string",
+            "description": "The global product name."
+          },
+          "description": {
+            "type": "string",
+            "description": "The global product description."
+          },
+          "sku": {
+            "type": "string",
+            "description": "The seller-defined global product SKU."
+          },
+          "imageIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "A Shopee Media Space image ID."
+            },
+            "description": "Shopee Media Space image IDs for the product.",
+            "minItems": 1,
+            "maxItems": 9,
+            "uniqueItems": true
+          },
+          "originalPrice": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "description": "The original global product price in the merchant base currency."
+          },
+          "stock": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The available normal stock for the product."
+          },
+          "weight": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "description": "The package weight in kilograms."
+          },
+          "packageLength": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "description": "The package length in centimeters."
+          },
+          "packageWidth": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "description": "The package width in centimeters."
+          },
+          "packageHeight": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "description": "The package height in centimeters."
+          },
+          "daysToShip": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The number of days needed to ship the product."
+          },
+          "condition": {
+            "type": "string",
+            "enum": [
+              "NEW",
+              "USED"
+            ],
+            "description": "The product condition."
+          },
+          "brandId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee brand ID."
+          },
+          "brandName": {
+            "type": "string",
+            "description": "The original brand name."
+          },
+          "attributes": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "attributeId": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "The Shopee attribute ID."
+                },
+                "values": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "valueId": {
+                        "type": "integer",
+                        "description": "The predefined Shopee attribute value ID, or 0 for a custom value."
+                      },
+                      "originalValueName": {
+                        "type": "string",
+                        "description": "The predefined or custom attribute value name."
+                      },
+                      "valueUnit": {
+                        "type": "string",
+                        "description": "The unit for a quantitative attribute value."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "description": "A value assigned to a Shopee global product attribute."
+                  },
+                  "description": "The values selected for this attribute.",
+                  "minItems": 1
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "attributeId"
+              ],
+              "description": "A Shopee global product attribute and its selected values."
+            },
+            "description": "The product attributes required by its category."
+          },
+          "sellerStock": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "locationId": {
+                  "type": "string",
+                  "description": "The Shopee seller stock location ID."
+                },
+                "stock": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "description": "The available stock at this location."
+                }
+              },
+              "additionalProperties": false,
+              "description": "Stock held at a Shopee seller stock location."
+            },
+            "description": "Stock allocated to Shopee seller stock locations."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "categoryId",
+          "name",
+          "description",
+          "originalPrice",
+          "weight",
+          "daysToShip",
+          "condition"
+        ],
+        "description": "The product information used to create a Shopee global product draft."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_global_attribute_tree",
+      "service": "shopee",
+      "name": "get_global_attribute_tree",
+      "description": "Get Shopee global product attributes for up to 20 category IDs.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          },
+          "categoryIds": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "A Shopee global category ID."
+            },
+            "description": "The global category IDs whose attribute definitions should be returned.",
+            "minItems": 1,
+            "maxItems": 20,
+            "uniqueItems": true
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "en",
+              "zh-hans"
+            ],
+            "description": "The language used for category and attribute names."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "categoryIds"
+        ],
+        "description": "The merchant, categories, and display language for global product attributes."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_global_items",
+      "service": "shopee",
+      "name": "get_global_items",
+      "description": "Get details for up to 20 Shopee global products.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          },
+          "globalItemIds": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "A Shopee global product ID."
+            },
+            "description": "The global product IDs to retrieve.",
+            "minItems": 1,
+            "maxItems": 20,
+            "uniqueItems": true
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "globalItemIds"
+        ],
+        "description": "Shopee global product identifiers."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_item_models",
+      "service": "shopee",
+      "name": "get_item_models",
+      "description": "Get variation tiers, model prices, and model stock for a Shopee shop item.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "itemId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee item ID."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "itemId"
+        ],
+        "description": "A Shopee shop item whose variation models should be returned."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_merchant_info",
+      "service": "shopee",
+      "name": "get_merchant_info",
+      "description": "Get the identity, region, currency, and authorization status of a Shopee merchant.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          }
+        },
+        "additionalProperties": false,
+        "description": "A Shopee merchant selected from the authorized CNSC account."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_order_escrow",
+      "service": "shopee",
+      "name": "get_order_escrow",
+      "description": "Get Shopee accounting and fee details for one order.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "orderSerialNumber": {
+            "type": "string",
+            "description": "The Shopee order serial number."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "orderSerialNumber"
+        ],
+        "description": "A Shopee order whose escrow accounting should be returned."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_orders",
+      "service": "shopee",
+      "name": "get_orders",
+      "description": "Get detailed information for up to 50 Shopee orders from one shop.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "orderSerialNumbers": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "A Shopee order serial number."
+            },
+            "description": "The Shopee order serial numbers to retrieve.",
+            "minItems": 1,
+            "maxItems": 50,
+            "uniqueItems": true
+          },
+          "optionalFields": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "description": "A field name from the Shopee get order detail API."
+            },
+            "description": "Additional documented order fields to include in the response.",
+            "minItems": 1,
+            "uniqueItems": true
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "orderSerialNumbers"
+        ],
+        "description": "Shopee order identifiers and optional response fields."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_return",
+      "service": "shopee",
+      "name": "get_return",
+      "description": "Get the details and current workflow state of a Shopee return.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "returnSerialNumber": {
+            "type": "string",
+            "description": "The Shopee return serial number."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "returnSerialNumber"
+        ],
+        "description": "A Shopee return selected from one shop."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_shipping_parameters",
+      "service": "shopee",
+      "name": "get_shipping_parameters",
+      "description": "Get the pickup, drop-off, or non-integrated shipping options for an order package.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "orderSerialNumber": {
+            "type": "string",
+            "description": "The Shopee order serial number."
+          },
+          "packageNumber": {
+            "type": "string",
+            "description": "The package number for an order split into packages."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "orderSerialNumber"
+        ],
+        "description": "A Shopee order package ready for shipment."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_shop_info",
+      "service": "shopee",
+      "name": "get_shop_info",
+      "description": "Get the profile, region, authorization, and cross-border status of a Shopee shop.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          }
+        },
+        "additionalProperties": false,
+        "description": "A Shopee shop selected from the authorized account."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_shop_items",
+      "service": "shopee",
+      "name": "get_shop_items",
+      "description": "Get base information for up to 50 Shopee shop items.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "itemIds": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "A Shopee item ID."
+            },
+            "description": "The Shopee item IDs to retrieve.",
+            "minItems": 1,
+            "maxItems": 50,
+            "uniqueItems": true
+          },
+          "includeTaxInfo": {
+            "type": "boolean",
+            "description": "Whether to include item tax information."
+          },
+          "includeComplaintPolicy": {
+            "type": "boolean",
+            "description": "Whether to include item complaint policies."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "itemIds"
+        ],
+        "description": "Shopee shop item identifiers and optional detail sections."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_tracking_info",
+      "service": "shopee",
+      "name": "get_tracking_info",
+      "description": "Get logistics tracking events for a Shopee order package.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "orderSerialNumber": {
+            "type": "string",
+            "description": "The Shopee order serial number."
+          },
+          "packageNumber": {
+            "type": "string",
+            "description": "The package number for an order split into packages."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "orderSerialNumber"
+        ],
+        "description": "A shipped Shopee order package."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.get_tracking_number",
+      "service": "shopee",
+      "name": "get_tracking_number",
+      "description": "Get carrier tracking numbers for a shipped Shopee order package.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "orderSerialNumber": {
+            "type": "string",
+            "description": "The Shopee order serial number."
+          },
+          "packageNumber": {
+            "type": "string",
+            "description": "The package number for an order split into packages."
+          },
+          "optionalFields": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "plp_number",
+                "first_mile_tracking_number",
+                "last_mile_tracking_number"
+              ],
+              "description": "A supported tracking number field."
+            },
+            "description": "Additional tracking number fields to return.",
+            "uniqueItems": true
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "orderSerialNumber"
+        ],
+        "description": "A shipped Shopee order package and optional tracking fields."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.list_global_brands",
+      "service": "shopee",
+      "name": "list_global_brands",
+      "description": "List Shopee brands available for a global product category.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          },
+          "categoryId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee global category ID."
+          },
+          "offset": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The zero-based result offset."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "The number of brands to return, from 1 to 100."
+          },
+          "status": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 2,
+            "description": "The brand status: 1 for normal or 2 for pending."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "categoryId"
+        ],
+        "description": "The category and pagination parameters for Shopee global brands."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.list_global_categories",
+      "service": "shopee",
+      "name": "list_global_categories",
+      "description": "List the Shopee global product category tree for a cross-border merchant.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          },
+          "language": {
+            "type": "string",
+            "enum": [
+              "en",
+              "zh-hans"
+            ],
+            "description": "The language used for category and attribute names."
+          }
+        },
+        "additionalProperties": false,
+        "description": "The merchant and display language for the global category tree."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.list_global_items",
+      "service": "shopee",
+      "name": "list_global_items",
+      "description": "List global products owned by a Shopee cross-border merchant.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          },
+          "cursor": {
+            "type": "string",
+            "description": "The cursor returned by the previous page."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 50,
+            "description": "The number of global products to return, from 1 to 50."
+          },
+          "updatedFrom": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The earliest item update time as a Unix timestamp in seconds."
+          },
+          "updatedTo": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The latest item update time as a Unix timestamp in seconds."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Cursor and update-time filters for Shopee global products."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.list_merchant_shops",
+      "service": "shopee",
+      "name": "list_merchant_shops",
+      "description": "List shops authorized and bound to a Shopee merchant.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "merchantId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee merchant ID. Omit it when the connection has exactly one merchant."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based page number to retrieve."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500,
+            "description": "The number of shops to return, from 1 to 500."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Pagination parameters for shops bound to a Shopee merchant."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.list_orders",
+      "service": "shopee",
+      "name": "list_orders",
+      "description": "List Shopee shop orders created or updated in a time range of at most 15 days.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "timeRangeField": {
+            "type": "string",
+            "enum": [
+              "create_time",
+              "update_time"
+            ],
+            "description": "The order timestamp field used for the range."
+          },
+          "timeFrom": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The inclusive range start as a Unix timestamp in seconds."
+          },
+          "timeTo": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The inclusive range end as a Unix timestamp in seconds."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "The number of orders to return, from 1 to 100."
+          },
+          "cursor": {
+            "type": "string",
+            "description": "The cursor returned by the previous page."
+          },
+          "orderStatus": {
+            "type": "string",
+            "enum": [
+              "UNPAID",
+              "READY_TO_SHIP",
+              "PROCESSED",
+              "SHIPPED",
+              "COMPLETED",
+              "IN_CANCEL",
+              "CANCELLED",
+              "INVOICE_PENDING"
+            ],
+            "description": "The Shopee order status to include."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "timeFrom",
+          "timeTo"
+        ],
+        "description": "Filters and cursor pagination for Shopee shop orders."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.list_returns",
+      "service": "shopee",
+      "name": "list_returns",
+      "description": "List Shopee returns by creation time, update time, and workflow status.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The one-based page number."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "The number of returns to include, from 1 to 100."
+          },
+          "createdFrom": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The earliest return creation time as a Unix timestamp."
+          },
+          "createdTo": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The latest return creation time as a Unix timestamp."
+          },
+          "updatedFrom": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The earliest return update time as a Unix timestamp."
+          },
+          "updatedTo": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The latest return update time as a Unix timestamp."
+          },
+          "status": {
+            "type": "string",
+            "description": "A Shopee ReturnStatus value."
+          },
+          "negotiationStatus": {
+            "type": "string",
+            "description": "A Shopee NegotiationStatus value."
+          },
+          "sellerProofStatus": {
+            "type": "string",
+            "description": "A Shopee SellerProofStatus value."
+          },
+          "sellerCompensationStatus": {
+            "type": "string",
+            "description": "A Shopee SellerCompensationStatus value."
+          }
+        },
+        "additionalProperties": false,
+        "description": "Filters and page pagination for Shopee returns."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.list_shop_items",
+      "service": "shopee",
+      "name": "list_shop_items",
+      "description": "List Shopee shop items by listing status and update time.",
+      "operationType": "read",
+      "requiredScopes": [
+        "shopee.read"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "offset": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The zero-based result offset."
+          },
+          "pageSize": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "The number of items to return, from 1 to 100."
+          },
+          "statuses": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "NORMAL",
+                "BANNED",
+                "UNLIST",
+                "REVIEWING",
+                "SELLER_DELETE",
+                "SHOPEE_DELETE"
+              ],
+              "description": "A Shopee listing status."
+            },
+            "description": "The listing statuses to include.",
+            "minItems": 1,
+            "uniqueItems": true
+          },
+          "updatedFrom": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The earliest item update time as a Unix timestamp."
+          },
+          "updatedTo": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "The latest item update time as a Unix timestamp."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "statuses"
+        ],
+        "description": "Filters and offset pagination for Shopee shop items."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.ship_order",
+      "service": "shopee",
+      "name": "ship_order",
+      "description": "Arrange pickup, drop-off, or non-integrated shipment for a Shopee order package.",
+      "operationType": "write",
+      "requiredScopes": [
+        "shopee.write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "orderSerialNumber": {
+            "type": "string",
+            "description": "The Shopee order serial number."
+          },
+          "packageNumber": {
+            "type": "string",
+            "description": "The package number for an order split into packages."
+          },
+          "pickup": {
+            "type": "object",
+            "properties": {
+              "addressId": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The pickup address ID."
+              },
+              "pickupTimeId": {
+                "type": "string",
+                "description": "The pickup time-slot ID."
+              },
+              "trackingNumber": {
+                "type": "string",
+                "description": "A carrier-assigned tracking number when required."
+              }
+            },
+            "additionalProperties": false,
+            "required": [
+              "addressId"
+            ],
+            "description": "Pickup options returned by Shopee."
+          },
+          "dropoff": {
+            "type": "object",
+            "properties": {
+              "branchId": {
+                "type": "integer",
+                "minimum": 1,
+                "description": "The carrier branch ID."
+              },
+              "senderRealName": {
+                "type": "string",
+                "description": "The sender's legal name when required."
+              },
+              "trackingNumber": {
+                "type": "string",
+                "description": "A carrier-assigned tracking number when required."
+              },
+              "slug": {
+                "type": "string",
+                "description": "The selected third-party logistics provider slug."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Drop-off options returned by Shopee."
+          },
+          "nonIntegrated": {
+            "type": "object",
+            "properties": {
+              "trackingNumber": {
+                "type": "string",
+                "description": "The carrier-assigned tracking number."
+              }
+            },
+            "additionalProperties": false,
+            "description": "Options for a non-integrated logistics channel."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "orderSerialNumber"
+        ],
+        "description": "A Shopee order package and one shipping method returned by get_shipping_parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.update_item_prices",
+      "service": "shopee",
+      "name": "update_item_prices",
+      "description": "Replace prices for up to 50 models of one Shopee shop item.",
+      "operationType": "destructive",
+      "requiredScopes": [
+        "shopee.write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "itemId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee item ID."
+          },
+          "prices": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "modelId": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "The Shopee model ID. Omit it for an item without variations."
+                },
+                "originalPrice": {
+                  "type": "number",
+                  "exclusiveMinimum": 0,
+                  "description": "The new original price in the shop currency."
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "originalPrice"
+              ],
+              "description": "A new price for an item or variation model."
+            },
+            "description": "The replacement prices for the item or its models.",
+            "minItems": 1,
+            "maxItems": 50
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "itemId",
+          "prices"
+        ],
+        "description": "A Shopee shop item and its replacement prices."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.update_item_stocks",
+      "service": "shopee",
+      "name": "update_item_stocks",
+      "description": "Replace seller stock for up to 50 models of one Shopee shop item.",
+      "operationType": "destructive",
+      "requiredScopes": [
+        "shopee.write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "itemId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee item ID."
+          },
+          "stocks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "modelId": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "The Shopee model ID. Omit it for an item without variations."
+                },
+                "sellerStock": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "locationId": {
+                        "type": "string",
+                        "description": "The warehouse location ID returned by Shopee."
+                      },
+                      "stock": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "description": "The new available stock at this location."
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "stock"
+                    ],
+                    "description": "Stock assigned to one seller warehouse location."
+                  },
+                  "description": "The new seller stock values, optionally split by warehouse location.",
+                  "minItems": 1
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "sellerStock"
+              ],
+              "description": "New stock for an item or variation model."
+            },
+            "description": "The replacement stock for the item or its models.",
+            "minItems": 1,
+            "maxItems": 50
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "itemId",
+          "stocks"
+        ],
+        "description": "A Shopee shop item and its replacement seller stock."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    },
+    {
+      "id": "shopee.upload_product_image",
+      "service": "shopee",
+      "name": "upload_product_image",
+      "description": "Download a public image URL and upload it to Shopee Media Space for products.",
+      "operationType": "write",
+      "requiredScopes": [
+        "shopee.write"
+      ],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "shopId": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The Shopee shop ID. Omit it when the connection has exactly one shop."
+          },
+          "imageUrl": {
+            "type": "string",
+            "description": "A public HTTPS URL for a JPG, JPEG, or PNG image up to 10 MB.",
+            "format": "uri"
+          },
+          "scene": {
+            "type": "string",
+            "enum": [
+              "normal",
+              "desc"
+            ],
+            "description": "How Shopee processes the image."
+          },
+          "ratio": {
+            "type": "string",
+            "enum": [
+              "1:1",
+              "3:4"
+            ],
+            "description": "The requested image ratio for eligible sellers."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "imageUrl"
+        ],
+        "description": "A public image URL and Shopee image processing options."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "requestId": {
+            "type": "string",
+            "description": "The Shopee request ID used for upstream error tracking."
+          },
+          "data": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "The response data returned by Shopee Open Platform."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "data"
+        ],
+        "description": "A normalized Shopee Open Platform response."
+      }
+    }
+  ]
+}