Historique des rechargements wallet
Récupère l'historique des rechargements du wallet de l'entreprise avec gestion du format datetime et pagination. Utile pour le suivi de trésorerie et la réconciliation des flux d'approvisionnement.
🎯 But du skill
Récupère l'historique des rechargements du wallet de l'entreprise avec gestion du format datetime et pagination. Utile pour le suivi de trésorerie et la réconciliation des flux d'approvisionnement.
📊 Ce que ça produit
Liste chronologique des rechargements wallet avec dates, montants, devises et métadonnées de chaque opération.
⚡ Bénéfice
Avant
Recherche manuelle dans l'interface Spendesk, export CSV nécessaire pour analyser les rechargements passés.
Après
Historique complet des rechargements directement dans Claude, prêt à analyser et réconcilier.
# 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`
Comment installer ce skill
- 1Télécharger le fichier
s02-wallet-loads-datetime.mdvia le bouton ci-dessus. - 2Placer le fichier dans le répertoire
.claude/de votre projet (ou~/.claude/pour une installation globale).cp s02-wallet-loads-datetime.md .claude/s02-wallet-loads-datetime.md - 3Utiliser dans Claude Code — le skill est automatiquement découvert. Décrivez votre besoin en langage naturel et Claude appliquera les instructions du skill.
.claude/settings.json avec les outils get_wallet_loads.