ForHosting KIT · 開発者向けツール

配送の容積重量と請求重量を計算

配送料は、はかりに表示された重量だけで決まるとは限りません。大きくて軽い荷物は輸送スペースを多く使うため、配送会社が容積重量を基準に料金を計算する場合があります。この計算ツールは、荷物の長さ、幅、高さを掛けて体積を求め、配送会社の容積重量除数で割った結果を実重量と比較します。両方の値と、実際に請求対象となる大きい方の重量を示すため、ラベルを購入する前に販売者、出荷担当者、購入者が根拠の明確な見積もりを確認できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

互換性のある寸法と配送会社の除数を入力します

まず、輸送中に占有する空間に影響する膨らみ、取っ手、保護材も含めて、梱包後の外寸で長さ、幅、高さを測ってください。3つの寸法はすべて正の数である必要があります。実重量には、商品カタログの重量を合計した値ではなく、箱や緩衝材を加えて完全に梱包した後にはかりで測った値を入力します。次に、利用する配送会社、サービス、単位系、契約条件に対応して公開されている除数を指定してください。単位の互換性は重要です。立方インチとポンド向けの除数を、センチメートルやキログラムの値と組み合わせることはできません。このツールが単位名を固定しないのは、除数が寸法単位と重量単位の関係を定めるためです。未入力、0、負数、無限大、数値以外の値は、もっともらしい誤結果を避けるため拒否されます。除数や規則は、サービス、配送先、契約、時期によって異なることがあります。顧客向け見積もりに使う前に、必ず現在の料金表で該当する値をご確認ください。

容積重量と請求重量の意味を確認します

計算では最初に、長さ、幅、高さを掛けて荷物の体積を求めます。その体積を指定された除数で割った値が容積重量です。次に容積重量と実重量を比較し、大きい方を請求重量として返します。2つが完全に同じ場合は、請求額となる数値は変わりませんが、出力上の基準は実重量と表示されます。自動処理で安定した結果を扱えるよう、表示値は小数点以下6桁に整えられます。一方、大小の比較には表示用に丸める前の完全な計算値を使用します。この機能は、寸法を自動的に整数へ丸めたり、重量を次の請求単位まで切り上げたりしません。配送会社によっては、掛け算の前に各寸法を丸める、最終重量を切り上げる、最低重量を設ける、不定形荷物を別扱いにするといった規則があります。公開された規則を入力前に反映するか、返された請求重量へ別途適用してください。出力には体積も含まれるため、式の確認や単位の取り違えの発見にも役立ちます。

出荷判断に重量比較を活用します

容積重量の比較は、荷物を配送会社へ渡す前に行うと最も効果的です。箱を選ぶ段階で計算すれば、余分な空間のために軽い注文が容積基準で請求されるかどうかを確認できます。実重量を変えずに複数の梱包案を比べたり、各サービスが公開する除数を使って利用可能な配送方法を比較したりすることもできます。チェックアウトや倉庫の処理では、後から判断を再現できるように、入力値と結果を料金見積もりと一緒に保存してください。APIは1リクエストあたり$0.002で、配送会社へ接続せずに決定論的な計算を行うため、個別の荷物にも短時間の一括確認にも適しています。ただし、送料の提示、サービスの選択、契約内容の検証、最終的な料金回答の代替は行いません。大型荷物、地域、取扱い、燃料、個人宅配送などの追加料金も対象外です。請求重量は完全な料金計算に必要な要素の1つとして扱ってください。除数や丸め規則が変更された場合は、古い結果を使い続けず、入力値と業務手順を更新してください。

活用例

より小さい箱を選ぶ

出荷前に梱包案を比較し、空きスペースによって容積重量が実重量を上回る場合を見つけられます。

配送料の見積もりを確認する

荷物の寸法と対象サービスの公開除数を使い、見積もりに採用された重量基準を再現できます。

出荷データを監査する

保存された請求重量が、計算した容積重量と実重量の大きい方に一致しない注文を検出できます。

よくある質問

容積重量とは何ですか？

荷物の体積を配送会社が定めた除数で割り、占有する空間を重量に換算した値です。

どちらの重量が請求されますか？

容積重量と実重量のうち大きい方が請求重量です。同じ場合、出力では実重量を基準として示します。

どの単位を使えばよいですか？

除数に指定された寸法単位と重量単位をご使用ください。すべての入力を互換性のある同じ単位系にそろえる必要があります。

ポンドやキログラムの整数へ切り上げますか？

いいえ。数学的結果を小数点以下6桁で返します。配送会社が公開する寸法と請求単位の規則は別途適用してください。

寸法が0または負数の場合はどうなりますか？

無効な入力としてリクエストが失敗します。長さ、幅、高さはそれぞれ正の有限数でなければなりません。

APIでの計算料金はいくらですか？

APIリクエスト1回につき$0.002です。配送会社には接続せず、同じ入力から常に同じ結果を返します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/ecom/shipping-dimensional-weight

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

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

curl -X POST https://api.kit.forhosting.com/ecom/shipping-dimensional-weight \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}'

const res = await fetch("https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "length": 20,
    "width": 15,
    "height": 10,
    "divisor": 139,
    "actual_weight": 18
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/shipping-dimensional-weight",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "length": 20,
    "width": 15,
    "height": 10,
    "divisor": 139,
    "actual_weight": 18
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"length":20,"width":15,"height":10,"divisor":139,"actual_weight":18}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/shipping-dimensional-weight", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "length": 20,
  "width": 15,
  "height": 10,
  "divisor": 139,
  "actual_weight": 18
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.shipping_dimensional_weight",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

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