Scotland PCS Site Notices (OCDS)

Unofficial Apify Actor. It reads Public Contracts Scotland Site Notices from the official OCDS API and writes one dataset item per OCDS release.

This Actor covers PCS site notices only (noticeType 101 / 102 / 103 / 104). Above-threshold England / UK-wide notices go through Find a Tender (FTS) or the complementary Actor elekezem/uk-tenders-ocds. It does not read Contracts Finder, Sell2Wales, PCS HTML/RSS, or PCS notice types 1-25.

Contains public sector information licensed under the Open Government Licence v3.0.

This project is not affiliated with, endorsed by, or connected to Public Contracts Scotland, the Scottish Government, or Proactis. Do not use PCS or Scottish Government logos with this Actor.

中文摘要

只拉苏格兰 Public Contracts Scotland 的 Site Notices（101 PIN、102 合同通知、103 授标、104 Quick Quote 授标）。输出与 elekezem/uk-tenders-ocds 对齐的扁平 OCDS 字段，并去掉联系人姓名 / 邮箱 / 电话。英格兰及英国门槛以上通知请走 FTS / 那个互补 Actor。非正式产品，不含官方徽标，不声称官方背书。

Contains public sector information licensed under the Open Government Licence v3.0.

What it does

• Calls GET https://api.publiccontractsscotland.gov.uk/v1/Notices?dateFrom=mm-yyyy&noticeType={101-104}&outputType=0.
• Optionally calls GET …/v1/Notice?id={ocid} when fetchFamily is true.
• Maps each release to fields aligned with the UK tenders Actor (ocid, title, buyerName, value, dates, documents, source="pcs", noticeType) plus a PII-stripped raw release.
• Charges the PPE event ocds-release once per saved item. Unpriced local runs log the Apify SDK warning and still save data.
• Sends requests serially with at least 2 seconds between calls. Retries HTTP 429 / 503 with backoff.

No PCS account. No API key. No HTML scraping. No login.

Input

Defaults are a cheap sample run for Apify daily tests and free users.

Field	Default	Notes
mode	sample	sample, dateRange, or incremental
dateFrom / dateTo	unset	ISO dates. Expanded to covering mm-yyyy months.
noticeTypes	[101, 102, 103, 104]	Subset allowed. Types 1-25 are rejected.
maxResults	10	Caps dataset items and charges.
keywords	unset	Title / description / buyer, any keyword, case-insensitive.
cpvCodes	unset	CPV prefixes.
fetchFamily	false	Extra /v1/Notice calls. Off by default.
watermarkStoreName	scotland-pcs-site-notices-watermarks	Incremental mode only.
minRequestIntervalSeconds	2	Floor 2.

Example:

{
  "mode": "sample",
  "noticeTypes": [102, 103],
  "maxResults": 10
}

Output

One item per OCDS release. Overview columns: source, noticeType, title, buyerName, tag, valueAmount, date, noticeUrl.

Each item includes license: Contains public sector information licensed under the Open Government Licence v3.0.

raw deletes parties[].contactPoint name / email / telephone / faxNumber, drops street-level address fields, and replaces emails and phone numbers in free text with [contact removed].

Run locally

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
pytest -m "not live"
RUN_LIVE=1 pytest -m live -s

The PCS TLS chain often omits the Sectigo DV R36 intermediate. This Actor loads that public intermediate from scotland_pcs_site_notices/certs/. Do not disable certificate verification.

Apify CLI (optional): apify run with storage/key_value_stores/default/INPUT.json.

Legal

• Data licence: Open Government Licence v3.0.
• Attribution: Contains public sector information licensed under the Open Government Licence v3.0.
• Personal data is outside OGL. Contact fields are stripped before save.
• RSS terms on the PCS website do not apply. This Actor uses the OCDS API only.

Store status

Draft copy lives in STORE.md. Do not publish this Actor to Apify Store from this repository until pricing and listing review are done.