Ententes préalables

Une demande d’accord préalable à la caisse, et le suivi de sa réponse.

Le cycle de vie et les pièges : Devis et ententes préalables.

Événements : prior_agreement.*.

Routes

Route	Effet
`POST /v1/prior-agreements`	Préparer une demande d’entente préalable
`GET /v1/prior-agreements/{agreement}`	Lire une demande d’entente préalable
`GET /v1/prior-agreements`	Lister les demandes d’entente préalable
`POST /v1/prior-agreements/{agreement}/send`	Envoyer une demande d’entente préalable
`POST /v1/prior-agreements/{agreement}/answer`	Enregistrer la réponse de la caisse
`POST /v1/prior-agreements/{agreement}/cancel`	Annuler une demande d’entente préalable

L’objet

idtexte
L'identifiant de l'objet, préfixé par son type.
objecttexte
Le nom du type d'objet.
statusénumération
draftsentapprovedrefusedcanceled
practitionertexte
patienttexte
quotetexteou null
Le devis dont la demande porte les soins, qt_….
linestableau de objet
Les actes demandés.
Champs de lines
- nomenclaturetexteobligatoire
- codetexteobligatoire
- quantityentierobligatoire
- coefficienttexteobligatoire
urgentbooléen
Les soins n'attendent pas la réponse : la facture porte le code d'urgence dès l'envoi.
channelénumérationou null
paperonline
sent_ontexteou null
Le jour où la demande est partie.
responseénumérationou null
favorableno_answer
responded_ontexteou null
Le jour où la réponse est arrivée.
identifiertexteou null
L'identification que porte la réponse.
claim_line_agreementobjetou null
Ce qu'une ligne de facture porte de cette entente, à recopier dans lines[].prior_agreement. Null tant qu'elle ne permet pas de facturer.
Champs de claim_line_agreement
- responseénumérationobligatoire
  favorableno_answeremergency
- sent_ontexteobligatoire
- identifiertexte
sent_atentierou null
approved_atentierou null
refused_atentierou null
canceled_atentierou null
livemodebooléen
true en production, false en mode test.
createdentierou null
La création de l'objet, en secondes Unix.

L'objet


{
  "id": "obj_…",
  "object": "prior_agreement",
  "status": "draft",
  "practitioner": "…",
  "patient": "…",
  "quote": null,
  "lines": [
    {
      "nomenclature": "…",
      "code": "…",
      "quantity": 0,
      "coefficient": "…"
    }
  ],
  "urgent": true,
  "channel": "paper",
  "sent_on": null,
  "response": "favorable",
  "responded_on": null,
  "identifier": null,
  "claim_line_agreement": null,
  "sent_at": null,
  "approved_at": null,
  "refused_at": null,
  "canceled_at": null,
  "livemode": false,
  "created": 1793970000
}