Catégories de dépenses et mapping cost centers

# Catégories de dépenses et mapping cost centers

## Structure d'une catégorie

```json
{
  "id": "r96xprmx87jiso",
  "name": "ABM",
  "costCenters": [
    {
      "id": "e411c663-1e1f-4b1e-b674-d954272afbc4",
      "name": "Marketing"
    }
  ]
}
```

Champs : `id`, `name`, `costCenters` (tableau d'objets `{id, name}`).

## Appel

```json
{
  "tool": "get_expense_categories",
  "params": {
    "companyId": "<companyId>"
  }
}
```

Liste paginée par curseur (100 catégories par page par défaut) : si `meta.pagination.hasNextPage` est vrai, rappeler avec `cursor`. Sur ce compte : 62 catégories.

## Mapping catégorie → cost centers (1-to-many)

Une catégorie peut être liée à plusieurs cost centers. Exemples :
- "Agency" → 7 CCs (dont Marketing + 6 "X- old" CCs)
- "Workspace - Rental costs" → 2 CCs ("X- old Workspace" + "People")
- "ABM" → 1 CC (Marketing uniquement)

## Catégories sans restriction de cost center (costCenters = [])

**15 catégories ont `costCenters: []` (tableau vide)** — cela signifie que la catégorie s'applique à TOUS les cost centers, pas à aucun. Ce sont généralement des catégories transversales :

| Catégorie | Usage typique |
|-----------|--------------|
| Externalised salaries | Masse salariale externalisée |
| Financial result | Résultats financiers |
| Monthly Learning Allowance | Enveloppe formation individuelle |
| Personal Expense | NDF personnelles |
| Salaries | Salaires |
| Server and COGS tools | Infrastructure cloud |
| Services - Consulting & advisory | Conseil |
| Services - Contractors or Freelancer | Freelances |
| Tools and subscriptions | Abonnements SaaS |
| Travel & Expense (T&E) - Business | NDF professionnelles |
| Travel & Expense (T&E) - Candidates | Frais candidats |
| Travel & Expense (T&E) - Relocation | Relocalisation |
| Travel & Expense (T&E) - Remote employee | Frais remote |
| T&E - Spendesk Onboarding Connect | Onboarding |
| T&E - Team Building & Team Lunch | Team events |

**Interprétation correcte :** `costCenters: []` = catégorie disponible pour TOUS les cost centers (aucune restriction), pas "aucun cost center" ni "erreur".

## Mappings obsolètes (X-old CCs)

Certaines catégories pointent exclusivement vers des CCs "X-old" décommissionnés par convention (mais toujours `isArchived: false` dans l'API). Exemples :
- "Content" → uniquement "X- old Content" (CC décommissionné)
- "Banking charges" → mix d'un CC actif ("Banking Operations") + 5 "X-old"
- "Agency" → Marketing (actif) + 6 "X- old" CCs

Ces mappings n'ont pas été mis à jour lors de la restructuration des équipes.

## Correspondance avec la réalité API

Sur ce compte, les CCs référencés dans `costCenters` incluent des CCs avec `isArchived: false` (actifs et X-old) — jamais des CCs avec `isArchived: true`. Les catégories ne pointent pas vers les 10 vrais CCs archivés.

## Pas de filtre ni pagination

`get_expense_categories` renvoie une page à la fois (curseur), catégories archivées comprises (`isArchived`). Pas de filtre disponible (par nom, par CC, par statut). Le filtrage est à faire côté client.

## Pattern d'utilisation courant

1. Récupérer toutes les catégories avec `get_expense_categories`
2. Identifier les catégories actives : exclure celles dont tous les `costCenters` sont des CCs "X-old"
3. Pour les dépenses par catégorie : il n'existe ni filtre `get_payables` ni dimension `spendesk_analyze_spend` par catégorie de dépense — regrouper par `payableType`, `costCenter` ou `analyticalCode` à la place, et le dire à l'utilisateur.

## Distinction avec get_cost_centers

| Tool | Retourne | Usage |
|------|----------|-------|
| `get_expense_categories` | Libellés employés + CCs liés | Référentiel de classification des dépenses |
| `get_cost_centers` | Départements/entités + owners | Référentiel organisationnel |

Une catégorie ("Travel & Expense - Business") peut être utilisée par tous les CCs — le mapping dans `get_expense_categories` précise pour quels CCs cette catégorie est configurée dans l'UI Spendesk.

## Exemples de prompts utilisateur

- "Liste toutes les catégories de dépenses disponibles"
- "Quelles catégories de dépenses sont associées au cost center Marketing ?"
- "Quelles catégories sont restreintes à certains cost centers, et lesquelles s'appliquent à tous ?"
- "Donne-moi le référentiel complet catégories / cost centers pour notre intégration ERP"