Partenariats et durées
Choisir le partenariat courtier – compagnie (companyBrokerId) et la durée de couverture (durationCode).
Partenariats
Un partenariat est un lien courtier – compagnie. Il définit qui souscrit pour qui, le taux de
commission et les droits (créer une proposition, valider, émettre une attestation, gérer des
avenants). Son id est le companyBrokerId de la proposition ; la compagnie du lien devient
l'assureur du contrat.
Lister
curl -s "$API/provider/lnk-broker-companies?page=0&size=20" -H "Authorization: Bearer $TOKEN"Le serveur force isActive=true et canCreateProposal=true. Filtres utiles :
| Paramètre | Effet |
|---|---|
filter[query] | Recherche partielle sur le code du lien, le code et le nom du courtier, le code et le nom de la compagnie |
filter[companyCode], filter[brokerCode] | Égalité insensible à la casse |
filter[broker.id], filter[company.id], filter[companyBrokerCode], filter[partnershipStatus] | Égalité |
Réponse : tableau de LnkBrokerCompanyDto + en-têtes de pagination.
| Champ | Type | Description |
|---|---|---|
id | string | → companyBrokerId |
brokerId, companyId | string | Identifiants du courtier et de la compagnie |
brokerCode, brokerLegalName | string | Courtier |
companyCode, companyLegalName | string | Compagnie (assureur du contrat) |
broker, company | objet | Résumés (id, codes, raison sociale, tradeName / companyLabel) |
companyBrokerCode | string | Code du partenariat |
commissionRate | number | Taux de commission |
issuanceLimit | number | Plafond d'émission |
canCreateProposal, canValidateContract, canIssueCertificate, canManageEndorsement | boolean | Droits |
partnershipStartDate, partnershipEndDate | date | Validité |
partnershipStatus | enum | ACTIVE, SUSPENDED, TERMINATED |
statusReason, isActive, createdDate, lastModifiedDate |
Consulter
GET /provider/lnk-broker-companies/{id} renvoie le même objet, pour vérifier droits et validité
avant de créer un contrat.
Un compte rattaché à un courtier ne voit que ses propres partenariats ; un compte compagnie voit ceux de sa compagnie. Si la liste est vide, le partenariat n'est pas actif ou n'autorise pas la création de proposition : contactez le Pool.
Durées
curl -s $API/provider/durations -H "Authorization: Bearer $TOKEN"Réponse : tableau des durées actives, en-tête X-Total.
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant interne, à ne pas envoyer |
durationCode | string | Code à envoyer dans durationCode (ex. 3_MOIS, 12_MOIS) |
durationLabel | string | Libellé (ex. « 12 mois ») |
numberOfMonths | int | Nombre de mois |
fractionatedRate | number | Taux de fractionnement (%) |
isTemporary | boolean | Durée temporaire |
isActive, displayOrder, createdAt, lastModifiedDate |
La date d'échéance est calculée par le serveur à partir de effectiveDate et de la durée ; elle est
renvoyée dans expiryDate du contrat. Une durée inactive est refusée (DURATION_NOT_ACTIVE).