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
- Connectez-vous avec un compte gérant.
- Ouvrez Équipe → Données de l'agence.
- 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 avecPOST /api/auth/login, corps JSON{"email": "…", "password": "…"}(Content-Type: application/json) ; la réponse pose le cookie (HttpOnly, 14 jours).
- Jeton du nouveau fournisseur (voir ci-dessous) : en-tête
- 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/exportJeton 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.txtdé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éé leinvitations.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éé ledocuments-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'exportabsences.csv— Absences et demandes d'absence (types neutres, aucune donnée de santé).
Colonnes : Agent · Type · Du · Au · Statut · Note · Créée ledocuments/— 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-endmissions-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 · Notesmissions-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 · Longitudeheures-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é lecorrections-heures.csv— Historique des validations et corrections d'heures (avant / après).
Colonnes : Date · Par · Action · Agent · Vacation · Avant · Aprèsfeuilles-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 · Photomain-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ésultatjournal-activite.csv— Journal d'activité de l'agence (qui a fait quoi, quand).
Colonnes : Date · Type · Événement · Détail · Par