Beta

Správa zakázek

End-to-end API pro podávání a stahování nabídek na 5 portálech veřejných zakázek. Šifrování, upload souborů a step-by-step logging — vše přes jednotné REST API. Aktuálně v beta testování — pro přístup nás kontaktujte.

Podporované portály

GET/api/v1/procurement/portalsSeznam portálů

NEN (nen.nipez.cz), E-ZAK (instance URL), TenderArena, Eveza (instance URL), E-zakazky.cz (instance URL). Portály E-ZAK, Eveza a E-zakazky vyžadují portalUrl — URL konkrétní instance.

Podání nabídky

POST/api/v1/procurement/bidsVytvořit job (50 kreditů)

Body parametry

Parametr	Typ	Popis
portal*	string	NEN \| EZAK \| TENDERARENA \| EVEZA \| EZAKAZKY
tenderId*	string	ID zakázky na portálu
credentialId	string	ID uloženého přístupu (nebo credentials)
credentials	object	{username, password, portalUrl?} — alternativa k credentialId
files	array	[{name, url, size}] — soubory nabídky
criteria	array	[{name, value}] — hodnotící kritéria
tenderTitle	string	Název zakázky (pro přehled)
dryRun	boolean	true = test bez finálního odeslání

curl -X POST https://api.mrickwood.cz/api/v1/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": "Nabídková cena", "value": "1500000"}]
  }'

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

Stav jobu

GET/api/v1/procurement/bids/:jobIdDetail + kroky (1 kredit)

{
  "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}
  ]
}

Seznam nabídek

GET/api/v1/procurement/bidsMoje joby (1 kredit)

Stažení nabídky

DELETE/api/v1/procurement/bids/:jobIdWithdraw (20 kreditů)

Body parametry

Parametr	Typ	Popis
reason	string	Důvod stažení (volitelné)

AI analýza

POST/api/v1/procurement/analyzeSpustit analýzu (10 kreditů)

Parametr	Typ	Popis
tenderId*	string	ID zakázky v RWX databázi

Vrací strukturovaný JSON s 50+ poli: název, hodnota, kritéria, kvalifikace, rizika, AI doporučení, odhad šance na výhru.

Přístupy k portálům

Portálové přístupy spravujete v dashboardu na /dashboard/procurement/credentials. Hesla jsou šifrována AES-256-GCM a nikdy se neukládají v plaintextu.

Kreditové náklady

Parametr	Typ	Popis
Podání nabídky	POST bids	50 kreditů
Stažení nabídky	DELETE bids/:id	20 kreditů
AI analýza	POST analyze	10 kreditů
Čtení (seznam, detail)	GET	1 kredit
Seznam portálů	GET portals	0 kreditů

Workflow

Typický postup: 1) Uložit credentials v dashboardu → 2) Otestovat login → 3) Najít zakázku (GET tenders) → 4) Analyzovat dokumentaci (POST analyze) → 5) Podat nabídku (POST bids) → 6) Sledovat stav (GET bids/:jobId)