---
name: s02-wallet-loads-datetime
scenario: S02
description: Récupérer l'historique des rechargements wallet — format datetime, limites de réconciliation bancaire, et cache 24h
tags: [wallet, loads, datetime, reconciliation, cache]
when_to_use: Quand on veut l'historique des virements wallet (top-ups) sur une période donnée
risk: P2 — La documentation du tool avertit que YYYY-MM-DD est refusé, mais en pratique l'API accepte ce format (coercion vers midnight UTC). Utiliser ISO 8601 avec timezone pour être explicite.
---

# Instructions — Historique des rechargements wallet

## ⚠️ Format de date : ISO 8601 + timezone recommandé

La documentation MCP indique que YYYY-MM-DD seul n'est pas accepté et qu'il faut un datetime complet.
En pratique, `from="2026-06-01"` est accepté par l'API (testé en live — 16 résultats retournés).

**Malgré ce comportement tolérant, toujours utiliser ISO 8601 complet avec timezone :**
```
from: "2026-06-01T00:00:00.000Z"
to:   "2026-06-30T23:59:59.999Z"
```

Raison : la coercion de YYYY-MM-DD vers midnight peut produire des résultats inattendus selon la timezone du serveur. L'utilisation de `T00:00:00.000Z` (UTC) est non ambiguë.

## ⚠️ Pas pour la réconciliation bancaire exacte

`get_wallet_loads` retourne la **date d'enregistrement Spendesk**, pas la **date valeur bancaire**.
→ Ne pas utiliser pour aligner les soldes Spendesk avec un relevé bancaire.
→ Pour la réconciliation exacte, croiser avec votre banque.

## ⚠️ Cache 24h (86400 secondes)

Les données retournées peuvent avoir jusqu'à 24h de retard.
→ Ne pas utiliser pour un solde temps réel — utiliser `get_wallet_summary` pour ça.

## Étape 1 — Appel avec période et paramètres recommandés

```json
{
  "companyId": "...",
  "from": "YYYY-MM-DDT00:00:00.000Z",
  "to": "YYYY-MM-DDT23:59:59.999Z",
  "pageSize": 100
}
```

## Étape 2 — Interpréter les champs

Pour chaque load :
- `amount` : `{ amount, currency, precision }` → montant = `amount / 10^precision` EUR
- `type` : `"wireTransfer"` (seul type observé sur ce compte)
- `bankName` : `sfs` | `adyen` | `other`
  - `sfs` = Spendesk Financial Services (compte principal)
  - `adyen` = Adyen (comptes de certaines filiales)
  - `other` = virement externe
- `createdAt` : date d'enregistrement dans Spendesk (≠ date valeur bancaire)

## Étape 3 — Pagination

Vérifier `meta.pagination.hasNextPage` — si `true`, paginer avec `page=2, 3, ...` et les mêmes filtres.

## Exemple live (données réelles, juin 2026)

16 loads en juin 2026, dont :
- 2026-06-23 : 500 000,00 EUR (virement sfs)
- 2026-06-10 : 600 000,00 EUR (virement sfs)
- Totalité du mois : ~1 105 721 EUR (incluant deux grands chargements tests)

## Exemple de prompt

- "Montre les rechargements wallet du mois dernier" → from/to = mois dernier + ISO 8601
- "Combien avons-nous chargé le wallet en 2026 ?" → from=2026-01-01T00:00:00.000Z, to=aujourd'hui + pagination
- "Quel est le solde actuel du wallet ?" → utiliser `get_wallet_summary`, pas `get_wallet_loads`