Aller au contenu principal

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

NomTypeDescription
apresDateTimedateSignature ≥ apres (inclusif)
idExternestringFiltre 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

NomTypeDescription
apresDateTimedateSignature ≥ apres
avantDateTimedateSignature ≤ avant
idExterneSyndicatstringÉgalité sur le syndicat
idExterneEmployestringÉgalité sur l'employé
noMembrestringRecherche par numéro de membre
aSignatureManuscriptebooltrue = avec signature, false = sans
avecPaiementbooltrue = 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

CodeHTTPSignification
Adhesion.NotFound404L'adhésion n'existe pas
Adhesion.LinkedToActiveCampaign409Liée à un votant dans une campagne active
Adhesion.HasPayments409Liée à un paiement
Adhesion.HasPaymentAuthorizations409Liée à une autorisation de paiement

Supprimer toutes les adhésions d'un membre

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

Paramètres

NomEmplacementTypeDescription
idExterneMembrePathstringIdentifiant externe du membre
idExterneSyndicatQuerystring?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.


Voir aussi