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.Aniva fonctionne désormais dans toutes les langues de l’UE, et quelques autres
- Panel d’administration, site web, centre d’aide et documentation : dans les 32 langues.
- Profils : définis la langue de chaque patient. La page de résultats et les e-mails de résultats s’y adaptent.
Un seul endpoint pour lister les panels
- Lister les panels renvoie désormais
biomarker_groups. Utilise-le à la place de/api/v2/panels. - Créer un panel a été supprimé. Utilise le panneau d’administration.
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.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 :- Lister les expéditions
- Lister les commandes de kits à domicile
- Lister les rendez-vous
- Lister les profils
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.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 champaniva_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.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.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çoit409, 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_labetorder_in_flight: le laboratoire a peut-être déjà la commande, donc le code doit rester sur son tube.
Adresses de livraison plus strictes pour les commandes de kits à domicile
Créer un kit à domicile et Mettre à jour un kit à domicile vérifientdelivery_address plus strictement.country_codeaccepte les minuscules, par ex.de. Aniva l’enregistre et le renvoie en majuscules.- Une adresse allemande (
DE) nécessite unpostal_coded’exactement 5 chiffres. Les autres valeurs renvoient un400. - Les espaces autour de
postal_codesont supprimés avant l’enregistrement.
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éfinissantreplaces_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.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_emailspour 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.
Le patient saisit sa date de naissance et son sexe
Nous pouvons désormais autoriser ton groupe de profils à créer un profil sansdate_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.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 enfault 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.Unités logarithmiques
Lister les unités renvoie un troisièmeunit_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.Estimer un kit à domicile avec ses frais
Estimer le panier acceptefulfilment. 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.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.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.Les profils en double sont refusés
Créer un profil renvoie désormais409 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.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.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ésormaisreference_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. Affichelab_reported.reference_range.not_measured: le résultat estundeliverable.
null quand une plage est présente. Voir
Résultats.Prix publics et coordonnées
- Les centres disposent désormais de
state_code,latitudeetlongitude. - 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.updatedt’informe quand un prix change.
retail_prices_view.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.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_centset unnamesur chaque ligne de biomarqueur. rate_carddans les listes prend l’idfourni par Obtenir la grille tarifaire.
prices_view.Plus de détails sur les documents
Chaque entrée dansdocuments 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.
results.updated, par exemple le rapport final de Labor Quade
(_E) après le rapport préliminaire (_V).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.completedt’indique que les résultats sont définitifs. - Les événements
location.*,profile.*etshipment.*t’indiquent quand un lieu, un profil ou un envoi apparaît, change ou disparaît. Un envoi envoie aussishipment.<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’
urldans 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énementresults.updated. - Obtenir un lieu renvoie un lieu par son
id. L’urld’un événementlocation.*pointe vers celui-ci.
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_viewpour 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 scoperesults_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.Envoyer le téléphone et l’e-mail du destinataire avec chaque kit
Sidelivery_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.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim et Wiesbaden
Quatre nouveaux lieux pour les prises de sang veineuses. Voir Lister les lieux.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 scoperesults_view, et d’une autorisation pour les kits à domicile pour voir les kits.Clés API limitées à l’activation
Le nouveau scopehome_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.Le sexe doit être masculin ou féminin
Créer un profil et Mettre à jour un profil n’acceptent plussex: 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 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.Intervalles Aniva dans les résultats
Les endpoints de résultats remplissent maintenantreference_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.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.Un prix par biomarqueur et par panel
Les biomarqueurs et les panels portent unprice_cents selon ta grille tarifaire, avec retail_cents
à côté :> 0: commandable seul.0: un ratio (voirrequires), ou commandable uniquement avec d’autres marqueurs (voirpositions).null: sans prix, donc non commandable.
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.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êteIdempotency-Key. Une nouvelle tentative avec la même clé renvoie la première réponse et n’écrit
rien.Voir Idempotence.
