Droits

Une lecture de droits (Coverage, cov_…) photographie ce que l’assurance dit d’un patient à un instant : droits ouverts ou fermés, régime, caisse, exonérations.

Droits de clé : patients:read et patients:write.

Cycle de vie

Une lecture ne se modifie jamais. Chaque lecture en crée une nouvelle, et crée le patient s’il est nouveau. Du plus récent au plus ancien, GET /v1/patients/{id}/coverages donne l’histoire : la première est la dernière lecture.

Je veux…

Je veux…	Appel
Lire une carte Vitale	`POST /v1/coverages` avec `source: vitale_card` et `card`
Saisir les droits à la main	`POST /v1/coverages` avec `source: manual`
Relire une lecture	`GET /v1/coverages/{id}`
Choisir la lecture d’une facture	`coverage` à `POST /v1/claims`


curl https://api.ophelix.fr/v1/coverages \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"source": "vitale_card", "card": "vitale_ok"}'

En mode test, card est un scénario de carte Vitale.

Sources

`source`	Sens
`vitale_card`	La carte Vitale
`vitale_app`	L’application carte Vitale
`adri`	Le service d’acquisition des droits
`manual`	Le mode dégradé : les droits sont saisis

Mode dégradé

Quand aucune carte n’est disponible, source: manual saisit les droits. regime_code, fund_code et center_code sont obligatoires. Donnez patient, un patient connu, ou beneficiary, un bénéficiaire saisi, mais pas les deux.


curl https://api.ophelix.fr/v1/coverages \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"source": "manual", "patient": "pat_…", "regime_code": "01", "fund_code": "751", "center_code": "0001"}'

card est interdit avec manual, et les champs de saisie sont interdits avec toute autre source.

Événements

Type	Quand
`coverage.retrieved`	Une lecture vient d’aboutir

L’événement ne porte ni exonérations ni complémentaire. Relisez la lecture.

Pièges

Des droits fermés se lisent sans erreur. rights: closed répond 201 : c’est la validation de la facture qui refuse.
Une carte illisible ne crée rien. vitale_unreadable répond card_unreadable.
Sans coverage, une facture prend la dernière lecture. Si le patient a changé de droits entre-temps, relisez-les avant de facturer.