SIRIUSSHIFT
Salle de contrôle
← Sirius ShiftCGV / CGUConfidentialitéHébergement

Vos données et leur portabilité

Toutes les données de votre agence peuvent être récupérées gratuitement, à tout moment, sans limite, dans un format ouvert et lisible par machine. Cet export est l'interface ouverte qui permet de changer de logiciel (règlement (UE) 2023/2854 sur les données, article 30, paragraphes 2 et 6).

Comment exporter

  1. Connectez-vous avec un compte gérant.
  2. Ouvrez Équipe → Données de l'agence.
  3. Touchez « Exporter toutes mes données » : un fichier ZIP se télécharge (sur iPhone, il arrive dans l'app Fichiers).

Le même export est proposé avant toute suppression de l'agence, et reste disponible pendant les 14 jours où la suppression peut être annulée.

Interface ouverte (pour un logiciel)

Un logiciel (par exemple celui du nouveau fournisseur) peut récupérer le même fichier :

  • Méthode et adresse : GET /api/export (ancienne adresse identique : GET /api/org/export), sans paramètre ni corps.
  • Authentification, au choix :
    • Jeton du nouveau fournisseur (voir ci-dessous) : en-tête Authorization: Bearer ssx_…. Si cet en-tête est présent, le cookie est ignoré.
    • Session du gérant : cookie sirius_session, obtenu avec POST /api/auth/login, corps JSON {"email": "…", "password": "…"} (Content-Type: application/json) ; la réponse pose le cookie (HttpOnly, 14 jours).
    Les deux fonctionnent aussi pendant les 14 jours d'une suppression programmée.
  • Réponse 200 : Content-Type: application/zip, Content-Disposition: attachment; filename="sirius-shift-export-AAAA-MM-JJ.zip", Cache-Control: no-store. Archive ZIP (méthode « stockée », noms de fichiers en UTF-8).
  • Erreurs (corps JSON {"error": "message"}, Cache-Control: no-store) :
    • 401 — Ni session de gérant ni jeton valable : cookie « sirius_session » absent ou expiré, ou jeton faux, expiré ou révoqué (en-tête WWW-Authenticate: Bearer).
    • 403 — Le compte connecté n'est pas gérant (planificateur ou agent).
    • 405 — Méthode autre que GET.
    • 429 — Trop de demandes : plus de 10 exports en une heure avec le même jeton, ou plus de 20 jetons invalides en 15 minutes depuis la même adresse IP (en-tête Retry-After, en secondes).
    • 500 — Erreur interne : réessayer plus tard.
  • Gratuit. Limites : 10 exports par heure et par jeton ; 20 jetons invalides en 15 minutes par adresse IP.
# Avec un jeton (nouveau fournisseur)
curl -H 'Authorization: Bearer ssx_…' -o export.zip https://<adresse-du-site>/api/export

# Avec la session du gérant
curl -c c.txt -H 'Content-Type: application/json' \
  -d '{"email":"gerant@agence.fr","password":"…"}' \
  https://<adresse-du-site>/api/auth/login
curl -b c.txt -o export.zip https://<adresse-du-site>/api/export

Jeton d'accès pour le nouveau fournisseur

  • Création : le gérant ouvre Équipe → Données de l'agence → « Accès pour votre nouveau logiciel », indique le nom du nouveau fournisseur et une durée, puis touche « Créer un jeton » (possible aussi pendant une suppression programmée, depuis l'écran de suppression).
  • Affiché une seule fois, à la création : il faut le copier et le transmettre au fournisseur. Sirius Shift n'enregistre que son empreinte (SHA-256) et ne peut pas le réafficher.
  • Lecture seule, export seulement : il n'ouvre que GET /api/export (et son alias) ; aucune autre page ni action.
  • Durée : 7 jours au plus (choix de 1 à 7). Révocable à tout moment (« Révoquer ») : il est alors refusé immédiatement.
  • Journal : chaque utilisation est notée avec la date, l'adresse IP et le navigateur ou logiciel ; le gérant la voit sous le jeton. Chaque export est aussi inscrit au journal d'activité.
  • Suppression de l'agence : les jetons restent utilisables pendant les 14 jours d'annulation, puis sont effacés avec toutes les données lors de la suppression définitive.
  • Pas de jeton dans l'agence de démonstration. Gratuit.

Format

  • Une archive ZIP contenant des fichiers CSV : encodage UTF-8 (avec BOM), séparateur « ; », fins de ligne CRLF, une ligne d'en-tête (libellés ci-dessous, dans cet ordre) ; champs contenant « ; », guillemet ou retour à la ligne entourés de guillemets (guillemets doublés). Tous les fichiers CSV sont toujours présents, même vides.
  • Dates au format JJ/MM/AAAA HH:MM, heure de Paris (jours seuls : JJ/MM/AAAA) ; nombres avec virgule décimale ; oui/non ; listes séparées par « , » ; valeurs détaillées en JSON.
  • Pièces jointes dans leur format d'origine (PDF, JPEG, PNG) et contenus signés en JSON.
  • Un fichier LISEZ-MOI.txt décrit chaque fichier et chacune de ses colonnes.
  • Ne sont pas exportés : mots de passe (seule une empreinte est stockée), jetons de session et d'invitation.

Catégories de données exportées

Agence

  • agence.csv — Identité de l'agence, acceptation des conditions, accords et demandes.
    Colonnes : Nom · SIRET · Autorisation CNAPS · Statut · Créée le · Conditions acceptées le · Version des conditions · Accord pour être cité en référence · Accord référence modifié le · Résiliation demandée le · Raison sociale (factures) · Forme juridique · Capital social · RCS · Adresse du siège (factures) · N° TVA · Taux de TVA (%) · Délai de paiement (jours) · IBAN · Heures sup au-delà de (h/semaine) · Heures au 1er taux · 1er taux heures sup (%) · 2e taux heures sup (%)

Comptes

  • comptes.csv — Comptes utilisateurs de l'agence (sans mot de passe).
    Colonnes : Nom · E-mail · Rôle · E-mail vérifié le · Créé le
  • invitations.csv — Invitations envoyées.
    Colonnes : E-mail · Rôle · Envoyée le · Expire le · Acceptée le

Agents

  • agents.csv — Fiches des agents, domicile (code postal et ville seulement) et distance maximale.
    Colonnes : Prénom · Nom · E-mail · Carte CNAPS · Validité carte · SSIAP · Qualifications · Statut · Domicile (code postal et ville) · Distance max (km) · Solde de congés de départ (jours) · Date de référence congés · Créé le
  • documents-agents.csv — Documents des agents (carte CNAPS, SSIAP, contrat, pièce d'identité…) ; le fichier est dans le dossier documents/.
    Colonnes : Agent · Type · Numéro · Expire le · Nom du fichier · Type de fichier · Taille (octets) · Ajouté le · Fichier dans l'export
  • absences.csv — Absences et demandes d'absence (types neutres, aucune donnée de santé).
    Colonnes : Agent · Type · Du · Au · Statut · Note · Créée le
  • documents/ — Fichiers des documents des agents (PDF ou photo), tels que déposés.

Sites

  • sites.csv — Sites clients et leurs exigences.
    Colonnes : Nom · Nom court · Adresse · Ville · Latitude · Longitude · SSIAP requis · Qualifications requises · Effectif jour · Effectif nuit · Effectif week-end
  • missions-sites.csv — Liste des missions (tâches) par site.
    Colonnes : Site · Mission · Ordre

Planning

  • vacations.csv — Toutes les vacations (passées et futures).
    Colonnes : Site · Agent · Début · Fin · Type · Confirmation · Réponse attendue avant · Notes
  • missions-cochees.csv — Missions cochées par les agents pendant leurs vacations.
    Colonnes : Vacation (début) · Site · Mission · Agent · Faite le

Heures

  • pointages.csv — Pointages d'arrivée et de départ.
    Colonnes : Agent · Site · Arrivée/Départ · Heure · Latitude · Longitude
  • heures-validees.csv — Heures validées par le gérant (base de la paie).
    Colonnes : Agent · Site · Début validé · Fin validée · Corrigé · Motif · Validé le
  • corrections-heures.csv — Historique des validations et corrections d'heures (avant / après).
    Colonnes : Date · Par · Action · Agent · Vacation · Avant · Après
  • feuilles-signees.csv — Feuilles d'heures signées ; signature (image) et contenu signé dans le dossier feuilles-signees/.
    Colonnes : Agent · Mois · Signataire · Signée le · Adresse IP · Navigateur · Empreinte SHA-256 · Image de la signature · Contenu signé
  • feuilles-signees/ — Pour chaque feuille signée : image PNG de la signature et contenu signé (JSON, celui dont l'empreinte SHA-256 est indiquée).

Main courante

  • main-courante.csv — Inscriptions de main courante ; photos dans le dossier main-courante-photos/.
    Colonnes : Date · Site · Auteur · Type · Texte · Complément de · Photo
  • main-courante-photos/ — Photos jointes aux inscriptions de main courante.

Facturation

  • factures.csv — Factures et avoirs émis à vos clients (à conserver 10 ans).
    Colonnes : Numéro · Type · Date · Échéance · Période · Client · Total HT (€) · TVA (€) · Total TTC (€) · Avoir de · Payée le · Vendeur (mentions figées) · Client (mentions figées)
  • factures-lignes.csv — Détail des lignes de chaque facture et avoir.
    Colonnes : Numéro · Libellé · Heures · Prix unitaire HT (€) · Montant HT (€)
  • facturation-clients.csv — Client à facturer et tarifs de chaque site (réglages de la facturation).
    Colonnes : Site · Client · Adresse du client · SIRET du client · TVA du client · Taux horaire HT (€) · Majoration nuit (%) · Majoration dimanche (%) · Majoration jours fériés (%) · Modifié le

Journal

  • controle-plateforme.csv — Décisions de la plateforme concernant cette agence uniquement (sans données des autres agences).
    Colonnes : Date · Action · Résultat
  • journal-activite.csv — Journal d'activité de l'agence (qui a fait quoi, quand).
    Colonnes : Date · Type · Événement · Détail · Par
Mentions légales·Conditions·Confidentialité·Portabilité·Hébergement