---
name: financial-orchestrator
description: Mollie, checkout, Yuki, Ponto, BTW  -  centrale lib-paden in apps/web (geen hallucinated routes).
---

# FINANCIAL ORCHESTRATOR SUPER-SKILL

Geldstroom en integriteit: **enige waarheid** via services en DB, geen zelfbedachte bedragen in UI/mail.

## Core workflows

### 1. Betaling & checkout
- **Mollie**: `apps/web/src/lib/payments/mollie.ts`
- **Mollie Orders-id guard**: `apps/web/src/lib/payments/mollie-order-resource.ts` (`isMollieOrdersApiId`)
- **Orders-kolom SSOT + stale-PSP + Mollie live reconcile**: `.cursor/rules/330-MOLLIE-ORDER-ID-AND-STALE-PSP-SSOT.mdc`  -  `runMollieLiveReconcileForOrderId`, `npm run reconcile:mollie-live`, `payment_method_id`-backfill: `npm run reconcile:pm-backfill`, legacy Woo ↔ DB: `npm run dry-run:woo-mollie-vs-supabase` (read-only), optioneel apply lege kolommen: `npm run apply:woo-mollie-meta-backfill`
- **Checkout**: `apps/web/src/lib/checkout/checkout-service.ts`
- **Webhook**: `apps/web/src/app/api/checkout/webhook/route.ts`

### 2. Facturatie & sync
- **Yuki migratiespoor (bank/factuur vs Mollie PSP, canoniek):** `docs/03-LOGIC-AND-FLOWS/51-YUKI-MIGRATIESPOOR-COMMERCE.md`
- **Yuki / factuur**: `apps/web/src/lib/commerce/invoice-service.ts`
- **Financial sync engine**: `apps/web/src/lib/commerce/financial-sync-engine.ts`
- **BTW (VIES)**: `apps/web/src/lib/compliance/vat-service.ts`

### 3. Uitbetalingen
- **Ponto**: `apps/web/src/lib/payments/ponto-bridge.ts`
- **Payout readiness**: `apps/web/src/lib/services/payout-readiness-service.ts`

### 4. Scripts (voorbeeld)
- Integratie-debug: `npx tsx scripts/test-yuki-sync.ts` (indien relevant voor de taak)

## Verplichte richtlijnen
- **Pricing integrity**: alleen Slimme Kassa / engine  -  `003-BUSINESS-GLOSSARY.mdc`, `002-DEVELOPER-GUIDELINES.mdc`.
- **Excl. BTW** waar van toepassing; **integer centen** voor berekeningen.
- Managed door **Kelly** en **Lex**.