最小限のリクエスト例（必須パラメータのみ）

curl -X POST https://api.miryo.ai/api/invoices/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "issuer": {
      "company": "miryo.AI株式会社"
    },
    "customer": {
      "company": "サンプル株式会社"
    },
    "invoice": {
      "subject": "Webシステム開発費用（2025年11月分）",
      "items": [
        {
          "name": "開発作業",
          "quantity": 10,
          "unitPrice": 80000,
          "amount": 800000
        }
      ]
    }
  }' \
  --output invoice.pdf

完全なリクエスト例（全オプション指定）

curl -X POST https://api.miryo.ai/api/invoices/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "issuer": {
      "company": "miryo.AI株式会社",
      "email": "info@miryo.ai",
      "phone": "050-1725-6435",
      "address": "東京都港区1-2-3 ミリョービル5F",
      "contactPerson": "経理部 佐藤次郎",
      "registrationNumber": "T1234567890123"
    },
    "customer": {
      "company": "サンプル株式会社",
      "name": "田中花子",
      "email": "tanaka@sample.co.jp",
      "phone": "03-9876-5432",
      "department": "情報システム部",
      "position": "部長",
      "nameKana": "タナカ ハナコ",
      "zipCode": "150-0001",
      "address": "東京都渋谷区神宮前1-1-1"
    },
    "invoice": {
      "invoiceNumber": "INV-2025-11-001",
      "invoiceDate": "2025-11-30T00:00:00.000Z",
      "paymentDueDate": "2025-12-31T23:59:59.000Z",
      "subject": "Webシステム開発費用（2025年11月分）",
      "items": [
        {
          "name": "要件定義",
          "majorCategory": "設計・開発",
          "description": "業務フロー分析、機能要件定義書作成（完了）",
          "quantity": 10,
          "unitPrice": 80000,
          "amount": 800000
        },
        {
          "name": "基本設計",
          "majorCategory": "設計・開発",
          "quantity": 15,
          "unitPrice": 80000,
          "amount": 1200000
        }
      ],
      "bankAccount": {
        "bankName": "みずほ銀行",
        "branchName": "渋谷支店",
        "accountType": "普通",
        "accountNumber": "1234567",
        "accountHolder": "ミリョーエーアイ(カ"
      },
      "taxRate": 0.1,
      "paymentTerms": "月末締め翌月末払い",
      "notes": "※お支払期日は2025年12月31日です。\n※振込手数料はご負担願います。",
      "showItemDescription": true,
      "qualifiedInvoice": true,
      "fontSize": {
        "customerCompany": 20,
        "customerName": 16
      },
      "tableColumns": {
        "showNo": true,
        "showMajorCategory": true
      }
    }
  }' \
  --output invoice.pdf

リクエストパラメータ

レスポンス

PDF Binary Data (application/pdf)

Response Headers:
Content-Type: application/pdf
Content-Disposition: attachment; filename="invoice-INV-2025-11-001.pdf"
X-Invoice-Number: INV-2025-11-001

注: 請求番号がリクエストで指定されていない場合、自動生成された番号がX-Invoice-Numberヘッダーに含まれます。

エラーレスポンス

{
  "error": "Invalid request data",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "received": "undefined",
      "path": ["customer", "email"],
      "message": "Required"
    }
  ]
}

{
  "error": "API key is required"
}

サンプルコード

const axios = require('axios');
const fs = require('fs');

async function generateInvoice() {
  const response = await axios.post(
    'https://api.miryo.ai/api/invoices/generate',
    {
      issuer: { 
        company: 'miryo.AI株式会社',
        registrationNumber: 'T1234567890123'
      },
      customer: {
        company: 'サンプル株式会社',
        name: '田中花子',
        email: 'tanaka@sample.co.jp',
        phone: '03-9876-5432'
      },
      invoice: {
        subject: 'Webシステム開発費用（2025年11月分）',
        items: [{
          name: '開発作業',
          quantity: 10,
          unitPrice: 80000,
          amount: 800000  // quantity × unitPrice
        }],
        qualifiedInvoice: true
      }
    },
    {
      headers: { 'x-api-key': 'your_api_key_here' },
      responseType: 'arraybuffer'
    }
  );

  fs.writeFileSync('invoice.pdf', response.data);
  console.log('Invoice Number:', response.headers['x-invoice-number']);
}

import requests

def generate_invoice():
    response = requests.post(
        'https://api.miryo.ai/api/invoices/generate',
        headers={'x-api-key': 'your_api_key_here'},
        json={
            'issuer': {
                'company': 'miryo.AI株式会社',
                'registrationNumber': 'T1234567890123'
            },
            'customer': {
                'company': 'サンプル株式会社',
                'name': '田中花子',
                'email': 'tanaka@sample.co.jp',
                'phone': '03-9876-5432'
            },
            'invoice': {
                'subject': 'Webシステム開発費用（2025年11月分）',
                'items': [{
                    'name': '開発作業',
                    'quantity': 10,
                    'unitPrice': 80000,
                    'amount': 800000  # quantity × unitPrice
                }],
                'qualifiedInvoice': True
            }
        }
    )

    with open('invoice.pdf', 'wb') as f:
        f.write(response.content)

    invoice_number = response.headers.get('X-Invoice-Number')
    if invoice_number:
        print('Invoice Number:', invoice_number)

注意事項

• 【重要】amount = quantity × unitPrice で計算してください
• 【日付フォーマット】ISO 8601形式で指定（例: "2025-11-30T00:00:00.000Z"）
• 【税率】デフォルト0.1 (10%)。0.0～1.0の範囲で指定可能
• 【適格請求書】適格請求書として発行する場合は、qualifiedInvoiceをtrueに設定し、issuer.registrationNumber（インボイス登録番号）を設定してください
• 【自動改ページ】コンテンツに応じて自動的に改ページされます
• 【データ保存】このAPIは請求書を保存しません。PDF生成のみを行います