TRANSMIT
概要ページに戻る

インボイス OCR API

インボイス画像からデータを抽出し、構造化されたJSON形式で返します

概要

  • Base URL: https://ai.transmit.work/v1
  • 認証方式: Bearer Token
  • レスポンス形式: JSON

認証

APIキーを使用した認証

すべてのリクエストには認証ヘッダーが必須です（以下のいずれか）

方法1: Authorization ヘッダー（推奨）

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.jpg" \
  /invoice/api

方法2: X-API-Key ヘッダー

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@document.jpg" \
  /invoice/api

エンドポイント

POST/invoice/api

インボイス画像からデータを抽出し、構造化されたJSON形式で返します

Content-Type

multipart/form-data

最大ファイルサイズ

4.5MB

対応フォーマット

JPG, PNG, JPEG, PDF

請求書データ抽出

インボイス画像から構造化データを抽出し、構造化されたJSONで返します

リクエストパラメータ

filerequired

画像ファイル（multipart/form-data）
対応形式: JPG, PNG, JPEG, PDF

レスポンス例

成功（200）

{
  "success": true,
  "data": {
    "invoice": {
      "currency": "JPY",
      "invoice_number": "INV-2025-001",
      "invoice_date": "2025-02-01",
      "invoice_amount": 50000,
      "payment_due_date": "2025-03-01",
      "invoice_registration_number": "T1234567890123",
      "subject": "システム開発費のご請求",
      "billing_from_name": "サンプル株式会社",
      "billing_to_name": "取引先株式会社",
      "billing_account_name": "サンプル株式会社"
    },
    "line_items": [
      {
        "name": "システム開発費",
        "quantity": 1,
        "unit_price": 45455,
        "amount": 45455,
        "tax_rate": 10
      }
    ],
    "bank_transfer": {
      "bank_name": "○○銀行",
      "branch_name": "△△支店",
      "account_number": "1234567",
      "account_holder_kana": "カブシキガイシャ"
    },
    "extractedAt": "2025-02-10T15:35:20.123Z",
    "averageConfidence": 0.96
  }
}

エラー

{
  "success": false,
  "error": {
    "code": "EXTRACTION_FAILED",
    "message": "データ抽出に失敗しました",
    "details": "画像の処理中にエラーが発生しました",
    "level": "error"
  }
}

フィールド説明

インボイス情報
インボイス基本情報
currency

string

通貨

請求書に記載された通貨（JPY, USD, EUR, GBP のいずれか。文書から自動判定）

invoice_number

string

インボイス番号

インボイスの識別番号

invoice_date

string

発行日

YYYY-MM-DD形式のインボイス発行日

invoice_amount

number

請求金額

インボイスの合計金額（currency フィールドの通貨単位）

payment_due_date

string

支払期限

YYYY-MM-DD形式の支払期限

invoice_registration_number

string

インボイス登録番号

T + 13桁の形式（インボイス制度対応）

subject

string

件名

請求書の件名/タイトル

billing_from_name

string

請求元名

請求書を発行した企業名または個人名（差出人/供給者側、振込先口座名義人と同一主体）

billing_to_name

string

請求先名

請求書上部の宛先企業名または個人名（請求を受ける側）

billing_account_name

string

請求元名（互換）

billing_from_name と同じ値（既存API互換のため維持）

内訳（明細）
請求明細の配列。トップレベルの独立した配列で、invoice の各フィールドから導出される必要はなく、独立して取得・設定できる。
line_items

object[]

内訳

請求明細の配列（トップレベル / invoice とは独立）。各要素: name（品目名）, quantity（数���）, unit_price（単価、invoice.currency の通貨単位）, amount（金額、invoice.currency の通貨単位）, tax_rate（税率）。明細が無い場合は空配列。

銀行振込情報
支払先銀行口座情報
bank_name

string

銀行名

支払先銀行名

bank_code

string

銀行コード

銀行の識別コード（4桁の数字形式チェックは通貨がJPYの場合のみ適用）

branch_name

string

支店名

支払先支店名

branch_code

string

支店コード

支店の識別コード（3桁の数字形式チェックは通貨がJPYの場合のみ適用）

account_number

string

口座番号

支払先口座番号

エラーコード

INVALID_FILE_FORMAT

ファイル形式がサポートされていません

対応形式: JPG, PNG, JPEG

FILE_TOO_LARGE

ファイルサイズが大きすぎます

最大サイズ: 2MB

EXTRACTION_FAILED

データ抽出に失敗しました

PDFの処理中にエラーが発生しました

LOW_QUALITY

画像品質が低すぎます

より鮮明な画像を提供してください

APIキーの発行をご希望の方

まずはご登録でお試しいただけます

デモを試すお問い合わせ