Vai al contenuto principale
Aniva definisce il prezzo di una sola cosa: la posizione. Una posizione è un’offerta commerciale — un insieme curato di biomarcatori fatturato una sola volta, a un prezzo fisso, e sempre fornito per intero. Un biomarcatore acquistabile singolarmente è semplicemente una posizione composta da un solo elemento. Tutto ciò che vedi in pricing deriva da questo. Leggi questa pagina una volta e i quattro stati qui sotto smetteranno di sembrare casi speciali.

Cosa significano i numeri

Ogni price_cents è ciò che paghi tu, in base al listino associato alla tua chiave API. Accanto, retail_cents indica lo stesso articolo al listino consigliato al pubblico, così puoi mostrare il risparmio senza una seconda richiesta. Entrambi sono numeri interi in centesimi ed entrambi sono netti: l’IVA viene aggiunta nella tua fattura mensile all’aliquota prevista dal tuo regime IVA, mentre un regime esente non aggiunge nulla. Un pannello venduto al prezzo di catalogo al pubblico di Aniva è indicato a quel prezzo al netto dell’IVA tedesca del 19%.
retail_cents è sempre presente. Quando la tua chiave utilizza già il listino al pubblico, corrisponde semplicemente a price_cents.
I prezzi richiedono lo scope prices_view. Senza di esso, pricing è null negli elenchi e nell’anteprima, e gli endpoint Prezzi restituiscono 403.

Il tuo listino

Il tuo listino definisce i tuoi prezzi. Leggilo tramite Ottieni listino.
  • Ogni analisi ha un tier: routine o specialty. Il suo prezzo è il prezzo di catalogo Aniva moltiplicato per il moltiplicatore di quel livello.
  • Le tariffe sono per appuntamento e la tariffa logistica è per ritiro del corriere. I tuoi appuntamenti nella stessa sede e nello stesso giorno condividono un unico ritiro. Aniva addebita le tariffe nella tua fattura mensile.

I quattro stati

price_cents, insieme al blocco opzionale presente accanto, determina lo stato. Non esiste un campo separato per il tipo.

Positivo — ordinabile singolarmente

Il marcatore ha un prezzo proprio. Può comunque comparire in alcune posizioni, che positions elenca dalla più economica in poi — acquistare la posizione costa spesso meno che acquistare i suoi elementi uno per uno.
biomarker_ids è l’insieme completo degli elementi della posizione; includes è quell’insieme meno il marcatore richiesto — ciò che è incluso in aggiunta.

Zero con requires — un rapporto

Un rapporto viene calcolato a partire da marcatori misurati. La maggior parte dei rapporti costa 0. Un rapporto con un price_cents positivo fattura quel prezzo in aggiunta ai suoi componenti. Se lo ordini, Aniva inserisce i suoi componenti nel carrello al rispettivo prezzo. Un componente si paga una sola volta per carrello, indipendentemente da quanti rapporti si basano su di esso.
Un rapporto si combina con le posizioni anziché entrare in conflitto con esse. Se i suoi componenti fanno parte di una posizione che stai già acquistando, li copre la posizione e il rapporto è incluso.
Un rapporto i cui componenti non hanno tutti un prezzo è assente dal catalogo — non compare con price_cents: null. Ritorna non appena Aniva definisce il prezzo del componente mancante.

Zero con positions — venduto solo all’interno di una posizione

Il marcatore non ha un prezzo proprio, ma fa parte di una o più posizioni. Acquista una di quelle posizioni e lo ottieni.
Aggiungerne uno da solo a un appuntamento viene rifiutato — vedi Aggiungi singoli biomarcatori. Aggiungi invece tutti i biomarcatori di una delle posizioni elencate.

Null — non configurato

Aniva non ha stabilito il prezzo di questo marcatore, quindi non è in vendita. null non significa zero e nemmeno “chiedi a noi”: consideralo non disponibile.
Aniva rifiuta un marcatore null al momento dell’ordine. Due condizioni rendono un biomarcatore ordinabile. Un laboratorio a cui Aniva può inviare l’ordine deve fornire il biomarcatore. Il catalogo Aniva deve assegnargli un prezzo. Se aggiungi un marcatore null a un appuntamento, l’API restituisce 400 con error: "biomarker_not_priced". Vedi Aggiungi singoli biomarcatori. Un laboratorio può fornire un marcatore null, ma la fornitura da sola non rende disponibile il marcatore. Considera null come non disponibile.
Alcuni marcatori sono null per scelta. Aniva vende i test del microbioma e genetici come kit. Un kit ha un prezzo unico, quindi i marcatori che include non hanno un prezzo proprio. Per acquistare questi marcatori, ordina il pannello corrispondente al kit. I suoi marcatori sono inclusi nel pannello. L’API accetta anche un marcatore del kit se lo aggiungi a un appuntamento che include già il relativo pannello. Un marcatore risulta null anche quando Aniva lo vende solo all’interno di una posizione che non puoi vedere. Il risultato è lo stesso: non hai un prezzo per acquistare il marcatore. Il marcatore ottiene un prezzo quando Aniva rende quella posizione visibile ai partner.

Trovare il modo più conveniente per acquistare un set

Dato che ogni posizione di cui un marcatore fa parte viene restituita insieme al marcatore, puoi risolverlo in locale, senza richieste aggiuntive:
  1. Raccogli i marcatori che vuoi da Elenca biomarcatori.
  2. Per ciascuno, confronta il suo price_cents con il price_cents delle posizioni nel suo blocco positions.
  3. Una posizione viene fatturata una volta e fornisce l’intero set biomarker_ids, quindi una posizione che copre diversi tuoi marcatori viene addebitata una sola volta. I marcatori extra che non hai richiesto sono inclusi senza costi aggiuntivi.
Nulla si sovrappone due volte: due posizioni che condividono un marcatore forniscono ciascuna il proprio set, il marcatore compare una sola volta e le posizioni non si scontano mai a vicenda.

Il conto

Anteprima appuntamento restituisce il conto di un appuntamento. Preventivo carrello restituisce lo stesso conto senza un appuntamento. Il conto include:
  • positions[] — ogni posizione attivata, addebitata una sola volta al suo prezzo fisso.
  • panels[] — ogni pannello associato.
  • biomarkers[] — una riga per ogni marcatore fornito. Una riga coperta da una posizione costa 0 e la indica in via_position. Un componente richiamato da un rapporto riporta required_by; il rapporto stesso riporta requires.
  • total_cents — le posizioni prezzate più i pannelli prezzati più le righe di biomarcatori prezzate, con retail_total_cents accanto.
  • fees e total_with_fees_cents — le spese di un appuntamento e il totale che le include.
Una riga a cui Aniva non può assegnare un prezzo riporta price_cents: null. La riga non aggiunge nulla al totale. Non puoi aggiungere da solo un marcatore senza prezzo, quindi questa riga è stata inclusa da una posizione o da un pannello. Quella posizione o quel pannello la addebita già.
Aniva non ha ancora pubblicato tutte le posizioni. Una posizione non pubblicata viene comunque addebitata. Compare in positions[] con id e name impostati su null, e le relative righe di biomarcatori hanno via_position: null.