Journal des changements

Chaque version de l’API a son entrée, de la plus récente à la plus ancienne. Le titre d’une entrée est la valeur à passer dans Ophelix-Version. Ce qui casse et ce qui ne casse pas, et combien de temps une version reste servie : voir la politique de versions.

Un ajout qui ne casse rien arrive sans nouvelle version : il prend sa ligne datée sous la version en cours.

2026-11-01

Première version de l’API. Tout part de https://api.ophelix.fr/v1, avec une clé sk_test_ ou sk_live_ selon le mode.

Ressources

• Praticiens : créer un praticien depuis la lecture de sa carte, le modifier, le suspendre, lever la suspension.
• Patients et droits : retrouver un patient, lire ses droits depuis sa carte Vitale ou en mode dégradé, relire les droits lus.
• Factures : ouvrir un brouillon, ajouter, corriger ou retirer une prestation, valider à blanc, passer à prêt, sécuriser avec la carte du praticien, annuler.
• Lots et fichiers : lister les lots, voir le prochain envoi, envoyer maintenant, relire les fichiers envoyés.
• Postes : créer un code d’appairage, confirmer le rattachement d’un poste, renommer ou révoquer un poste.
• Webhooks : créer un point de terminaison, suivre ses livraisons, renouveler son secret, envoyer un événement de test, renvoyer un événement.
• Événements et requêtes : relire les événements et les appels de votre organisation.

Mode test

• Un simulateur répond à la place de l’Assurance Maladie et des cartes : lectures de carte, factures de test, accusés et retours simulés. Voir Cartes et scénarios de test.

Dans toute l’API

• Un format d’erreur commun, des listes par curseur, des objets liés à la demande par expand[], l’en-tête Idempotency-Key sur chaque écriture et Request-Id sur chaque réponse. Voir Conventions.
• Les bibliothèques PHP et Node envoient cette version.

Ajouts du 9 novembre 2026

• Virements et relevés : chaque retour de paiement annonce ses virements (Payout), avec leurs paiements et leurs retenues. Un relevé de compte déposé (CSV ou camt.053) ou un crédit saisi à la main les rapproche, et les écarts sont signalés. Les paiements portent leur virement (payout), et GET /v1/claims?payout= liste les factures qu’il règle. Événements payout.created, payout.reconciled et payout.flagged, code d’erreur statement_unreadable.

Ajouts du 7 novembre 2026

• Fil du mode test : GET /v1/test-helpers/feed rend les événements et les requêtes qui suivent deux curseurs, et le secret qui signe leur relais vers un serveur local. L’outil en ligne de commande s’en sert. Nouveau code d’erreur : cli_login_code_invalid.
• Part complémentaire : amc_pricing explique amc_amount_cents, chaque prestation porte sa part (lines[].amc_amount_cents), et une facture reçoit sous complementary la convention retenue et la réponse de prise en charge. Une couverture décrit sa complémentaire, et une situation de facturation ses tables de conventions.
• Retours des caisses : déposer un fichier d’accusés ou de retours de paiement, lire les paiements et les rejets de chaque facture, rapprocher un retour à la main, reconstituer un lot refusé, corriger et réémettre une facture rejetée. Une facture porte désormais son numéro (number), et un lot refusé son code et son libellé (failure_code, failure_label).

Ajouts du 8 novembre 2026

• Sans carte Vitale : sans mode à la création, une facture sur des droits saisis part en mode dégradé, et les règles retiennent le mode à finalize (un acte à distance sans carte part en sesam_sans_vitale). Une feuille dégradée signée porte supporting_document_status: "pending", filtrable dans GET /v1/claims. Un lot porte acknowledgment_expected, faux pour un lot de FSE dégradées, que l’organisme n’accuse pas.