Créer une facture de test

POST/v1/test-helpers/claims

Lit deux cartes du simulateur et ouvre un brouillon avec une prestation fictive.

Droit de clé restreinte : claims:write.

Mode test seulement

Corps de la requête

practitioner_cardtexte
Le scénario de carte CPS. Par défaut, cps_doctor.
patient_cardtexte
Le scénario de carte Vitale. Par défaut, vitale_ok.

En-têtes

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

Réponse

Rend l’objet factures.

Une erreur suit le format commun.

Requête

curl


curl -X POST https://api.ophelix.fr/v1/test-helpers/claims \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{"patient_card":"vitale_ok"}'

PHP


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

TypeScript


const response = await fetch('https://api.ophelix.fr/v1/test-helpers/claims', {
  method: 'POST',
  headers: { Authorization: 'Bearer sk_test_…', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    patient_card: 'vitale_ok'
  }),
})
const object = await response.json()

Réponse 201


{
  "id": "clm_034t7hAn4eNnGhufsRhPt3",
  "object": "claim",
  "status": "draft",
  "kind": "fse",
  "mode": "secured",
  "practitioner": "prac_034stsE7Z3xrDD833mQ3Kz",
  "practice_situation": "sit_034stsE7xFkwRLDQT8u2tW",
  "patient": "pat_034suQ2fyOnQtlR2EbxM0C",
  "coverage": "cov_034t7hAl1gh8dTLPOlQJ2R",
  "insurance_nature": "sickness",
  "third_party_amo": false,
  "third_party_amc": false,
  "context": {},
  "lines": [
    {
      "id": "cli_034t7hAnGi7l82OiGb4jIx",
      "object": "claim_line",
      "nomenclature": "ngap",
      "code": "ZC",
      "service_date": "2026-11-06",
      "quantity": 1,
      "coefficient": "1.00",
      "modifiers": [],
      "prescriber": null,
      "unit_price_cents": 2650,
      "base_unit_cents": null,
      "amount_cents": 2650,
      "base_amount_cents": 2650,
      "livemode": false
    }
  ],
  "amount_cents": 2650,
  "base_amount_cents": 2650,
  "amo_amount_cents": 1855,
  "amc_amount_cents": 0,
  "patient_amount_cents": 795,
  "paid_amount_cents": null,
  "rejection_code": null,
  "referential_versions": [],
  "ready_at": null,
  "secured_at": null,
  "transmitted_at": null,
  "acknowledged_at": null,
  "settled_at": null,
  "canceled_at": null,
  "livemode": false,
  "created": 1794004695,
  "updated": 1794004695
}