Beta

Správa zákaziek

End-to-end API na podávanie a sťahovanie ponúk na 5 portáloch verejného obstarávania. Šifrovanie, upload súborov a step-by-step logging — všetko cez jednotné REST API. Aktuálne v beta testovaní — pre prístup nás kontaktujte.

Podporované portály

GET/api/v2/procurement/portalsZoznam portálov

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étnej inštancie.

Podanie ponuky

POST/api/v2/procurement/bidsVytvoriť job (50 kreditov)

Body parametre

Parameter	Typ	Popis
portal*	string	NEN \| EZAK \| TENDERARENA \| EVEZA \| EZAKAZKY
tenderId*	string	ID zákazky na portáli
credentialId	string	ID uloženého prístupu (alebo credentials)
credentials	object	Objekt s fieldmi username, password a (voliteľne) portalUrl — alternatíva ku credentialId
files	array	Pole objektov (name, url, size) — súbory ponuky
criteria	array	Pole objektov (name, value) — hodnotiace kritériá
tenderTitle	string	Názov zákazky (pre prehľad)
dryRun	boolean	true = test bez finálneho odoslania

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": "ponuka.pdf", "url": "https://..."}],
    "criteria": [{"name": "Ponuková cena", "value": "1500000"}]
  }'

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

Stav jobu

GET/api/v2/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}
  ]
}

Zoznam ponúk

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

Stiahnutie ponuky

DELETE/api/v2/procurement/bids/:jobIdWithdraw (20 kreditov)

Body parametre

Parameter	Typ	Popis
reason	string	Dôvod stiahnutia (voliteľné)

AI analýza

POST/api/v2/procurement/analyzeSpustiť analýzu (10 kreditov)

Parameter	Typ	Popis
tenderId*	string	ID zákazky v RWX databáze

Vracia štruktúrovaný JSON s 50+ poľami: názov, hodnota, kritériá, kvalifikácia, riziká, AI odporúčania, odhad šance na výhru.

Prístupy k portálom

Portálové prístupy spravujete v dashboarde na /dashboard/procurement/credentials. Heslá sú šifrované AES-256-GCM a nikdy sa neukladajú v plaintexte.

Kreditové náklady

Parameter	Typ	Popis
Podanie ponuky	POST bids	50 kreditov
Stiahnutie ponuky	DELETE bids/:id	20 kreditov
AI analýza	POST analyze	10 kreditov
Čítanie (zoznam, detail)	GET	1 kredit
Zoznam portálov	GET portals	0 kreditov

Workflow

Typický postup: 1) Uložiť credentials v dashboarde → 2) Otestovať prihlásenie → 3) Nájsť zákazku (GET tenders) → 4) Analyzovať dokumentáciu (POST analyze) → 5) Podať ponuku (POST bids) → 6) Sledovať stav (GET bids/:jobId)