ForHosting KIT · Maison, cuisine et loisirs

Partage de note par articles

Sur une addition de 35 en nourriture, avec 2,8 de taxe et 6,3 de pourboire, Alice, qui a commandé pour 20,5, doit 25,83 et Bob 18,27. Attribuez chaque plat et boisson à une personne : taxe et pourboire suivent ce que chacun a vraiment pris. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Tax: 2,8
Service: 6,3

Vous obtenez

Nombre d'éléments: 4
Nombre de personnes: 2
Total nourriture: 35
Total général: 44,1

Les notes de restaurant et les commandes de groupe sont rarement équitables lorsque chacun paie la même part d'un total partagé. Ce calculateur de partage de note par articles vous permet d'attribuer chaque plat, boisson ou ligne à une personne nommée, de sommer le sous-total alimentaire de cette personne, puis de répartir la taxe absolue et les frais de service du ticket au prorata de ces sous-totaux, afin que les commandes plus lourdes portent une plus grande part de la taxe et du pourboire.

Fonctionnement de l'attribution des articles et de la taxe et du service proportionnels

Partez du ticket imprimé ou de l'application comme liste de lignes plutôt que comme une somme unique. Chaque ligne porte un montant dans une devise et une chaîne person qui identifie qui a commandé ou accepté de payer ce plat. Les lignes partageant la même chaîne person se regroupent en un sous-total alimentaire pour ce convive.

Le calculateur prend le montant absolu de taxe et les frais de service ou pourboire inscrits sur le ticket, puis alloue les deux charges selon la règle proportionnelle classique : la part de taxe de chaque personne égale la taxe multipliée par le sous-total de cette personne divisé par le total alimentaire de la table, et le même ratio multiplie le montant de service. L'addition des trois éléments donne ce que doit cette personne : sous-total alimentaire plus part de taxe plus part de service.

C'est le schéma de partage équitable que l'on fait déjà sur une serviette lorsqu'un invité a pris un steak et un autre seulement une salade, mais sans erreurs d'arrondi manuel laissant quelques centimes non comptabilisés. Le partage égal de toute la note, y compris taxe et pourboire entre N têtes, est une autre intention produit traitée ailleurs ; ici l'intention SEO est explicitement l'attribution par articles avec frais généraux proportionnels.

Lorsque le total alimentaire est nul alors que la taxe ou le service restent positifs, le ratio diviserait par zéro, aussi le moteur rejette cette combinaison au lieu d'inventer des parts arbitraires. Lorsque chaque ligne est gratuite et que taxe et service valent zéro, chaque total par personne est zéro et l'appel réussit tout de même pour exhaustivité.

Quand partager l'addition plat par plat

Les dîners entre amis, déjeuners de coworking et livraisons partagées ont besoin d'un détail neutre que chacun peut auditer ligne par ligne au lieu de discuter de moitiés égales. Les démos d'hospitalité et outils de formation point de vente peuvent montrer comment taxe et service se rattachent à qui a réellement commandé plutôt que de répartir des frais fixes sur des places sans commande.

Gardez les listes à des tailles de table ordinaires, figez dans les tests les totaux arrondis par personne, et vous obtenez des règlements reproductibles pour discussions de groupe, exemples LMS et workers en périphérie sans déployer de tableur ni de moteur de pourboire sur mesure pour chaque langue que vous publiez.

Cas d’usage

Tables de restaurant avec commandes différentes

Attribuez chaque plat et boisson à un convive, collez les lignes de taxe et de pourboire du ticket, et voyez exactement ce que chacun doit sans partage égal.

Livraison et à emporter en groupe

Mappez les lignes du panier à des colocs ou collègues et répartissez taxe de livraison et frais de service au prorata du sous-total alimentaire de chacun.

Questions fréquentes

La taxe et le service sont-ils des pourcentages ou des montants ?

Des montants monétaires absolus dans la même devise que les lignes. Copiez la taxe et le pourboire ou frais de service du reçu ; ils sont répartis par ratio de sous-total alimentaire, non par têtes égales.

Que faire si deux personnes partagent un plat ?

Divisez le plat en deux lignes (moitié de montant chacune) attribuées à chaque personne, ou attribuez la ligne entière à l'une et réglez la moitié en privé.

Comment la taxe et le pourboire sont-ils répartis entre les convives ?

Au prorata de ce que chacun a commandé : sa part de taxe est la taxe multipliée par son sous-total puis divisée par le total des plats, et de même pour le pourboire. Avec 20,5 sur 35, Alice paie 1,64 de taxe et 3,69 de pourboire.

Pourquoi ne pas partager l'addition à parts égales ?

Parce que la personne qui n'a pris qu'une salade paierait autant que celle qui a mangé un steak, taxe et pourboire compris. Ici chacun paie ses plats plus sa juste part des frais ; pour un partage égal, utilisez un calculateur de partage à parts égales.

Comment saisir plusieurs plats pour la même personne ?

Inscrivez exactement le même nom sur chacune de ses lignes. Les lignes portant le même nom s'additionnent en un seul sous-total, si bien que le burger et les frites d'Alice font 20,5 avant la répartition de la taxe et du pourboire.

Outils associés

Pour les développeurs — accès API

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.

Endpoint

POSThttps://api.kit.forhosting.com/life/itemized-bill-split

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é.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/life/itemized-bill-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"description":"Burger","amount":14.5,"person":"Alice"},{"description":"Salad","amount":11,"person":"Bob"},{"description":"Fries","amount":6,"person":"Alice"},{"description":"Soda","amount":3.5,"person":"Bob"}]}'

const res = await fetch("https://api.kit.forhosting.com/life/itemized-bill-split", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      {
        "description": "Burger",
        "amount": 14.5,
        "person": "Alice"
      },
      {
        "description": "Salad",
        "amount": 11,
        "person": "Bob"
      },
      {
        "description": "Fries",
        "amount": 6,
        "person": "Alice"
      },
      {
        "description": "Soda",
        "amount": 3.5,
        "person": "Bob"
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/life/itemized-bill-split",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "items": [
        {
            "description": "Burger",
            "amount": 14.5,
            "person": "Alice"
        },
        {
            "description": "Salad",
            "amount": 11,
            "person": "Bob"
        },
        {
            "description": "Fries",
            "amount": 6,
            "person": "Alice"
        },
        {
            "description": "Soda",
            "amount": 3.5,
            "person": "Bob"
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/life/itemized-bill-split", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"items":[{"description":"Burger","amount":14.5,"person":"Alice"},{"description":"Salad","amount":11,"person":"Bob"},{"description":"Fries","amount":6,"person":"Alice"},{"description":"Soda","amount":3.5,"person":"Bob"}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":[{"description":"Burger","amount":14.5,"person":"Alice"},{"description":"Salad","amount":11,"person":"Bob"},{"description":"Fries","amount":6,"person":"Alice"},{"description":"Soda","amount":3.5,"person":"Bob"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/life/itemized-bill-split", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "items": [
    {
      "description": "Burger",
      "amount": 14.5,
      "person": "Alice"
    },
    {
      "description": "Salad",
      "amount": 11,
      "person": "Bob"
    },
    {
      "description": "Fries",
      "amount": 6,
      "person": "Alice"
    },
    {
      "description": "Soda",
      "amount": 3.5,
      "person": "Bob"
    }
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.itemized_bill_split",
  "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.

Tarifs

par requête$0.002

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

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Les listes d'articles vides, montants négatifs, noms de personne vides et taxe ou service positifs sur un sous-total alimentaire nul échouent avec une erreur invalid_input claire et ne sont pas facturés.

Contrat d'entrée, champs de réponse et règles de validation

Chaque objet exige amount comme nombre fini non négatif et person comme nom ou identifiant court non vide ; description optionnelle étiquette le plat dans le détail renvoyé. Les deux frais sont des montants monétaires absolus dans la même devise que les lignes, pas des points de pourcentage, afin que vous copiiez directement les lignes de taxe et de pourboire du reçu. Envoyez en POST un corps JSON avec un tableau items obligatoire d'un à deux cents objets. Les alias lines, line_items, dishes et orders sont acceptés pour le tableau lorsque votre client utilise déjà ces clés. La taxe optionnelle vaut zéro par défaut et accepte les alias tax_amount, sales_tax et vat ; le service optionnel vaut zéro par défaut et accepte service_amount, service_charge, tip et gratuity. Items manquants, tableaux vides, montants de ligne négatifs, chaînes person vides, tax ou service négatifs et nombres non finis échouent avec invalid_input en nommant le problème ; ces échecs ne consomment jamais le solde prépayé. En succès le corps renvoie item_count, person_count, la liste items normalisée avec index, description, amount et person, food_total, tax, service, grand_total et un tableau people ordonné par première apparition de chaque chaîne person. Chaque ligne people inclut person, subtotal, share_ratio, tax_share, service_share, total et item_count. Les champs monétaires utilisent un arrondi half-up à deux décimales avec ajustement résiduel sur la dernière personne à sous-total positif afin que les parts de taxe arrondies somment encore tax, les parts de service somment service et les totaux par personne somment grand_total. method vaut itemized_proportional_tax_service et formula reformule la règle proportionnelle pour l'affichage à côté du résultat.

Où une API de partage de note par articles apporte de la valeur

Les bots de dépenses et de remboursement peuvent accepter le même payload structuré qu'un formulaire mobile collecte et renvoyer des totaux par personne prêts pour un message de règlement ou une écriture comptable. Comme l'implémentation est une arithmétique analytique de niveau A sans jetons de modèle ni réseau sortant, chaque appel réussi coûte le prix de base publié $0.002, et les échecs de validation sont gratuits.

Cas d'intégration

Bots de dépenses et applications de règlement

Appelez un endpoint prépayé stable qui renvoie des totaux par personne prêts pour messages de remboursement, grands livres ou interfaces de demande de partage.

Questions techniques

Comment fonctionne le calculateur de partage de note par articles ?

Envoyez items comme lignes {amount, person}, plus tax et service absolus optionnels. Le total de chaque personne est son sous-total alimentaire plus une part proportionnelle de taxe et de service selon subtotal sur food_total.

Quelles erreurs le calculateur renvoie-t-il ?

invalid_input pour items vides, montants négatifs, noms de personne vides, tax ou service négatifs, ou tax/service positifs lorsque food_total est zéro. Ces échecs ne sont pas facturés.

Combien coûte le calculateur de partage de note par articles ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; l'entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement