Saltar al contingut principal
Aniva posa preu a una sola cosa: la posició. Una posició és una oferta comercial —un conjunt seleccionat de biomarcadors que es factura un sol cop, a un preu fix, i sempre es lliura sencer. Un biomarcador que pots comprar per separat és simplement una posició d’un sol element. Tot el que veus a pricing se’n deriva. Llegeix aquesta pàgina un cop i els quatre estats següents deixaran de semblar casos especials.

Què signifiquen els números

Cada price_cents és el que pagues tu, segons la tarifa de la teva clau d’API. Al costat, retail_cents és el mateix article segons la tarifa de venda al públic recomanada, perquè puguis mostrar un estalvi sense fer una segona sol·licitud. Tots dos són cèntims enters i tots dos són nets: l’IVA s’afegeix a la teva factura mensual al tipus que correspongui al teu règim d’IVA, i un règim exempt no n’afegeix cap. Un panell que es ven al preu del catàleg per a consumidors d’Aniva es mostra amb aquest preu sense el 19 % d’IVA alemany.
retail_cents sempre hi és present. Quan la teva clau ja fa servir la tarifa de venda al públic, simplement és igual a price_cents.
Els preus necessiten l’abast prices_view. Sense aquest abast, pricing és null als llistats i a la previsualització, i els endpoints de preus retornen 403.

La teva tarifa

La teva tarifa defineix els teus preus. Consulta-la a Obtenir la tarifa.
  • Cada anàlisi té un tier: routine o specialty. El seu preu és el preu de catàleg d’Aniva aplicant-hi el multiplicador d’aquest nivell.
  • Els càrrecs són per cita, i el càrrec logístic és per recollida de missatgeria. Les teves cites a la mateixa ubicació el mateix dia comparteixen una sola recollida. Aniva factura els càrrecs a la teva factura mensual.

Els quatre estats

price_cents, juntament amb el bloc opcional que té al costat, defineix l’estat. No hi ha cap camp de tipus separat.

Positiu — es pot demanar per separat

El marcador té un preu propi. Encara pot aparèixer en posicions, i llavors positions les llista de la més econòmica a la més cara: comprar la posició sovint surt més barat que comprar-ne els elements un per un.
biomarker_ids és el conjunt complet d’elements de la posició; includes és aquest conjunt menys el marcador que has consultat: el que hi ve inclòs.

Zero amb requires — una ràtio

Una ràtio es calcula a partir de marcadors mesurats. La majoria de ràtios costen 0. Una ràtio amb un price_cents positiu factura aquest preu a més dels seus components. Demana-la i Aniva posa els seus components a la cistella al seu propi preu. Un component es paga un cop per cistella, per moltes ràtios que en depenguin.
Una ràtio es combina amb les posicions en lloc de competir-hi. Si els seus components formen part d’una posició que ja compres, la posició els cobreix i la ràtio hi va inclosa.
Si no tots els components d’una ràtio tenen preu, la ràtio no apareix al catàleg: no es mostra amb price_cents: null. Hi torna a aparèixer quan Aniva posa preu al component que falta.

Zero amb positions — només es ven dins d’una posició

El marcador no té un preu propi, però forma part d’una o més posicions. Compra una d’aquestes posicions i l’obtindràs.
Afegir un d’aquests a una cita per separat es rebutja — consulta Afegeix biomarcadors individuals. En lloc d’això, afegeix tots els biomarcadors d’una de les posicions llistades.

Null — no catalogat

Aniva no ha decidit quant costa aquest marcador, així que no està a la venda. null no és zero ni “pregunta’ns”: tracta’l com a no disponible.
Aniva rebutja un marcador null en el moment de fer la comanda. Dues condicions fan que un biomarcador es pugui demanar. Un laboratori al qual Aniva pugui derivar la comanda ha de lliurar el biomarcador. El catàleg d’Aniva li ha d’assignar un preu. Si afegeixes un marcador null a una cita, l’API retorna 400 amb error: "biomarker_not_priced". Consulta Afegeix biomarcadors individuals. Un laboratori pot lliurar un marcador null, però el lliurament per si sol no fa que el marcador estigui disponible. Tracta null com a no disponible.
Alguns marcadors són null per disseny. Aniva ven les proves de microbioma i de genètica com a kits. Un kit té un únic preu, així que els marcadors que en formen part no tenen un preu propi. Per comprar aquests marcadors, demana el panell que és el kit. Els membres venen amb el panell. L’API també accepta un membre que afegeixis a una cita que ja inclou el seu panell. Un marcador també apareix com a null quan Aniva només el ven dins d’una posició que no pots veure. El resultat és el mateix: no tens cap preu per comprar el marcador. El marcador obté un preu quan Aniva fa visible aquesta posició per als col·laboradors.

Trobar la manera més econòmica de comprar un conjunt

Com que cada posició a la qual pertany un marcador viatja amb el marcador, pots resoldre això localment, sense peticions addicionals:
  1. Recull els marcadors que vols de Llista biomarcadors.
  2. Per a cadascun, compara el seu propi price_cents amb el price_cents de les posicions del seu bloc positions.
  3. Una posició es factura un sol cop i lliura tot el seu conjunt de biomarker_ids, de manera que una posició que cobreix diversos dels teus marcadors es cobra una sola vegada. Els marcadors addicionals que no has demanat s’hi inclouen sense cap cost addicional.
Res no se solapa dues vegades: dues posicions que comparteixen un membre lliuren cadascuna el seu conjunt, el membre apareix una sola vegada i mai no es descompten entre si.

La factura

Previsualitza la cita retorna la factura d’una cita. Pressuposta la cistella retorna la mateixa factura sense cita. La factura conté:
  • positions[] — cada posició que s’ha activat, facturada un sol cop al seu preu fix.
  • panels[] — cada panell afegit.
  • biomarkers[] — una fila per cada marcador lliurat. Una fila que paga una posició costa 0 i l’anomena a via_position. Un component incorporat per una ràtio porta required_by; la ràtio mateixa porta requires.
  • total_cents — les posicions amb preu més els panells amb preu més les files de biomarcadors amb preu, amb retail_total_cents al costat.
  • fees i total_with_fees_cents — les tarifes d’una cita i el total amb elles.
Una fila a la qual Aniva no pot assignar un preu porta price_cents: null. La fila no afegeix res al total. No pots afegir un marcador sense preu per separat, així que aquesta fila l’ha proporcionada una posició o un panell. Aquesta posició o aquest panell ja la factura.
Aniva encara no ha publicat totes les posicions. Una posició no publicada es continua facturant. Apareix a positions[] amb id i name definits com a null, i les seves files de biomarcadors tenen via_position: null.