Développement d'un endpoint d'import de données (API Python / Flask)

Nous éditons une plateforme SaaS de comptabilité carbone. Le backend est une API REST développée en Python (Flask), avec authentification par jeton JWT et une base de données relationnelle gérée via SQLAlchemy. Nous souhaitons ajouter une fonctionnalité d'import de données à partir d'un fichier Excel structuré, afin d'alimenter automatiquement les données métier de la plateforme.

Développer un nouvel endpoint d'API permettant d'importer un classeur Excel comportant plusieurs onglets, et de créer automatiquement les enregistrements correspondants dans les tables métier de la base de données (émissions, facteurs d'émission, entités).

Périmètre technique (aperçu général)
• Endpoint POST sécurisé (JWT), réception d'un fichier .xlsx en multipart/form-data
• Lecture et parsing de plusieurs onglets du classeur
• Création des enregistrements dans les tables concernées (facteurs d'émission, émissions, entités)
• Calcul d'une valeur dérivée (intensité d'émission) à partir des données importées et du facteur associé
• Détection des doublons pour éviter les insertions multiples si l'import est relancé sur le même fichier
• Option de simulation « dry run » (validation sans écriture en base)
• Réponse JSON exploitable par le front-end pour signaler le succès ou les erreurs

Compétences requises
• Python / Flask (API REST)
• SQLAlchemy et bases de données relationnelles (PostgreSQL)
• Manipulation de fichiers Excel (openpyxl / pandas)
• Authentification JWT
• Bonnes pratiques : validation des données, gestion des erreurs, code testé et documenté
Livrables attendus
• Code de l'endpoint, intégré à notre backend existant et documenté
• Tests de la fonctionnalité
• Brèves instructions de mise en service