Sovrapprezzo carburante spedizione
Trasformi la tariffa base e la percentuale carburante in vigore nell’importo da fatturare: una base di 48,5 al 12,5 % aggiunge un sovrapprezzo di 6,06 per un nolo totale di 54,56. Lei inserisce entrambe le cifre, nessuna tabella viene consultata. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Tariffa base
- 48,5
- Supplemento (%)
- 12,5
- Importo del supplemento
- 6,06
- Trasporto totale
- 54,56
I corrieri e le reti di pacchi pubblicano sovrapprezzi carburante come percentuale del costo di trasporto base, così l'importo fatturato al cliente non è mai solo la tariffa di listino della griglia zone. I team operativi, i venditori di marketplace e i broker di nolo necessitano di un unico passo deterministico che trasformi una tariffa base nota e la percentuale carburante vigente nell'importo del sovrapprezzo e nel totale nolo tutto compreso.
Come un sovrapprezzo carburante percentuale trasforma la tariffa base nel nolo totale
Un sovrapprezzo carburante è quasi sempre espresso come percentuale del costo di trasporto o spedizione base per un dato livello di servizio, fascia di peso e zona di destinazione. Se il preventivo del corriere o la sua tariffa mostra una base di quarantotto virgola cinque unità monetarie e il fattore carburante pubblicato è del dodici virgola cinque per cento, l'importo del sovrapprezzo è base per percentuale diviso cento, e il nolo totale è base più quel sovrapprezzo—oppure, in modo equivalente, base per uno più la percentuale su cento.
Fare i conti a mano è semplice per un singolo pacco e faticoso quando si riconcilia una fattura settimanale con centinaia di righe, ciascuna con base diversa e la stessa tabella carburante settimanale. Questa capacità implementa esattamente quella identità in due passi senza consultazione della rete del corriere e senza tabella dipendente dalla data: Lei fornisce la tariffa base che già conosce e la percentuale di sovrapprezzo valida per il periodo che sta quotando.
Le uscite monetarie sono arrotondate half-up a due decimali così intermedi in virgola mobile come sei virgola zero sei due cinque diventano sei virgola zero sei per il sovrapprezzo e cinquantaquattro virgola cinque sei per il totale, in linea con contabilità e righe di fattura comuni.
Dove serve calcolare il sovrapprezzo carburante
Le piattaforme di e-commerce usano un calcolatore di sovrapprezzo carburante affinché checkout e strumenti di back-office mostrino il nolo all-in allineato ai bollettini settimanali del corriere senza codificare una nuova costante ogni lunedì. Gli operatori logistici terzi e i broker di nolo necessitano di un oracolo deterministico per email di preventivo, listini e controlli di margine quando la stessa base compare sotto tabelle carburante diverse per regione o servizio.
Mantenga base e percentuale come unici input, fissi i campi monetari arrotondati nei test e otterrà totali di nolo riproducibili per marketplace, plugin WMS e worker edge senza montare un motore di tariffazione completo proprio.
Casi d'uso
Checkout e visualizzazione del nolo all-in
Mostri ad acquirenti o clienti B2B il nolo tutto compreso applicando la percentuale carburante corrente del corriere alla tariffa base quotata prima del pagamento.
Righe di fattura e audit del corriere
Ricostruisca sovrapprezzo e nolo totale per ogni riga base riconciliando le fatture settimanali del corriere con la tabella carburante pubblicata per quel periodo.
Email di preventivo e listini
Generi preventivi broker o 3PL che elencano tariffa base, importo del sovrapprezzo carburante e nolo totale da un'unica percentuale condivisa su molti SKU.
Domande frequenti
Consulta tabelle carburante del corriere in tempo reale?
No. Lei fornisce la percentuale valida per il periodo che sta quotando.
Come si calcola il sovrapprezzo carburante di una spedizione?
Moltiplichi la tariffa base per la percentuale carburante e divida per cento, poi sommi l’importo alla base per ottenere il totale. Una base di 100 all’8 % dà un sovrapprezzo di 8, che poi si somma alla base.
Come vengono arrotondati sovrapprezzo e totale?
Entrambi sono arrotondati a due decimali, con la metà verso l’alto, come nelle righe di fattura più comuni. Una base di 48,5 al 12,5 % mostra quindi un sovrapprezzo di 6,06 e un nolo totale di 54,56.
La tariffa base o la percentuale possono essere zero?
Sì. Se una delle due è zero, il sovrapprezzo è zero e il totale coincide con la base. I valori negativi sono rifiutati e la percentuale carburante non può superare il mille per cento.
Devo scrivere 12,5 o una frazione decimale per il 12,5 %?
Scriva 12,5. Il dato carburante viene letto come percentuale della tariffa base, così come i corrieri lo pubblicano nelle loro tabelle, quindi non serve convertirlo prima in decimale.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"base_rate": 48.5,
"surcharge_percent": 12.5
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.fuel_surcharge",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Questo calcolatore di sovrapprezzo carburante per spedizioni accetta la tariffa base di spedizione e la percentuale di sovrapprezzo, moltiplica la base per la percentuale su cento per l'importo del sovrapprezzo, lo somma alla base per il nolo totale e arrotonda i campi monetari half-up a due decimali così fatture e client API restano allineati. Base zero o percentuale zero sono ammesse e producono sovrapprezzo nullo; gli input negativi falliscono con invalid_input e non vengono addebitati.
Come un sovrapprezzo carburante percentuale trasforma la tariffa base nel nolo totale
La risposta ripete gli input inviati, restituisce surcharge_amount e total_freight e include una breve stringa formula che può mostrare nell'interfaccia o nel log di audit accanto ai numeri.
Contratto di input, forma della risposta e validazione
La tariffa base è limitata a un trilione di unità monetarie e la percentuale di sovrapprezzo a mille per cento affinché un'automazione fuori controllo non saturi i percorsi di visualizzazione. Una base di cento con otto per cento produce sovrapprezzo otto e totale cento otto. Le richieste non valide non vengono addebitate. Invii un body JSON con POST con due numeri finiti non negativi obbligatori: base_rate, l'importo di spedizione o nolo prima del carburante (accettato anche con gli alias shipping_rate, rate, base_shipping_rate e freight_base); e surcharge_percent, la percentuale carburante, ad esempio dodici virgola cinque per il dodici virgola cinque per cento (alias fuel_surcharge_percent, percent, fuel_percent e surcharge_pct). Ogni campo può arrivare come numero JSON o stringa numerica; stringhe vuote, campi mancanti, valori non finiti e negativi falliscono con invalid_input indicando il campo. In caso di successo il body include base_rate e surcharge_percent come numeri normalizzati, surcharge_amount e total_freight come denaro half-up a due decimali, e formula che riafferma l'identità. Esempio: base_rate quarantotto virgola cinque e surcharge_percent dodici virgola cinque producono surcharge_amount sei virgola zero sei e total_freight cinquantaquattro virgola cinque sei. Abbini questo endpoint al proprio passo di tariffa per zona o peso dimensionale se deve ancora derivare la base; questo calcolatore applica la percentuale carburante solo quando la base è già nota.
Dove un'API di sovrapprezzo carburante per spedizioni genera valore
Sostituti di fogli di calcolo e automazioni low-code chiamano l'API così che la finanza possa riprezzare spedizioni storiche durante l'audit di una riga di fattura contestata che usava il fattore carburante del mese precedente. Poiché l'implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita.
Domande tecniche
Come si calcola il sovrapprezzo carburante di una spedizione?
Invii base_rate e surcharge_percent non negativi. L'API restituisce surcharge_amount = base_rate × surcharge_percent / 100 e total_freight = base_rate + surcharge_amount, con denaro arrotondato half-up a due decimali.
Quali unità devo usare per base_rate?
Qualsiasi unità monetaria coerente (USD, EUR, ecc.). Il calcolatore è agnostico all'unità: moltiplica e arrotonda; non converte valute né consulta tabelle del corriere.
surcharge_percent può essere zero o superare 100?
Zero è ammesso e produce sovrapprezzo nullo. Valori sopra 100 sono accettati fino a 1000 per tabelle temporanee estreme; una percentuale negativa è respinta con invalid_input.
Quanto costa il calcolatore di sovrapprezzo carburante spedizione?
Lo strumento nel browser è gratuito. Le richieste API usano il saldo KIT prepagato a $0.002 per chiamata riuscita; l'input non valido non viene addebitato.