Identifie les cartes en état terminal (perdues, volées, expirées, annulées) via list_cards avec filtre par statut
Identifie les cartes en état terminal (perdues, volées, expirées, annulées) via list_cards. Utile pour le reporting sécurité et le nettoyage du référentiel cartes.
77/100·📆 Mensuel·IntermédiaireControllerFinance Analyst
CartesConformitélist_cards
🎯 But du skill
Identifie les cartes en état terminal (perdues, volées, expirées, annulées) via list_cards. Utile pour le reporting sécurité et le nettoyage du référentiel cartes.
📊 Ce que ça produit
Liste des cartes hors service avec statut, propriétaire et date de dernière activité.
⚡ Bénéfice
Avant
Pas de vue consolidée des cartes inactives — plusieurs filtres manuels nécessaires.
Après
Tableau complet des cartes hors service en une requête, prêt pour le reporting sécurité.
# Instructions
## Use case
Identifier les cartes en état terminal pour les workflows de sécurité (blocage de cartes perdues/volées) ou de nettoyage (cartes expirées ou annulées).
## Cycle de vie complet des cartes
```
PRE (pre-active)
↓
ACT (active) ←→ BLO (blocked)
↓
REA (reactivated) → ACT
États terminaux — IRRÉVERSIBLES :
LOS — Lost (perdue)
STO — Stolen (volée)
DAM — Damaged (endommagée)
EXP — Expired (expirée à la date d'échéance)
CAN — Cancelled (annulée manuellement)
CMD — Compromised (compromise)
CBL — Disabled/hidden (désactivée, ne revient pas active)
```
## Piège — un seul statut par appel
`list_cards.status` est une **string simple** (pas un tableau). Pour couvrir plusieurs états terminaux, effectuer plusieurs appels :
```json
// Appel 1 — Cartes perdues
{ "companyId": "<COMPANY_ID>", "status": "LOS", "pageSize": 100 }
// Appel 2 — Cartes volées
{ "companyId": "<COMPANY_ID>", "status": "STO", "pageSize": 100 }
// Appel 3 — Cartes expirées (utile pour nettoyage)
{ "companyId": "<COMPANY_ID>", "status": "EXP", "pageSize": 100 }
// Appel 4 — Cartes annulées
{ "companyId": "<COMPANY_ID>", "status": "CAN", "pageSize": 100 }
// Appel 5 — Cartes compromises (alerte sécurité)
{ "companyId": "<COMPANY_ID>", "status": "CMD", "pageSize": 100 }
```
→ Merger les résultats côté client pour une vue consolidée.
## Distinguer terminal vs non-terminal
| Statut | Terminal ? | Peut revenir ACT ? | Use case |
|--------|-----------|-------------------|----------|
| ACT | Non | — | Actuelle |
| BLO | Non | Oui (via REA) | Temporairement bloquée |
| REA | Non | — | Réactivée après BLO |
| PRE | Non | Oui | En attente d'activation |
| LOS | **Oui** | ❌ Non | Déclaration de perte |
| STO | **Oui** | ❌ Non | Déclaration de vol |
| DAM | **Oui** | ❌ Non | Carte endommagée physiquement |
| EXP | **Oui** | ❌ Non | Date d'expiration atteinte |
| CAN | **Oui** | ❌ Non | Annulation manuelle |
| CMD | **Oui** | ❌ Non | Compromission détectée |
| CBL | **Oui** | ❌ Non | Désactivée/cachée |
## Données disponibles sur une carte terminale
Les cartes en état terminal retournent les mêmes champs que les cartes ACT :
```json
{
"id": "...",
"type": "subscription",
"status": "CAN",
"lastFourDigits": "1234",
"expiryDate": "2025-12-31T23:59:59.000Z",
"ownerId": "<userId>",
"currency": "EUR",
"availableBalance": { ... }, // solde résiduel potentiel
"spendingLimit": { ... }
}
```
Si `availableBalance > 0` sur une carte annulée ou expirée, un remboursement peut être en attente.
## Limitations observées sur ce compte
- `status: "EXP"` → 0 résultats — aucune carte expirée visible (possible que les cartes expirées soient archivées ou purgées de l'API après un certain délai)
- `status: "CAN"`, `status: "BLO"`, etc. → non testés sur ce compte en raison d'une instabilité de connexion MCP
## PAN et CVV jamais retournés
Le numéro complet de la carte (PAN) et le CVV ne sont jamais retournés par le MCP — uniquement les 4 derniers chiffres (`lastFourDigits`). C'est une limitation de sécurité par conception.
## Exemples de prompts utilisateurs
- "Y a-t-il des cartes perdues ou volées actives sur le compte ?"
- "Montre-moi toutes les cartes annulées ce trimestre"
- "Quelles cartes expirées ont encore un solde positif ?"
Comment installer ce skill
/
- 1Télécharger le fichier
s30-cartes-statuts-terminaux.mdvia le bouton ci-dessus. - 2Placer le fichier dans le répertoire
.claude/de votre projet (ou~/.claude/pour une installation globale).cp s30-cartes-statuts-terminaux.md .claude/s30-cartes-statuts-terminaux.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.
💡 Assurez-vous que le MCP Spendesk est configuré dans votre
.claude/settings.json avec les outils list_cards.Skills similaires
★ Top