APAJH — Documentation

Apparence

Imports CEGI par SFTP ​

Le flux reçoit les exports « Personnes Contrats » de CEGI, crée ou met à jour les salariés et contrats, puis conserve une piste de chaque traitement.

Pour qui : un compte avec le statut équipe et les permissions du domaine Imports de données · Où : section Imports de données du menu

Écrans couverts : Lots d'import, Tentatives d'import, Résultats des lignes importées

Les colonnes, filtres et droits de chacun sont dans la référence des écrans.

Comprendre ​

  • La collecte parcourt le répertoire SFTP chaque jour à 04 h 37. Un dépôt ne demande aucune action dans l'application.
  • Un lot d'import représente un contenu unique. Son empreinte interdit une deuxième intégration du même fichier, même renommé.
  • Une tentative d'import conserve un passage automatique ou une reprise. Un échec n'efface jamais les tentatives précédentes.
  • Le fichier est indivisible : une erreur rejette toutes ses lignes sans modifier les salariés ni les contrats.
  • Un rejet fonctionnel est archivé 90 jours et peut être rejoué. Un fichier réussi reste disponible 30 jours. Le journal est conservé trois ans.

Contrôler le fonctionnement du flux ​

  1. Ouvrez Lots d'import.

  2. Consultez le bandeau État du flux CEGI : il donne le dernier succès, le dernier échec et le nombre de lots à traiter ou à reprendre.

  3. Ouvrez le lot le plus récent. Vérifiez son Statut, ses compteurs et son Encodage détecté.

  4. Consultez la sous-liste Tentatives d'import. En cas de rejet, relevez le Code d'erreur, la Ligne et la Colonne.

    ✅ Vous devriez voir un lot Réussi, un total de lignes égal à la somme des créations, mises à jour et lignes inchangées, puis une tentative réussie.

Rejouer un fichier rejeté ​

Corrigez d'abord la cause. Un unknown_establishment demande par exemple de renseigner le Code dossier de paye CEGI sur l'établissement concerné.

  1. Ouvrez Lots d'import et filtrez sur le statut Rejeté ou À réessayer.

  2. Ouvrez le lot et vérifiez que Fichier disponible est coché.

  3. Revenez à la liste, cochez le lot, puis choisissez Rejouer les imports sélectionnés.

  4. Cliquez sur Envoyer.

  5. Rechargez la fiche du lot après le passage du worker.

    ✅ Vous devriez voir une nouvelle tentative avec le déclencheur Administration et votre compte comme opérateur. La tentative précédente reste visible.

La reprise exige la permission Peut rejouer un lot d'import. Sans fichier archivé disponible, le lot reste consultable mais n'est pas rejouable.

Administrer le serveur SFTP ​

L'interface SFTPGo n'est pas exposée sur le réseau. Cette tâche relève de l'équipe technique et s'effectue depuis un tunnel SSH décrit dans le DAT § 06.

Les comptes ont des rôles séparés :

  • le déposant est enfermé dans le répertoire incoming et peut seulement téléverser ;
  • l'importeur Django lit et archive, sans accès au WebAdmin ;
  • l'administrateur nommé gère SFTPGo avec TOTP, sans être utilisé par l'application.

Après une création ou une rotation, contrôlez un dépôt avec le compte déposant, puis lancez make poll-sftp-imports. Ne désactivez l'ancien accès qu'après ce contrôle. La clé publique hôte affichée par SFTPGo doit correspondre exactement à SFTP_HOST_PUBLIC_KEY ; ne la validez jamais à partir d'une alerte de connexion.

Points d'attention ​

  • Ne modifiez pas un fichier rejeté dans son archive. Corrigez le référentiel puis rejouez le lot, ou déposez un nouveau fichier dont le contenu diffère.
  • Un code établissement CEGI inconnu rejette tout le fichier. Le mapping se tient sur Établissements, champ Code dossier de paye CEGI.
  • Une valeur facultative vide efface la valeur précédente. Le fichier est un instantané des champs qu'il transporte ; son absence ne supprime en revanche ni salarié ni contrat.
  • L'email CEGI est personnel. Il n'écrase jamais l'email professionnel du compte de connexion.
  • Aucun contenu métier ne doit être copié dans un ticket ou un journal. Le code d'erreur, la ligne et la colonne suffisent au diagnostic courant.