← Retour à la marketplace
📊

Import Excel

Import et export de données via fichiers Excel (XLSX) et CSV.

IntégrationSimple~3 joursv1.1.0

Module d'import/export Excel avec validation des colonnes, mapping configurable, prévisualisation avant import, gestion des erreurs ligne par ligne et export de templates.

excelxlsxcsvimportexport

Dépendances requises :

📋 Schéma Prisma

// === Module Import Excel ===

enum ImportStatus {
  PENDING
  PROCESSING
  COMPLETED
  FAILED
}

model ImportJob {
  id           String       @id @default(cuid())
  entity       String       // "contacts", "products", etc.
  filename     String
  totalRows    Int          @default(0)
  processedRows Int         @default(0)
  errorRows    Int          @default(0)
  status       ImportStatus @default(PENDING)
  errors       Json?
  createdAt    DateTime     @default(now())
  updatedAt    DateTime     @updatedAt

  @@map("import_jobs")
}

🔌 Endpoints API

## API Import Excel

POST /api/import/upload          # Upload fichier + démarrer l'import
GET  /api/import/:id/status      # Statut et progression
GET  /api/import/:id/errors      # Détail des erreurs par ligne
GET  /api/export/:entity         # Exporter en Excel
GET  /api/export/:entity/template # Télécharger le template vide

🛠️ Guide d'implémentation

## Implémentation Import Excel

### Dépendances
```bash
npm install xlsx  # ou exceljs
```

### Étape 1 — Parser
Créer src/lib/excel/parser.ts :
- Lire le fichier XLSX/CSV
- Mapper les colonnes selon la config
- Valider chaque ligne (Zod)
- Collecter les erreurs sans stopper

### Étape 2 — Import asynchrone
Pour les gros fichiers : créer un ImportJob, traiter en background (ou en streaming).

### Étape 3 — Rapport d'import
Après import : X lignes importées, Y erreurs avec détail (ligne, colonne, message).

Prêt à installer ce module ?

Ajoutez-le à un projet existant depuis la page modules du projet.

Voir les projets →