# Mes données GPS ne s'importent pas (/docs/erreurs-frequentes/donnees-gps-non-importees)



## Symptôme [#symptôme]

Tes données GPS n'arrivent pas correctement dans FormaPulse. Deux contextes possibles :

* **Import manuel** d'un fichier CSV / Excel exporté depuis ton GPS — l'import est rejeté ou les données n'apparaissent pas dans la séance.
* **Synchronisation automatique via API** (Catapult, STATSports, Polar Team Pro, GPSports…) — les activités sont récupérées mais **rattachées à la mauvaise séance**, ou aucune séance candidate n'est détectée.

***

## Cas 1 — Import manuel d'un fichier (CSV / Excel) [#cas-1--import-manuel-dun-fichier-csv--excel]

Tu as exporté un fichier depuis ton GPS et tu l'importes via **Statistiques > GPS > Importer**.

### 1. Format du fichier non supporté [#1-format-du-fichier-non-supporté]

FormaPulse accepte **CSV**, **Excel** et certains formats propriétaires. Vérifie que ton fichier n'est pas en `.json` ou `.xml` non standard. Re-exporte au format CSV si possible.

### 2. Encodage du fichier [#2-encodage-du-fichier]

Un fichier exporté avec un mauvais encodage (UTF-16, Windows-1252) peut être illisible. Ouvre-le dans Excel et **enregistre-le sous** au format **CSV UTF-8**.

### 3. Mapping des joueurs incomplet [#3-mapping-des-joueurs-incomplet]

À la première utilisation d'un GPS, FormaPulse demande la correspondance entre les noms du fichier et les joueurs FormaPulse. Si certains joueurs n'ont pas été mappés, leurs données n'apparaîtront pas. Va dans **Paramètres > GPS > Mapping** pour compléter.

### 4. Date du fichier ≠ date de la séance [#4-date-du-fichier--date-de-la-séance]

FormaPulse rattache automatiquement le fichier à la séance la plus proche. Si l'écart est trop grand (> 24h), aucune séance n'est trouvée. Vérifie la date du fichier.

### 5. Doublon détecté [#5-doublon-détecté]

Si le fichier a déjà été importé, FormaPulse demande de choisir entre **écraser** ou **ignorer**. Si tu cliques « ignorer » par erreur, les données ne sont pas mises à jour.

***

## Cas 2 — Synchronisation automatique via API [#cas-2--synchronisation-automatique-via-api]

Si tu as connecté ton compte GPS (Catapult, STATSports…), FormaPulse récupère **automatiquement** les activités après chaque session. Pour décider à quelle séance rattacher chaque activité, l'algorithme de matching croise :

* la **date** (et heure approximative) de l'activité GPS,
* les **noms des joueurs** présents dans l'activité,
* la **liste des événements planifiés** (séances, matchs) dans la même fenêtre temporelle pour les équipes auxquelles ces joueurs appartiennent.

### 1. Aucune séance candidate trouvée [#1-aucune-séance-candidate-trouvée]

Aucun événement n'était planifié sur le créneau de l'activité GPS, ou les joueurs présents ne sont rattachés à aucune équipe avec une séance planifiée à ce moment-là.

→ Crée la séance manquante dans le calendrier, puis utilise la **synchronisation manuelle** ci-dessous pour rattacher l'activité.

### 2. Plusieurs séances candidates en parallèle [#2-plusieurs-séances-candidates-en-parallèle]

Deux équipes avaient une séance au même créneau (ex: U17 et U19 partageant le terrain). L'algorithme ne peut pas trancher seul et peut rattacher au mauvais événement.

→ Bascule via la **synchronisation manuelle** depuis l'événement cible. Tu verras apparaitre la bonne séance.

### 3. La séance auto-rattachée n'est pas la bonne [#3-la-séance-auto-rattachée-nest-pas-la-bonne]

Un joueur invité ponctuellement sur une autre équipe peut brouiller le matching, ou les fenêtres horaires se chevauchent.

→ Ouvre l'événement actuellement rattaché, **clique sur synchrosiné les données** l'activité GPS, puis choisis la bonne séance de ton provider.

### Synchronisation manuelle — comment faire [#synchronisation-manuelle--comment-faire]

Depuis l'événement de planification cible (séance ou match) :

1. Passe la soucis sur le "+" de ton evenement
2. Clique sur "Synchroniser GPS"
3. Tu verras apparaitre les séances de ton provider pour cet date. Pour un setup GPS manuel, tu es invité à importer le fichier CSV de la séance.
4. Clique sur **Synchroniser**.

L'activité est rattachée à l'événement et **remplace** le rattachement automatique ou manuel précédent s'il existait.

<Callout type="info">
  La synchronisation manuelle écrase toujours le rattachement automatique ou le rattachement en cours.
  Tu peux aussi l'utiliser pour **rattacher une activité à un événement
  passé** que l'algorithme aurait raté.
</Callout>

***

## Liste de contrôle [#liste-de-contrôle]

**Pour un import manuel :**

* ✅ Le fichier est en CSV ou Excel
* ✅ Encodage UTF-8
* ✅ Tous les joueurs sont mappés (vérifier dans **Paramètres > GPS**)
* ✅ La séance correspondante existe et est dans la même fenêtre temporelle
* ✅ Pas de doublon

**Pour la sync automatique :**

* ✅ Ton compte GPS est bien **connecté** dans **Paramètres > GPS > Intégrations**
* ✅ Les **noms des joueurs** côté GPS correspondent à ceux côté FormaPulse (mapping)
* ✅ L'événement de planification existe sur le créneau de l'activité
* ✅ Si plusieurs équipes en parallèle : utilise la **synchronisation manuelle**

## Si rien ne fonctionne [#si-rien-ne-fonctionne]

<SignalerBug sujet="Import GPS qui échoue" contexte="/docs/erreurs-frequentes/donnees-gps-non-importees" />
