Hoppa till huvudinnehåll
Aniva prissätter en sak: positionen. En position är ett kommersiellt erbjudande – en kurerad uppsättning biomarkörer som faktureras en gång, till ett fast pris, och alltid levereras i sin helhet. En biomarkör du kan köpa separat är helt enkelt en position med en biomarkör. Allt du ser i pricing följer av det. Läs den här sidan en gång så slutar de fyra tillstånden nedan att se ut som specialfall.

Vad siffrorna betyder

Varje price_cents är vad du betalar, enligt prislistan på din API-nyckel. Bredvid det visar retail_cents samma artikel enligt den rekommenderade utprislistan, så att du kan visa en besparing utan ett andra anrop. Båda anges som heltal i cent och båda är netto: moms läggs till på din månadsfaktura med den momssats som gäller för din momsstatus, och vid momsbefrielse läggs ingen till. En panel som säljs till Anivas katalogpris för konsumenter anges till det priset exklusive 19 % tysk moms.
retail_cents finns alltid med. När din nyckel redan använder utprislistan är det helt enkelt lika med price_cents.
Priser kräver scopet prices_view. Utan det är pricing null i listningarna och förhandsgranskningen, och endpoints under Prissättning returnerar 403.

Din prislista

Din prislista styr dina priser. Läs den via Hämta prislista.
  • Varje analys har en tier: routine eller specialty. Dess pris är Anivas katalogpris gånger multiplikatorn för den nivån.
  • Avgifterna gäller per bokning, och logistikavgiften gäller per budhämtning. Dina bokningar på samma plats samma dag delar på en hämtning. Aniva fakturerar avgifterna på din månadsfaktura.

De fyra tillstånden

price_cents, tillsammans med vilket valfritt block som ligger bredvid, utgör tillståndet. Det finns inget separat typfält.

Positivt – kan beställas separat

Markören har ett eget pris. Den kan ändå ingå i positioner, och positions listar dem då med billigast först – att köpa positionen är ofta billigare än att köpa dess ingående markörer en och en.
biomarker_ids är alla markörer som ingår i positionen; includes är den uppsättningen minus markören du frågade om – det som följer med.

Noll med requires – en kvot

En kvot beräknas utifrån uppmätta markörer. De flesta kvoter kostar 0. En kvot med ett positivt price_cents fakturerar det priset utöver sina komponenter. Beställ den så lägger Aniva dess komponenter i varukorgen till deras egna priser. En komponent betalas en gång per varukorg, oavsett hur många kvoter som bygger på den.
En kvot kombineras med positioner i stället för att konkurrera med dem. Om dess komponenter ingår i en position du redan köper betalar positionen för dem, och kvoten följer med utan extra kostnad.
En kvot där inte alla komponenter är prissatta saknas i katalogen – den visas inte med price_cents: null. Den kommer tillbaka så snart Aniva prissätter den saknade komponenten.

Noll med positions – säljs endast i en position

Markören har inget eget pris, men den ingår i en eller flera positioner. Köp en av de positionerna så får du den.
Att lägga till en av dessa enskilt i en bokning nekas – se Lägg till enskilda biomarkörer. Lägg istället till alla biomarkörer i en av de listade positionerna.

Null – okurerad

Aniva har inte bestämt vad den här markören kostar, så den är inte till salu. null är inte noll och inte “fråga oss”: behandla den som otillgänglig.
Aniva nekar en null-markör vid beställning. Två villkor gör en biomarkör beställningsbar. Ett laboratorium som Aniva kan dirigera till måste leverera biomarkören. Anivas katalog måste prissätta den. Om du lägger till en null-markör i en bokning returnerar API:et 400 med error: "biomarker_not_priced". Se Lägg till enskilda biomarkörer. Ett laboratorium kan leverera en null-markör, men enbart leverans gör inte markören tillgänglig. Behandla null som otillgängligt.
Vissa markörer är null med avsikt. Aniva säljer mikrobiom- och genetiktester som kit. Ett kit har ett pris, så markörerna som ingår har inget eget pris. För att köpa de här markörerna beställer du panelen som utgör kitet. De ingående markörerna följer med panelen. API:et accepterar också en ingående markör som du lägger till i en bokning som redan innehåller dess panel. En markör visar också null när Aniva bara säljer den i en position som du inte kan se. Resultatet blir detsamma: du har inget pris att köpa markören för. Markören får ett pris när Aniva gör den positionen tillgänglig för partners.

Hitta det billigaste sättet att köpa en uppsättning

Eftersom varje position som en markör ingår i följer med markören kan du lösa det lokalt, utan extra anrop:
  1. Hämta de markörer du vill ha från Lista biomarkörer.
  2. För varje markör jämför du dess eget price_cents med price_cents för positionerna i dess positions-block.
  3. En position debiteras en gång och levererar hela sin biomarker_ids-uppsättning, så en position som täcker flera av dina markörer debiteras bara en gång. Extra markörer som du inte bad om följer med utan extra kostnad.
Inget överlappar två gånger: två positioner som delar en markör levererar varsin uppsättning, markören listas en gång och de ger aldrig rabatt på varandra.

Kostnadsöversikten

Förhandsgranska bokning returnerar kostnadsöversikten för en bokning. Prisberäkna varukorg returnerar samma kostnadsöversikt utan en bokning. Kostnadsöversikten innehåller:
  • positions[] – varje position som utlöstes, debiterad en gång till sitt fasta pris.
  • panels[] – varje tillagd panel.
  • biomarkers[] – en rad per levererad markör. En rad som en position betalar för kostar 0 och anger den i via_position. En komponent som hämtas in av en kvot har required_by; själva kvoten har requires.
  • total_cents – de prissatta positionerna plus de prissatta panelerna plus de prissatta biomarkörraderna, med retail_total_cents bredvid.
  • fees och total_with_fees_cents – avgifterna för en bokning, och totalsumman med dem.
En rad som Aniva inte kan prissätta har price_cents: null. Raden lägger inte till något i totalsumman. Du kan inte lägga till en oprissatt markör på egen hand, så en position eller en panel har levererat den här raden. Den positionen eller panelen debiterar redan för den.
Aniva har inte publicerat alla positioner ännu. En opublicerad position debiteras ändå. Den visas i positions[] med id och name satta till null, och dess biomarkörrader har via_position: null.