Santé

Deux offres : RelaxSanté, complémentaire santé famille avec tiers payant, et Coups Durs, un capital versé en cas d'événement grave (AVC, infarctus, accident...). Le client déclare chaque personne couverte, l'API calcule la prime.

Offres

Offre	Code	Durée	Documents remis
RelaxSanté	`relaxsante`	12 mois	conditions generales, conditions particulieres
Coups Durs	`coups_durs`	12 mois	conditions generales, conditions particulieres

Règles à connaître

Exactement un adhérent (18 ans au moins), un conjoint au plus, 15 personnes au maximum.
Les âges limites de l'offre (age_max_souscription, age_max_enfant) s'appliquent à chaque personne : au-delà, erreur non_eligible.
Certaines maladies chroniques déclarées entraînent une surprime : leur liste figure dans les garanties de l'offre.
À la souscription, donnez le nom de chaque personne dans le même ordre que dans le devis.

RelaxSanté

relaxsante

Complémentaire santé famille : consultations, hospitalisation, pharmacie, examens, imagerie. Tiers payant dans le réseau de soins.

Durée : 12 mois. Documents : conditions generales, conditions particulieres.

Garanties et limites

Garantie ou règle	Valeur
`taux_remboursement`	70
`plafond_individuel`	500 000 FCFA
`plafond_famille`	1 000 000 FCFA
`age_max_souscription`	60
`age_max_enfant`	21
`couvre`	consultations, hospitalisation, pharmacie, examens_medicaux, imagerie
`maladies_chroniques_avec_surprime`	hyperthyroidie, asthme, hypercholesterolemie, fibrome_uterin, diabete, drepanocytose, glaucome, hta, kyste_ovarien, adenome_prostate, hepatite_virale, epilepsie, goutte, insuffisance_renale

Exemple de devis

POST /v1/devis, prime calculée : 238 000 FCFA

{
  "offre": "relaxsante",
  "donnees": {
    "assures": [
      {
        "role": "adherent",
        "date_naissance": "1990-04-12",
        "sexe": "F",
        "maladies_chroniques": []
      },
      {
        "role": "conjoint",
        "date_naissance": "1988-09-30",
        "sexe": "M",
        "maladies_chroniques": [
          "hta"
        ]
      },
      {
        "role": "enfant",
        "date_naissance": "2018-01-05",
        "sexe": "F"
      }
    ]
  }
}

Coups Durs

coups_durs

Capital versé en cas d'événement grave (AVC, infarctus, accident de la route, brûlures sévères...) et capital décès.

Durée : 12 mois. Documents : conditions generales, conditions particulieres.

Garanties et limites

Garantie ou règle	Valeur
`capital_maladie`	500 000 FCFA
`capital_deces`	500 000 FCFA
`evenements`	AVC, Infarctus du myocarde (crise cardiaque), Accident de la voie publique, Traumatisme crânien, Hémorragie externe sévère, Brûlures sévères (plus de 20 %), Morsure de serpent
`carence_jours`	7
`age_max_souscription`	59
`prime_par_personne`	15 000 FCFA

Exemple de devis

POST /v1/devis, prime calculée : 45 000 FCFA

{
  "offre": "coups_durs",
  "donnees": {
    "assures": [
      {
        "role": "adherent",
        "date_naissance": "1990-04-12",
        "sexe": "F",
        "maladies_chroniques": []
      },
      {
        "role": "conjoint",
        "date_naissance": "1988-09-30",
        "sexe": "M",
        "maladies_chroniques": [
          "hta"
        ]
      },
      {
        "role": "enfant",
        "date_naissance": "2018-01-05",
        "sexe": "F"
      }
    ]
  }
}

Champs du devis

Objet donnees de POST /v1/devis, identique pour toutes les offres santé.

Champ	Type	Obligatoire	Description
`assures`	liste (1 à 15)	oui	Toutes les personnes couvertes, l'adhérent compris.
`assures[].role`	« adherent » \| « conjoint » \| « enfant » \| « autre_adulte »	oui	Exactement un « adherent », un « conjoint » au plus.
`assures[].date_naissance`	date AAAA-MM-JJ	oui	L'adhérent doit avoir au moins 18 ans. Les âges limites de l'offre s'appliquent aussi (voir garanties).
`assures[].sexe`	« M » \| « F »	oui
`assures[].maladies_chroniques`	liste de codes	non	Maladies déclarées (questionnaire de l'assureur). Certaines entraînent une surprime : liste dans GET /v1/produits/{code}.

Prime calculée pour cet exemple (RelaxSanté)

{
  "nette": 238000,
  "accessoires": 0,
  "taxes": 0,
  "totale": 238000,
  "devise": "XOF"
}

Champs de la souscription

Objet informations de POST /v1/souscriptions. Le souscripteur est commun à tous les produits (voir Modèles de données).

Champ	Type	Obligatoire	Description
`assures`	liste	oui	Même nombre et même ordre que dans le devis.
`assures[].nom`	texte	oui
`assures[].prenoms`	texte	oui
`assures[].lieu_naissance`	texte	non
`assures[].profession`	texte	non
`assures[].groupe_sanguin`	texte	non	Ex. O+.

Exemple : POST /v1/souscriptions

{
  "devis_id": "dev_...",
  "souscripteur": {
    "nom": "KONE",
    "prenom": "Awa",
    "telephone": "+2250701020304",
    "email": "awa.kone@example.com",
    "adresse": "Cocody, Abidjan",
    "date_naissance": "1990-04-12"
  },
  "informations": {
    "assures": [
      {
        "nom": "KONE",
        "prenoms": "Awa",
        "lieu_naissance": "Abidjan"
      },
      {
        "nom": "KONE",
        "prenoms": "Moussa",
        "lieu_naissance": "Abidjan"
      },
      {
        "nom": "KONE",
        "prenoms": "Fatou",
        "lieu_naissance": "Abidjan"
      }
    ]
  }
}

Documents remis

Document	Quand	Appel
Conditions Générales	Avant le paiement (obligatoire)	`GET /v1/produits/{code}/conditions-generales`
Conditions Particulières	Après paiement	`GET /v1/contrats/{numero}/documents/conditions_particulieres`

Erreurs fréquentes

Code	HTTP	Signification
`validation`	422	Certaines données sont manquantes ou incorrectes. Voir erreur.details.
`non_eligible`	422	Une personne ne remplit pas les conditions de cette offre.
`offre_non_autorisee`	403	Cette offre n'est pas ouverte à votre compte.
`offre_indisponible`	409	Cette offre est momentanément indisponible à la vente.

Tester ce produit

Copiez l'exemple de devis ci-dessus dans la sandbox : il est vérifié contre l'API à chaque mise à jour de cette documentation. La prime indiquée est celle calculée ce jour-là : elle peut varier ensuite avec l'âge des personnes de l'exemple.