Turn published TED lot end dates into supplier signals Link each published date to its lot, settled contract, winning tender and named supplier using official TED XML evidence.

Use direct TED notice numbers for deterministic checks, or search a bounded end-date window with optional buyer-country and CPV filters. Each complete Dataset row represents one source-verified contract-lot observation with grouped winning suppliers. NEW, UPDATED and UNCHANGED rows use the same output unit.

What the date means

publishedLotEndDate reproduces TED field BT-537-Lot: the published estimated end date for the lot duration. Depending on the notice, this date can describe a contract, framework agreement, dynamic purchasing system, qualification system or setup phase. Use procedureType, frameworkType, dpsUsage and durationDescription to qualify the signal. It is not a forecast of a new tender or renewal.

Input

Direct mode takes priority when noticeNumbers is present. Set-like arrays are sorted and deduplicated before the search and monitor scope are created.

{
  "noticeNumbers": ["599729-2026"],
  "buyerCountries": ["DEU"],
  "cpvCodes": ["45315700"],
  "maxNotices": 20,
  "monitorKey": "facilities-de"
}

For search mode, omit noticeNumbers and provide both dates:

{
  "endFrom": "2027-10-01",
  "endTo": "2027-12-31",
  "buyerCountries": ["DEU"],
  "cpvCodes": ["45315700"],
  "maxNotices": 25,
  "monitorKey": "facilities-de"
}

• noticeNumbers: 1 to 20 TED publication numbers.
• endFrom, endTo: ISO dates in YYYY-MM-DD form, ordered within a 366-day window.
• buyerCountries: optional ISO alpha-3 buyer-country codes, such as DEU or FRA.
• cpvCodes: optional exact eight-digit CPV codes.
• maxNotices: 1 to 100 notices.
• monitorKey: stable key for one isolated recurring workflow.

Search mode reads page 1 of the public TED Search API and processes at most maxNotices candidates. CAPPED_FIRST_PAGE confirms this bounded page was processed. It does not mean the whole date window or all EU notices were covered.

Output and monitoring

{
  "observationId": "notice-specific-id",
  "contractKey": "stable-procedure-contract-lot-key",
  "noticeNumber": "599729-2026",
  "publicationDate": "2026-09-01",
  "lotId": "LOT-0000",
  "contractId": "CON-0001",
  "publishedLotEndDate": "2027-12-31",
  "dateBasis": "PUBLISHED_LOT_DURATION_END",
  "winnerNames": ["Siemens AG"],
  "winners": [{
    "organisationId": "ORG-0001",
    "name": "Siemens AG",
    "tenderIds": ["TEN-0001"],
    "tenderValues": []
  }],
  "changeType": "UNCHANGED",
  "isAlert": false,
  "sourceXmlUrl": "https://ted.europa.eu/en/notice/599729-2026/xml"
}

The Actor emits a row only when XML references connect the lot result, winning tender, settled contract, tendering party and named organisation. Multiple suppliers for one contract and lot stay grouped in winners. If several validated notices describe the same contract-lot in one run, the Actor selects the version with the latest published date and records the selection in SUMMARY diagnostics. Conflicting duplicate XML IDs are rejected instead of being silently overwritten.

The monitor keeps a bounded snapshot for the validated input scope and monitorKey. The first complete observation is NEW. A changed observation for the same contract-lot is UPDATED. A repeated complete observation is UNCHANGED with isAlert=false, so a scheduled run remains useful without creating a false alert. State advances only after exact Dataset payload readback and snapshot readback succeed while the run still owns the monitor lock.

SUMMARY.coverageStatus means:

• VERIFIED_DIRECT_NOTICES: direct notices were parsed without source issues.
• CAPPED_FIRST_PAGE: page 1 of the TED search was processed up to maxNotices; window-wide completeness is unknown.
• PARTIAL_SOURCE_ERRORS: one or more candidates, links or source documents could not be fully verified.

Billing follows each delivered, complete contract-lot observation, including NEW, UPDATED and UNCHANGED. Multiple winners remain part of that single result. A run-start fee applies even when no complete observation is produced. Completed observations are charged separately, including unchanged checks. Apify compute and proxy usage are included in the event prices. See Pricing for the current tariff.

The Dataset row is the source-verified contract-lot unit. SUMMARY separately reports observed, new, updated, unchanged, alert and delivered counts. Source or delivery failures are reported as failed or partial health and do not produce unverified contract-lot rows.

---

EU TED: опубликованные даты окончания лотов и мониторинг поставщиков

Используйте известные номера извещений TED для детерминированной проверки или ищите в ограниченном диапазоне дат с фильтрами по стране заказчика и CPV. Каждая полная строка Dataset соответствует одной проверенной по первичному XML связке договор-лот с объединённым списком победителей. Строки NEW, UPDATED и UNCHANGED являются одной и той же единицей результата.

Что означает дата

publishedLotEndDate воспроизводит поле TED BT-537-Lot: опубликованную оценочную дату окончания периода лота. В зависимости от извещения дата может относиться к договору, рамочному соглашению, динамической системе закупок, квалификационной системе или этапу настройки. Для интерпретации используйте procedureType, frameworkType, dpsUsage и durationDescription. Дата не является прогнозом новой закупки или продления.

Входные данные

Прямой режим имеет приоритет, если задан noticeNumbers. Массивы, используемые как множества, сортируются и очищаются от повторов до поиска и создания области монитора.

{
  "noticeNumbers": ["599729-2026"],
  "buyerCountries": ["DEU"],
  "cpvCodes": ["45315700"],
  "maxNotices": 20,
  "monitorKey": "facilities-de"
}

Для режима поиска не задавайте noticeNumbers, но укажите обе даты:

{
  "endFrom": "2027-10-01",
  "endTo": "2027-12-31",
  "buyerCountries": ["DEU"],
  "cpvCodes": ["45315700"],
  "maxNotices": 25,
  "monitorKey": "facilities-de"
}

• noticeNumbers: от 1 до 20 номеров публикаций TED.
• endFrom, endTo: даты ISO в форме YYYY-MM-DD, по порядку и в окне не более 366 дней.
• buyerCountries: необязательные коды стран заказчика ISO alpha-3, например DEU или FRA.
• cpvCodes: необязательные точные восьмизначные коды CPV.
• maxNotices: от 1 до 100 извещений.
• monitorKey: стабильный ключ одного изолированного повторяемого сценария.

Режим поиска читает страницу 1 публичного TED Search API и обрабатывает не более maxNotices кандидатов. CAPPED_FIRST_PAGE подтверждает обработку этой ограниченной страницы. Этот статус не означает полного покрытия диапазона дат или всех извещений ЕС.

Результат и мониторинг

{
  "observationId": "notice-specific-id",
  "contractKey": "stable-procedure-contract-lot-key",
  "noticeNumber": "599729-2026",
  "publicationDate": "2026-09-01",
  "lotId": "LOT-0000",
  "contractId": "CON-0001",
  "publishedLotEndDate": "2027-12-31",
  "dateBasis": "PUBLISHED_LOT_DURATION_END",
  "winnerNames": ["Siemens AG"],
  "winners": [{
    "organisationId": "ORG-0001",
    "name": "Siemens AG",
    "tenderIds": ["TEN-0001"],
    "tenderValues": []
  }],
  "changeType": "UNCHANGED",
  "isAlert": false,
  "sourceXmlUrl": "https://ted.europa.eu/en/notice/599729-2026/xml"
}

Строка создаётся только тогда, когда ссылки XML связывают результат лота, победившую заявку, заключённый договор, сторону заявки и названную организацию. Несколько поставщиков одной связки договор-лот остаются в одном массиве winners. Если несколько проверенных извещений в одном запуске описывают одну связку, Actor выбирает версию с самой поздней датой публикации и фиксирует выбор в диагностике SUMMARY. Противоречивые повторяющиеся ID в XML отклоняются и не перезаписывают сведения незаметно.

Монитор хранит ограниченный снимок для проверенной области входных параметров и monitorKey. Первое полное наблюдение имеет тип NEW. Изменённое наблюдение для той же связки имеет тип UPDATED. Повторное полное наблюдение имеет тип UNCHANGED и isAlert=false, поэтому запуск по расписанию остаётся полезным и не создаёт ложное оповещение. Состояние обновляется только после точной обратной проверки содержимого Dataset и снимка, пока запуск владеет блокировкой монитора.

Значения SUMMARY.coverageStatus:

• VERIFIED_DIRECT_NOTICES: прямые извещения разобраны без ошибок источника.
• CAPPED_FIRST_PAGE: обработана страница 1 поиска TED с ограничением maxNotices; полнота всего окна неизвестна.
• PARTIAL_SOURCE_ERRORS: один или несколько кандидатов, связей или исходных документов не удалось проверить полностью.

Тарификация применяется к каждой доставленной полной проверке связки договор-лот, включая NEW, UPDATED и UNCHANGED. Несколько победителей входят в один результат. Плата за старт применяется и при отсутствии полной проверки. Полные доставленные проверки оплачиваются отдельно, включая проверки без изменений. Вычисления и прокси Apify включены в цену событий. Актуальный тариф указан в разделе Pricing.

Строка Dataset является проверенной по источнику единицей договор-лот. SUMMARY отдельно показывает число наблюдений, новых, изменённых, неизменённых, сигнальных и доставленных строк. Ошибки источника или доставки отражаются как неуспешное или частичное состояние и не создают непроверенных строк договор-лот.