{"id":31721221,"url":"https://github.com/smdlabtech/vat-vies-validator-batch-eu-excel-file","last_synced_at":"2026-04-19T05:34:12.103Z","repository":{"id":315293745,"uuid":"1058903518","full_name":"smdlabtech/VAT-VIES-Validator-Batch-EU-Excel-File","owner":"smdlabtech","description":"🌍Open GitHub - VAT VIES Validator Batch EU Excel File 🤝Shared 🌐App","archived":false,"fork":false,"pushed_at":"2025-09-17T18:24:54.000Z","size":88,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-09T03:46:02.040Z","etag":null,"topics":["api-rest","app","checker","eu","european-union","streamlit","tva","ue","validator","vat","web","web-app"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smdlabtech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-17T17:51:56.000Z","updated_at":"2025-10-05T10:28:37.000Z","dependencies_parsed_at":"2025-09-17T20:52:27.132Z","dependency_job_id":"4b370277-df10-43a6-b52f-2c2a675db9d3","html_url":"https://github.com/smdlabtech/VAT-VIES-Validator-Batch-EU-Excel-File","commit_stats":null,"previous_names":["smdlabtech/vat-vies-validator-batch-eu-excel-file"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/smdlabtech/VAT-VIES-Validator-Batch-EU-Excel-File","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smdlabtech%2FVAT-VIES-Validator-Batch-EU-Excel-File","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smdlabtech%2FVAT-VIES-Validator-Batch-EU-Excel-File/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smdlabtech%2FVAT-VIES-Validator-Batch-EU-Excel-File/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smdlabtech%2FVAT-VIES-Validator-Batch-EU-Excel-File/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smdlabtech","download_url":"https://codeload.github.com/smdlabtech/VAT-VIES-Validator-Batch-EU-Excel-File/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smdlabtech%2FVAT-VIES-Validator-Batch-EU-Excel-File/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31996441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-rest","app","checker","eu","european-union","streamlit","tva","ue","validator","vat","web","web-app"],"created_at":"2025-10-09T03:44:41.864Z","updated_at":"2026-04-19T05:34:12.084Z","avatar_url":"https://github.com/smdlabtech.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VIES TVA Validator - Batch Excel\n\n[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://your-app-url.streamlit.app)\n\nUne application web Streamlit pour la vérification en masse de numéros de TVA européens via l'API VIES (Validation Information Exchange System) de la Commission Européenne.\n\n## 🎯 Fonctionnalités\n\n- **Validation en masse** : Traitement de fichiers Excel contenant plusieurs numéros TVA\n- **Interface intuitive** : Interface web simple et claire avec Streamlit\n- **Gestion d'erreurs robuste** : Retry automatique, gestion des timeouts, traitement par lots\n- **Export multiple formats** : Téléchargement des résultats en Excel et CSV\n- **Statistiques en temps réel** : Suivi de la progression et statistiques de validation\n- **Configuration avancée** : Paramètres personnalisables pour les délais et tentatives\n\n## 📋 Format du fichier Excel\n\n### Colonnes requises\n- `MS Code` : Code pays à 2 lettres (FR, DE, IT, ES, etc.)\n- `VAT Number` : Numéro de TVA à valider\n\n### Colonnes optionnelles\n- `Requester MS Code` : Code pays du demandeur\n- `Requester VAT Number` : Numéro TVA du demandeur\n\nSi les colonnes optionnelles sont absentes, les valeurs par défaut configurées dans l'interface seront utilisées.\n\n### Exemple de fichier\n```\nMS Code | VAT Number  | Requester MS Code | Requester VAT Number\nFR      | 12345678901 | FR               | 98765432109\nDE      | 123456789   |                  |\nIT      | 12345678901 |                  |\n```\n\n## 🚀 Utilisation\n\n1. **Charger un fichier Excel** avec les colonnes requises\n2. **Configurer les paramètres** dans la barre latérale (optionnel)\n3. **Lancer la vérification** et suivre la progression\n4. **Consulter les résultats** et statistiques\n5. **Télécharger** les résultats en Excel ou CSV\n\n## ⚙️ Configuration\n\n### Paramètres essentiels\n- **Requester MS** : Code pays par défaut du demandeur (défaut: FR)\n- **Requester VAT** : Numéro TVA par défaut du demandeur\n\n### Paramètres avancés\n- **Delay** : Délai entre les requêtes API (défaut: 1.5s)\n- **Retries** : Nombre de tentatives en cas d'échec (défaut: 2)\n- **Chunk size** : Taille des lots de traitement (défaut: 10)\n- **Chunk pause** : Pause entre les lots (défaut: 3s)\n- **Timeout** : Timeout des requêtes HTTP (défaut: 10s)\n\n## 🛠️ Installation locale\n\n### Prérequis\n- Python 3.8+\n- pip\n\n### Installation\n```bash\n# Cloner le repository\ngit clone https://github.com/votre-username/smdlabtech-vat-vies-validator-batch-excel.git\ncd smdlabtech-vat-vies-validator-batch-excel\n\n# Installer les dépendances\npip install -r requirements.txt\n\n# Lancer l'application\nstreamlit run app/main.py\n```\n\nL'application sera disponible sur `http://localhost:8501`\n\n## 🌐 API VIES\n\nCette application utilise l'API REST VIES officielle de la Commission Européenne :\n- **URL** : `https://ec.europa.eu/taxation_customs/vies/rest-api/check-vat-number`\n- **Méthode** : POST\n- **Format** : JSON\n- **Limite de taux** : Respect nécessaire des limites (d'où les délais configurables)\n\n### Pays supportés\nTous les pays membres de l'Union Européenne :\nAT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK\n\n## 📊 Résultats\n\n### Colonnes de sortie\n- **MS Code** : Code pays d'origine\n- **VAT Number** : Numéro TVA vérifié\n- **valid** : Statut de validation (True/False)\n- **name** : Nom de l'entreprise (si disponible)\n- **address** : Adresse de l'entreprise (si disponible)\n- **Requester MS Code** : Code pays du demandeur\n- **Requester VAT Number** : Numéro TVA du demandeur\n- **Attempts** : Nombre de tentatives effectuées\n- **timestamp** : Horodatage de la vérification\n- **error** : Message d'erreur (si applicable)\n\n## 🔧 Structure du projet\n\n```\nsmdlabtech-vat-vies-validator-batch-excel/\n├── app/\n│   └── main.py                    # Application Streamlit principale\n├── requirements.txt               # Dépendances Python\n├── .streamlit/\n│   └── config.toml               # Configuration Streamlit\n├── README.md                     # Documentation\n├── LICENSE                       # Licence MIT\n└── Test_Check_VAT.xlsx          # Fichier de test\n```\n\n## 📝 Licence\n\nCe projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails.\n\n## ⚠️ Limitations et bonnes pratiques\n\n### Limitations\n- **Timeout Streamlit Cloud** : Sessions limitées à quelques minutes\n- **Taille de fichier** : Limité par la mémoire disponible\n- **Pas de stockage persistant** : Les données ne sont pas sauvegardées entre les sessions\n\n### Bonnes pratiques\n- **Fichiers volumineux** : Diviser en plusieurs fichiers plus petits\n- **Erreurs 429** : Augmenter les délais entre requêtes\n- **Timeouts** : Augmenter la valeur du timeout pour les connexions lentes\n- **Traitement par lots** : Ajuster la taille des chunks selon les performances\n\n## 🐛 Problèmes connus\n\n- L'API VIES peut être temporairement indisponible\n- Certains numéros TVA valides peuvent être rejetés par l'API\n- Les réponses peuvent varier selon la charge du serveur VIES\n\n## 📞 Support\n\nPour signaler un bug ou demander une fonctionnalité :\n1. Ouvrir une issue sur GitHub\n2. Fournir un fichier de test Excel\n3. Inclure les paramètres utilisés et les messages d'erreur\n\n## 🎉 Contribution\n\nLes contributions sont les bienvenues ! Merci de :\n1. Fork le projet\n2. Créer une branche pour votre fonctionnalité\n3. Commiter vos changements\n4. Pousser vers la branche\n5. Ouvrir une Pull Request","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmdlabtech%2Fvat-vies-validator-batch-eu-excel-file","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmdlabtech%2Fvat-vies-validator-batch-eu-excel-file","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmdlabtech%2Fvat-vies-validator-batch-eu-excel-file/lists"}