ForHosting KIT · 開発者向けツール

顧客ランク別の価格表・掛け率計算ツール

価格階層表は、1つの原価から複数の顧客グループ向けに一貫した販売価格を作るための仕組みです。商品の原価を入力し、小売、卸売、VIP、代理店、会員など、必要なランクごとに原価への上乗せ率を追加します。計算ツールは各行を独立して処理し、ランク名が明記された価格を返します。原価は共通でも、対象顧客、販売経路、取引関係によって条件が異なる場合に役立ちます。負の上乗せ率は受け付けないため、誤って入力したマイナス記号によって、上乗せ方針が割引へ変わることを防げます。

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

無料で実行 API仕様を見る

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

すべてのランクを同じ原価から組み立てます

信頼できる価格階層表を作るには、まず基準となる原価を1つに定めます。この金額には、商品の仕入原価、1個当たりの直接製造原価、または社内の価格方針で一貫して原価として扱う数値を使用できます。顧客グループを1行ずつ追加し、同じ原価に対する上乗せ率を入力してください。たとえば、小売の上乗せ率を卸売より高くし、VIPを両者の間またはそれ以下に設定できます。ランク名の意味は固定されていないため、販売店、会員、提携先、地域など、事業に合う名称をご利用いただけます。結果には入力した名称と率が保持されるので、価格方針と算出額の関係を確認しやすくなります。原価とすべての結果には同じ通貨をお使いください。この計算は通貨に依存せず、為替換算は行いません。上乗せ率がゼロの場合は原価と同額になり、負の値はエラーになります。この厳格な規則により、上乗せ表と割引表を区別し、カタログや見積書へ反映される前に誤ったマイナス記号を検出できます。

計算式と端数処理を確認します

各ランクの販売価格は、原価に「1と、上乗せ率を100で割った値との合計」を掛けて求めます。原価が40、上乗せ率が50パーセントなら、40の半分を原価に加えるため、結果は60です。上乗せ率は最終販売価格ではなく原価を基準にします。この違いは重要です。上乗せ率と粗利益率には関係がありますが、同じものではなく、50パーセントの上乗せ率が50パーセントの粗利益率を意味するわけではありません。返される価格は小数点以下2桁に丸められるため、一般的な価格表に使いやすく、自動処理でも安定した結果になります。元の原価と入力した各率も返されるので、後続システムで計算条件と金額を一緒に保存できます。各行の計算は独立しており、卸売率を変更しても小売やVIPの価格には影響しません。値が有限で公開された範囲内なら、原価や率にゼロを指定できます。必須値の欠落、数値以外の入力、空のランク名、長すぎる一覧、負の率は拒否されます。原価未満での販売を認める場合は、負の上乗せではなく、別の割引または例外として管理してください。

価格設定業務に階層表を組み込みます

ランク別の結果は、繰り返し利用できる価格設定手順に組み込むことで、さらに役立ちます。仕入先の原価が変わるたびに階層表全体を再計算できるため、複数の販売価格を個別に編集して条件が不統一になるリスクを減らせます。営業管理部門では、返された行を見積作成ツール、カタログ生成、承認表、顧客別価格の見直しへ渡せます。小規模事業者は公開前に、提案する小売価格と、上乗せ率の低い卸売・VIP価格を比較できます。アルゴリズムは決定論的なので、同じ入力からはブラウザーでもAPIでも必ず同じ結果が得られます。監査記録が必要な場合は、原価、ランク名、上乗せ率、計算価格をまとめて保存してください。各金額の根拠を正確に説明できます。税金、送料、決済手数料、最低広告価格、必要な粗利益率は、この計算の対象外ですので別途確認が必要です。APIの料金は1回$0.002で、ブラウザー版は簡単な対話操作にご利用いただけます。自動処理では1回につき最大100行を送信でき、入力エラーが返った場合は危険な値を黙認せず、価格データを修正してください。

活用例

原価変更後に価格を更新する

仕入先が原価を変更したとき、小売、卸売、VIPの価格をまとめて再計算できます。

顧客ランク別の見積価格を作る

各顧客区分に承認済みの上乗せ率を適用し、名称付き価格を見積業務へ渡せます。

価格方針を点検する

各ランクの結果を並べて比較し、価格表の公開前に負の上乗せ率を検出できます。

よくある質問

各ランクの価格はどのように計算しますか？

原価に、1とランク別上乗せ率を100で割った値との合計を掛けます。

独自のランク名を使えますか？

はい。小売、卸売、VIPは一例であり、制限内の空でない名称なら指定できます。

上乗せ率が負の場合はどうなりますか？

リクエスト全体が入力エラーになります。負の上乗せ率を割引として扱うことはありません。

上乗せ率と粗利益率は同じですか？

いいえ。上乗せ率は原価を基準にし、粗利益率は販売価格を基準にします。

価格はどのように丸められますか？

通貨向けの安定した結果になるよう、計算価格を小数点以下2桁に丸めます。

APIリクエストの料金はいくらですか？

APIは1リクエストにつき$0.002です。同じ決定論的計算をブラウザーでもご利用いただけます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/calc3/markup-price-ladder

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

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

curl -X POST https://api.kit.forhosting.com/calc3/markup-price-ladder \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_cost":40,"tiers":[{"tier":"Retail","markup_percent":50},{"tier":"Wholesale","markup_percent":20},{"tier":"VIP","markup_percent":10}]}'

const res = await fetch("https://api.kit.forhosting.com/calc3/markup-price-ladder", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "base_cost": 40,
    "tiers": [
      {
        "tier": "Retail",
        "markup_percent": 50
      },
      {
        "tier": "Wholesale",
        "markup_percent": 20
      },
      {
        "tier": "VIP",
        "markup_percent": 10
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/calc3/markup-price-ladder",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "base_cost": 40,
    "tiers": [
        {
            "tier": "Retail",
            "markup_percent": 50
        },
        {
            "tier": "Wholesale",
            "markup_percent": 20
        },
        {
            "tier": "VIP",
            "markup_percent": 10
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/calc3/markup-price-ladder", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"base_cost":40,"tiers":[{"tier":"Retail","markup_percent":50},{"tier":"Wholesale","markup_percent":20},{"tier":"VIP","markup_percent":10}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"base_cost":40,"tiers":[{"tier":"Retail","markup_percent":50},{"tier":"Wholesale","markup_percent":20},{"tier":"VIP","markup_percent":10}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/calc3/markup-price-ladder", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "base_cost": 40,
  "tiers": [
    {
      "tier": "Retail",
      "markup_percent": 50
    },
    {
      "tier": "Wholesale",
      "markup_percent": 20
    },
    {
      "tier": "VIP",
      "markup_percent": 10
    }
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_items 100

エラー

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

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