配送燃料サーチャージ計算
基本運賃と現在の燃料率から請求額を出せます。基本運賃48.5に12.5パーセントを適用すると、サーチャージは6.06、運賃合計は54.56です。2つの数字はご自身で入力するので、表の照会はありません。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 基本料金
- 48.5
- 割増率 (%)
- 12.5
- 割増金額
- 6.06
- 運賃合計
- 54.56
運送会社や宅配ネットワークは、燃料サーチャージを基本輸送料金に対する百分率として公表するため、お客様へ請求する金額がゾーン表のリスト料金そのものになることはありません。運用チーム、マーケットプレイス出品者、フォワーダーは、既知の基本運賃と現行の燃料パーセンテージからサーチャージ額と税込総運賃を一意に導く決定的な一手を必要とします。基本がゼロまたは率がゼロでも許容されサーチャージはゼロになります。
百分率の燃料サーチャージが基本運賃を総運賃に変える仕組み
燃料サーチャージは、ほぼ常にサービスレベル・重量帯・配送先ゾーンごとの基本輸送または配送料金に対する百分率として表されます。
運送会社の見積や料金表が基本運賃四十八点五通貨単位、公表燃料係数が十二点五パーセントであれば、サーチャージ額は基本に率を掛けて百で割った値であり、総運賃はそのサーチャージを基本に加えたもの—あるいは基本に一プラス率割る百を掛けたものと同等です。手計算は一個の小包なら容易でも、異なる基本と同一の週次燃料表を持つ数百行の週次請求を突合するときは苦痛です。
本機能は運送会社ネットワーク参照も日付依存の表もなく、その二段階の恒等式だけを実装します。すでに把握している基本運賃と、料金設定対象期間に適用するサーチャージ率を入力してください。金額出力は半上げで小数第二位に丸められ、六点零六二五のような浮動小数の中間値はサーチャージで六点零六、合計で五十四点五六となり、一般的な会計・請求行の慣習と一致します。
活用例
チェックアウトと着地送料の表示
支払い前に、運送会社の現行燃料パーセンテージを見積基本配送料金へ適用し、購入者やB2B顧客に総額運賃を示します。
請求行と運送会社監査
その期間の公表燃料表に照らして週次の運送会社請求を突合する際、各基本行のサーチャージと総運賃を再構築します。
見積メールと料金表
多くのSKUで共有する単一の率入力から、基本運賃・燃料サーチャージ額・総運賃を列挙するブローカーまたは3PL見積を生成します。
よくある質問
運送会社の燃料表をライブ照会しますか?
いいえ。 料金設定対象期間に適用する率をあなたが指定します。ハンドラはネットワークなしの純粋 parse のため、テストと監査で結果は決定的です。
燃料サーチャージはどう計算しますか?
基本運賃に燃料率を掛けて100で割り、その額を基本運賃に足すと合計になります。基本運賃100に8パーセントなら、サーチャージは8で、これを基本運賃に足します。
サーチャージと合計はどう丸められますか?
どちらも小数点以下2桁で四捨五入され、一般的な請求書の行と一致します。そのため、基本運賃48.5に12.5パーセントでは、サーチャージ6.06、合計54.56と表示されます。
基本運賃や燃料率は0でも使えますか?
はい。どちらかが0ならサーチャージは0になり、合計は基本運賃と同じです。負の値は受け付けず、燃料率は1000パーセントまでです。
12.5パーセントは12.5と小数のどちらで入力しますか?
12.5と入力してください。燃料の数字は基本運賃に対するパーセントとして扱われ、運送会社が燃料表で公表する形のままで使えます。小数への換算は不要です。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
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)リクエスト例
{
"base_rate": 48.5,
"surcharge_percent": 12.5
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.fuel_surcharge",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
この配送燃料サーチャージ計算ツールは基本配送料金と燃料サーチャージ率を受け取り、基本額に率を百分の一で掛けてサーチャージ額を求め、それを基本に加算して総運賃とし、金額フィールドを半上げで小数第二位に丸めて請求書とAPIクライアントを揃えます。負の入力は invalid_input で失敗し課金されません。
百分率の燃料サーチャージが基本運賃を総運賃に変える仕組み
応答は送信した入力を返し、surcharge_amount と total_freight を示し、数値の横にUIや監査ログへ出せる短い formula 文字列を含みます。
入力契約・応答形状・検証の振る舞い
基本運賃は一兆通貨単位まで、サーチャージ率は千パーセントまでに上限があり、暴走した自動化が表示経路を溢れさせないようにしています。基本百に八パーセントならサーチャージ八、合計百八です。無効な要求は課金されません。基本をまだ求める必要がある場合は、ゾーン料金や容積重量の自前ステップと組み合わせてください。本計算は基本が分かった後に燃料率だけを適用します。POST で JSON 本体に、必須の有限非負数を二つ送ってください。base_rate は燃料前の配送または運賃額(別名 shipping_rate、rate、base_shipping_rate、freight_base も可)、surcharge_percent は燃料百分率で、十二点五パーセントなら十二点五(別名 fuel_surcharge_percent、percent、fuel_percent、surcharge_pct)。各フィールドは JSON 数値でも数値文字列でも可です。空文字、欠落、非有限値、負数はフィールド名付きの invalid_input で失敗します。成功時の本体には正規化された base_rate と surcharge_percent、半上げ二桁の surcharge_amount と total_freight、恒等式を再掲する formula が含まれます。例:base_rate 四十八点五と surcharge_percent 十二点五なら surcharge_amount は六点零六、total_freight は五十四点五六。
配送燃料サーチャージ API が役立つ場面
ECプラットフォームは、毎週の運送会社掲示に合う着地運賃をチェックアウトやバックオフィスで示すために燃料サーチャージ計算を使い、月曜日ごとに新しい定数をハードコードしません。3PL事業者とフォワーダーは、同一基本が地域やサービスごとの異なる燃料表に載るとき、見積メール・料金表・粗利確認のための決定的なオラクルを必要とします。表計算の置き換えやローコード自動化は API を呼び、先月の燃料係数を使った争議請求行を監査する際に財務が過去出荷を再価格付けできるようにします。実装は純粋 parse のティア A のため、成功コールはモデルトークンも外向きネットワークもなく公開の基本価格 $0.002 です。入力は基本と率だけに保ち、丸めた金額フィールドをテストに固定すれば、自前の完全なレーティングエンジンなしでマーケットプレイス、WMSプラグイン、エッジワーカー向けに再現可能な運賃合計が得られます。
技術的な質問
配送の燃料サーチャージはどう計算しますか?
非負の base_rate と surcharge_percent を送ってください。API は surcharge_amount = base_rate × surcharge_percent / 100 と total_freight = base_rate + surcharge_amount を返し、金額は半上げで小数第二位です。
base_rate にはどの単位を使えばよいですか?
一貫した任意の通貨単位(USD、EUR など)です。計算は単位非依存で乗算と丸めのみ行い、為替換算や運送会社表の参照はしません。
surcharge_percent はゼロや100超でもよいですか?
ゼロは許容されサーチャージはゼロになります。100超は一時的な極端な表向けに1000まで許可され、負の率は invalid_input で拒否されます。
配送燃料サーチャージ計算の料金は?
ブラウザツールは無料です。API要求は前払いKIT残高を成功1回あたり $0.002 で使用し、無効入力は課金されません。