Przetargowy Janusz — Polish public tenders

Adds a tender to the signed-in company's 'Moje przetargi' — the same as 'Dodaj do Moich' in Przetargowy Janusz: a new entry in the first kanban column, 'Do przejrzenia' (one removed earlier comes back there). Its AI summary is not ordered — request_summary does that. A tender already there — also as its copy from another portal — stays as it is, and the answer gives the entry that is there. By tender_id (from search_tenders, list_matched_tenders or get_tender) or public slug. Returns the result (added / restored / already), the status and the workspace link. Requires OAuth authentication and a trial or paid plan.

Sets the offer price (net PLN) of a tender in 'Moje przetargi' — the same as choosing the price in Przetargowy Janusz: one of Janusz's price variants (aggressive, realistic, higher — listed in get_my_tender fill_details.price_proposals) or variant 'manual' with amount. The price goes into the offer documents; it is the price the user states or picks. Requires OAuth authentication and a trial or paid plan.

Resolve CPV codes to their Polish labels. Pass an array of codes, with or without the check digit (e.g. ['45000000-7', '79952000']); each label comes with the full code. Requires OAuth authentication and a trial or paid plan.

Resolve free-text to CPV codes (the EU Common Procurement Vocabulary used to classify tenders). Returns matching codes with Polish labels. Use the codes with list_tenders filter='category' (division = first 8 digits). Requires OAuth authentication and a trial or paid plan.

Walk the CPV hierarchy. Omit `parent` for top-level divisions; pass a code, with or without the check digit (e.g. '45000000-7' or '45000000'), to list its children. Each node flags whether it has children. Requires OAuth authentication and a trial or paid plan.

Profile of one contracting authority (zamawiający) by slug (from search_entities or a tender's authority): identity (NIP, REGON, KRS, region), counts, its active tenders, recent awards with winners, top contractors, procurement plan positions and recent contracts — or, on older pages, its tenders and public finance (municipal budget, NFZ contracts, investments). Same data as its public page. Requires OAuth authentication and a trial or paid plan.

The signed-in company in Przetargowy Janusz: what it does — its matching profile (matching_profile: CPV codes with names, voivodeships, budget, interests and its own description of what it does and doesn't do), from which its matched tenders come — and the details Janusz writes into offer documents: name, address, NIP, REGON, KRS, contact and the default signatory, with those missing. The NIP is set only in the app (profile_url, checked in the GUS register); the rest with set_company_details. The matching profile changes only with set_matching_profile. Requires OAuth authentication and a trial or paid plan.

Profile of one contractor (wykonawca — company or sole trader) by slug (from search_entities or a buyer's results): registry data (REGON, legal form, VAT status, PKD, debtor-register flags), wins and offers, recent wins and losses, its main buyers, rivals it meets, and recent public contracts. Same data as its public page. Requires OAuth authentication and a trial or paid plan.

One tender from the signed-in company's 'Moje przetargi' by tender_id (from list_my_tenders or list_matched_tenders): pipeline status and its history, deadlines, the AI summary state (ready / requested / no_documents / none), the number of tender documents and archive files, the last document fill run, what filling in its documents still needs (fill_details: missing details, confirmed values, Janusz's price proposals), and links to its workspace in the app, its public page and its page on the source portal (source_url, where the official documents are). The summary's text itself comes from get_tender with the returned slug. Requires OAuth authentication and a trial or paid plan.

Fetch full detail for one tender by its public slug (from search_tenders/list_tenders results): metadata, the 12-section AI SWZ summary, the OPZ scope brief, full award results (winner, value, offer price band, rejected offers, whether the cheapest offer won), the cancelled predecessor it re-issues (with that procedure's offer band — a price signal), the EU project funding it, and the bidders' Q&A. A tender without an AI summary (has_summary=false) returns its notice data with summary_sections and scope_brief null, like its public page. Returns not-found for non-public tenders. Requires OAuth authentication and a trial or paid plan.

The text read from a tender's documentation (SWZ, OPZ and attachments; the specification first), by tender_id or public slug, 20000 characters per call (pass next_offset as offset for the rest), with the list of documents it came from. When there is no document text, documents_status and message say why (no documents, or not read yet), the text is the tender's notice instead when Janusz has it (text_source: notice — conditions, wadium, criteria, dates), and copy_with_documents points to the same tender from another portal that has documents. source_url is the procedure's page on the source portal, where its official documents are. Requires OAuth authentication and a trial or paid plan.

One file from the signed-in company's document archive (file_id from list_tender_files): its text, 20000 characters per call (pass next_offset as offset for the rest; a tender document copied in gives the text read from it), and a download link valid for 5 minutes. download_filename is the name it downloads under: a filled document is listed and downloads as its editable Word/Excel original; pdf_download_url and pdf_filename then give its PDF. Requires OAuth authentication and a trial or paid plan.

Award results of up to 10 tenders at once, by public slug (from search_archived_tenders or any other listing) — to compare prices of similar past tenders. For each: title, contracting authority, estimated value, submission deadline, public URL, and the same award results get_tender returns (winner, value, number of offers, offer price band, the winner's own offer price, rejected offers, whether the cheapest offer won), without the AI summary. `results` is empty when no award is known; `found` is false for a slug that is not public. `winners` lists every winner by part as the tender's public page and the search_archived_tenders card show them (company, NIP, value in PLN only where reliable, award date) — use it for prices when a tender has parts. `results` names the same winner as `winners`; when different companies won different parts, its winner_name says so and `winners` lists them. Requires OAuth authentication and a trial or paid plan.

List the browsable facets of the active tender set: CPV categories, voivodeships (regions), and cities, each with a count and the slug/code to pass to list_tenders. Also the types of contracting authority (buyer_types) and kinds of contract (kinds) — the codes search_tenders filters by. Call this to discover valid filter values. Requires OAuth authentication and a trial or paid plan.

The signed-in company's matched tenders — the list in Przetargowy Janusz built from its profile (CPV codes, voivodeships, budget): view 'recommended' (filtered by what the company does, when its profile says so) or 'all'. 50 per page, each with fit_score (0–100), has_summary, an app_url and the public url, and the profile they are matched to (matching_profile: CPV codes, voivodeships, budget, what the company does). Without CPV codes in the profile there is no list — the answer says so with a link to the profile. Requires OAuth authentication and a trial or paid plan.

List the signed-in user's saved alert profiles (saved searches / notification rules): query, CPV codes, regions, budget band, and delivery settings. Requires OAuth authentication and a trial or paid plan.

List the tenders in the signed-in user's pipeline ('Moje przetargi'), most recently updated first, with each one's pipeline status and public URL. Requires OAuth authentication and a trial or paid plan.

Files in the document archive of one tender from the signed-in company's 'Moje przetargi' (tender_id): the tender's documents copied in (copied on the first call when the archive has none yet, as opening the tender in the app does), the company's uploads and the documents Janusz filled — with type, version and date. Read one with get_tender_file. Requires OAuth authentication and a trial or paid plan.

Browse tenders without a text query. `filter` selects the axis: 'all' (every active tender, or archived when archived=true), 'category' (CPV division code from list_facets), 'region' (voivodeship slug from list_facets), or 'city' (city slug from list_facets). Use list_facets first to get valid values. Requires OAuth authentication and a trial or paid plan.

Who wins public tenders in a sector and region: the contractors that won the most tenders (sort='wins') or the highest total award value (sort='value') among finished tenders with the given CPV codes, in the given voivodeships (of the contracting authority), published in the given period — by default the last 24 months. A whole CPV division (e.g. '45000000') counts tenders whose main CPV code is in that division; a narrower code counts tenders with any CPV code under it, sub-codes included, as in search_archived_tenders (`cpv_codes[].match` says which). settled_tenders = tenders in that scope with a known winner; the award result is known for part of the finished tenders, less often for the latest months, and a very broad scope may not count in time (the answer then says so). Each contractor: wins (tenders won), parts_won, share_of_tenders (% of settled_tenders), value_pln (sum of the reliable award amounts of value_known_parts of its parts), last_win, NIP, and slug / url when it has a public page (get_contractor takes the slug). Requires OAuth authentication and a trial or paid plan.

Orders the AI summary of a tender's documentation (SWZ) — the same as 'Wygeneruj teraz' in Przetargowy Janusz: queues the summary, or first the download or reading of the tender documents. By tender_id or public slug. status: already-done (the summary is there — read it with get_tender or get_my_tender), generating (ready in a few minutes), fetch-needed (documents are being downloaded — ask again in a few minutes), extraction-needed (no SWZ among the documents), no-source / no-documents (nothing to summarize), error. Requires OAuth authentication and a trial or paid plan.

Search finished Polish public tenders (submission deadline passed) — e.g. similar past tenders to price an offer, and who won them. A tender matches when it contains every word of the query (title, contracting authority, CPV, description); recently finished tenders close in meaning are added. Each card's `teaser` starts with the award result as the tender's public page shows it: 'Wynik: wygrała <company> — <amount> zł; ofert: <offers>; <date>.', several winners by part, 'Wynik: unieważniony.' (cancelled) or 'Wynik: brak w danych.' (no result known yet — common for tenders finished in the last months); an amount only where it is reliable. only_settled=true lists only tenders with a known winner — use it to compare prices. Optional filters: CPV codes with all their sub-codes (cpv_codes, from cpv_search), voivodeships, works / supplies / services, estimated value, submission-deadline and publication-date ranges; sort by relevance, deadline or publication date. get_tender_results gives the full results (`winners` by part, offer price band). Few results: try fewer or other Polish words; `hint` says how to search again when nothing matches. Tenders without an AI summary are included (has_summary=false). `mode` is 'semantic' when the meaning search took part, 'lexical' otherwise; `unapplied_filters` lists filters a temporary fallback could not apply. Requires OAuth authentication and a trial or paid plan.

Find contracting authorities (kind='buyer', zamawiający) or contractors (kind='contractor', wykonawcy — companies and sole traders) by name or NIP. Returns each match with its city, voivodeship, slug and public URL; pass the slug to get_buyer / get_contractor. Requires OAuth authentication and a trial or paid plan.

Search the signed-in company's matched tenders by words — the search box of the tender list in Przetargowy Janusz: only tenders that fit the company profile (CPV codes, voivodeships). view 'recommended' (filtered by what the company does, when its profile says so) or 'all'; 50 per page, the same tender cards as list_matched_tenders. To search all Polish tenders, use search_tenders. Requires OAuth authentication and a trial or paid plan.

Search active Polish public tenders (przetargi) by keywords — the same search as the tender list in Przetargowy Janusz: a tender matches when it contains every word of the query, in any inflection, in its title or contracting authority (the whole query also in CPV and description); words like 'dla' or 'oraz' are skipped. After those come open tenders close in meaning to the query that use other words (e.g. 'ambulans' → 'środki transportu sanitarnego'). Query: 1–3 Polish keywords naming the subject of the tender, e.g. 'catering', 'wywóz odpadów', 'remont dachu' — not sentences, lists of services or a description of the company: every extra word removes tenders. Narrow with the filters instead: CPV codes with all their sub-codes (take them from cpv_search), voivodeships, works / supplies / services, type of contracting authority, notice type (tenders, market research, corrections), submission-deadline and publication-date ranges, bid deposit, estimated value; sort by relevance, deadline, value or publication date. Tenders the company already has in 'Moje przetargi' are found too. For the tenders that fit the user's company use list_matched_tenders — it is built from the company's matching profile (set once in the app or with set_matching_profile). Returns up to 10 pages of 25 tender cards, each with a public URL. Tenders without an AI summary yet are included: their card has has_summary=false and no teaser, get_tender returns their notice data, and a signed-in user on a trial or paid plan can order the summary in Przetargowy Janusz. `mode` is 'semantic' when tenders close in meaning were added, 'lexical' when only words searched; `hint` says how to search again when nothing or too much matches. When the search engine is temporarily unavailable, a simpler search answers and `unapplied_filters` lists the filters it could not apply. Requires OAuth authentication and a trial or paid plan.

Sets the signed-in company's details that Janusz writes into offer documents, as the user stated them (the same as 'Profil firmy' in the app). Only the given fields change. Not the NIP — it is set only in the app (profile_url), where it is checked in the GUS register. Returns the saved fields and what is still missing. Requires OAuth authentication and a trial or paid plan.

Sets the details Janusz needs to fill in the documents of a tender in 'Moje przetargi' — the completion deadline, the signatory's name and role, and the VAT rate of the offer price — as the user stated them (the same details the Janusz chat in the app records). Only the given fields change. Returns what is still missing before start_fill; the offer price is set with confirm_bid_price. Requires OAuth authentication and a trial or paid plan.

Changes the signed-in company's MATCHING PROFILE in Przetargowy Janusz — the same as Settings → Profil in the app: CPV codes (add or remove; take them from cpv_search), voivodeships, budget, and what the company does and does not do. This profile decides which tenders are matched to the company — its list (list_matched_tenders), the fit score ('Dopasowanie'), new-tender notifications and e-mails — for EVERY user of the company. It is set ONCE and then stays as it is; it changes for a concrete reason the user gives (e.g. the company started or stopped a line of business). After a change, newly matched tenders show up at once but without AI summaries and fit scores: the score follows within about an hour, the summaries come from a shared queue and can take several hours. Tenders outside the profile are found with search_tenders, without changing it. A change needs user_confirmed=true: the user has been told exactly what will change and what that means, and has confirmed it. Only the given fields change. At most 10 changes a day per company. Returns the profile before and after. Requires OAuth authentication and a trial or paid plan.

Moves a tender of the signed-in company's 'Moje przetargi' (tender_id) to another status — a kanban column by its name as the company sees it (status from list_my_tenders, e.g. 'Do przejrzenia') or by its id (status_id) — with the moves the app allows: between the company's own kanban stages, to 'Do wysłania' or 'Oczekiwanie na wynik', closing it as 'Wygrana', 'Uczciwa przegrana', 'Nieuczciwa przegrana', 'Anulowane', 'Do odwołania' or 'Odpuszczam', back from 'Do wysłania' / 'Oczekiwanie na wynik' to a work stage, and an appeal to 'Udane odwołanie' or 'Nieudane odwołanie'. Odpuszczam needs a reason; for a loss, cancellation or appeal the reason is optional, for Wygrana the contract value. A refused move lists the allowed statuses with their names (allowed_statuses). Saved to the status history; the rest of the team is notified as in the app. Requires OAuth authentication and a trial or paid plan.

Starts filling in the documents of a tender in 'Moje przetargi' (forms, declarations, price form) with the company's data — the same as 'Wypełnij' in Przetargowy Janusz; it takes a few minutes. Janusz needs the offer price, the completion deadline and the signatory's name and role first: status missing_facts lists what is missing — set it with confirm_bid_price and set_fill_details; allow_missing=true is the user's choice to fill in with what there is (the app's 'Wypełnij z tym co jest'). Progress: get_my_tender (last_fill); the filled files: list_tender_files. Counts toward the plan's fill limit. status: started, missing_facts, nip_required (the company's NIP is not set), fill_limit, rate_limit (8 per day per person). Requires OAuth authentication and a trial or paid plan.