Préparer une demande d’entente préalable

POST/v1/prior-agreements

Sur un devis, elle en reprend le praticien, le patient et les lignes. Sans devis, elle nomme ses actes.

Droit de clé restreinte : quotes:write.

Corps de la requête

quotetexte
Le devis dont la demande porte les soins, qt_…. Elle en reprend praticien, patient et lignes.
practitionertexte
Sans devis : le praticien qui demande, prac_….
patienttexte
Sans devis : le patient, pat_….
linestableau de objet
Sans devis : les actes demandés.
Champs de lines
- nomenclatureénumérationobligatoire
  ngapccamlppbiologymedication
- codetexteobligatoire
- quantityentier
- coefficientnombre
urgentbooléen
Les soins ne peuvent pas attendre la réponse : la facture porte le code d'urgence dès l'envoi.

En-têtes

Idempotency-Keytexte
Rend le rejeu de cette écriture sûr pendant 24 heures. Idempotence.

Réponse

Rend l’objet ententes préalables.

Une erreur suit le format commun.

Requête

curl


curl -X POST https://api.ophelix.fr/v1/prior-agreements \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"quote":"qt_…"}'

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.ophelix.fr']);
 
$response = $client->post('/v1/prior-agreements', [
    'headers' => ['Authorization' => 'Bearer sk_test_…'],
    'json' => [
        'quote' => 'qt_…',
    ],
]);
$object = json_decode((string) $response->getBody(), true);

TypeScript


const response = await fetch('https://api.ophelix.fr/v1/prior-agreements', {
  method: 'POST',
  headers: { Authorization: 'Bearer sk_test_…', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    quote: 'qt_…'
  }),
})
const object = await response.json()

Réponse 201


{
  "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
}