Calculateur de frais de manutention de commande
Ce calculateur associe un montant fixe à un pourcentage du sous-total de la commande, puis affiche les frais complets et le total à payer.
Lancer gratuitement
Il convient lorsque l’emballage, l’administration, un traitement particulier ou la préparation logistique ne peuvent pas être couverts par une seule méthode. Saisissez le sous-total et l’une ou les deux composantes afin d’obtenir un détail transparent, avec des montants arrondis à deux décimales avant leur intégration dans une boutique, un devis, une facture ou un parcours de paiement.
Renseignez le sous-total et les deux composantes
Commencez par le sous-total avant frais de manutention. Il doit correspondre au montant des biens ou services auquel votre politique applique le pourcentage ; n’y ajoutez pas les frais eux-mêmes, au risque de composer le calcul. Indiquez ensuite le montant fixe, qui peut couvrir l’emballage, les documents, la préparation en entrepôt ou tout coût identique pour chaque commande concernée. Enfin, saisissez un pourcentage et non une fraction décimale : utilisez 4.5 pour quatre et demi pour cent, et non 0.045. Chaque composante peut être nulle, ce qui autorise aussi des politiques uniquement fixes ou proportionnelles. Les entrées doivent être positives ou nulles et le taux est plafonné à 100. Leur séparation facilite l’explication au client, la vérification de votre plateforme et la prévention d’une inclusion accidentelle du montant fixe dans l’assiette proportionnelle.
Comprenez le calcul et les arrondis
Le calculateur multiplie d’abord le sous-total par le taux divisé par 100. Ce montant proportionnel est arrondi à deux décimales, conformément à la précision monétaire habituelle lors du paiement. Il ajoute ensuite le montant fixe et arrondit les frais cumulés. Le total final correspond au sous-total initial augmenté de ces frais. La réponse contient le sous-total normalisé, le montant fixe, le taux, la part proportionnelle, les frais complets et le total de la commande. Ce détail permet à une intégration d’afficher une seule ligne tout en conservant les données nécessaires aux tests et au rapprochement. Le calcul n’ajoute ni taxes, ni livraison, ni remises, ni pourboires, ni frais de paiement, ni conversion monétaire. Traitez ces éléments séparément selon les règles de votre système et la législation applicable.
Intégrez le résultat avec prudence au paiement
Utilisez cet outil comme une étape déterministe après avoir défini le sous-total admissible et avant d’afficher le récapitulatif final. Une boutique peut l’appeler lorsque le panier change, une équipe d’exploitation peut tester un nouveau barème et un service administratif peut contrôler les commandes terminées. Sans réseau, état enregistré, hasard ni date courante, des entrées identiques produisent toujours le même résultat. Conservez les valeurs saisies avec le détail si vous devez justifier ultérieurement un prélèvement. Avant le lancement, vérifiez l’ordre dans lequel votre plateforme applique remises, livraison, taxes et frais, car le calculateur utilise uniquement le sous-total fourni. Présentez clairement les frais avant la confirmation du paiement. L’API coûte $0.002 par requête ; dans le navigateur, le même calcul pur s’exécute sans transmettre les valeurs à un service tiers.
Cas d’usage
Configurer le paiement d’une boutique
Calculez précisément les frais cumulés d’une politique associant montant fixe et pourcentage.
Tester un nouveau barème
Comparez les frais sur des sous-totaux représentatifs avant de publier une politique.
Rapprocher les commandes terminées
Recalculez les frais attendus avec les données enregistrées et comparez-les à la commande.
Questions fréquentes
Quel sous-total faut-il saisir ?
Utilisez l’assiette prévue par votre politique avant ces frais. L’inclusion des remises, de la livraison ou des taxes dépend de votre paiement.
Puis-je calculer uniquement un montant fixe ?
Oui. Attribuez zéro à percentage_fee ou omettez-le ; les frais correspondront au montant fixe.
Comment les fractions de centime sont-elles traitées ?
La part proportionnelle est arrondie à deux décimales avant l’ajout du montant fixe. Les frais et le total le sont également.
Les taxes et la livraison sont-elles incluses ?
Non. Seule la manutention fondée sur le sous-total fourni est calculée ; les autres ajustements restent séparés.
Quel est le prix de l’API ?
L’API coûte $0.002 par requête. La version navigateur exécute localement le même calcul déterministe.
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
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/ecom/handling-fee \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"subtotal":125.5}'const res = await fetch("https://api.kit.forhosting.com/ecom/handling-fee", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"subtotal": 125.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/handling-fee",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"subtotal": 125.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/handling-fee", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"subtotal":125.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"subtotal":125.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/handling-fee", 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
{
"subtotal": 125.5
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.handling_fee",
"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
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. |