> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shop Admin

> Quick walkthrough of the Jelou Shop admin panel for managing your catalog.

The new Jelou Shop UI brings products, categories, branches, promotions, orders, activity, and settings together in a single panel, with a live preview of the webview your customers see.

## Access

Open the [Shop Admin panel](https://apps.jelou.ai/shop-v2/products).

## Products

Open in [Products](https://apps.jelou.ai/shop-v2/products).

Catalog list with search and filters by **branch**, **status**, and **stock**. Create products with the **+ New product** button.

![Product list in Shop Admin with filters and search](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/productos.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=e1b5b43c1e3fb72b02ce2a4fdf751d77)

Product list with filters by branch, status, and stock.

When you open a product you'll see the form in collapsible blocks and, on the right, a **live preview** that reflects your changes:

![Product detail with live preview](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/producto-detalle.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=975ecca7cffa237be33c0e8df7df4183)

Product detail with a live preview of the webview.

| Block | What it controls |
| - | - |
| **Product details** | SKU, name, description, price, images, categories. |
| **Taxes and discounts** | Per-product taxes and discounts (percentage or amount). |
| **Inventory and Branch** | Stock (limited or unlimited) and branch. |
| **Customization** *(advanced)* | Variations, attributes, customer note, and modifier groups. |

![Advanced sections: inventory and customization with variations, attributes, and modifiers](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/producto-secciones.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=bbeea405a5d78018f22f8f6f42744dd2)

Customization block with variations, attributes, and modifiers.

## Categories

Open in [Categories](https://apps.jelou.ai/shop-v2/categories).

Organize the catalog as a **hierarchical tree** with subcategories. Categories are created automatically when assigned to a product, or manually with **+ New category**.

![Hierarchical category tree with subcategories and product counts](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/categorias.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=40012aef6f5c081f5c731fb99633506f)

Hierarchical tree with subcategories and product count per node.

## Branches

Open in [Branches](https://apps.jelou.ai/shop-v2/branches).

Manage the points of sale where each product is sold. Each branch has **code**, **name**, **address**, **phone**, and **status**.

![Branch list with code, name, address, and status](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/sucursales.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=a35636a18e91f9b7bab41195ba292e37)

Branch list with code, name, address, and status.

## Promotions

Open in [Promotions](https://apps.jelou.ai/shop-v2/promotions).

Create and manage **discount coupons** for your store. Use the search box (by code or name) and the filters by **state** and **type**. Create coupons with the **+ New coupon** button.

![Promotions list in Shop Admin with coupons, discounts, validity, and state](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/promociones.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=e5a41448f7f839284dbc5156c60c0d4e)

Coupon list with code, discount, validity, branch, uses, and state.

Each coupon is defined with:

| Field | What it does |
| - | - |
| **Code** | What the customer enters at checkout to apply the discount. |
| **Name** | Internal name to identify the coupon. |
| **Discount** | Percentage (%) or fixed amount. |
| **Validity** | Optional start and end date range. Without validity, the coupon never expires. |
| **Branch** | **All** or one or more specific branches. |
| **Uses** | Total redemption limit and one-use-per-customer option. |

Each coupon's **state** is computed automatically:

| State | Meaning |
| - | - |
| **Active** | Valid and applicable at checkout. |
| **Scheduled** | Its start date has not arrived yet. |
| **Expired** | Its end date has passed. |
| **Depleted** | It reached its usage limit. |
| **Inactive** | Manually deactivated. |

The discount is validated and applied at the [webview](https://docs.jelou.ai/en/guides/integrations/e-commerce/webview.md) checkout. An invalid, expired, or out-of-branch coupon is rejected with a clear message.

> [!TIP]
>
> You can also create and manage coupons via API. See [API → Promotions](https://docs.jelou.ai/en/guides/integraciones/e-commerce/api-cupones/crear.md).

## Orders

Open in [Orders](https://apps.jelou.ai/shop-v2/orders).

Review the list of your **customers' carts** with their state and recent activity. Use the search box (by ID, reference, or customer), the **state** filter, and the date range. Each row opens its detail with **View detail**.

![Order list in Shop Admin with cart ID, reference, items, state, and dates](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/pedidos.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=619dd796216dcd530f6b4f4c75137bc0)

Order list with cart ID, reference, items, state, and dates.

| Column | Description |
| - | - |
| **Cart ID** | Internal cart identifier. |
| **Reference** | Order or customer reference. |
| **Items** | Number of products in the cart. |
| **State** | **Active** (in progress), **Completed** (checkout finished), or **Abandoned** (no recent activity). |
| **Last activity** | Date and time of the last change to the cart. |
| **Created** | Date and time the cart was created. |

## Activity

Open in [Activity](https://apps.jelou.ai/shop-v2/activity).

Review the **complete history of changes** in your store. Filter by **entity**, **action**, **source**, and date range, or search by author, SKU, name, or ID. You can **download** the history.

![Activity history in Shop Admin with action, entity, author, source, and changes](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/actividad.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=d582da5f643074eb087c5ccaf71b9eb8)

Activity history with date, action, entity, author, source, and changed fields.

| Column | Description |
| - | - |
| **Date** | When the change happened. |
| **Action** | Type of change: **Created**, **Updated**, or **Deleted**. |
| **Entity** | What was modified: Product, Coupon, Category, Branch, or Settings. |
| **Reference** | Identifier of the affected entity (SKU, code, name). |
| **Author** | Who made the change. |
| **Source** | Where it came from: **UI** (panel) or **API**. |
| **Changes** | Fields modified in that action. |

## Settings

Open in [Settings](https://apps.jelou.ai/shop-v2/settings).

Store information, connected integrations, and global preferences.

![Settings screen with information, integrations, currency, and taxes](https://mintcdn.com/jelouai/iC8zdv4B6xOY2cqw/assets/images/integraciones/e-commerce/shop-admin/configuracion.png?fit=max\&auto=format\&n=iC8zdv4B6xOY2cqw\&q=85\&s=36be87a74ac4c92867d0f7e4d6d18da8)

Settings screen with credentials, integrations, and preferences.

| Section | What you configure |
| - | - |
| **Information** | Store name and **Shop ID** (`app_id`). To authenticate your requests to the gateway, generate an API key in [API Keys](https://docs.jelou.ai/en/guides/settings/api-keys.md). |
| **Integrations** | Status of connectors (Shopify, WooCommerce, Facebook Catalog) and access to the marketplace. |
| **Currency** | ISO 4217 code used to display prices. |
| **Language** | Language used by the store for text and customer communications (`es`, `en`, `pt`). |
| **Taxes** | Global rate and **per-product tax** option for individual rates. |
| **Inventory** | Hide out-of-stock products from listings and searches. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.