Passer au contenu principal
API

Les noms des contenants dans l’aperçu du rendez-vous deviennent des noms de produits

À partir de la prochaine version, containers[].name dans Aperçu du rendez-vous est le nom de produit du tube. type ne change pas, donc lis type si ton application compare les contenants.
Panneau d'administrationAPI

Aniva fonctionne désormais dans toutes les langues de l’UE, et quelques autres

API

Un seul endpoint pour lister les panels

API

Afficher les résultats de laboratoire dans ton application

Tes patients peuvent désormais voir leurs résultats de laboratoire dans ton application : la liste des biomarqueurs, l’évolution de chaque biomarqueur et un Twin 3D avec une note par domaine de santé. La page utilise la couleur de ta marque et ton logo, en mode clair ou sombre.La page de résultats est une option payante, et ton contact chez Aniva peut t’en indiquer le prix. Créer une session d’intégration montre comment la configurer.
API

Les requêtes de liste de l’API sont mises en cache jusqu’à 5 minutes

Ces quatre endpoints mettent désormais leur réponse en cache jusqu’à 5 minutes, donc une modification peut prendre jusqu’à 5 minutes pour apparaître :Les endpoints Get affichent toujours les modifications directement.Si tu interroges régulièrement l’API pour détecter des modifications, utilise plutôt les webhooks. Un webhook t’informe de chaque modification dès qu’elle se produit. Voir Lectures répétées.
Panneau d'administration

Voir quand le coursier vient chercher tes échantillons

Le panneau d’administration affiche désormais le prochain enlèvement par coursier à ton cabinet, avec le suivi et l’étiquette.Panneau d'administration avec une bannière en haut : GO! passe demain ~10:00–12:00.Panneau d'administration avec une bannière en haut : GO! passe demain ~10:00–12:00.
API

Les plages Aniva sont désormais disponibles

Tes résultats peuvent désormais inclure les plages Aniva : une plage générale et une plage plus étroite pour chaque biomarqueur, avec les sources enregistrées par Aniva. Les plages varient selon l’âge, le sexe et la semaine de grossesse.Pour y accéder, signe le court accord sur les plages Aniva. Nous les activons ensuite pour ta clé API. Demande l’accord à ton contact chez Aniva.Les plages figurent dans le nouveau champ aniva_range. Il remplace reference_range_aniva, qui était toujours null. Les plages sont des informations générales. Elles n’évaluent pas un résultat, et elles ne constituent ni un avis médical ni un dispositif médical. La plage du laboratoire reste la référence. Voir Plages Aniva.
API

Le tube fluorure est désormais fluoride

Prévisualiser les contenants nomme le tube fluorure fluoride. L’ancienne valeur était naf. Si ton code compare container.type à naf, remplace-la par fluoride.Deux nouvelles valeurs peuvent apparaître : lihep_capillary et fluoride_capillary. Ce sont le tube capillaire héparine de lithium et le tube capillaire fluorure.
API

Plus de double réservation du dernier créneau

Si deux réservations pour la dernière place d’un créneau arrivent en même temps, une seule réussit. L’autre reçoit 409, comme pour tout créneau complet. C’est la même chose quand un rendez-vous est modifié pendant qu’il est en cours d’annulation ou de confirmation.Confirmer la prise de sang a trois nouveaux motifs 409 :
  • remapped : le code correspond désormais à d’autres panels qu’avant.
  • sent_to_lab et order_in_flight : le laboratoire a peut-être déjà la commande, donc le code doit rester sur son tube.
APIKits à domicile

Adresses de livraison plus strictes pour les commandes de kits à domicile

Créer un kit à domicile et Mettre à jour un kit à domicile vérifient delivery_address plus strictement.
  • country_code accepte les minuscules, par ex. de. Aniva l’enregistre et le renvoie en majuscules.
  • Une adresse allemande (DE) nécessite un postal_code d’exactement 5 chiffres. Les autres valeurs renvoient un 400.
  • Les espaces autour de postal_code sont supprimés avant l’enregistrement.
Panneau d'administrationKits à domicileAPI

Un nouveau kit pour un kit qui nous est retourné

Quand le transporteur nous retourne un kit, nous n’attendons plus la boîte. Dis-nous que tu veux à nouveau le kit, et nous envoyons un nouveau kit tout de suite. Tu peux aussi le créer toi-même : appelle Créer un kit à domicile en définissant replaces_home_kit_order_id sur le kit retourné. Le nouveau kit est une commande distincte avec un nouveau code de kit.Nous vérifions la boîte retournée à son arrivée. Le kit retourné passe alors à cancelled, et tu vois ce qu’il y avait dans la boîte.
RésultatsAPIPanneau d'administration

Prévenir ton équipe par e-mail quand les résultats sont prêts

Demande-nous de définir une adresse e-mail par défaut pour ton groupe de profils, par exemple la boîte de réception de ton équipe. Elle reçoit alors un e-mail quand les résultats d’une nouvelle réservation sont prêts. Cela couvre les réservations faites depuis le panneau d’administration, via l’API et par tes patients.Pour la modifier pour une réservation :
  • Panneau d’administration : modifie les adresses e-mail ou désactive « M’envoyer un e-mail quand les résultats sont prêts ».
  • API : envoie une liste dans results_ready_emails pour utiliser ces adresses e-mail à la place. Pour conserver ton adresse e-mail par défaut, inclus-la dans la liste. Envoie [] pour ne pas envoyer d’e-mail.
Voir E-mails de résultats prêts.
APIKits à domicile

Le patient saisit sa date de naissance et son sexe

Nous pouvons désormais autoriser ton groupe de profils à créer un profil sans date_of_birth ni sex. Le patient saisit les deux sur la page d’activation du kit, en tapant sa date de naissance deux fois. Demande-nous de l’activer. Voir Profils.
Panneau d'administration

Un panneau d’administration plus rapide

Le panneau d’administration affiche désormais le premier contenu en environ 0,2 s, contre 1,3 s auparavant. Fini les indicateurs de chargement. Les pages se remplissent à mesure que les données arrivent. Elles commencent à se charger quand tu survoles un lien.
Panneau d'administrationKits à domicileWebhooks

Kits qui nous sont retournés

Quand le transporteur nous retourne un kit, la page Kits à domicile l’affiche désormais. Filtre par Retourné pour voir tous les kits que le transporteur nous a retournés, avec le motif du transporteur. L’envoi se termine en fault et déclenche shipment.fault, et non plus delivered. Une fois la boîte ouverte, tu vois aussi ce qu’elle contenait : complet, une pièce manquante ou ouvert. Cela t’indique si ton client reçoit un remboursement intégral.Tu veux qu’on renvoie le kit ? Écris-nous avec le code du kit et la bonne adresse de livraison. Nous l’expédions avec le même code de kit.
API

Unités logarithmiques

Lister les unités renvoie un troisième unit_type : logarithmic, pour une valeur qui est le logarithme d’une grandeur, comme le pH ou un indice athérogène. Traite-le comme physical à l’affichage. Ne mets pas la valeur à l’échelle : deux unités logarithmiques diffèrent par un décalage, pas par un facteur.
APITarification

Estimer un kit à domicile avec ses frais

Estimer le panier accepte fulfilment. Envoie home_kit avec un country_code et le devis ajoute les lignes de kit de ta facture mensuelle pour une commande : les frais de kit, les dispositifs de prélèvement, les frais de port aller-retour vers ce pays, l’étui et un sachet de lancettes de rechange. La valeur par défaut reste un draw en centre avec les frais de rendez-vous. La réponse indique l’option tarifée dans fulfilment.kind.
Concierge

Découvre l’Aniva Concierge

Désormais, notre changelog apparaît aussi dans ton canal Slack avec nous, dès que nous déployons une nouveauté.Nous avons aussi créé l’Aniva Concierge. Une question sur l’API ou le panneau d’administration ? Mentionne @Aniva dans Slack, ou réponds simplement sous un message du changelog. Il consulte notre documentation et t’indique où cliquer dans le panneau d’administration, ou quel endpoint et quels filtres utiliser, avec un lien vers la page.
APIRendez-vous

Lister les rendez-vous d’une journée

Lister les rendez-vous accepte deux nouveaux filtres. date (YYYY-MM-DD) renvoie une journée civile, dans le fuseau horaire du centre de chaque rendez-vous, du plus tôt au plus tard. location_id renvoie un centre de prélèvement. Utilise les deux pour obtenir le planning du jour d’un centre.
APIProfils

Les profils en double sont refusés

Créer un profil renvoie désormais 409 avec error_name: "duplicate_profile_error" lorsqu’un profil visible par ta clé a les mêmes prénom, nom, sexe et date de naissance. La réponse indique le profile_id existant. Utilise-le au lieu de créer un second profil. Les noms de famille de la sandbox font exception.
Centres

Aniva Berlin Mitte ferme

À partir du 1er novembre 2026, Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) ne propose plus de rendez-vous. Le centre le plus proche est Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Panneau d'administrationTarification

Catalogue de tests avec tes tarifs

Le nouveau Catalogue de tests dans le panneau d’administration liste chaque biomarqueur avec ses laboratoires, ses tubes et son prix selon ta grille tarifaire.
APIRésultats

Pourquoi un résultat n’a pas de plage du laboratoire

Chaque résultat clinique dans Obtenir les résultats et Obtenir les résultats de laboratoire pour les kits à domicile contient désormais reference_range_lab_absent_reason. Ce champ indique pourquoi reference_range_lab est null :
  • not_provided : aucune plage n’existe. Affiche « Non applicable ».
  • lab_text_only : le laboratoire a uniquement imprimé du texte, comme une cible ou un niveau de risque. Affiche lab_reported.reference_range.
  • not_measured : le résultat est undeliverable.
Il vaut null quand une plage est présente. Voir Résultats.
APICentres

Prix publics et coordonnées

  • Les centres disposent désormais de state_code, latitude et longitude.
  • Lister les prix publics et Obtenir les prix publics renvoient le prix de chaque panel qu’une pharmacie vend aux clients de passage.
  • Le webhook location.retail_prices.updated t’informe quand un prix change.
Les endpoints et l’événement liés aux prix publics nécessitent le scope retail_prices_view.
Kits à domicilePanneau d'administration

Commander des kits à domicile dans le panneau d’administration

Tu peux désormais commander un kit à domicile pour ton patient sur la page Kits à domicile du panneau d’administration. Choisis ou crée le patient, choisis le kit et saisis l’adresse de livraison. Tu peux aussi y annuler un kit.
APITarifs

Grille tarifaire et devis

  • Obtenir la grille tarifaire renvoie tes tarifs sur le catalogue Aniva et tes frais.
  • Chiffrer un panier calcule le prix des panels et des biomarqueurs sans rendez-vous.
  • La facture dans Chiffrer un panier et Prévisualiser un rendez-vous contient maintenant fees, total_with_fees_cents et un name sur chaque ligne de biomarqueur.
  • rate_card dans les listes prend l’id fourni par Obtenir la grille tarifaire.
Les deux nouveaux endpoints nécessitent le scope prices_view.
APIRésultats

Plus de détails sur les documents

Chaque entrée dans documents sur Obtenir les résultats contient maintenant :
  • file_name : le nom utilisé par Télécharger un document.
  • Nouveau : original_file_name, origin, content_type, etag, size_bytes.
Un rapport PDF remplacé envoie maintenant results.updated, par exemple le rapport final de Labor Quade (_E) après le rapport préliminaire (_V).
APIWebhooks

Webhooks

Aniva appelle maintenant ton serveur quand un rendez-vous, une commande de kit à domicile, ses résultats, un lieu, un profil ou un envoi change. Tu n’as plus besoin de faire du polling.
  • Enregistre une URL HTTPS avec Créer un webhook. Tu as besoin du scope webhooks_manage. Demande à Aniva de l’ajouter à ta clé ou de configurer le webhook pour toi.
  • Les événements couvrent chaque statut d’un rendez-vous et d’une commande de kit à domicile, un nouvel horaire ou lieu, et chaque modification des résultats. results.completed t’indique que les résultats sont définitifs.
  • Les événements location.*, profile.* et shipment.* t’indiquent quand un lieu, un profil ou un envoi apparaît, change ou disparaît. Un envoi envoie aussi shipment.<status> à chaque changement de statut.
  • Les événements contiennent des identifiants et des statuts, jamais de valeurs de laboratoire ni de données personnelles. Consulte l’url dans l’événement pour récupérer les données.
  • Chaque requête est signée selon le schéma Standard Webhooks.
  • Aniva réessaie une livraison échouée 10 fois sur environ trois jours. Tu peux lister et renvoyer les livraisons pendant 30 jours.
  • Chaque résultat dans Obtenir les résultats a maintenant un id, ce qui te permet de mettre à jour le résultat pointé par un événement results.updated.
  • Obtenir un lieu renvoie un lieu par son id. L’url d’un événement location.* pointe vers celui-ci.
Voir Webhooks.
RésultatsPanneau d'administration

Envoyer les résultats par e-mail au client

Tu peux maintenant prévenir un client par e-mail que ses résultats de laboratoire sont prêts. Envoie l’e-mail depuis la page Résultats de laboratoire dans le panneau d’administration, ou via deux nouveaux endpoints : Envoyer les résultats par e-mail pour les rendez-vous et Envoyer les résultats par e-mail pour les commandes de kit à domicile.
  • L’e-mail peut inclure les rapports de laboratoire en pièces jointes PDF. Chaque PDF est protégé par mot de passe : le mot de passe est la date de naissance du client en 8 chiffres (JJMMAAAA), et l’e-mail le précise.
  • Tu peux ajouter une note personnelle de 1 000 caractères maximum.
  • Il affiche le nom et le logo du groupe de profils principal du profil, dans la langue du profil.
  • Chaque envoi correspond à un e-mail. Une nouvelle tentative en envoie un deuxième. Tu as besoin du scope results_view pour ce client.

Recevoir un e-mail quand les résultats sont prêts

Quand tu réserves un rendez-vous ou commandes un kit à domicile de remplacement dans le panneau d’administration, tu peux activer « M’envoyer un e-mail quand les résultats sont prêts ». Nous t’envoyons alors un e-mail, ou à toute adresse que tu saisis, dès que tous les résultats de laboratoire sont arrivés. L’e-mail renvoie vers le résultat dans le panneau d’administration. Le client ne reçoit pas cet e-mail. Tu as besoin du scope results_view pour ce client.Via l’API, tu peux définir jusqu’à 5 adresses dans results_ready_emails sur Créer un rendez-vous, Créer une commande de kit à domicile, Mettre à jour un rendez-vous et Mettre à jour une commande de kit à domicile.
Kits à domicile

Envoyer le téléphone et l’e-mail du destinataire avec chaque kit

Si delivery_address d’un kit à domicile contient phone ou email, nous les transmettons au transporteur. Le transporteur prévient alors le destinataire quand le colis est en route ou attend en point relais. Si tu ne les renseignes pas, le transporteur ne reçoit aucun contact, même si le profil en a un. C’est toi qui décides qui reçoit les notifications du transporteur. La notification peut mentionner Aniva Health comme expéditeur.Voir Créer une commande de kit à domicile.
Lieux

Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim et Wiesbaden

Quatre nouveaux lieux pour les prises de sang veineuses. Voir Lister les lieux.
Panneau d'administration

Page Résultats de laboratoire

La nouvelle page Résultats de laboratoire dans le panneau d’administration liste chaque prise de sang et chaque kit à domicile activé avec ses rapports de laboratoire. Recherche par nom, date de naissance ou code-barres du tube. Tu as besoin du scope results_view, et d’une autorisation pour les kits à domicile pour voir les kits.
Kits à domicile

Clés API limitées à l’activation

Le nouveau scope home_kit_orders_activate permet à une clé d’activer des kits à domicile et rien d’autre. Elle ne peut pas créer, modifier ni annuler un kit. Demande une telle clé à Aniva si un système distinct active tes kits.Voir Activer une commande de kit à domicile.
APIChangement majeur

Le sexe doit être masculin ou féminin

Créer un profil et Mettre à jour un profil n’acceptent plus sex: 0 (inconnu). Envoie 1 pour masculin ou 2 pour féminin ; 0 renvoie 400. Le laboratoire a besoin du sexe pour les intervalles de référence, et une commande pour un profil qui n’en a pas ne pourrait pas parvenir au laboratoire.Voir Créer un profil.
Kits à domicile

Kits arrivés au laboratoire sans activation

Si un échantillon arrive au laboratoire avant que son kit ne soit activé, Aniva active le kit. activated_at correspond au matin du premier événement de suivi du colis retour, ou au matin de l’arrivée de l’échantillon au laboratoire s’il n’y a pas de suivi. Un appel d’activation ultérieur avec un activated_at différent renvoie 409.Voir Activer une commande de kit à domicile.
API

Intervalles Aniva dans les résultats

Les endpoints de résultats remplissent maintenant reference_range_aniva avec les valeurs de comparaison qu’Aniva a compilées, converties dans l’unité du résultat. Les valeurs varient selon l’âge, le sexe et la semaine de grossesse. Ta clé a besoin du scope ANIVA_REFERENCE_RANGES_VIEW. Sans lui, le champ vaut null.Voir Obtenir les résultats d’un rendez-vous.
APIKits à domicile

Kits de remplacement

Commande un remplacement lorsqu’un kit n’a pas pu fournir tous les résultats. Un remplacement est une nouvelle commande avec un nouveau code laboratoire et conserve le panel de la commande d’origine. biomarker_ids définit ce que le laboratoire analyse à nouveau.Voir Commandes de kit à domicile.
APITarifsChangement majeur

Un prix par biomarqueur et par panel

Les biomarqueurs et les panels portent un price_cents selon ta grille tarifaire, avec retail_cents à côté :
  • > 0 : commandable seul.
  • 0 : un ratio (voir requires), ou commandable uniquement avec d’autres marqueurs (voir positions).
  • null : sans prix, donc non commandable.
Changement incompatible : groups[] est supprimé des listes et de l’aperçu du rendez-vous. Les champs de prix retail et yours sont supprimés.Voir Tarification.
API

Clés d’idempotence

Les endpoints de création pour les profils, les rendez-vous, les commandes de kits à domicile et les expéditions acceptent un en-tête Idempotency-Key. Une nouvelle tentative avec la même clé renvoie la première réponse et n’écrit rien.Voir Idempotence.
Sites

Aniva Hannover, Düsseldorf, Duisburg et Essen

Quatre nouveaux sites Aniva en Allemagne sont ouverts pour les prises de sang veineuses : Hannover, Düsseldorf, Duisburg et Essen. Appelle Lister les sites pour voir les sites que ta clé peut réserver.