Integrations overview

Status: Placeholder — to be developed. Last reviewed: —

Scope

Shared patterns for any external integration: where credentials live (env vars, secret stores), retry/backoff, cursor/pagination handling, rate-limit handling, idempotent fetch (resume on partial failure), how raw responses are persisted (audit trail vs ephemeral), how a sync becomes a Celery task, error surfacing (Sentry, ImportRow, dataquality flag).

The per-connector files (doctolib.md, pennylane.md, logosw.md, inpi.md) document the connector-specific quirks; this file documents what they all share.

Sources to mine when writing this

• Compare existing connectors side-by-side (sync, pennylane_sync, imports for Logosw, annuaire for INPI) — the shared patterns and the divergences both teach.
• The reusable Pennylane bundle (referenced in roadmap/done/meta-finance-captable-planning-session.md) — was an early attempt at extracting shared patterns.