Zum Hauptinhalt springen
Aniva bepreist genau eine Einheit: die Position. Eine Position ist ein kommerzielles Angebot – ein kuratiertes Set aus Biomarkern, das einmalig zum Festpreis abgerechnet und immer vollständig geliefert wird. Ein Biomarker, den du einzeln kaufen kannst, ist einfach eine Position mit einem Biomarker. Alles, was du in pricing siehst, ergibt sich daraus. Lies diese Seite einmal durch, und die vier Zustände unten wirken nicht mehr wie Sonderfälle.

Was die Zahlen bedeuten

Jeder Wert in price_cents ist das, was du laut der Preistabelle deines API-Schlüssels zahlst. Daneben zeigt retail_cents denselben Artikel laut der empfohlenen Verkaufspreistabelle, damit du eine Ersparnis ohne zweite Anfrage darstellen kannst. Beide Werte sind ganzzahlige Cent-Beträge und beide sind netto: Die Mehrwertsteuer wird auf deiner monatlichen Rechnung mit dem für dich geltenden Steuersatz aufgeschlagen – bei einer Steuerbefreiung fällt keine an. Ein Panel, das zum Aniva-Endkundenkatalogpreis verkauft wird, wird ohne die 19 % deutsche Mehrwertsteuer angegeben.
retail_cents ist immer vorhanden. Wenn für deinen Schlüssel bereits die Verkaufspreistabelle gilt, entspricht der Wert einfach price_cents.
Preise benötigen den Scope prices_view. Ohne ihn ist pricing in den Listen und in der Vorschau null, und die Pricing-Endpunkte geben 403 zurück.

Deine Preistabelle

Deine Preistabelle legt deine Preise fest. Lies sie über Get Rate Card aus.
  • Jede Analyse hat ein tier: routine oder specialty. Ihr Preis ist der Aniva-Katalogpreis multipliziert mit dem Multiplikator dieses Tiers.
  • Die Gebühren gelten pro Termin, und die Logistikgebühr gilt pro Kurierabholung. Deine Termine am selben Standort am selben Tag teilen sich eine Abholung. Aniva berechnet die Gebühren auf deiner monatlichen Rechnung.

Die vier Zustände

price_cents zusammen mit dem optionalen Block daneben ergibt den Zustand. Ein eigenes Typfeld gibt es nicht.

Positiv – einzeln bestellbar

Der Marker hat einen eigenen Preis. Er kann trotzdem in Positionen vorkommen, und positions listet diese dann beginnend mit der günstigsten auf – der Kauf der Position ist oft günstiger als der Einzelkauf ihrer Bestandteile.
biomarker_ids ist die vollständige Liste aller Biomarker der Position; includes ist diese Liste abzüglich des abgefragten Markers – also das, was zusätzlich enthalten ist.

Null mit requires – ein Verhältnis

Ein Verhältnis wird aus gemessenen Markern berechnet. Die meisten Verhältnisse kosten 0. Bei einem Verhältnis mit positivem price_cents wird dieser Preis zusätzlich zu seinen Bestandteilen berechnet. Bestellst du es, legt Aniva seine Bestandteile zu ihren jeweiligen Preisen in den Warenkorb. Ein Bestandteil wird einmal pro Warenkorb bezahlt, egal wie viele Verhältnisse darauf aufbauen.
Ein Verhältnis ergänzt Positionen, statt mit ihnen zu konkurrieren. Sind seine Bestandteile bereits Teil einer Position, die du kaufst, deckt die Position sie ab und das Verhältnis ist ohne Aufpreis enthalten.
Ein Verhältnis, dessen Bestandteile nicht alle bepreist sind, fehlt im Katalog – es erscheint nicht mit price_cents: null. Es taucht wieder auf, sobald Aniva den fehlenden Bestandteil bepreist.

Null mit positions – nur innerhalb einer Position erhältlich

Der Marker hat keinen eigenen Preis, ist aber Teil einer oder mehrerer Positionen. Wenn du eine dieser Positionen kaufst, bekommst du ihn.
Einen dieser Marker einzeln zu einem Termin hinzuzufügen wird abgelehnt – siehe Einzelne Biomarker hinzufügen. Füge stattdessen alle Biomarker einer der aufgeführten Positionen hinzu.

Null – nicht kuratiert

Aniva hat noch nicht festgelegt, was dieser Marker kostet, daher steht er nicht zum Verkauf. null ist nicht null und bedeutet nicht „frag uns“: Behandle es als nicht verfügbar.
Aniva lehnt einen null-Marker bei der Bestellung ab. Zwei Bedingungen machen einen Biomarker bestellbar. Ein Labor, an das Aniva weiterleiten kann, muss den Biomarker liefern. Der Aniva-Katalog muss einen Preis dafür enthalten. Wenn du einem Termin einen null-Marker hinzufügst, gibt die API 400 mit error: "biomarker_not_priced" zurück. Siehe Einzelne Biomarker hinzufügen. Ein Labor kann einen null-Marker liefern, aber die Lieferung allein macht den Marker nicht verfügbar. Behandle null als nicht verfügbar.
Einige Marker sind absichtlich null. Aniva verkauft Mikrobiom- und Gentests als Kits. Ein Kit hat einen einzigen Preis, sodass die enthaltenen Marker keinen eigenen Preis haben. Um diese Marker zu kaufen, bestelle das Panel, das dem Kit entspricht. Die enthaltenen Marker sind im Panel enthalten. Die API akzeptiert einen enthaltenen Marker auch dann, wenn du ihn zu einem Termin hinzufügst, der das zugehörige Panel bereits enthält. Ein Marker hat ebenfalls den Wert null, wenn Aniva ihn nur innerhalb einer Position verkauft, die du nicht sehen kannst. Das Ergebnis ist dasselbe: Du hast keinen Preis, zu dem du den Marker kaufen kannst. Der Marker erhält einen Preis, sobald Aniva diese Position für Partner freigibt.

Den günstigsten Weg finden, ein Set zu kaufen

Da jede Position, zu der ein Marker gehört, zusammen mit dem Marker zurückgegeben wird, kannst du das lokal und ohne zusätzliche Anfragen lösen:
  1. Sammle die gewünschten Marker über Biomarker auflisten.
  2. Vergleiche für jeden Marker seinen eigenen price_cents-Wert mit dem price_cents-Wert der Positionen in seinem positions-Block.
  3. Eine Position wird einmal berechnet und liefert ihr gesamtes biomarker_ids-Set, sodass eine Position, die mehrere deiner Marker abdeckt, nur einmal in Rechnung gestellt wird. Zusätzliche Marker, die du nicht angefragt hast, sind ohne Aufpreis enthalten.
Nichts überschneidet sich doppelt: Zwei Positionen, die einen Marker gemeinsam haben, liefern jeweils ihr Set, der Marker wird einmal aufgeführt und sie gewähren keinen gegenseitigen Rabatt.

Die Rechnung

Terminvorschau gibt die Rechnung für einen Termin zurück. Warenkorb kalkulieren gibt dieselbe Rechnung ohne Termin zurück. Die Rechnung enthält:
  • positions[] – jede ausgelöste Position, einmal zu ihrem Pauschalpreis berechnet.
  • panels[] – jedes hinzugefügte Panel.
  • biomarkers[] – eine Zeile pro geliefertem Marker. Eine Zeile, die über eine Position abgerechnet wird, kostet 0 und nennt diese in via_position. Eine Komponente, die durch ein Verhältnis hinzugezogen wird, trägt required_by; das Verhältnis selbst trägt requires.
  • total_cents – die bepreisten Positionen plus die bepreisten Panels plus die bepreisten Biomarker-Zeilen, daneben retail_total_cents.
  • fees und total_with_fees_cents – die Gebühren eines Termins und die Gesamtsumme inklusive dieser Gebühren.
Eine Zeile, für die Aniva keinen Preis angeben kann, hat price_cents: null. Die Zeile trägt nichts zur Gesamtsumme bei. Du kannst einen Marker ohne Preis nicht einzeln hinzufügen, daher wurde diese Zeile über eine Position oder ein Panel bereitgestellt. Diese Position oder dieses Panel berechnet sie bereits.
Aniva hat noch nicht jede Position veröffentlicht. Eine unveröffentlichte Position wird dennoch berechnet. Sie erscheint in positions[] mit id und name auf null gesetzt, und ihre Biomarker-Zeilen haben via_position: null.