Payables filtrés par date d'entrée système (firstCreatedAt)

# Payables filtrés par date d'entrée système (firstCreatedAt)

## Distinction clé : payableDate vs firstCreatedAt

| Champ | Signification | Quand l'utiliser |
|-------|---------------|------------------|
| `payableDate` (= `creationDate` dans la réponse) | Date du document (date inscrite sur la facture) | Période comptable, clôture mensuelle |
| `firstCreatedAt` | Date à laquelle la payable a été saisie dans Spendesk | Ce qui a été traité cette semaine, SLA de traitement |

Une facture d'avril 2026 peut être **saisie dans Spendesk en juillet 2026** — `payableDate` = avril, `firstCreatedAt` = juillet. Ces deux filtres retournent des ensembles complètement différents.

## Requête — Saisies de la dernière semaine

```json
{
  "companyId": "<companyId>",
  "filters": {
    "field": "firstCreatedAt",
    "operator": "inLast",
    "value": { "timeUnit": "days", "amount": 7 }
  },
  "pageSize": 20
}
```

## Opérateurs pour les filtres de date

**⚠️ Les opérateurs de date sont différents des opérateurs de montant :**

| Objectif | Opérateur date | ❌ Ne pas utiliser |
|----------|---------------|-------------------|
| Après une date | `after` | `>=` (invalide pour les dates) |
| Avant une date | `before` | `<=` (invalide pour les dates) |
| Entre deux dates | `between` | — |
| Fenêtre glissante | `inLast` | — |
| Date exacte | `=` | — |

## Valeurs magiques disponibles (pas de date hardcodée)

Au lieu d'une date ISO, ces valeurs dynamiques sont acceptées :

| Valeur | Signification |
|--------|---------------|
| `"today"` | Aujourd'hui |
| `"yesterday"` | Hier |
| `"thisMonth"` | Depuis le 1er du mois courant |
| `"lastMonth"` | Le mois précédent (du 1er au dernier jour) |

Exemples :
```json
// Ce mois-ci
{ "field": "firstCreatedAt", "operator": "after", "value": "thisMonth" }

// Le mois dernier
{ "field": "firstCreatedAt", "operator": "between", "value": { "from": "lastMonth", "to": "today" } }

// Les 30 derniers jours
{ "field": "firstCreatedAt", "operator": "inLast", "value": { "timeUnit": "days", "amount": 30 } }
```

## Ces opérateurs s'appliquent à tous les champs date

Les mêmes opérateurs (`before`/`after`/`between`/`inLast`) fonctionnent pour tous les champs de date de `get_payables` :
- `payableDate` — date du document
- `firstCreatedAt` — date d'entrée dans Spendesk
- `firstExportedAt` — date du premier export ERP
- `lastUpdatedAt` — date de dernière modification
- `dueDate` — date d'échéance
- `accountingDate` — date comptable (feature optionnelle — voir skill S18)

## Cas d'usage : surveiller le backlog de saisie

Pour mesurer le délai entre la date du document et la saisie dans Spendesk :
1. Filtrer par `firstCreatedAt` (saisies de la semaine)
2. Comparer avec `payableDate` (`creationDate` dans la réponse)

Exemple observé sur des données réelles :
- "Contrat 1527322 - 2026-05" → payableDate=**2026-04-16**, firstCreatedAt=**2026-07-01** (2,5 mois de délai)
- "Clare Holmes freelancer" → payableDate=**2026-04-30**, firstCreatedAt=**2026-07-01** (2 mois de délai)

→ Des délais importants révèlent un backlog de traitement ou des saisies en retard.

## Exemples de prompts

- "Quelles factures ont été saisies dans Spendesk cette semaine ?"
- "Combien de factures ont été traitées le mois dernier dans notre équipe comptable ?"
- "Montre-moi les dépenses entrées dans Spendesk depuis le 1er juin"
- "Y a-t-il des factures d'avril encore en cours de saisie ?"