APIドキュメント

ベースURL: https://jp-pint-rryxbfcsxq-an.a.run.app ・ OpenAPI

1. 登録番号チェック（無料・キー不要）

GET /v1/registration/T2010401021385
# → { "number": "T2010401021385", "valid": true, "errors": [] }

「T+13桁」の形式と、法人番号の検査用数字（チェックディジット）を検証します。

2. 無料キー取得

curl -X POST $BASE/v1/keys -H "content-type: application/json" -d '{"email":"you@co.com"}'
# → { "api_key": "jpp_live_...", "free_limit": 200 }

3. 適格請求書の検証

POST /v1/validate ・ヘッダ x-api-key: jpp_live_... ・ JSON body:

{
  "seller_name": "サンプル合同会社",
  "registration_number": "T2010401021385",
  "issue_date": "2026-06-18",
  "recipient_name": "取引先株式会社",
  "lines": [
    { "description": "コンサルティング費用", "amount": 100000, "tax_rate": 0.1 },
    { "description": "新聞図書費（軽減税率対象）", "amount": 10000, "tax_rate": 0.08 }
  ],
  "tax_summary": [
    { "tax_rate": 0.1, "taxable_amount": 100000, "tax_amount": 10000 },
    { "tax_rate": 0.08, "taxable_amount": 10000, "tax_amount": 800 }
  ]
}
# → { "valid": true, "errors": [], "warnings": [] }

記載事項（適格請求書）

項目	内容
seller_name	発行者の氏名又は名称（必須）
registration_number	登録番号 T+13桁（必須・チェックディジット検証）
issue_date	取引年月日（必須）
recipient_name	交付を受ける事業者の氏名又は名称（必須）
lines[]	取引内容 { description, amount, tax_rate }。軽減税率対象は description に明記。tax_rate は 0.1 / 0.08 / 0
tax_summary[]	税率ごとに区分した対価・消費税額 { tax_rate, taxable_amount, tax_amount }

エラー

コード	意味
401	x-api-key が無い/不正
402	無料枠（200件/月）超過
429	レート制限

4. MCP（AIエージェント向け）

{
  "mcpServers": {
    "jp-pint": { "command": "npx", "args": ["github:junju523/jp-pint-mcp"], "env": { "JP_PINT_KEY": "jpp_live_..." } }
  }
}

ツール: check_registration_number(number) / validate_invoice(invoice)。

注記

本APIは送信されたデータの検証のみを行い、請求書の内容は保存しません（キーの利用回数のみ記録）。検証結果は参考用です。最終的な税務判断は専門家にご確認ください。