# Alibaba Cloud LinkedMall API

> Alibaba Cloud LinkedMall API on Apizie: 26 endpoints (Cancels a refund order, Confirms the receipt of goods, Backfill shipping notice information, Creates a purchase order and returns the purchase order ID. The specific result of order creation is…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-linkedmall`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/linkedmall
- Page: https://zieapi.vercel.app/api/cloud/aliyun-linkedmall
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-linkedmall/openapi.json

Alibaba Cloud OpenAPI for LinkedMall (linkedmall, version 2023-09-30). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Cancels a refund order
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/cancel-refund-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| disputeId | string | yes | The ID of the refund order |

### Confirms the receipt of goods
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/confirm-disburse` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| orderId | string | no | The primary distribution order ID |
| purchaseOrderId | string | no | The distribution transaction ID |

### Backfill shipping notice information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/create-goods-shipping-notice` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| cpCode | string | yes | Company code |
| disputeId | string | yes | Dispute ID |
| logisticsNo | string | yes | Logistics tracking number |

### Creates a purchase order and returns the purchase order ID. The specific result of order creation is…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/create-purchase-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| buyerId | string | yes | The user ID in the distributor business, which is defined by the distributor. Assign different buyerIds to different buyers. |
| deliveryAddress | object | yes | The address information |
| extInfo | object | no | The extended information |
| outerPurchaseOrderId | string | yes | The order ID in the distributor business, which is defined by the distributor |
| productList | array | yes | The product list. Maximum number of SKUs per purchase order: 20 |

### Create a support ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/create-refund-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| applyReasonTextId | integer | yes | The refund reason ID |
| applyReasonTips | string | no | The refund reason text |
| applyRefundCount | integer | yes | The return quantity |
| applyRefundFee | integer | yes | The requested refund amount in cents |
| bizClaimType | integer | yes | The refund type. Valid values: 1: Refund only. 3: Return and refund |
| goodsStatus | integer | yes | The goods status. Valid values: 4: Not shipped. 1: Not received. 2: Received |
| leaveMessage | string | no | The message |
| leavePictureLists | array | no | The image list |
| orderLineId | string | yes | The sub-distribution order ID |

### Queries the details of an order
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/get-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| orderId | string | yes | The ID of the order |

### Retrieve the purchase order status
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/get-purchase-order-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| purchaseOrderId | string | yes | Purchase order ID |

### Retrieves the purchaser's shop
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/get-purchaser-shop` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| purchaserId | string | yes | Purchaser ID |

### Retrieve details of an after-sales order
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/get-refund-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| disputeId | string | yes | ID of the after-sales order |

### Queries the details of a product in the selection pool
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/get-selection-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| productId | string | yes | The product ID |
| purchaserId | string | yes | The ID of the purchaser |
| divisionCode | string | no | The division code. We recommend using a level-5 township or subdistrict address code |

### Queries sales information for products in the selection pool
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/get-selection-product-sale-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| productId | string | yes | Product ID |
| purchaserId | string | yes | Purchaser ID |
| divisionCode | string | no | Administrative division code. We recommend using a five-level code (township or subdistrict level) |

### Lists categories
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/list-categories` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| categoryIds | array | no | Collection of category IDs |
| parentCategoryId | integer | no | Parent category ID |

### Query logistics information for an order
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/list-logistics-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| orderId | string | yes | Order ID |

### Lists purchaser shops
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/list-purchaser-shops` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| pageNumber | integer | no | Page number of the request |
| pageSize | integer | no | Number of items per page |

### Query product sales information for the selection pool in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/list-selection-product-sale-infos` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| divisionCode | string | no | Area code (recommended to use a five-level township/street-level address code) |
| productIds | array | yes | Collection of product IDs to query, supporting batch queries of 1 to 10 items |
| purchaserId | string | yes | Purchaser ID |

### Retrieves a list of products from a product selection pool
`GET https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/list-selection-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| pageSize | integer | yes | The number of entries per page. Valid values: 1 to 20 |
| pageNumber | integer | yes | The page number. The value must be 1 or greater |
| purchaserId | string | yes | The ID of the purchaser |

### Query SKU sales information for items in the selection pool in batch
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/list-selection-sku-sale-infos` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| divisionCode | string | no | The division code. A level-5 township or sub-district address code is recommended |
| purchaserId | string | yes | The purchaser ID |
| skuQueryParams | array | yes | The product query parameters. The maximum number of SKUs that can be queried in a single request is 20 |

### Queries child division codes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/query-child-division-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| divisionCode | string | yes | divisionCode |

### Lists orders
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/query-orders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| orderIdList | array | no | The collection of primary order IDs |
| outPurchaseOrderId | string | no | The external purchase order ID |
| pageNumber | integer | yes | The page number |
| pageSize | integer | yes | The number of entries per page |
| purchaseOrderId | string | no | The purchase order ID |

### Renders a purchase order and returns both sellable and unsellable products. Customers can then select the…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/render-purchase-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| buyerId | string | yes | The actual buyer ID for distribution. Assign a unique ID to each buyer. Do not use the same ID for different buyers. |
| deliveryAddress | object | yes | The address information |
| extInfo | object | no | The extension information |
| productList | array | yes | The product list. Maximum number of SKUs per purchase order: 20 |

### Reverse Single Rendering
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/render-refund-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| bizClaimType | integer | yes | Refund Type: 1 for refund only, 3 for return and refund |
| goodsStatus | integer | yes | Goods Status: 4 for not shipped, 1 for not received, 2 for received |
| orderLineId | string | yes | Sub-distribution order ID |

### Queries products based on various conditions and returns paginated results
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/search-products` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| brandName | string | no | The brand name |
| categoryIds | array | no | The category IDs |
| createEndTime | string | no | The end time of the creation. Format: yyyy-MM-dd HH:mm:ss |
| createStartTime | string | no | The start time of the creation. Format: yyyy-MM-dd HH:mm:ss |
| distributionHighPrice | integer | no | The maximum distribution purchase price. Unit: cents |
| distributionHighPriceRatio | integer | no | The maximum distribution premium rate. A value of 244 indicates 2.44% |
| distributionLowPrice | integer | no | The minimum distribution purchase price. Unit: cents |
| distributionLowPriceRatio | integer | no | The minimum distribution premium rate. A value of 133 indicates 1.33% |
| highMarkPrice | integer | no | The maximum strikethrough price. Unit: cents |
| highPrice | integer | no | The maximum suggested retail price. Unit: cents |
| inGroup | string | no | Specifies whether the product is added to the inventory |
| inGroupEndTime | string | no | The end time when the product was added to the inventory. Format: yyyy-MM-dd HH:mm:ss |
| inGroupStartTime | string | no | The start time when the product was added to the inventory. Format: yyyy-MM-dd HH:mm:ss |
| inventoryRiskLevel | string | no | The inventory risk level |
| lmItemId | string | no | The LM product ID |
| lowMarkPrice | integer | no | The minimum strikethrough price. Unit: cents |
| lowPrice | integer | no | The minimum suggested retail price. Unit: cents |
| modifyEndTime | string | no | The end time of the modification. Format: yyyy-MM-dd HH:mm:ss |
| modifyStartTime | string | no | The start time of the modification. Format: yyyy-MM-dd HH:mm:ss |
| orderBy | string | no | The field used for sorting. This parameter must be used in combination with the sort direction parameter |
| orderDirection | string | no | The sort direction. This parameter must be used in combination with the sort field parameter |
| pageNumber | integer | yes | The page number |
| pageSize | integer | yes | The number of entries per page. Maximum value: 20 |
| platform | string | no | The source platform |
| productId | string | no | The product ID |
| productName | string | no | The product name |
| productStatus | string | no | The product status |
| purchaserId | string | yes | The ID of the purchaser |
| taxRate | string | no | The tax rate. You can combine multiple tax rate enum values as input parameters. Separate them with commas (,). Example: Rate0,Rate1.… |
| tradeModeAndCredit | string | no | The sales mode |

### The distributor takes delivery of goods
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/selection-group-add-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| productIds | array | yes | Collection of product IDs to add You can add up to 30 products per call |
| purchaserId | string | yes | Purchaser ID |

### Removes products from a distributor's stock
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/selection-group-remove-product` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| productIds | array | yes | A list of IDs for the products to be removed from stock. A single call supports a maximum of 30 products |
| purchaserId | string | yes | The ID of the purchaser |

### Splits a purchase order and renders the resulting parent-child order structure. This API returns a list of…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/split-purchase-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |
| buyerId | string | yes | The actual buyer ID for distribution. Assign a unique ID to each buyer. Do not use the same ID for different buyers. |
| deliveryAddress | object | yes | The address information |
| extInfo | object | no | The extension information |
| productList | array | yes | The product list. Maximum number of SKUs per purchase order: 20 |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://linkedmall.cn-hangzhou.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/cancel-refund-order" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud LinkedMall API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-linkedmall/cancel-refund-order with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud LinkedMall API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud LinkedMall itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud LinkedMall API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-linkedmall.

### What is the status of the Alibaba Cloud LinkedMall API?
Needs your own provider key (bring your own key)