ForHosting KIT · PDF・文書ツール

明細と合計を計算して購入注文書を作成

承認済みの購買データを、アプリケーションごとに計算規則を作り直すことなく、一貫した構造の購入注文書へ変換できます。注文番号、買い手、仕入先に加え、説明、数量、単価を含む明細を1件以上ご指定ください。必須データを検証し、各行の金額と注文総額を計算したうえで、社内確認、長期保存、文書表示、正式承認、その他の購買工程に利用できる予測可能なオブジェクトを返します。

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

無料で実行 API仕様を見る

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

購入注文書のデータをすべてご用意ください

最初に、購買システムですでに採番された注文番号をご用意ください。生成機能は前後の空白を除いた値をそのまま保持し、識別子の新規作成、連番の確認、番号の予約は行いません。次に買い手と仕入先をご指定ください。これらの項目には、文書を表示するシステムの要件に応じて、短い法人名のほか、住所や登録情報を含む詳細な文字列も入力できます。明細を1件以上追加し、各行に具体的な説明、ゼロより大きい数値の数量、ゼロ以上の数値の単価をご入力ください。重量、長さ、時間など分割可能な単位で購入する商品やサービスには、小数の数量も使用できます。実際に無償の品目であれば単価ゼロを使用できますが、ゼロ以下の数量は注文を表さないため拒否されます。すべての単価で通貨と価格基準を統一してください。本機能は通貨、計量単位、支払条件、納期、税、値引き、送料を推測しません。これらの業務上の条件は、必要に応じて計算の前後で別途処理してください。

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

各行について数量と単価を乗算し、算出した行合計を小数第2位までに丸めます。次に、丸め済みの行合計を加算し、その合計も丸めて注文書の小計を算出します。本機能では税、送料、値引き、その他の調整額を受け取らないため、返される総額は小計と同じです。この明確な順序は、小数の数量や複数桁の小数を含む単価を扱う場合に重要です。丸めていない中間値を合計する別のシステムとは、1セント相当の差が生じる可能性があります。レスポンスには、正規化した説明、元の数値数量、丸めた単価、各品目の行合計が保持されます。文書レベルでは、文書種別、指定された注文番号、買い手、仕入先、明細配列、小計、総額を返します。すべての数値は有限でなければならず、数値に見える文字列を自動変換することはありません。負の単価も拒否されます。これらの規則により、不正な購買データを早期に発見し、テンプレート、承認画面、データベース、連携処理で共通の安定した計算規約をご利用いただけます。

購買ワークフローで構造化文書をご利用ください

購入申請の承認と注文番号の採番が完了し、編集可能な購買データを管理対象の注文記録へ移す段階で本機能をご利用ください。当事者名と明細を正規化して送信し、返されたオブジェクトを後続工程で使用する計算結果として保存します。テンプレートでHTMLやPDFに変換したり、承認サービスで総額を権限上限と比較したり、連携処理で明細をERPや仕入先ポータルへ転送したりできます。これらは別工程です。本機能は注文書の送信、仕入先への連絡、ファイル作成、予算の確保、在庫更新を行いません。ネットワーク、時刻、乱数、ストレージ、隠れた状態を使用しないため、同じリクエストからは常に同じレスポンスが得られます。再試行や監査時の比較も容易です。明細の欠落、当事者情報の空欄、注文番号の不足、数値でない金額などの検証エラーは、署名前に解決してください。APIリクエストの料金は $0.002 で、同じ純粋な計算をブラウザー体験にも使用できます。

活用例

承認済みの購入注文書を作成

承認済み申請の明細を、一貫した計算済み合計を持つ構造化注文書へ変換します。

購買入力フォームを構築

担当者が確認・表示用データを準備する間に、行金額と注文総額を計算します。

購買連携の計算を統一

社内アプリケーションと仕入先ワークフローへ、単一の決定論的な計算規約を提供します。

よくある質問

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

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

明細がない場合はどうなりますか？

すべての購入注文書には1件以上の明細が必要なため、入力エラーを返します。

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

数量と単価を乗算して小数第2位までに丸め、丸め済みの行合計を加算して再度丸めます。

注文番号は自動的に割り当てられますか？

いいえ。注文番号をご指定いただき、結果では構造化文書の一部として保持します。

税、通貨、PDFも結果に含まれますか？

いいえ。構造化データと計算済み合計を返します。税、通貨表示、文書化、送信は別工程です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/doc/purchase-order-generate

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

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

curl -X POST https://api.kit.forhosting.com/doc/purchase-order-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"po_number":"PO-2026-0142","buyer":"Contoso Retail","vendor":"Northwind Supplies","line_items":[{"description":"Ergonomic keyboard","quantity":12,"unit_cost":79.95},{"description":"USB-C dock","quantity":5,"unit_cost":149.5}]}'

const res = await fetch("https://api.kit.forhosting.com/doc/purchase-order-generate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "po_number": "PO-2026-0142",
    "buyer": "Contoso Retail",
    "vendor": "Northwind Supplies",
    "line_items": [
      {
        "description": "Ergonomic keyboard",
        "quantity": 12,
        "unit_cost": 79.95
      },
      {
        "description": "USB-C dock",
        "quantity": 5,
        "unit_cost": 149.5
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/doc/purchase-order-generate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "po_number": "PO-2026-0142",
    "buyer": "Contoso Retail",
    "vendor": "Northwind Supplies",
    "line_items": [
        {
            "description": "Ergonomic keyboard",
            "quantity": 12,
            "unit_cost": 79.95
        },
        {
            "description": "USB-C dock",
            "quantity": 5,
            "unit_cost": 149.5
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/doc/purchase-order-generate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"po_number":"PO-2026-0142","buyer":"Contoso Retail","vendor":"Northwind Supplies","line_items":[{"description":"Ergonomic keyboard","quantity":12,"unit_cost":79.95},{"description":"USB-C dock","quantity":5,"unit_cost":149.5}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"po_number":"PO-2026-0142","buyer":"Contoso Retail","vendor":"Northwind Supplies","line_items":[{"description":"Ergonomic keyboard","quantity":12,"unit_cost":79.95},{"description":"USB-C dock","quantity":5,"unit_cost":149.5}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/doc/purchase-order-generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "po_number": "PO-2026-0142",
  "buyer": "Contoso Retail",
  "vendor": "Northwind Supplies",
  "line_items": [
    {
      "description": "Ergonomic keyboard",
      "quantity": 12,
      "unit_cost": 79.95
    },
    {
      "description": "USB-C dock",
      "quantity": 5,
      "unit_cost": 149.5
    }
  ]
}

レスポンス例

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