DACH Supplier KYB Packet

For German / Austrian / Swiss supplier domains, build one JSON KYB packet: statutory Impressum identity from the supplier’s own site, a live official VIES VAT check, and an official Insolvenzbekanntmachungen open-insolvency flag — plus typed mismatch events. Not a Northdata clone. Not imprint-only email scraping.

Honest title: batch / scheduled KYB packet over public HTTP. Not a certified Handelsregister extract, not Creditreform, not real-time gazette push.

Value proposition

• Cross-source join: first-party Impressum × EU VIES × official German insolvency gazette.
• Mismatch events: VAT_INVALID_OR_MISMATCH, VIES_UNAVAILABLE, INSOLVENCY_OPEN, HRB_PARSE_UNVERIFIED (and incomplete helpers).
• Official / public HTTP only. No paid Northdata / Creditreform / Handelsregister API.
• Pay only for unique verified KYB packets. Impressum miss, VIES outage, and fixture health ≈ $0 product charges.
• Durable KVS checkpoint + event_uid dedupe.

PRODUCTION USE (required for real KYB)

Store default ≠ product. Schema defaults use sourceMode=fixture so Apify Store daily auto-tests leave a non-empty health dataset without calling supplier sites, VIES, or the gazette. That fixture path only writes a non-billable RUN_STATUS / FIXTURE_HEALTH row. It is not supplier verification.

For production KYB you must:

1. Set sourceMode = live
2. Provide supplierUrls (domains or URLs)
3. Use fair-use requestPaceMs (default 500)
4. Optionally set viesRequesterVat (your EU VAT) to obtain a VIES consultation / request identifier

Official references:

• VIES VAT validation
• Insolvenzbekanntmachungen (UI: neu.insolvenzbekanntmachungen.de)
• Statutory Impressum obligations on the supplier’s own website (TMG / DDV / local equivalents) — first-party pages only

Data limitations (read before buying)

• Not a Northdata / Creditreform substitute. No paid register API; HRB fields are parsed from Impressum text (best-effort) and may be incomplete → HRB_PARSE_UNVERIFIED.
• VIES can be temporarily unavailable; those runs do not charge as verified packets (VIES_UNAVAILABLE → retry).
• Swiss (CH) VAT is outside EU VIES; packets may still verify with vies_status=SKIPPED when Impressum + insolvency succeed.
• Insolvency search is the official public UI (fair-use). Name collisions, portal challenges, or rate limits → INSOLVENCY_CHECK_UNAVAILABLE (not charged as verified). Austrian/Swiss insolvency gazettes are not fully covered by the German portal.
• Impressum HTML varies widely; email/phone/GF parsing is best-effort.
• Fair-use pacing applies; large batches need longer maxRunSeconds or chunked runs.
• We cite the supplier site, the European Commission (VIES), and Justizportal Insolvenzbekanntmachungen as data origins. This Actor is not affiliated with or endorsed by them.

Apify Store daily auto-test / default input

Field	Default
supplierUrls	["example-maschine.de","risk-supplier.at"]
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 kyb-packet-delivered.

Input (summary)

Field	Notes
supplierUrls	Domains or URLs (required)
sourceMode	fixture (default) or live
emitFixtureDemoEvents	Default false
insolvencyLookbackDays	Default 3650
viesRequesterVat	Optional EU VAT for consultation id
maxRunSeconds / maxEvents	Budgets
resumeFromCheckpoint	Default true
requestPaceMs	Fair-use delay (default 500)

Production example

{
  "supplierUrls": ["https://supplier.de", "partner.at"],
  "sourceMode": "live",
  "maxRunSeconds": 120,
  "requestPaceMs": 500,
  "resumeFromCheckpoint": true
}

Output

KYB packets (billable under PPE when verified)

Typed rows include: supplier_domain, legal_name, vat_id, vies_status, insolvency_status, mismatch_events, verified, evidence, 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: kyb-packet-delivered at $0.02 per delivered unique verified KYB packet ($20 / 1,000). Single tier (see docs/monetization.md and ADR 0010). Health / incomplete / duplicate / fixture rows are never charged.

Local development

cd actors/dach-supplier-kyb-packet
npm install
npm test
npm run build
# Store-safe fixture health:
apify run -p
# Demo typed packets locally:
# set input emitFixtureDemoEvents=true (still sourceMode=fixture)

Attribution

Impressum text originates from the supplier’s own website. VAT validity originates from the European Commission VIES service. Insolvency flags originate from Insolvenzbekanntmachungen (Justizportal). Not an official product of those bodies.