PrestaShop Category

PrestaShop Category connects your flow to the categories of your PrestaShop store’s catalogue, the sections that group your products. With it you can get the list of categories or one specific category, create new categories inside another one, change their name, description or visibility, and delete them.

It is useful when you organise the catalogue from somewhere else, or when another step of the flow needs to know which categories exist, for example before adding products.

When to use it

• You launch a new product line and want to create its category and subcategories in one go.
• You want to hide a seasonal category when the campaign ends.
• You need each category’s number to assign it to the products you add with PrestaShop Product.
• You want to export the category structure to a spreadsheet to review it.

Configuration

You need a PrestaShop credential with your store’s address and a PrestaShop web service key. You create the key in the PrestaShop admin panel, under Advanced Parameters > Webservice, by enabling the web service and giving the key access to categories. See Credentials.

Field	What it does
Credential (required)	The PrestaShop credential used to access your store.
Operation	What the component does. See Operations. Default: Get Categories.
Query Type	Only in Get Categories. List returns a list of categories; By ID returns one specific category. Default: List.
Category ID	The category’s number in PrestaShop. Required in Get Categories with By ID, Update Category and Delete Category.
Max Results	Only in Get Categories with List. The maximum number of categories to return. Default: 50.
Category Name	Only in Create Category and Update Category. The category’s name. Required when creating.
Description	Only in Create Category and Update Category. The category’s description.
Parent Category	Only in Create Category and Update Category. The category it is placed in. The list loads when you choose the credential and suggests the store’s home category.
Active	Only in Create Category and Update Category. Whether the category is visible in the store. Default: on.

Operations

Operation	What it does
Get Categories	Returns a list of categories (List) or the details of one category (By ID).
Create Category	Creates a new category inside the one chosen in Parent Category.
Update Category	Changes an existing category’s details. The name and description only change if you fill them in.
Delete Category	Deletes the category with that number.

Fields that always apply when updating

In Update Category, Active and Parent Category are always applied. Before updating, check that Active is set the way you want and that Parent Category is the category it is in now; otherwise the category moves to the one shown in that field.

Output

The Data output depends on the operation:

• Get Categories: the category’s number, name, the number of the category that contains it, whether it is active, its description and its depth in the category tree. With List you get one item per category.
• Create Category: a confirmation with the new category’s number and name.
• Update Category and Delete Category: a confirmation with the category number.

You can connect the result to a spreadsheet, an agent or PrestaShop Product. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

A sports shop opens a padel section.

1. Add PrestaShop Category with the Create Category operation and the shop’s PrestaShop credential.
2. In Category Name write Padel and in Description a sentence for the section page.
3. In Parent Category choose the Racket sports category and leave Active on.
4. Connect the Data output to an email that tells the content team the new category’s number, so they can assign it to the padel products.

Related components

• PrestaShop Product: manage the catalogue’s products.
• PrestaShop Order: look up orders and change their status.
• PrestaShop Customer: manage the store’s customers.