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

curl -X POST https://api.miryo.ai/api/purchase-orders/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "issuer": {
      "company": "miryo.AI株式会社"
    },
    "customer": {
      "company": "サンプルシステム株式会社"
    },
    "order": {
      "subject": "Webシステム開発業務委託",
      "items": [
        {
          "name": "開発作業",
          "quantity": 1,
          "unitPrice": 1000000,
          "amount": 1000000
        }
      ]
    }
  }' \
  --output purchase-order.pdf

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

curl -X POST https://api.miryo.ai/api/purchase-orders/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": "購買部 佐藤次郎"
    },
    "customer": {
      "company": "サンプルシステム株式会社",
      "name": "山田太郎",
      "email": "yamada@sample-system.co.jp",
      "phone": "03-1234-5678",
      "department": "開発部",
      "position": "部長",
      "nameKana": "ヤマダ タロウ",
      "zipCode": "150-0001",
      "address": "東京都渋谷区神宮前1-1-1"
    },
    "order": {
      "orderNumber": "PO-2025-12-001",
      "orderDate": "2025-12-07T00:00:00.000Z",
      "deliveryDate": "2025-12-31T00:00:00.000Z",
      "subject": "Webシステム開発業務委託",
      "items": [
        {
          "name": "要件定義・基本設計",
          "majorCategory": "設計",
          "description": "業務フロー分析、機能要件定義書作成、画面設計",
          "quantity": 1,
          "unitPrice": 500000,
          "amount": 500000
        },
        {
          "name": "詳細設計・開発",
          "majorCategory": "開発",
          "quantity": 1,
          "unitPrice": 800000,
          "amount": 800000
        }
      ],
      "taxRate": 0.1,
      "paymentTerms": "検収完了後、翌月末払い",
      "notes": "■ 納品物：ソースコード一式、設計書\n■ 検収期間：納品後2週間",
      "showItemDescription": true,
      "fontSize": {
        "customerCompany": 20,
        "customerName": 16
      },
      "tableColumns": {
        "showNo": true,
        "showMajorCategory": true
      }
    }
  }' \
  --output purchase-order.pdf

リクエストパラメータ

レスポンス

PDF Binary Data (application/pdf)

Response Headers:
Content-Type: application/pdf
Content-Disposition: attachment; filename="purchase-order-PO-2025-12-001.pdf"
X-Order-Number: PO-2025-12-001

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

エラーレスポンス

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

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

サンプルコード

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

async function generatePurchaseOrder() {
  const response = await axios.post(
    'https://api.miryo.ai/api/purchase-orders/generate',
    {
      issuer: { 
        company: 'miryo.AI株式会社',
        contactPerson: '購買部 佐藤次郎'
      },
      customer: {
        company: 'サンプルシステム株式会社',
        name: '山田太郎',
        email: 'yamada@sample-system.co.jp',
        phone: '03-1234-5678'
      },
      order: {
        subject: 'Webシステム開発業務委託',
        deliveryDate: '2025-12-31T00:00:00.000Z',
        items: [{
          name: '開発作業',
          quantity: 1,
          unitPrice: 1000000,
          amount: 1000000  // quantity × unitPrice
        }]
      }
    },
    {
      headers: { 'x-api-key': 'your_api_key_here' },
      responseType: 'arraybuffer'
    }
  );

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

import requests

def generate_purchase_order():
    response = requests.post(
        'https://api.miryo.ai/api/purchase-orders/generate',
        headers={'x-api-key': 'your_api_key_here'},
        json={
            'issuer': {
                'company': 'miryo.AI株式会社',
                'contactPerson': '購買部 佐藤次郎'
            },
            'customer': {
                'company': 'サンプルシステム株式会社',
                'name': '山田太郎',
                'email': 'yamada@sample-system.co.jp',
                'phone': '03-1234-5678'
            },
            'order': {
                'subject': 'Webシステム開発業務委託',
                'deliveryDate': '2025-12-31T00:00:00.000Z',
                'items': [{
                    'name': '開発作業',
                    'quantity': 1,
                    'unitPrice': 1000000,
                    'amount': 1000000  # quantity × unitPrice
                }],
                'notes': '■ 納品物：ソースコード一式、設計書\n■ 検収期間：納品後2週間'
            }
        }
    )

    with open('purchase-order.pdf', 'wb') as f:
        f.write(response.content)

    order_number = response.headers.get('X-Order-Number')
    if order_number:
        print('Order Number:', order_number)

請求書APIとの違い

注意事項

• 【重要】amount = quantity × unitPrice で計算してください
• 【重要】発注書では customer.name（発注先担当者名）が必須です
• 【日付フォーマット】ISO 8601形式で指定（例: "2025-12-07T00:00:00.000Z"）
• 【税率】デフォルト0.1 (10%)。0.0～1.0の範囲で指定可能
• 【自動改ページ】コンテンツに応じて自動的に改ページされます
• 【データ保存】このAPIは発注書を保存しません。PDF生成のみを行います