Surcharge carburant expédition
Transformez le tarif de base et le pourcentage carburant en vigueur en montant à facturer : une base de 48,5 à 12,5 % ajoute une surcharge de 6,06 pour un fret total de 54,56. Vous saisissez les deux chiffres, aucune table n’est consultée. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Tarif de base
- 48,5
- Surcharge (%)
- 12,5
- Montant du supplément
- 6,06
- Fret total
- 54,56
Les transporteurs et les réseaux de colis publient des surcharges carburant en pourcentage de la charge de transport de base, de sorte que le montant facturé au client n'est jamais le simple tarif catalogue de la grille de zones. Les équipes opérations, les vendeurs de marketplaces et les courtiers fret ont besoin d'une étape déterministe unique qui transforme un tarif de base connu et le pourcentage carburant en vigueur en montant de surcharge et en total fret tout compris.
Comment une surcharge carburant en pourcentage convertit le tarif de base en fret total
Une surcharge carburant s'exprime presque toujours en pourcentage de la charge de transport ou d'expédition de base pour un niveau de service, une tranche de poids et une zone de destination donnés.
Si le devis transporteur ou votre grille affiche un tarif de base de quarante-huit virgule cinq unités monétaires et que le facteur carburant publié est de douze virgule cinq pour cent, le montant de la surcharge est base multiplié par le pourcentage divisé par cent, et le fret total est base plus cette surcharge—ou de façon équivalente base multiplié par un plus le pourcentage sur cent.
Faire le calcul à la main est simple pour un seul colis et pénible lors du rapprochement d'une facture hebdomadaire de centaines de lignes, chacune avec une base différente et la même table carburant de la semaine. Cette capacité met en œuvre exactement cette identité en deux étapes sans consultation du réseau transporteur et sans table dépendante de la date : vous fournissez le tarif de base que vous connaissez déjà et le pourcentage de surcharge applicable à la période que vous tarifez.
Les sorties monétaires sont arrondies half-up à deux décimales afin que des intermédiaires flottants tels que six virgule zéro six deux cinq deviennent six virgule zéro six pour la surcharge et cinquante-quatre virgule cinq six pour le total, conformes aux conventions comptables et de lignes de facture.
Contrat d'entrée, forme de la réponse et validation
Le tarif de base est plafonné à un billion d'unités monétaires et le pourcentage de surcharge à mille pour cent afin qu'une automatisation dérivante ne fasse pas déborder les chemins d'affichage. Une base de cent avec huit pour cent donne une surcharge de huit et un total de cent huit. Les requêtes invalides ne sont pas facturées.
Associez ce point d'accès à votre propre étape de tarif par zone ou de poids dimensionnel si vous devez encore dériver la base ; ce calculateur n'applique le pourcentage carburant qu'une fois la base connue.
Quand calculer la surcharge carburant est utile
Les plateformes d'e-commerce utilisent un calculateur de surcharge carburant pour que le checkout et les outils back-office affichent un fret atterri aligné sur les bulletins hebdomadaires du transporteur sans coder une nouvelle constante chaque lundi. Les opérateurs logistiques tiers et les courtiers fret ont besoin d'un oracle déterministe pour les e-mails de devis, les grilles et les contrôles de marge lorsque la même base apparaît sous des tables carburant différentes selon la région ou le service.
Conservez la base et le pourcentage comme seules entrées, figez les champs monétaires arrondis dans les tests, et vous obtenez des totaux de fret reproductibles pour marketplaces, plugins WMS et workers en périphérie sans déployer un moteur de tarification complet en propre.
Cas d’usage
Checkout et affichage du fret atterri
Montrez aux acheteurs ou clients B2B le frettage tout compris en appliquant le pourcentage carburant transporteur en vigueur au tarif d'expédition de base coté avant paiement.
Lignes de facture et audit transporteur
Reconstituez la surcharge et le fret total de chaque ligne de base lors du rapprochement des factures hebdomadaires transporteur avec la table carburant publiée pour cette période.
E-mails de devis et grilles tarifaires
Générez des devis courtier ou 3PL listant tarif de base, montant de surcharge carburant et fret total à partir d'un seul pourcentage partagé entre de nombreux SKU.
Questions fréquentes
Cet outil interroge-t-il les tables carburant en direct ?
Non. Vous fournissez le pourcentage applicable à la période que vous tarifez.
Comment calcule-t-on la surcharge carburant d’un envoi ?
Multipliez le tarif de base par le pourcentage carburant et divisez par cent, puis ajoutez ce montant à la base pour obtenir le total. Une base de 100 à 8 % donne une surcharge de 8, ajoutée ensuite à la base.
Comment la surcharge et le total sont-ils arrondis ?
Les deux sont arrondis à deux décimales, la moitié vers le haut, comme sur la plupart des lignes de facture. Une base de 48,5 à 12,5 % affiche donc une surcharge de 6,06 et un fret total de 54,56.
Le tarif de base ou le pourcentage peuvent-ils être nuls ?
Oui. Si l’un des deux vaut zéro, la surcharge est nulle et le total égale la base. Les valeurs négatives sont refusées, et le pourcentage carburant ne peut pas dépasser mille pour cent.
Faut-il saisir 12,5 ou une fraction décimale pour 12,5 % ?
Saisissez 12,5. Le chiffre carburant est lu comme un pourcentage du tarif de base, tel que les transporteurs le publient dans leurs tables, sans conversion préalable en décimal.
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
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/fuel-surcharge \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"base_rate":48.5,"surcharge_percent":12.5}'const res = await fetch("https://api.kit.forhosting.com/ecom/fuel-surcharge", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"base_rate": 48.5,
"surcharge_percent": 12.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/fuel-surcharge",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"base_rate": 48.5,
"surcharge_percent": 12.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/fuel-surcharge", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"base_rate":48.5,"surcharge_percent":12.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"base_rate":48.5,"surcharge_percent":12.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/fuel-surcharge", 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
{
"base_rate": 48.5,
"surcharge_percent": 12.5
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.fuel_surcharge",
"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. |
Notes techniques
Ce calculateur de surcharge carburant d'expédition accepte le tarif d'expédition de base et le pourcentage de surcharge, multiplie la base par le pourcentage divisé par cent pour le montant de la surcharge, l'ajoute à la base pour le fret total, et arrondit les champs monétaires half-up à deux décimales afin d'aligner factures et clients API. Une base nulle ou un pourcentage nul est autorisé et donne une surcharge nulle ; les entrées négatives échouent avec invalid_input et ne sont pas facturées.
Comment une surcharge carburant en pourcentage convertit le tarif de base en fret total
La réponse renvoie les entrées envoyées, surcharge_amount et total_freight, ainsi qu'une courte chaîne formula que vous pouvez afficher dans l'interface ou le journal d'audit à côté des chiffres.
Contrat d'entrée, forme de la réponse et validation
Envoyez un corps JSON en POST avec deux nombres finis non négatifs obligatoires : base_rate, le montant d'expédition ou de fret avant carburant (aussi accepté sous les alias shipping_rate, rate, base_shipping_rate et freight_base) ; et surcharge_percent, le pourcentage carburant, par exemple douze virgule cinq pour douze virgule cinq pour cent (alias fuel_surcharge_percent, percent, fuel_percent et surcharge_pct). Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique ; chaînes vides, champs manquants, valeurs non finies et négatifs échouent avec invalid_input en nommant le champ. En cas de succès le corps inclut base_rate et surcharge_percent comme nombres normalisés, surcharge_amount et total_freight en monétaire half-up à deux décimales, et formula rappelant l'identité. Exemple : base_rate quarante-huit virgule cinq et surcharge_percent douze virgule cinq donnent surcharge_amount six virgule zéro six et total_freight cinquante-quatre virgule cinq six.
Où une API de surcharge carburant d'expédition apporte de la valeur
Les remplacements de tableurs et les automatisations low-code appellent l'API pour que la finance puisse revaloriser des expéditions historiques lors de l'audit d'une ligne de facture contestée qui utilisait le facteur carburant du mois précédent. Comme l'implémentation est parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.
Questions techniques
Comment calculer une surcharge carburant d'expédition ?
Envoyez base_rate et surcharge_percent non négatifs. L'API renvoie surcharge_amount = base_rate × surcharge_percent / 100 et total_freight = base_rate + surcharge_amount, avec monétaire arrondi half-up à deux décimales.
Quelles unités utiliser pour base_rate ?
Toute unité monétaire cohérente (USD, EUR, etc.). Le calculateur est agnostique à l'unité : il multiplie et arrondit ; il ne convertit pas les devises ni ne consulte les tables transporteur.
surcharge_percent peut-il être zéro ou dépasser 100 ?
Zéro est autorisé et donne une surcharge nulle. Les valeurs au-dessus de 100 sont acceptées jusqu'à 1000 pour des tables temporaires extrêmes ; un pourcentage négatif est rejeté avec invalid_input.
Combien coûte le calculateur de surcharge carburant d'expédition ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.