ForHosting KIT · PDF・文書ツール

明細・税額・合計を自動計算して請求書を作成

請求計算の規則をアプリケーションごとに実装せず、基本的な請求データを一貫した構造の請求書へ変換できます。販売者、購入者、明細、数量、単価、パーセント表記の税率をご指定ください。各行の金額、小計、税額、総合計を計算し、入力値と計算値を予測可能なオブジェクトとして返します。保存、確認、画面表示、後続ワークフローへの受け渡しにご利用いただけます。

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

無料で実行 API仕様を見る

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

請求書に必要な情報をご用意ください

まず、取引の当事者を指定してください。販売者と購入者の欄には、名称に加えて、後続処理で保持する必要がある住所、登録情報、連絡先も記載できます。次に、1件以上の明細を追加します。各行には、分かりやすい説明、数値の数量、数値の単価が必要です。税率はパーセントで指定するため、8.25パーセントの場合は0.0825ではなく8.25と入力してください。時間、重量、距離など、分割可能な単位で請求する場合は小数の数量も使用でき、単価にも小数を指定できます。負の数量や単価は、不正な請求書または別途クレジットノートで処理すべき調整を示すことが多いため拒否されます。実際に無料の項目を請求書に載せる場合に限り、ゼロをご使用ください。説明を具体的にすると、完成した文書を注文書、納品記録、契約書と照合しやすくなります。リクエストには日付や自動生成IDがないため、同じ入力からは常に同じ出力が得られます。

各金額の計算方法をご確認ください

各行について数量と単価を乗算し、得られた行合計を小数第2位までに丸めます。次に、丸め済みの行合計を加算して小計を算出します。税額は、その小計に指定された税率を掛けて計算し、同様に小数第2位までに丸めます。最後に、丸めた税額を小計へ加えて総合計を求めます。この順序は明示的で決定論的です。会計システムによって丸める段階が異なると結果に差が生じるため、この点は重要です。出力には、送信された説明と数量を保持し、単価を金額として示し、各行へline_totalを追加します。文書全体には販売者と購入者に加え、subtotal、tax_rate、tax、grand_totalが含まれます。通貨換算や通貨の推測は行いません。すべての価格には呼び出し側が選んだ同一通貨をご使用ください。構造化レスポンスは、テンプレート、データベース、承認処理、API連携で利用できる計算・文書データであり、PDFや画像ではありません。

請求ワークフローへ安全に組み込んでください

編集可能な注文データを正式な請求記録へ変換する地点で、この機能をご利用ください。最初に、当事者、通貨、課税管轄を確認し、割引、源泉徴収、複数税率、クレジット調整が必要か判断します。その後、正規化した明細を送信し、返されたオブジェクトを計算結果として保存してください。このアルゴリズムはネットワーク、乱数、時刻、隠れた状態を使用しないため、同一リクエストを安全に再実行でき、監査時にも比較できます。必須項目の不足、数値でない金額、空または上限超過の明細、負の税率、特に負の数量や単価にはエラーを返します。請求書番号の付与や顧客への送信前に、これらのエラーをご解決ください。結果はHTMLテンプレート、会計インポート、添付ファイル生成、承認キューへ渡せますが、それらの処理は分離されています。この分離により計算をテストでき、表示処理が合計を密かに変更することを防げます。APIリクエストは $0.002 で、ブラウザーでも同じ純粋な計算ロジックを使用します。

活用例

承認済み注文の請求書を作成

正規化した注文明細を、一貫した明細金額・税額を持つ構造化請求書へ変換します。

請求書入力フォームを構築

当事者、明細、税率の入力中に合計を計算し、表示処理へ結果を渡します。

請求連携の計算を統一

会計登録や承認の前に、複数のアプリケーションへ同じ決定論的な計算規約を提供します。

よくある質問

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

APIリクエスト1回につき $0.002 です。

税率はどのように指定しますか？

パーセントの数値で指定してください。例えば8.25パーセントの場合は8.25を使用します。

金額はどのように丸められますか？

各行の合計を小数第2位までに丸め、その合計から小計を作り、税額を計算して同様に丸めます。

返金に負の数量や価格を使えますか？

いいえ。負の数量または単価は入力エラーになります。専用のクレジットノート処理をご利用ください。

PDFや請求書番号も含まれますか？

いいえ。計算済み合計を持つ構造化データを返します。表示、採番、通貨表記、送付は別工程です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/doc/invoice-generate

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

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

curl -X POST https://api.kit.forhosting.com/doc/invoice-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seller":"Northwind Studio","buyer":"Contoso Retail","line_items":[{"description":"Design consultation","quantity":2,"unit_price":125},{"description":"Style guide","quantity":1,"unit_price":80.5}],"tax_rate":8.25}'

const res = await fetch("https://api.kit.forhosting.com/doc/invoice-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "seller": "Northwind Studio",
    "buyer": "Contoso Retail",
    "line_items": [
      {
        "description": "Design consultation",
        "quantity": 2,
        "unit_price": 125
      },
      {
        "description": "Style guide",
        "quantity": 1,
        "unit_price": 80.5
      }
    ],
    "tax_rate": 8.25
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/doc/invoice-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "seller": "Northwind Studio",
    "buyer": "Contoso Retail",
    "line_items": [
        {
            "description": "Design consultation",
            "quantity": 2,
            "unit_price": 125
        },
        {
            "description": "Style guide",
            "quantity": 1,
            "unit_price": 80.5
        }
    ],
    "tax_rate": 8.25
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/invoice-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"seller":"Northwind Studio","buyer":"Contoso Retail","line_items":[{"description":"Design consultation","quantity":2,"unit_price":125},{"description":"Style guide","quantity":1,"unit_price":80.5}],"tax_rate":8.25}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"seller":"Northwind Studio","buyer":"Contoso Retail","line_items":[{"description":"Design consultation","quantity":2,"unit_price":125},{"description":"Style guide","quantity":1,"unit_price":80.5}],"tax_rate":8.25}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/invoice-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "seller": "Northwind Studio",
  "buyer": "Contoso Retail",
  "line_items": [
    {
      "description": "Design consultation",
      "quantity": 2,
      "unit_price": 125
    },
    {
      "description": "Style guide",
      "quantity": 1,
      "unit_price": 80.5
    }
  ],
  "tax_rate": 8.25
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

`max_mb`	25
`max_pages`	200

エラー

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

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