France BODACC SIREN Portfolio Event Monitor

Watch a book of French SIRENs and receive typed BODACC gazette events the day DILA publishes procédures collectives, modifications, radiations, or cessions for those companies. Not a nationwide BODACC dump. Not a Pappers / Infogreffe directory scrape. Not paid surveillance seats.

Value proposition

• SIREN watchlist × daily official BODACC ingest → INSOLVENCY_OPENED (RJ/LJ/sauvegarde subtypes), MODIFICATION, RADIATION, CESSION (optional IMMATRICULATION / DEPOT_COMPTES off by default).
• Official DILA BODACC open data via Opendatasoft (bodacc-datadila.opendatasoft.com, Licence Ouverte 2.0). Fair-use HTTP pacing. No Pappers / Infogreffe / Ellisphere key.
• Pay only for unique delivered acts on watched SIRENs. Quiet days ≈ $0. Durable KVS checkpoint + annonce_id / event_uid dedupe. Events carry official BODACC provenance.

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 DILA. That fixture path only writes a non-billable RUN_STATUS / FIXTURE_HEALTH row. It is not BODACC monitoring.

For production monitoring you must:

1. Set sourceMode = live
2. Provide sirenNumbers (9-digit) and optionally watchlistPairs as SIREN|Company name for display
3. Schedule runs on business days (or use lookbackDays for catch-up) with fair-use requestPaceMs

Official references:

• BODACC annonces commerciales (Opendatasoft)
• Licence Ouverte / Open Licence (Etalab)
• API: https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records

Matching note

Official BODACC records publish registre / SIREN. Matching is by SIREN (exact 9-digit). Company names in watchlistPairs are optional display labels. Dirigeant / personne names may appear in statutory gazette text (PII as published).

Data limitations

• Coverage follows DILA open-data publication lag (usually same day / next business day for new acts).
• Large books: one HTTP query per SIREN per window — raise maxRunSeconds / pace carefully; quiet books stay cheap.
• First-seen acts are delivered when they match; duplicates are deduped via event_uid / annonce_id.
• We cite DILA / bodacc.fr as the data origin. This Actor is not affiliated with or endorsed by DILA, Infogreffe, or Pappers.

Apify Store daily auto-test / default input

Field	Default
sirenNumbers	demo SIRENs
eventTypes	insolvency / modification / radiation / cession (no immatriculation / dpc)
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 bodacc-event-delivered.

Input (summary)

Field	Notes
sirenNumbers	9-digit SIREN list (preferred)
watchlistPairs	Optional SIREN|Company name for display
eventTypes	Typed filters; IMMATRICULATION / DEPOT_COMPTES opt-in
publicationDate / lookbackDays	Live scan window
sourceMode	fixture (default) or live
emitFixtureDemoEvents	Default false
maxRunSeconds / maxEvents	Budgets
resumeFromCheckpoint	Default true
requestPaceMs	Fair-use delay (default 250)

Production example

{
  "sirenNumbers": ["552100554", "443061841"],
  "watchlistPairs": [
    "552100554|DEMO FOURNISSEUR LYON SAS",
    "443061841|ACME PARIS SARL"
  ],
  "eventTypes": [
    "INSOLVENCY_OPENED",
    "MODIFICATION",
    "RADIATION",
    "CESSION"
  ],
  "sourceMode": "live",
  "lookbackDays": 3,
  "maxRunSeconds": 120,
  "requestPaceMs": 250,
  "resumeFromCheckpoint": true
}

Output

Portfolio events (billable under PPE)

Typed rows include: siren, company_name, matched_name, event_type, event_subtype, annonce_id, famille_avis, publication_date, tribunal, 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: bodacc-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/france-bodacc-siren-portfolio-monitor
npm install
npm test
npm run build
npm run start:dev

Legal

BODACC is an official public-sector gazette. DILA open data is published under Licence Ouverte 2.0 (same basis commercial BODACC reusers cite). Do not use this Actor against paid Infogreffe / Pappers HTML as the primary source. Document dirigeant names as statutory publication.