Import: Get Organization & Category Choices
get_pre_publish_product_organization[Import List Product]
[What it does] Reads current and available Organization and Category values for pre-publish products in one target store. Organization includes Collection, Type, Tags, and Vendor.
[When to use] Use it when the user wants to inspect or change category, collection, tags, vendor, or URL settings before publishing. It is the normal read-and-review step before update_pre_publish_product_organization; call that Tool only when the user chooses a change. It is optional when no Organization or Category review is needed.
[When not to use] For product content and variants, use get_pre_publish_product. To save actual changes, use update_pre_publish_product_organization. It is not a prerequisite for publish_products_to_stores.
[How to use]
import_item_ids(1 to 100) anddsers_store_idare required; send the whole selection at once. Store choices are shared and each item returns its current store-specific selections.For a multi-store review, call once per store and use only choices returned for that store.
When
organizations_truncatedorcategories_truncatedis true, narrow withorganization_name,keyword, orcategory_keywordand re-read.categories_supported=falsemeans the platform returned no categories.select_number=0means no declared upper limit, andis_createcontrols whether new values may be created.Show choices to the user before applying changes. A batch read can fail per item, so inspect each failure reason and retryable flag. [Side effects] None. [Confirmation] Not required.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"import_item_ids": "<import_item_ids>",
"dsers_store_id": "<dsers_store_id>"
},
"name": "get_pre_publish_product_organization"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | No | Optional Organization value keyword filter. Omit to return all available values. | |
| dsers_store_id | Yes | The target store ID selected by the user. Copy from list_stores response. Required. | |
| marketplace_id | No | Optional seller marketplace ID used by stores whose Category API is marketplace-specific. | |
| import_item_ids | Yes | All import-list IDs selected in the user's current request, from one to 100. Send them together in one call; never split a known multi-product selection into repeated single-ID calls. Shared organization/category choices are returned once and each item includes its current store-specific selections. Paste JSON example: ["2085934367682592768"]. | |
| category_keyword | No | Optional case-insensitive Category ID or name filter. Use it when categories_truncated is true. | |
| organization_name | No | Optional exact Organization field filter, such as Type, Tags, or Vendor. Omit to return all fields. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | Per-import-item current settings when import_item_ids is used | |
| categories | Yes | Available flattened category choices | |
| organizations | Yes | Available store organization fields and values | |
| dsers_store_id | Yes | Target DSers store ID | |
| import_item_id | No | Import-list item ID | |
| categories_supported | Yes | True when the store returned category choices | |
| categories_truncated | Yes | Whether matching categories were omitted; refine category_keyword when true | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. | |
| organizations_truncated | Yes | Whether available Organization fields or values were omitted; refine organization_name or keyword when true |