Importer des prestations

POST/v1/claim-imports

Un message HPRIM Santé de facturation (contexte FAC) : chaque segment FAC ouvre une facture en brouillon pour son patient, déjà connu. Rend le rapport : factures ouvertes, segments refusés et pourquoi. Le message n’est pas gardé.

Droit de clé restreinte : claims:write.

Corps de la requête

formaténumérationobligatoire
Le format du message. hprim : HPRIM Santé 2.x, contexte de facturation (FAC).
hprim
contenttexteobligatoire
Le message, tel que le fichier le porte. Un million de caractères au plus.
practitionertexteobligatoire
Le praticien qui facture les prestations du message, prac_….
third_party_amobooléen
Le tiers payant de la part obligatoire, pour toutes les factures du message.
third_party_amcbooléen
Le tiers payant de la part complémentaire, pour toutes les factures du message.

En-têtes

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

Réponse

Rend l’objet imports de prestations.

Une erreur suit le format commun.

Requête

curl


curl -X POST https://api.ophelix.fr/v1/claim-imports \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "hprim",
    "practitioner": "prac_…",
    "content": "H|~^\\&|LABO1.HPR||LABO~LABORATOIRE||FAC|||CLIN~CLINIQUE||P|H2.5~C|202611060900\rP|1|…\rL|1\r"
  }'

PHP


$client = new GuzzleHttp\Client(['base_uri' => 'https://api.ophelix.fr']);
 
$response = $client->post('/v1/claim-imports', [
    'headers' => ['Authorization' => 'Bearer sk_test_…'],
    'json' => [
        'format' => 'hprim',
        'practitioner' => 'prac_…',
        'content' => 'H|~^\&|LABO1.HPR||LABO~LABORATOIRE||FAC|||CLIN~CLINIQUE||P|H2.5~C|202611060900
P|1|…
L|1
',
    ],
]);
$object = json_decode((string) $response->getBody(), true);

TypeScript


const response = await fetch('https://api.ophelix.fr/v1/claim-imports', {
  method: 'POST',
  headers: { Authorization: 'Bearer sk_test_…', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    format: 'hprim',
    practitioner: 'prac_…',
    content: 'H|~^\\&|LABO1.HPR||LABO~LABORATOIRE||FAC|||CLIN~CLINIQUE||P|H2.5~C|202611060900\rP|1|…\rL|1\r'
  }),
})
const object = await response.json()

Réponse 201


{
  "id": "obj_…",
  "object": "claim_import",
  "format": "hprim",
  "practitioner": "…",
  "claims": [
    {
      "claim": "…",
      "patient": "…",
      "line": 0,
      "file_number": null,
      "request_number": null,
      "lines": 0
    }
  ],
  "refusals": [
    {
      "line": 0,
      "segment": "…",
      "rank": null,
      "field": null,
      "reason": "patient_not_found"
    }
  ],
  "warnings": [
    {
      "line": 0,
      "segment": "…",
      "rank": null,
      "field": null,
      "reason": "segment_ignored"
    }
  ],
  "claims_count": 0,
  "lines_count": 0,
  "refusals_count": 0,
  "livemode": false,
  "created": 1793970000
}