Facturatie
Opmerking toevoegen
Je kunt opmerkingen plaatsen via Opmerking toevoegen aan de rechterkant van de pagina.
Overzicht
Facturatie is de stap waarin goedgekeurde uren worden omgezet in een factuur richting opdrachtgever of broker. Bij DPP bestaat dit niet uit één flow maar uit vier verschillende vormen, afhankelijk van wie de opdrachtgever is en welke broker tussen DPP en de opdrachtgever staat. Welke vorm geldt, is al bij contractondertekening uitgevraagd en vastgelegd (factuuradres, PO-nummer, periodiciteit, eventuele portaalindiening); zie Contracten.
Positie in de keten
flowchart LR
Z[Gunning] --> A[Dossier opbouw]
subgraph BH[Beheer]
direction LR
B[Contracten] --> U[Uren]
U --> F[Facturatie]
F --> P[Uitbetalingen]
P -.->|periodiek| U
end
A --> BH
BH --> G[Offboarding]
classDef ph fill:none,stroke:#94a3b8,stroke-dasharray:5 5,color:#475569
classDef act stroke:#059669,stroke-width:3px
class BH ph
class F actMVP-scope (besluit 2026-05-27) — We bouwen niet alle vier vormen tegelijk. De eerste end-to-end flow die we automatiseren is semi-self-billing van Flextender: simpelste structuur (broker zet draft klaar, DPP maakt factuur in Exact, plakt nummer terug in portal). Daarna self-billing (HeadFirst), dan bliq, Magnit en kickback. Eigen facturatie blijft in eerste instantie handmatig.
Procesflow
Generiek verloop van een facturatiecyclus. Trigger is altijd hetzelfde (uren goedgekeurd); per contract bepaalt de factuurvorm welk pad volgt. Alle paden convergeren op de Exact-boeking en eindigen met een statusdoorzet naar Uitbetalingen.
flowchart TD
S([Uren goedgekeurd voor de periode])
S --> V{Welke factuurvorm volgens contract en broker?}
V -->|Eigen| EI[DPP maakt verkoopfactuur in Exact en stuurt naar opdrachtgever]
V -->|Self-billing| SF[Broker stuurt PDF; DPP boekt in Exact met broker-nummer als ref]
V -->|Semi-self-billing| SS[DPP maakt factuur in Exact; nummer terug in broker-portaal]
V -->|Kickback| KB[Broker doet payroll en factuur; DPP factureert alleen fee]
EI --> A[Exact-artikelcode projectnr-volgnr]
SF --> A
SS --> A
KB --> A
A --> ST[Status openstaand: wacht op betaling opdrachtgever of broker]
ST --> U([Doorzet naar Uitbetalingen])
classDef startNode fill:#ecfeff,stroke:#0891b2,color:#0e7490
classDef finishNode fill:#ecfdf5,stroke:#059669,color:#065f46
classDef decisionNode fill:#fefce8,stroke:#ca8a04,color:#854d0e
class S startNode
class U finishNode
class V decisionNodeVier factuurvormen
Canonieke factuurvormen bij DPP
Wie factureert, wie ontvangt, per relatie
Eigen facturatie
Vorm 1 / 4- Directe contracten zonder broker
Navigeer met de pijltjestoetsen. Klik een vorm voor de detailweergave.
Hoe je weet welke vorm geldt — De factuurvorm staat in het broker-contract of in het CRM op de opdracht. Bij intake van een nieuwe broker wordt deze keuze expliciet vastgelegd. Bij twijfel: kijk wie de uren-factuur aan de eindklant uitschrijft (DPP → eigen/semi-self-billing, broker → self-billing/kickback).
Exact artikelcode
Elk verkoopfactuurregel in Exact gebruikt een artikelcode volgens het patroon [projectnummer]-[volgnummer]. Het projectnummer komt uit de opdracht in het CRM; het volgnummer telt op bij elke verlenging van hetzelfde contract.
| Artikelcode | Betekenis |
|---|---|
3837-1 | Basiscontract op project 3837 |
3837-2 | Eerste verlenging |
3837-3 | Tweede verlenging |
Toekomstige migratie — Het projectnummer is in de huidige Exact-administratie de stabiele identifier. Op termijn migreren we naar het dossier-ID als prefix, zodat de artikelcode één-op-één koppelt aan een dossier in TESS in plaats van aan een project-record in het CRM. Dit is een latere optimalisatie; voor MVP houden we het projectnummer aan.
Proces per factuurvorm
Semi-self-billing (MVP-flow Flextender)
Portal-notificatie ontvangen
Urenkaart valideren
Verkoopfactuur maken in Exact
Factuurnummer kopieren
Plakken in portal en verwerken
sequenceDiagram participant FT as Flextender portaal participant BO as Backoffice (Inhuurdesk) participant EX as Exact Online participant SB as Supabase FT->>BO: mail "factuur voor jou klaar" BO->>FT: open portaal, valideer urenkaart BO->>SB: cross-check dagniveau-uren BO->>EX: nieuwe verkoopfactuur (artikelcode 3837-1, 38u) EX-->>BO: factuurnummer BO->>FT: factuurnummer plakken + Verwerk factuur FT-->>BO: status "verwerkt"
Self-billing (HeadFirst, bliq Kees Nieuwenhuizen)
Mail met PDF binnen
Inboeken in Exact
Cross-check met dagniveau
Eigen facturatie
Verkoopfactuur in Exact Online via Verkoop → Verkoopboeking. Relatie = de eindklant. Artikelcode volgens [projectnr]-[volgnr]. Factuurmail kan automatisch (mail-template gekoppeld aan klant) of handmatig (boekhouder downloadt PDF en stuurt zelf). Handmatige override blijft altijd mogelijk voor correcties, afwijkende afspraken of speciale facturatievoorwaarden.
Kickback
DPP factureert per periode (vaak 4-wkn) alleen de afgesproken fee aan de broker, gebaseerd op de gewerkte uren bij die broker. Voorbeeld: Yacht ZCP-aanbrenging met fee EUR 12,50/uur × aantal gewerkte uren in periode = kickback-factuur. De uren-factuur naar de eindklant gaat uit van Yacht zelf en valt buiten DPP's administratie.
Factuurstatus
| Status | Betekenis |
|---|---|
| Concept | Factuur aangemaakt in Exact, nog niet definitief geboekt |
| Verzonden | Definitief geboekt en verstuurd; bij semi-self-billing ook nummer teruggekoppeld in portal |
| Betaald | Betaling ontvangen op DPP-rekening; triggert Uitbetalingen-cyclus naar kandidaat |
| Gecrediteerd | Volledig of deels gecrediteerd; bij verkeerde uren of correcties |
| Voorgeschoten | Interne markering: kandidaat is al uitbetaald terwijl factuur nog open staat (zie Uitbetalingen) |
Vastgelegde besluiten
| Besluit | Datum | Toelichting |
|---|---|---|
| Vier canonieke factuurvormen | 2026-05-27 | Eigen, Self-billing, Semi-self-billing, Kickback |
| MVP-flow = semi-self-billing Flextender | 2026-05-27 | Eenvoudigste structuur met één duidelijke automatiseringswinst |
Artikelcode-patroon [projectnr]-[volgnr] | 2026-05-27 | Migratie naar dossier-ID is een latere optimalisatie |
| Dagniveau-uren als brondata | 2026-05-27 | Maakt split-week-facturatie en self-billing PDF-reconciliatie mogelijk |
| Inhuurdesk IMAP voor self-billing-intake | 2026-05-27 | App-password actief; parser per broker volgt |
| Verzending: automatisch + handmatig | 2026-01 | Handmatige override blijft altijd mogelijk |
Technisch
Implementatiedetails voor het ontwikkelteam. Functioneel-gebruikers van de Facturatie-flow hoeven hier niet doorheen.
De PDF-structuur van factuur 2567722505 is stabiel en daarmee eerste parser-target.
- Koptekst: “Urenspecificatie factuur [nr]”
- Professional-naam (volledig)
- Twee maand-blokken (bv. April + Mei) per 4-wekenperiode
- Kolommen: Datum / Urensoort / Aantal / Tarief / Bedrag
Output: per dag één record naar Supabase. Verschillen tussen broker-PDF en interne registratie automatisch loggen als afwijking. Volgorde van uitrol: HeadFirst → Flextender → bliq → Magnit → Yacht.