ForHosting KIT · Strumenti per sviluppatori

Prezzo effettivo del prendi due, paghi uno

Un’offerta prendi due e paghi uno o acquista X e ricevi Y può sembrare generosa senza mostrare quanto costa davvero ogni articolo nel carrello che Lei intende acquistare.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Questa calcolatrice applica la promozione a una quantità precisa, separa gli articoli pagati da quelli gratuiti e indica totale normale, totale promozionale, risparmio complessivo e prezzo effettivo per articolo. Gestisce sia il classico prendi due e paghi uno sia offerte come acquista due e ricevi uno gratis, usando lo stesso prezzo normale per ogni articolo. Il risultato rende più facile il confronto con saldi ordinari e sconti percentuali.

Inserisca la promozione esattamente come pubblicizzata

Inizi dal prezzo unitario normale prima della promozione, quindi indichi la quantità totale che intende portare a casa. La quantità conta perché un’offerta BOGO non si distribuisce sempre in modo uniforme nel carrello. Sei articoli possono completare tre gruppi prendi due e paghi uno, mentre cinque completano due gruppi e lasciano un articolo a prezzo pieno. Usi la quantità da acquistare per X in acquista X e ricevi Y gratis e la quantità gratuita per Y. L’offerta classica usa 1 in entrambi i campi; acquista due e ricevi uno usa 2 e 1. Tutte le quantità rappresentano articoli interi e devono essere interi positivi. Il prezzo unitario può essere zero, ma non negativo né infinito. Si presume che tutti gli articoli abbiano lo stesso prezzo normale e che l’offerta conceda i gratuiti quando viene soddisfatto il requisito a pagamento. Inserisca gli articoli realmente acquistati, non il numero di gruppi, affinché le rimanenze siano gestite correttamente.

Comprenda il prezzo effettivo e il risparmio

La calcolatrice considera ogni gruppo promozionale come quantità da acquistare più quantità gratuita. Conta i gruppi completi, poi esamina gli articoli rimanenti. In un gruppo parziale, i primi X sono pagati; quelli successivi diventano gratuiti fino al limite del gruppo. Gli articoli pagati equivalgono alla quantità totale meno quelli gratuiti. Il totale normale moltiplica il prezzo unitario per tutti gli articoli, mentre quello promozionale considera soltanto quelli pagati. Il risparmio è la differenza. Infine, il prezzo effettivo per articolo divide il totale promozionale per tutti gli articoli ricevuti, inclusi quelli gratuiti. Spesso è il dato più utile. Un secondo articolo nominalmente gratis riduce il costo unitario solo se il carrello contiene una coppia valida; un articolo spaiato resta a prezzo pieno e aumenta la media. I risultati sono arrotondati stabilmente a dodici decimali. Non vengono aggiunti imposte, spedizione, coupon, quote associative o conversioni valutarie.

Confronti la promozione con alternative realistiche

Affianchi il risultato effettivo per articolo al vero prezzo unitario delle offerte concorrenti. Eviterà di confrontare uno slogan vistoso con uno sconto minore che potrebbe costare meno per la quantità scelta. Un’offerta BOGO può convenire quando servono tutte le unità, ma comprare prodotti extra solo per sbloccare omaggi può aumentare spesa e spreco. Controlli sia il totale promozionale sia il prezzo effettivo: la media può apparire conveniente anche se il totale supera il Suo budget. I rivenditori possono verificare cartellini e checkout; docenti e addetti agli acquisti possono spiegare o confrontare gruppi incompleti. Il calcolo è deterministico e non usa rete, data, casualità o fonti esterne, quindi input identici restituiscono sempre lo stesso risultato. Le chiamate API usano il prezzo base pubblicato di $0.002. Lo strumento modella articoli identici. Regole sul misto meno caro, limiti di utilizzo, sconti parziali o offerte cumulative richiedono calcoli separati.

Casi d'uso

Confrontare promozioni alimentari

Converta un’offerta BOGO nel costo effettivo di ogni articolo per la quantità esatta della lista della spesa.

Verificare un carrello online

Confermi quanti prodotti dovrebbero essere gratuiti e confronti il totale previsto con il checkout.

Valutare offerte dei fornitori

Trasformi offerte acquista X e ricevi Y in un valore unitario coerente per confrontare gli acquisti.

Domande frequenti

Che cos’è il prezzo effettivo per articolo?

È il totale promozionale diviso per tutti gli articoli ricevuti, compresi quelli resi gratuiti dall’offerta.

La calcolatrice gestisce acquista due e ricevi uno?

Sì. Imposti buy_quantity su 2 e free_quantity su 1, quindi inserisca la quantità totale acquistata.

Cosa accade a un gruppo promozionale incompleto?

Prima viene soddisfatto il requisito a pagamento. Solo gli articoli eccedenti possono risultare gratuiti nel gruppo parziale.

Gli articoli possono avere prezzi diversi?

No. Il calcolo presume articoli identici con un unico prezzo normale e non applica la regola del meno caro gratis.

Quanto costa un calcolo tramite API?

Ogni richiesta API usa il prezzo base pubblicato di $0.002.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/life/bogo-effective-price

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/life/bogo-effective-price \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"unit_price":12.5,"quantity":7,"buy_quantity":2,"free_quantity":1}'

const res = await fetch("https://api.kit.forhosting.com/life/bogo-effective-price", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "unit_price": 12.5,
    "quantity": 7,
    "buy_quantity": 2,
    "free_quantity": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/bogo-effective-price",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "unit_price": 12.5,
    "quantity": 7,
    "buy_quantity": 2,
    "free_quantity": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/bogo-effective-price", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"unit_price":12.5,"quantity":7,"buy_quantity":2,"free_quantity":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"unit_price":12.5,"quantity":7,"buy_quantity":2,"free_quantity":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/bogo-effective-price", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "unit_price": 12.5,
  "quantity": 7,
  "buy_quantity": 2,
  "free_quantity": 1
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.bogo_effective_price",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →