ForHosting KIT · Outils pour développeurs

Prix effectif d’une offre un acheté, un offert

Une offre un acheté, un offert ou achetez X, recevez Y peut sembler généreuse sans indiquer le coût réel de chaque article dans le panier que vous prévoyez.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Cette calculatrice applique la promotion à une quantité précise, distingue les articles payés des articles gratuits et fournit le total normal, le total promotionnel, l’économie totale et le prix effectif par article. Elle couvre aussi bien l’offre classique un acheté, un offert que l’offre deux achetés, un offert, avec un prix normal identique pour chaque article. Vous pouvez ainsi la comparer facilement aux soldes et aux remises en pourcentage.

Saisissez la promotion telle qu’elle est annoncée

Commencez par le prix unitaire normal avant promotion, puis indiquez la quantité totale que vous souhaitez emporter. Cette quantité est essentielle, car une offre BOGO ne s’applique pas toujours uniformément au panier. Six articles peuvent former trois groupes un acheté, un offert, tandis que cinq n’en forment que deux et laissent un article au prix fort. Utilisez la quantité à acheter pour X dans achetez X, recevez Y gratuitement, et la quantité gratuite pour Y. L’offre classique utilise 1 dans les deux champs ; deux achetés, un offert utilise 2 et 1. Toutes les quantités désignent des articles entiers et doivent être des entiers positifs. Le prix unitaire peut être nul, mais jamais négatif ou infini. Tous les articles sont supposés avoir le même prix normal et les gratuits sont accordés dès que la condition payante est remplie. Saisissez le nombre réellement acheté, pas le nombre de groupes promotionnels, afin de traiter correctement les articles restants.

Comprenez le prix effectif et l’économie

La calculatrice définit un groupe promotionnel comme la quantité à acheter plus la quantité gratuite. Elle compte les groupes complets, puis examine le reste. Dans un groupe partiel, les X premiers articles sont payants ; les suivants deviennent gratuits jusqu’à la limite du groupe. Le nombre payé correspond à la quantité totale moins les gratuits. Le total normal multiplie le prix unitaire par tous les articles, alors que le total promotionnel ne tient compte que des articles payés. L’économie totale est leur différence. Enfin, le prix effectif par article divise le total promotionnel par tous les articles reçus, gratuits compris. Cette valeur est souvent la plus utile. Un deuxième article prétendument gratuit ne réduit le coût unitaire que si le panier contient une paire admissible ; un article isolé reste plein tarif et augmente la moyenne. Les résultats sont arrondis de manière stable à douze décimales. Taxes, livraison, coupons, abonnement et conversion monétaire ne sont pas ajoutés.

Comparez la promotion à des solutions réalistes

Placez le prix effectif obtenu à côté du véritable prix unitaire des offres concurrentes. Vous évitez ainsi de comparer un slogan spectaculaire à une remise plus faible qui pourrait pourtant coûter moins cher pour la quantité choisie. Une offre BOGO est intéressante si vous avez besoin de chaque article, mais acheter davantage uniquement pour obtenir des gratuits peut accroître la dépense et le gaspillage. Vérifiez le total promotionnel et le prix effectif : la moyenne peut séduire alors que le passage en caisse dépasse votre budget. Les commerçants peuvent contrôler les étiquettes et les tests de caisse ; les enseignants et acheteurs peuvent expliquer ou comparer les groupes incomplets. Le calcul est déterministe, sans réseau, date, hasard ni source externe : une même entrée donne toujours le même résultat. Les appels API utilisent le tarif de base publié de $0.002. L’outil suppose des articles identiques. Les règles du moins cher offert, les plafonds, remises partielles ou cumuls nécessitent des calculs distincts.

Comparer les promotions alimentaires

Convertissez une offre BOGO en coût effectif par article pour la quantité exacte de votre liste de courses.

Vérifier un panier en ligne

Confirmez le nombre de produits gratuits et comparez le total promotionnel attendu au passage en caisse.

Évaluer les offres fournisseurs

Transformez les offres par carton achetez X, recevez Y en valeur unitaire cohérente pour vos comparaisons.

Qu’est-ce que le prix effectif par article ?

Il s’agit du total promotionnel divisé par tous les articles reçus, y compris ceux rendus gratuits par l’offre.

La calculatrice accepte-t-elle deux achetés, un offert ?

Oui. Réglez buy_quantity sur 2 et free_quantity sur 1, puis indiquez la quantité totale achetée.

Que devient un groupe promotionnel incomplet ?

La condition payante est remplie en premier. Seuls les articles restants au-delà de cette condition peuvent être gratuits.

Les articles peuvent-ils avoir des prix différents ?

Non. Le calcul suppose des articles identiques à un prix normal unique et n’applique pas la règle du moins cher offert.

Combien coûte un calcul par API ?

Chaque requête API utilise le tarif de base publié de $0.002.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

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

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

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}'
{
  "unit_price": 12.5,
  "quantity": 7,
  "buy_quantity": 2,
  "free_quantity": 1
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.bogo_effective_price",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →