Que fait statement-bookkeeping ?
Compétence d'agent pour la comptabilité consolidée des relevés WeChat / Alipay / JD / Banque — dédoublonnage, identification des virements, vérification puis écriture dans ezBookkeeping
Fonctionnalités
- Import de multiples formats : CSV, Excel depuis WeChat Pay, Alipay, JD.com, relevés bancaires (prise en charge de plusieurs banques)
- Dédoublonnage intelligent : détection et fusion des transactions en double sur la base de la date, du montant, du destinataire/expéditeur
- Identification des virements internes : repérage automatique des transferts entre comptes (ex. WeChat → Banque) pour éviter la double comptabilisation
- Vérification visuelle : affichage d'un tableau récapitulatif des transactions fusionnées avant écriture finale
- Export vers ezBookkeeping : génération d'un fichier CSV compatible avec l'import ezBookkeeping
- Gestion des catégories et tags : mappage automatique ou personnalisé des catégories de transactions
Prérequis
- Python 3.8+
- Bibliothèques :
pandas,openpyxl,ezbookkeeping-sdk(ou accès API ezBookkeeping) - Fichiers de relevés aux formats supportés
Installation
pip install pandas openpyxl
# Installation du SDK ezBookkeeping (si nécessaire)
pip install ezbookkeeping-sdk
Utilisation
- Placez vos relevés (CSV, XLSX) dans le dossier
./statements/ - Exécutez le script principal :
python consolidate.py --input ./statements/ --output ./consolidated.csv
- Vérifiez le rapport généré :
./consolidated_report.json - Importez le fichier
./consolidated.csvdans ezBookkeeping
Options avancées
--dedup: seuil de tolérance pour le dédoublonnage (par défaut : 0.95)--transfer-detect: activer/désactiver la détection de virements (par défaut : true)--category-map: chemin vers un fichier JSON de mappage de catégories
Exemple de fichier de mappage de catégories (category_map.json)
{
"Alimentation": ["épicerie", "restaurant", "café"],
"Transport": ["métro", "taxi", "essence"],
"Shopping": ["vêtements", "électronique", "ameublement"]
}
Flux de travail
- Étape 1 : Chargement et normalisation des colonnes de chaque relevé
- Étape 2 : Dédoublonnage basé sur la date, montant et description
- Étape 3 : Détection des virements internes (paires de transactions avec montants opposés)
- Étape 4 : Application du mappage de catégories
- Étape 5 : Génération du rapport récapitulatif pour vérification humaine
- Étape 6 : Export au format ezBookkeeping (CSV)
Dépannage
- Erreur de format : assurez-vous que les colonnes de vos relevés correspondent aux modèles attendus
- Doublons non détectés : réduisez le seuil
--dedup(ex. 0.90) - Problèmes d'API ezBookkeeping : vérifiez votre jeton d'API et la connectivité réseau
Licence
MIT
Contribution
Les contributions sont les bienvenues. Ouvrez une issue ou une pull request sur le dépôt GitHub.