ForHosting KIT · 開発者向けツール

販売数と返品数から商品返品率を計算

商品返品率は、同じ集計期間に販売した数量のうち、返品された数量が占める割合を示します。販売数と返品数をご入力いただくと、商品管理、業務運用、財務報告に活用できる一貫した比率を算出します。標準的な計算式を用いて両方の値を検証し、販売数がゼロの場合は明確にエラーを返します。二つの数値が同じ期間と範囲を対象としていれば、単一のSKU、カテゴリー、店舗、カタログ全体の分析にご利用いただけます。

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

無料で実行 API仕様を見る

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

対応する販売数と返品数をご用意ください

有用な返品率を得るには、同じ事業範囲を表す二つの数値が必要です。暦月などの集計期間を一つ選び、SKU、商品カテゴリー、店舗、マーケットプレイス、カタログ全体などの対象範囲も統一してください。その範囲で販売したすべての数量を販売数として、同じ期間に返品されたすべての数量を返品数としてご入力ください。注文数と商品数は混在させないでください。三商品を含む一件の注文は販売数三、一商品の返品は返品数一として扱います。組織が正式に返品として分類している場合を除き、キャンセルは別に集計してください。商品は個数で数えるため、入力できるのはゼロ以上の整数です。販売数はゼロより大きい必要があり、分母がなければ意味のある比率を算出できません。返品数はゼロでも構いません。以前に購入された商品が当期に返品される場合は、返品数が当期の販売数を上回ることもあります。そのため、計算結果を百パーセントに制限せず、実際の業務状況をそのまま示します。

比率の計算方法をご確認ください

計算式は、返品数を販売数で割り、その商に百を掛けるものです。店舗が1,250個を販売し、37個の返品を記録した場合は、37を1,250で割って100を掛け、2.96パーセントとなります。結果は最大六桁の小数に丸められるため、大規模なカタログや返品件数が少ない場合にも十分な精度を保ちながら、APIとブラウザーで安定した値を得られます。返品率は関係性を示す指標であり、原因そのものを診断するものではありません。高い比率の背景には、サイズの問題、破損、不正確な説明、お客様の期待、柔軟な返品方針、購入と返品の時期のずれなどが考えられます。比較する際は、同じ集計ルールを使用してください。発送数を基準とするレポートと注文数を基準とするレポートは、直接比較できません。出力には比率とともに入力した二つの数値も表示されるため、ダッシュボードの値や使用した分母を容易に監査できます。再現性が必要な場合は、返品率と各数値を一緒に保存してください。

定期分析に返品率をご活用ください

継続的に監視する場合は、一定の頻度で返品率を計算し、各期間の入力値を保存してください。週次の結果は出荷や品質の急な問題を見つけるのに役立ち、月次の結果は販売量が少ない商品の変動を抑えやすくなります。SKU、仕入先、カテゴリー、販売チャネル、倉庫、キャンペーン別に集計すると、全体平均では見えない傾向を発見できます。分母が小さい場合は慎重に解釈してください。二件の販売に対する一件の返品は五十パーセントですが、千件に対する五百件よりも不安定な観測値です。品ぞろえを変更する前に、販売量、返品理由、返金額、利益率も併せてご確認ください。自動化する際は、同じ締め日時点の整数を送信し、販売数ゼロのエラーはゼロパーセントではなく「該当なし」と表示してください。個別確認にはブラウザーが便利で、定期レポートやデータ処理には$0.002のAPIが適しています。外部サービスを使用しないため、同じ有効な入力からは常に同じ出力が得られます。

活用例

商品の実績を比較する

同じ期間と集計ルールで各SKUの返品率を計算し、詳しい確認が必要な商品を特定できます。

出荷工程の変更を監視する

梱包、配送業者、倉庫、品質管理を変更した後の返品率を週次または月次で追跡できます。

ECレポートを作成する

使用した販売数と返品数を保持しながら、再現可能な返品率をダッシュボードに追加できます。

よくある質問

どのような計算式を使用しますか？

返品数を販売数で割り、その結果に100を掛けます。

販売数がゼロの場合はどうなりますか？

分母がゼロでは比率を計算できないため、入力エラーを返します。

返品数はゼロでもよいですか？

はい。販売数が正の場合、返品数ゼロの返品率は0パーセントです。

結果が100パーセントを超えることはありますか？

はい。以前の期間に販売した商品が集計期間中に返品された場合に起こり得ます。

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

APIの各リクエストは$0.002です。ブラウザーでも計算をご利用いただけます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/ecom/return-rate-calculate

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

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

curl -X POST https://api.kit.forhosting.com/ecom/return-rate-calculate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"units_sold":1250,"units_returned":37}'

const res = await fetch("https://api.kit.forhosting.com/ecom/return-rate-calculate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "units_sold": 1250,
    "units_returned": 37
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/return-rate-calculate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "units_sold": 1250,
    "units_returned": 37
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/return-rate-calculate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"units_sold":1250,"units_returned":37}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"units_sold":1250,"units_returned":37}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/return-rate-calculate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "units_sold": 1250,
  "units_returned": 37
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.return_rate_calculate",
  "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の完全なドキュメントを見る →