# Changelog of Latin America Public Tenders: Colombia, Brazil & more (Lite) (`cleanyield/latam-public-tenders-lite`) Actor

- **URL**: https://apify.com/cleanyield/latam-public-tenders-lite/changelog.md
- **Full Actor documentation**: https://apify.com/cleanyield/latam-public-tenders-lite.md

## Changelog

All notable changes to the output and input of **Latin America Public Tenders** (`cleanyield/latam-public-tenders`).
The output schema is versioned with `schemaVersion` in every item. Fields are only ever added, never renamed or removed without a new major version announced here first.

### Unreleased — 2026-11-10

- Faster runs with English titles: translations go in small batches (2–3 tenders per call, up to 8 at a time) and results are saved every 24 tenders instead of 40. The pre-filled demo (15 Colombian IT tenders) went from 18–39 s to 8–9 s on Apify. Same fields and same output.

### 2026-11-09

- Buyer and awardee names no longer end with filler symbols from the source (`SUPERINTENDENCIA FINANCIERA DE COLOMBIA**` → `SUPERINTENDENCIA FINANCIERA DE COLOMBIA`, `…NIVEL CENTRAL.` → `…NIVEL CENTRAL`). Real abbreviations keep their dots (`S.A.S.`, `LTDA.`, `E.S.P.`). No field changes.

### 1.2.0 — 2026-11-06

`schemaVersion: 3` — only new fields and new countries; every version 1 and 2 field is unchanged.

- **New countries: Paraguay (`PY`, DNCP official OCDS API) and Uruguay (`UY`, ARCE official OCDS open data).** Same output format: amount (Paraguay), deadline in the right local time (Paraguay keeps the real offset; Uruguay labels Montevideo time as "Z" and is converted), UNSPSC codes (Paraguay), bidding documents (pliegos) links, awardees with tax ID and awarded amount, latest deadline after amendments (Uruguay). Lookup ids: `ocds-03ad3f-490443-1` (Paraguay), `UY-1384146` (Uruguay). They are opt-in: with `countries` empty you still get CO, BR and CL, exactly as before.
- **Brazil keyword searches in seconds instead of minutes**: keywords and sectors now use the official PNCP portal search, then the official items endpoint for the estimated amount (sum of items) and award status. Falls back to the full publication list automatically if the search engine fails.
- New field `titleEn` / `descriptionEn`: faithful English translation of the title and description (AI, in batches; no extra charge). New input `translateToEnglish` (default on). `null` when the AI is not available in a run.
- New field `standardCategory`: one category for every country — UNSPSC segment (and code when the source gives it) plus the ready-made sector id and label; `source` says whether it comes from the official classification or was deduced from the title.
- **Alert rules for monitor mode**: new inputs `alertCountries`, `alertSectors`, `alertMinAmountUsd`. Only matching tenders go to Slack/webhook; the dataset still has every new or changed tender with the new field `alert` (`true`/`false`, `null` without rules).
- Brazil awardee look-ups run 3 at a time (faster awarded tenders); PNCP items are fetched once per tender and reused.
- English translation is now structured (no broken JSON) and retried by halves: 100% of tenders translated when the AI is available. Batches run 4 at a time.
- Chile keyword searches stop after 30 s (240 s in monitor mode, which continues where it stopped next run) and say so in the log; an optional official Mercado Público ticket (`MERCADOPUBLICO_TICKET`, set by the publisher) filters Chile by tender name before reading each one.
- Uruguay is **beta**: from some servers its source does not answer; it now fails in seconds (12 s, 1 retry) and the other countries are delivered and nothing is charged for Uruguay.
- Argentina, Mexico, Peru and Ecuador are still not supported (no official open API that answers reliably today); asking for them gives a clear warning.

### 1.1.0 — 2026-11-05

`schemaVersion: 2` — only new fields; every version 1 field is unchanged.

- **Pro mode** (`proMode`, extra `pro-result` event per tender): `fitScore` 0–100 with `fitFactors` (how well the tender matches your keywords, sectors and UNSPSC codes, and whether there is time to bid), `daysToClose` and `urgency` (critical / high / normal / closed), `buyerProfile` from your own monitoring history (tenders published since you started monitoring, typical and largest budget, this tender vs typical), a dated `whyNow` line and a one-sentence AI `insight`. New inputs `priorityKeywords` and `minFitScore` (weak matches are skipped and not charged). Without Pro these fields are `null`.
- **Free dashboard** in every run (DASHBOARD record, link in the new SUMMARY record): tenders by country and sector, budget by country, top buyers, tenders closing this week.
- **Saved watchlists** (`savedListName`, `saveList`): keywords, sectors, codes, buyers and exclusions remembered across runs.
- New input `publishedUntil`. Input names from other tender scrapers accepted as-is (`maxItems`, `dateFrom`, `dateTo`, `mode: "monitor"`, `webhookUrl`, `minScore`, `priorityKeywords`); unsupported countries (PE, MX, AR) are skipped with a warning when other countries are given.
- The end of runs without Pro shows what Pro would have added (honest counts, no tricks).

### 1.0.0 — 2026-11-04

First public version (`schemaVersion: 1`).

- Sources: Colombia SECOP II (datos.gov.co open data, dataset `p6dx-8zbt`), Brazil PNCP (official consultation API), Chile Mercado Público (official OCDS API, no ticket needed).
- One normalized item per tender: stable `tenderId` (`country:source:id`), ISO country, buyer (clean name, NIT/CNPJ/RUT, region, city), UNSPSC categories with English segment names, normalized `procedureType` and `status` (plus the original text), estimated and awarded amounts with ISO currency and indicative USD value, local dates and exact UTC times (`publishedAt`, `closingAt`) with the correct time zone, official URL, documents URL, awardees, language.
- Chile: deadlines and publication times converted from local Chilean time (the API labels them "Z", they are not UTC).
- Search by sector (15 ready-made keyword + UNSPSC packs in Spanish and Portuguese), keywords (accent-insensitive), exclude keywords, UNSPSC codes, buyers (name or tax ID), regions, amount range in USD, status, procedure type/scope, publication window and closing date range. Lookup by tender ID.
- Monitor mode: only new tenders plus changes in tenders already sent (deadline extended or moved, awarded with winner and amount, cancelled, suspended, unsuccessful, estimated amount changed), with Slack / webhook alerts. Only new or changed tenders are charged.
- Competitive procedures only by default (direct awards excluded); natural-person awardees hidden by default.
