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

# Analyses des produits

> Récupérez le volume d'articles, la moyenne par commande, les meilleures ventes et les tendances par établissement.

```text Établissement theme={null}
GET /v1/locations/{location_id}/analytics/products
```

```text Organisation commerciale theme={null}
GET /v1/organizations/{organization_id}/analytics/products
```

## Statistiques

| Champ                                | Périmètre     | Signification                                                                                         |
| ------------------------------------ | ------------- | ----------------------------------------------------------------------------------------------------- |
| `sold_item_count`                    | Les deux      | Produits individuels et formules vendus. Chaque formule compte comme un article vendu.                |
| `average_items_per_order`            | Établissement | Quantité moyenne d'articles du menu par commande, y compris ceux contenus dans les formules.          |
| `top_products[].quantity`            | Les deux      | Quantité vendue d'un produit individuel ou d'une formule parmi les meilleures ventes.                 |
| `daily_top_product_sales[].quantity` | Établissement | Quantité vendue à une date locale pour l'un des trois articles du menu les plus vendus de la période. |

La tendance quotidienne utilise des lignes longues avec `date`, `product_name` et `quantity`. Le schéma reste stable même lorsque les produits les plus vendus changent.

```json Extrait de réponse établissement theme={null}
{
  "summary": {
    "sold_item_count": 910,
    "average_items_per_order": 2.8
  },
  "top_products": [{ "name": "Bowl saumon", "quantity": 86 }],
  "daily_top_product_sales": [
    { "date": "2026-06-01", "product_name": "Bowl saumon", "quantity": 8 }
  ]
}
```

Les noms de produits sont des instantanés enregistrés sur les commandes. Les valeurs historiques restent donc compréhensibles si le menu renomme ou supprime ensuite un article.
