ベータ

入札管理

5つの公共調達ポータルへの入札提出・取得に対応したエンドツーエンドAPI。暗号化、ファイルアップロード、ステップバイステップのログ記録 — すべて統一されたREST APIを通じて提供。現在ベータテスト中 — アクセスをご希望の方はお問い合わせください。

対応ポータル

GET/api/v2/procurement/portalsポータル一覧

NEN (nen.nipez.cz)、E-ZAK（インスタンスURL）、TenderArena、Eveza（インスタンスURL）、E-zakazky.cz（インスタンスURL）。E-ZAK、Eveza、E-zakazkyの各ポータルにはportalUrl — 特定インスタンスのURLが必要です。

入札書類の提出

POST/api/v2/procurement/bidsジョブを作成する（50クレジット）

ボディパラメータ

パラメータ	種別	説明
portal*	string	NEN \| EZAK \| TENDERARENA \| EVEZA \| EZAKAZKY
tenderId*	string	ポータル上の案件ID
credentialId	string	保存済みアクセスのID（またはcredentials）
credentials	object	username、password、および（任意）portalUrl のフィールドを持つオブジェクト — credentialId の代替
files	array	オブジェクトの配列（name、url、size）— 入札ファイル
criteria	array	オブジェクトの配列（name、value）— 評価基準
tenderTitle	string	案件名（概要表示用）
dryRun	boolean	true = 最終送信なしのテスト

curl -X POST https://veritra.io/api/v2/procurement/bids \
  -H "X-API-Key: mrw_procurement_..." \
  -H "Content-Type: application/json" \
  -d '{
    "portal": "NEN",
    "tenderId": "N006-24-V00012345",
    "credentialId": "clx1abc...",
    "files": [{"name": "nabidka.pdf", "url": "https://..."}],
    "criteria": [{"name": "入札価格", "value": "1500000"}]
  }'

{
  "jobId": "clx1abc...",
  "status": "PENDING",
  "message": "Job created — will be processed by cron"
}

ジョブのステータス

GET/api/v2/procurement/bids/:jobId詳細 + ステップ（1クレジット）

{
  "id": "clx1abc...",
  "type": "SUBMIT_BID",
  "status": "COMPLETED",
  "portal": "NEN",
  "steps": [
    {"step": 1, "action": "login", "status": "ok", "durationMs": 1240},
    {"step": 2, "action": "load_tender", "status": "ok", "durationMs": 890},
    {"step": 3, "action": "encrypt", "status": "ok", "durationMs": 320},
    {"step": 4, "action": "upload_file", "status": "ok", "durationMs": 2100},
    {"step": 5, "action": "submit", "status": "ok", "durationMs": 1560}
  ]
}

入札一覧

GET/api/v2/procurement/bidsマイジョブ（1クレジット）

入札の取り下げ

DELETE/api/v2/procurement/bids/:jobId取り下げ（20クレジット）

ボディパラメータ

パラメータ	種別	説明
reason	string	取り下げ理由（任意）

AI分析

POST/api/v2/procurement/analyze分析を実行する（10クレジット）

パラメータ	種別	説明
tenderId*	string	RWXデータベース内の案件ID

名称、金額、基準、資格要件、リスク、AIによる推奨事項、落札確率の推定など、50以上のフィールドを含む構造化JSONを返します。

ポータルアクセス

ポータルアクセスはダッシュボードで管理します：/dashboard/procurement/credentials。パスワードはAES-256-GCMで暗号化され、平文では保存されません。

クレジット費用

パラメータ	種別	説明
入札書類の提出	POST bids	50クレジット
入札の取り下げ	DELETE bids/:id	20クレジット
AI分析	POST analyze	10クレジット
読み取り（一覧、詳細）	GET	1クレジット
ポータル一覧	GET portals	0 クレジット

ワークフロー

標準的な手順：1) ダッシュボードで認証情報を保存 → 2) ログインをテスト → 3) 案件を検索（GET tenders）→ 4) ドキュメントを分析（POST analyze）→ 5) 入札を提出（POST bids）→ 6) ステータスを確認（GET bids/:jobId）