Adhésions / Signatures

Endpoints pour récupérer et supprimer les adhésions (signatures de membres). Module requis : MaCarteDeMembre.

Préférez les endpoints V2 pour les nouvelles intégrations — ils retournent un instantané historique des coordonnées au moment de la signature et offrent plus de filtres.

V1 — recherche par date / employé

GET /b2b/v1/adhesion
GET /b2b/v1/adhesion/{idExterne}

Filtres

Nom	Type	Description
apres	DateTime	dateSignature ≥ apres (inclusif)
idExterne	string	Filtre par employé (sur /b2b/v1/adhesion)

Réponse V1

[
  {
    "dateSignature": "2026-04-24T14:30:00Z",
    "courriel": "alice@example.com",
    "idUnique": "...",
    "idUniqueAdhesion": "...",
    "transactionId": "TX-10022",
    "aSignatureManuscripte": false,
    "syndicatIdExterne": "SYND001",
    "syndicatNom": "Syndicat",
    "employe": { /* B2BEmployeItem courant */ }
  }
]

---

V2 — recherche riche

GET /b2b/v2/adhesion
GET /b2b/v2/adhesion/{idExterne}

Filtres V2

Nom	Type	Description
apres	DateTime	dateSignature ≥ apres
avant	DateTime	dateSignature ≤ avant
idExterneSyndicat	string	Égalité sur le syndicat
idExterneEmploye	string	Égalité sur l'employé
noMembre	string	Recherche par numéro de membre
aSignatureManuscripte	bool	true = avec signature, false = sans
avecPaiement	bool	true = liée à un paiement, false = sans

Tous les filtres se combinent par ET logique (AND).

Réponse V2

[
  {
    "dateSignature": "2026-04-24T14:30:00Z",
    "idUniqueAdhesion": "...",
    "transactionId": "TX-10022",
    "aSignatureManuscripte": false,
    "syndicatIdExterne": "SYND001",
    "syndicatNom": "Syndicat",
    "employeIdExterne": "EMP-001",
    "employeIdUnique": "...",
    "employePrenom": "Alice",
    "employeNom": "Tremblay",
    "courriel": "alice@example.com",
    "telephonePrincipal": "5145551234",
    "adresse1": "123 rue Principale",
    "ville": "Montréal",
    "province": "QC",
    "codePostal": "H2X1Y2",
    "valeursChampUtilisateur": []
  }
]

Exemple V2

curl -X GET "https://api.macartedemembre.com/b2b/v2/adhesion?apres=2026-01-01T00:00:00Z&idExterneSyndicat=SYND001&avecPaiement=true" \
  -H "X-Api-Key: votre-cle-api"

---

Supprimer une adhésion par identifiant unique

DELETE /b2b/v2/adhesion/{idUnique}

Opération destructrice et irréversible.

Erreurs possibles

Code	HTTP	Signification
Adhesion.NotFound	404	L'adhésion n'existe pas
Adhesion.LinkedToActiveCampaign	409	Liée à un votant dans une campagne active
Adhesion.HasPayments	409	Liée à un paiement
Adhesion.HasPaymentAuthorizations	409	Liée à une autorisation de paiement

---

Supprimer toutes les adhésions d'un membre

DELETE /b2b/v2/adhesion/membre/{idExterneMembre}

Paramètres

Nom	Emplacement	Type	Description
idExterneMembre	Path	string	Identifiant externe du membre
idExterneSyndicat	Query	string?	Si fourni, restreint la suppression à ce syndicat

Sans idExterneSyndicat, toutes les adhésions du membre sont supprimées. Bloqué par les mêmes règles que la suppression unitaire.

---

Récupérer l'image de signature manuscrite

GET /b2b/adhesion/{idExterne}/image-signature

Retourne l'image de la signature manuscrite de l'adhésion la plus récente d'un·e employé·e ayant capturé une signature. Les adhésions sans capture de signature manuscrite sont ignorées — la requête remonte à la dernière adhésion signée manuellement.

Paramètres

Nom	Emplacement	Type	Description
idExterne	Path	string	Identifiant externe de l'employé·e (défini par le partenaire via Sync). Ce n'est pas le GUID de l'adhésion.

Réponse (200 OK)

{
  "idExterne": "EMP-001",
  "idUniqueAdhesion": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "dateSignature": "2026-04-24T14:30:00Z",
  "imageSignature": "data:image/png;base64,iVBORw0KGgo..."
}

Champs de la réponse

Champ	Type	Description
idExterne	string	Identifiant externe de l'employé·e (renvoyé tel quel)
idUniqueAdhesion	string (GUID)	Identifiant interne MCM de l'adhésion
dateSignature	DateTime (UTC)	Horodatage de la signature
imageSignature	string	Image de signature au format URL de données (ex. data:image/png;base64,...)

Erreurs possibles

Code	HTTP	Signification
Employe.NotFound	404	Aucun·e employé·e ne correspond à idExterne dans ce locataire
Signature.NotFound	404	L'employé·e existe mais aucune adhésion n'a de signature manuscrite capturée

Multi-locataire

Cet endpoint est limité au ClientId de la clé API appelante. Il est impossible de consulter les identifiants d'un autre locataire.

Exemple

curl -X GET "https://api.macartedemembre.com/b2b/adhesion/EMP-001/image-signature" \
  -H "X-Api-Key: votre-cle-api"

---

Voir aussi

• ISignatureClient — client SDK .NET
• Webhook adhesion.signee — notification temps réel à la signature