API données ouvrier — compte rendu de séance

Bureau des Métiers · Globaz · APCOM — instance centrale / guichet ouvrier · séance du 23.09.2026

Base : note du 15.09.2026 · note-seance.html

Composants. Instance centrale : master.mybmapp.ch. Guichet ouvrier : mybmapp.ch (web) et application mobile MyBM. Relevé des décisions par point.

1Compléments au flux affilié (données ouvrier)

Champs	Décision	Détail
`email` · `residencePermit` · `mobileAppAccess`	Acté	Ajoutés au flux descendant existant GET /bmaffiliates/{affiliationId} (employees[]).
`photo` · pièce d'identité	Modifié	Ne passent pas par ce flux. API Globaz déjà existante et mise à disposition, non encore exploitée par APCOM → à intégrer. Pièce d'identité = un seul fichier (recto + verso), voir §5.
`affiliationAppStatus` · préférences (`notifPush`, `notifEmail`, `interest*`)	Retiré Globaz	N'existeront pas côté Globaz. Détenus et exposés par APCOM (voir §3, flux 1 et 3).

2Flux « entreprises »

Inchangé — GET /bmaffiliates (collection) renvoie la liste complète des affiliés. Le filtrage de la population est tranché en §5.

3Remontée APCOM → Globaz — 3 flux GET distincts

Modifié — le service unique request_update_team est éclaté en trois flux GET exposés par APCOM, interrogés par Globaz (modèle pull ; accès par clé publique / privée + token, une paire par partenaire, secrets en Vaultwarden).

Flux	Auteur / clé	Contenu	Réponse Globaz
1 — Update employé (profil ouvrier)	`worker` / `nss`	Toutes les données ouvrier : adresse, mobile, e-mail, état civil, nationalité, permis, IBAN, pièce d'identité, photo, préférences, statut d'affiliation. + date de validité de la mutation (à partir de quand).	`mutationId` → prise en compte ou refusée
2 — Update poste (avenant, campagne CCT)	`companyAdmin` (+ `affiliationId`) / `nss` + `jobId`	Nouvelle situation `historical` : salaire, taux, type, classe CCT, qualification. Miroir de bmjobs/{jobId} → date de validité implicite (`startDate` / `endDate` du modèle `historical`).	`mutationId` → prise en compte ou refusée
3 — Préférences ouvrier	`nss`	`notifPush`, `notifEmail`, `interestWorkSafety`, `interestTrainingCenter`, `interestAdmin`, `interestDocuments`.	Aucune. Globaz ne stocke jamais ces données — elle les exploite. Donnée mère = MyBM app mobile ouvrier.

🔴 Flux 1 et 2 = deux API séparées (jamais fusionnées).

Sémantique du retour et cycle « pending »

Accusé ≠ application. mutationId « prise en compte » signifie donnée reçue, pas modification effectuée dans la solution métiers.
Vrai retour = au balayage descendant. L'application est confirmée quand APCOM balaie le flux existant (bmaffiliates/{affiliationId} → employees[], et bmjobs/{jobId} pour rémunération / cotisations) et constate la mutation.
Figement côté APCOM (MyBM app ouvrier + MyBM RH). Toute annonce (ouvrier ou entreprise) est figée (pending) jusqu'à ce constat d'application.
Refus. Si Globaz répond refusée : APCOM journalise (refus / acceptation) et libère immédiatement le pending.
Flux 3 : ni mutationId, ni pending.

4Référentiels

Validé

Nationalité — codes pays ISO 3166-1 alpha-2 (CH, FR, IT…).
Localité — référentiel officiel des NPA et localités de La Poste Suisse.

5Filtrage de la population & pièce d'identité

Point	Décision
Filtrage de la population	Modifié — assuré par Globaz, plus par APCOM : exclusion de la caisse 133 (temporaires) et sélection des travailleurs actifs opérées côté Globaz.
Pièce d'identité	Modifié — un seul fichier contenant recto et verso (et non deux images distinctes). L'app mobile permet à l'ouvrier de prendre une photo recto, une photo verso, puis les enregistre en un seul fichier. Maquette mise à jour : app-mobile.html.

Suites

APCOM	Globaz
Exposer les 3 flux GET (1 employé + date de validité, 2 poste, 3 préférences). Intégrer l'API photo / pièce d'identité existante (fichier unique recto+verso). Implémenter figement + balayage descendant + journal des refus. App mobile : capture recto+verso → un fichier fait.	Ajouter `email` / `residencePermit` / `mobileAppAccess` au flux affilié. Assurer le filtrage de la population. Répondre par `mutationId` sur flux 1 et 2. Confirmer les référentiels §4.

← Retour à l'accueil