Spain BORME NIF Portfolio Event Monitor

Watch a book of Spanish NIFs (with company legal names) and receive typed BORME gazette events the day BOE publishes director changes, capital events, insolvency/concurso, dissolution, address/name changes for those companies. Not a nationwide BORME dump. Not a Registro Mercantil directory scrape. Not paid eInforma / BORME API seats.

Value proposition

• NIF watchlist × daily official BORME ingest → DIRECTOR_APPOINTED, DIRECTOR_TERMINATED, CAPITAL_INCREASE, CAPITAL_REDUCTION, INSOLVENCY_DECLARED, DISSOLUTION, ADDRESS_CHANGED, NAME_CHANGED (optional INCORPORATION off by default).
• Official BOE datos abiertos BORME sumario + province XML only. Fair-use HTTP pacing. No paid BORME API / AlertaEmpresas / eInforma key.
• Pay only for unique delivered acts on watched NIFs. Quiet days ≈ $0. Durable KVS checkpoint + event_uid dedupe. Events carry boletin/acto provenance + match_confidence.

PRODUCTION USE (required for real monitoring)

Store default ≠ product. Schema defaults use sourceMode=fixture so Apify Store daily auto-tests leave a non-empty health dataset without calling BOE. That fixture path only writes a non-billable RUN_STATUS / FIXTURE_HEALTH row. It is not BORME monitoring.

For production monitoring you must:

1. Set sourceMode = live
2. Provide watchlistPairs as NIF|Company legal name (see matching note below)
3. Schedule runs on business days (or use lookbackDays for catch-up) with fair-use requestPaceMs
4. Optionally set provinces (e.g. MADRID) to reduce XML fetches for regional books

Official references:

• BOE datos abiertos API
• BORME sumario API docs (PDF)
• Endpoint: https://boe.es/datosabiertos/api/borme/sumario/{YYYYMMDD}

Matching note (read before buying)

Official BORME Section A XML does not publish NIF. Matching is by company denominación supplied in your watchlist, with match_confidence (exact / normalized / contains). Ambiguous short names may miss or false-positive — prefer full registered names. Administrator personal names appear in statutory gazette text (PII as published).

Data limitations

• Publication days only (no BORME on many weekends/holidays) — 404 days are idle, not errors.
• Large nationwide scans need higher maxRunSeconds or a provinces filter.
• First-seen acts are delivered when they match; duplicates are deduped via event_uid.
• We cite Agencia Estatal BOE as the data origin. This Actor is not affiliated with or endorsed by BOE / Registro Mercantil.

Apify Store daily auto-test / default input

Field	Default
watchlistPairs	demo NIF|name pairs
eventTypes	director / capital / insolvency / dissolution / address / name (no incorporation)
sourceMode	fixture
emitFixtureDemoEvents	false
maxRunSeconds	55
maxEvents	500

On that path the Actor SUCCEEDS quickly, pushes exactly one RUN_STATUS / FIXTURE_HEALTH row (billable: false), and does not charge borme-event-delivered.

Input (summary)

Field	Notes
watchlistPairs	NIF|Company legal name (preferred)
nifNumbers + companyNames	Alternate aligned lists
eventTypes	Typed filters; INCORPORATION opt-in
provinces	Optional province title filter
publicationDate / lookbackDays	Live scan window
sourceMode	fixture (default) or live
emitFixtureDemoEvents	Default false
maxRunSeconds / maxEvents	Budgets
resumeFromCheckpoint	Default true
requestPaceMs	Fair-use delay (default 400)

Production example

{
  "watchlistPairs": [
    "A28015865|TELEFONICA SA",
    "B86656961|FREEMATICA ESPAÑA SOCIEDAD LIMITADA"
  ],
  "eventTypes": [
    "DIRECTOR_APPOINTED",
    "DIRECTOR_TERMINATED",
    "CAPITAL_INCREASE",
    "CAPITAL_REDUCTION",
    "INSOLVENCY_DECLARED",
    "DISSOLUTION",
    "ADDRESS_CHANGED",
    "NAME_CHANGED"
  ],
  "sourceMode": "live",
  "provinces": ["MADRID"],
  "lookbackDays": 3,
  "maxRunSeconds": 120,
  "requestPaceMs": 400,
  "resumeFromCheckpoint": true
}

Output

Portfolio events (billable under PPE)

Typed rows include: nif, company_name, matched_name, match_confidence, event_type, act_id, boletin_id, province, publication_date, act_excerpt, evidence, summary, source_url, event_uid, billable: true.

RUN_STATUS (never billed)

Every successful run pushes one health row (FIXTURE_HEALTH | MONITOR_IDLE | CATCHUP_COMPLETE | HEALTH_OK).

Pricing

Pay-per-event: borme-event-delivered at $0.02 per delivered unique portfolio act ($20 / 1,000). Single tier (see docs/monetization.md and ADR 0010). Health / duplicate / fixture rows are never charged.

Local development

cd actors/spain-borme-nif-portfolio-monitor
npm install
npm test
npm run build
npm run start:dev

Legal

BORME is an official public-sector gazette. Reuse under Spanish open-data / reutilisation framing (Ley 18/2015 / RD 1495/2011 — same basis commercial BORME APIs cite). Do not use this Actor against paid Registradores certificate portals.