ForHosting KIT · 金融・お金

大型荷物サーチャージ計算

Q: 運送会社の大型テーブルをライブ参照しますか？

しません。 料金設定対象の契約に適用する手数料と、必要なら上限を渡してください。

大型荷物の追加料金を決済前に確認できます。50×20×15インチ、20 lbの箱は最長辺が上限の48インチを超えるため、大型手数料25が加わり、基本送料18.5は43.5になります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

長さ: 50
幅: 20
高さ: 15
重み: 20
基本料金: 18.5
大型品手数料: 25

結果

単位系: Imperial
最長辺: 50
周囲長: 70
長さと胴回りの合計: 120

宅配ネットワークは、箱が標準コンベヤの包絡線に対して長すぎる・かさばりすぎる・重すぎる場合、ゾーン表の基本運賃以上を請求します。出品者、倉庫担当、3PL見積窓口は、過大または過重量のサーチャージを判定し、公表手数料を決済や請求の前に基本送料へ足す決定的な一手を必要とします。この大型荷物サーチャージ計算は長さ・幅・高さ・請求重量を受け取り、最長辺を長さとし、残る二辺の和の二倍を胴回りとし、最長辺・長さ＋胴回り・重量を運送会社型の上限と比較します。上限を超えたときは過大手数料、過重量手数料、またはその両方を基本運賃に加えます。既定上限は追加取扱いと大型荷物の一般的な区切り（インチ／ポンドまたはセンチメートル／キログラム）に沿い、上書きもできます。

過大・過重量フラグが送料合計になる仕組み

運送会社は、最長辺または長さ＋胴回りが追加取扱い／大型荷物の包絡線を超える荷物を過大とし、請求重量が公表の重量区切りを超える荷物を過重量とします。胴回り（girth）は残る二辺の和の二倍——断面を巻く帯——であり、length plus girth は大型荷物の運賃ページで使う単一の合成寸法です。同じ箱で両方の旗が立ち得て、二種の手数料は積み上がります。

既定上限は一般的な区切りに従います。ヤード・ポンド法では四十八インチ、長さ＋胴回り百三十インチ、五十ポンド。メートル法では百二十二センチメートル、三百三十センチメートル、二十三キログラムです。

上限ちょうどではサーチャージは起きず、厳密な超過だけが起きます。契約が別の区切りなら三つの上限のいずれも上書きできます。

大型荷物サーチャージ計算が役立つ場面

ECプラットフォームは、長く重い SKU を標準箱運賃で見積もり、集荷後に大型荷物手数料を請求する前に出品者へ警告できるよう、チェックアウトとバックオフィスで大型荷物サーチャージ計算を使います。3PL事業者とフォワーダーは、同一基本が地域やサービスごとの異なる追加取扱い表に載るとき、見積メール・料金表・粗利確認のための決定的な参照を必要とします。

倉庫の梱包場は箱を一度測り、分割するか別箱にするかサーチャージを受け入れるかを決められ、週次の運送会社請求で初めて手数料を知る事態を避けられます。

必須入力は辺・重量・基本・二種の手数料だけに保ち、丸めた金額欄をテストに固定すれば、自前の完全なレーティングエンジンなしでマーケットプレイス、WMSプラグイン、エッジワーカー向けに再現可能な着地送料合計が得られます。

活用例

決済画面と着地送料の表示

過大・過重量の手数料を見積基本運賃に足し、支払い前に買い物客や B2B 買い手へ税込の送料を示します。

梱包場と箱の選定

封をした箱を測り、ラベル購入前に分割・箱の変更・サーチャージ受入のいずれかを判断します。

請求行と運送会社監査

週次の運送会社請求を公表の寸法・重量区切りと突合するとき、各出荷の過大・過重量手数料を再構築します。

よくある質問

過大・過重量の既定上限は何ですか？

ヤード・ポンド法は最長辺 48 インチ、長さ＋胴回り 130 インチ、50 ポンドです。メートル法は 122 cm、330 cm、23 kg です。

運送会社の大型テーブルをライブ参照しますか？

しません。料金設定対象の契約に適用する手数料と、必要なら上限を渡してください。

胴回りはどう測りますか？

胴回りは短い2辺の合計の2倍で、断面をリボンで一周した長さにあたります。50×20×15の箱なら胴回りは70で、長さと胴回りの合計は120となり、上限の130を下回ります。

上限ちょうどの荷物にも追加料金がかかりますか？

いいえ。上限を超えた場合だけ加算されるので、最長辺がちょうど48インチ、請求重量がちょうど50ポンドなら通常料金のままです。それを少しでも超えると追加料金の対象になります。

大型と過重量の両方に当てはまることはありますか？

はい。同じ箱が両方に該当することがあり、その場合は大型手数料と過重量手数料の両方が基本送料に加算されます。どちらに当てはまったかも結果に示されます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/ecom/oversize-surcharge

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/ecom/oversize-surcharge \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":50,"width":20,"height":15,"weight":20,"base_rate":18.5,"oversize_fee":25,"overweight_fee":40}'

const res = await fetch("https://api.kit.forhosting.com/ecom/oversize-surcharge", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "length": 50,
    "width": 20,
    "height": 15,
    "weight": 20,
    "base_rate": 18.5,
    "oversize_fee": 25,
    "overweight_fee": 40
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/oversize-surcharge",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "length": 50,
    "width": 20,
    "height": 15,
    "weight": 20,
    "base_rate": 18.5,
    "oversize_fee": 25,
    "overweight_fee": 40
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/oversize-surcharge", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"length":50,"width":20,"height":15,"weight":20,"base_rate":18.5,"oversize_fee":25,"overweight_fee":40}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"length":50,"width":20,"height":15,"weight":20,"base_rate":18.5,"oversize_fee":25,"overweight_fee":40}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/oversize-surcharge", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "length": 50,
  "width": 20,
  "height": 15,
  "weight": 20,
  "base_rate": 18.5,
  "oversize_fee": 25,
  "overweight_fee": 40
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.oversize_surcharge",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

過大・過重量フラグが送料合計になる仕組み

length・width・height を送ると、本計算は最長辺を長さに揃えるため、長い板を幅と名乗らせて隠すことはできません。最長辺が length_limit を超えるか、長さ＋胴回りが girth_limit を超えると過大と判定します。weight が weight_limit を超えると過重量と判定します。total_shipping は base_rate に、過大なら oversize_fee、過重量なら overweight_fee を加えた値です。金額欄は half-up で小数第二位に丸め、請求書と API クライアントが同じセントで揃うようにしています。

入力契約・応答の形・検証の振る舞い

無効な要求は課金されません。基本運賃をまだ求める必要がある場合はゾーン料金や容積重量の自前ステップと組み合わせてください。本計算は基本が分かった後に寸法と重量の手数料だけを適用します。POST で JSON 本体に、必須の有限数を七つ送ってください。length・width・height は選んだ長さ単位の正の辺、weight は非負の請求重量、base_rate はこれらのサーチャージ前の送料、oversize_fee は過大時に足す金額、overweight_fee は過重量時に足す金額です。任意の unit_system は imperial または metric の列挙で、省略時は imperial です。任意の length_limit・girth_limit・weight_limit はその体系の既定を上書きします。各数値欄は JSON 数値でも数値文字列でも構いません。空文字、必須欠落、非有限値、正でない辺、負の金額や重量はフィールド名付きの invalid_input で失敗します。よくある別名（l、w、h、depth、wt、shipping_rate、oversize_surcharge、weight_fee、units）も受け付けます。成功時の本体には unit_system、longest_side、girth、length_plus_girth、weight、実際に使った三上限、真偽値 is_oversize と is_overweight、内訳 oversize_fee_applied と overweight_fee_applied、surcharge_amount、エコーした base_rate、total_shipping、oversize と overweight をその順に並べた triggers 配列、恒等式を述べる formula 文字列が含まれます。例：imperial で length 五十、width 二十、height 十五、weight 二十、base_rate 十八点五、oversize_fee 二十五、overweight_fee 四十なら、longest_side は五十、girth は七十、length_plus_girth は百二十、五十が四十八を超えるため is_oversize は true、is_overweight は false、surcharge_amount は二十五、total_shipping は四十三点五です。

大型荷物サーチャージ計算が役立つ場面

表計算の置き換えやローコード自動化は API を呼び、前シーズンの寸法区切りを使った争議行を監査する際に財務が過去出荷を再価格付けできるようにします。実装は純粋 parse のティア A のため、成功コールはモデルトークンも外向きネットワークもなく公開の基本価格 $0.002 です。

技術的な質問

大型荷物サーチャージはどう計算しますか。

length、width、height、weight、base_rate、oversize_fee、overweight_fee を送ってください。API は最長辺を揃え、他の二辺の二倍を girth とし、上限に照らして過大または過重量を判定し、total_shipping = base_rate に該当手数料を加えた値を返します。

一つの荷物が過大かつ過重量になることはありますか。

あります。二つの旗は独立し、二種の手数料は積み上がります。triggers 配列は該当時に oversize と overweight をその順で並べ、surcharge_amount はその合計です。

大型荷物サーチャージ計算の料金はいくらですか。

ブラウザツールは無料です。API 要求は前払い KIT 残高を成功1回あたり $0.002 で使い、無効入力は課金されません。

KITの完全なドキュメントを見る →

大型荷物サーチャージ計算

無料で実行

計算例

過大・過重量フラグが送料合計になる仕組み

大型荷物サーチャージ計算が役立つ場面

活用例

決済画面と着地送料の表示

梱包場と箱の選定

請求行と運送会社監査

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

過大・過重量フラグが送料合計になる仕組み

入力契約・応答の形・検証の振る舞い

大型荷物サーチャージ計算が役立つ場面

技術的な質問

ありがとう