ForHosting KIT · Outils pour développeurs

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.

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

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.

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.

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.

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/ecom/handling-fee

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/ecom/handling-fee \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subtotal":125.5}'
{
  "subtotal": 125.5
}
{
  "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.

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 →