Praticiens

Un praticien (Practitioner, prac_…) est un professionnel de santé qui facture. Il naît de la lecture de sa carte et ne se saisit pas : son identité et ses situations d’exercice (sit_…) viennent de la carte.

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

Cycle de vie

État	Sens
`incomplete`	La carte ne porte aucune situation de facturation : il ne peut pas facturer
`ready`	Il peut facturer
`suspended`	Suspendu : la validation refuse ses factures

Une nouvelle lecture de sa carte met le praticien à jour, sans en créer un second. Elle ne lève pas une suspension.

Je veux…

Je veux…	Appel
Créer ou mettre à jour un praticien	`POST /v1/practitioners`
Lire un praticien	`GET /v1/practitioners/{id}`
Les lister	`GET /v1/practitioners`
Bloquer sa facturation	`POST /v1/practitioners/{id}/suspend`
Lever la suspension	`POST /v1/practitioners/{id}/reactivate`


curl https://api.ophelix.fr/v1/practitioners \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"card": "cps_doctor"}'

En mode test, card est un scénario de carte CPS. cps_nurse_multi donne deux situations, cps_no_situation un praticien incomplete.

Situations

Une situation dit sous quel numéro et dans quel cadre le praticien facture. Elles se lisent dans situations. billable dit si elle peut servir à facturer. Une facture sans practice_situation prend la première situation facturable.

Événements

Type	Quand
`practitioner.created`	Première lecture de sa carte
`practitioner.updated`	Nouvelle lecture, suspension ou levée de suspension
`practitioner.onboarding_completed`	Il peut facturer pour la première fois

Pièges

La création répond 201, la mise à jour 200. Relire la carte d’un praticien connu rend le même id.
Une carte bloquée ne crée rien. cps_blocked répond card_blocked.
specialty_code et convention_code sont ceux de sa première situation. Chaque situation porte les siens.
Lever une suspension ne rend pas toujours ready. Sans situation facturable, il revient à incomplete.