Databronnen & mapping
Hello Floor Operations blijft de enige bron. Geen klanten, projecten, facturen of tickets worden hier opgeslagen. Er zijn geen voorbeeldgegevens meer; bij een verbindingsfout blijft de lijst leeg met een duidelijke melding.
Veld → verwachte bron
| Dashboardveld | Hello Floor-bronveld | Afspraak |
|---|---|---|
| Klant / project | client_name / sale_id / project_id | Koppelen uitsluitend op bron-ID |
| Bedrijf | company | Hello Floor of Hello Egaliseren |
| Offertewaarde | offer_value_incl | Inclusief btw; niet teruggerekend |
| Openstaand | outstanding_incl | Bronbedrag is leidend |
| Aanbetaling | deposit.invoiced_incl / paid_incl / invoices | Totalen rechtstreeks uit bron |
| Slotfactuur | final_invoice | Betaald bedrag kan onbekend zijn |
| Uitvoering | installation_days | Datum, tijd, uitvoerder, assistenten, afgerond |
| Service | service_tickets | Status, planning en openstaand per ticket |
| Verkoper | seller | Onbekend als niet aangeleverd |
Cash status — rekenregels (in volgorde van voorrang)
| 1 | Gefactureerd — vervallen | Factuur met vervaldatum vóór peildatum en betaald < bedrag. |
| 2 | Uitvoering verlopen — geen factuur | Laatste uitvoerdag in verleden, geen toekomstige dag, geen slot- of volledige factuur. |
| 3 | On hold | Projectstatus = on hold. |
| 4 | Service ticket | Minimaal één open serviceticket aan het project. |
| 5 | Lopend — geen toekomstige uitvoerdag | Project niet afgerond en geen uitvoerdag na peildatum. |
| 6 | Deels betaald | Slotfactuur waarop een deel (niet alles) is betaald. |
| 7 | Gefactureerd — openstaand | Er staat nog een bedrag open op een verstuurde factuur. |
| 8 | Lopend | Minstens één uitvoerdag na de peildatum (geen exception). |
| 9 | Afgerond / betaald | Afgerond en orderwaarde volledig betaald (verborgen). |
Prioriteit: punten voor openstaand bedrag (≥ €2k/5k/10k), ouderdom (≥ 14/30 dagen), vervallen factuur, geen planning en service/on hold. ≥ 5 = Hoog, ≥ 3 = Midden.
Nog nodig of te bevestigen
- Aanbetalingsfacturen: due_date en paid_incl voor exacte vervallen en gedeeltelijk betaalde bedragen.
- Slotfactuur: sent_at en paid_incl; due_date graag altijd leveren bij een verstuurde factuur.
- Planner, bestelstatus, materiaal ontvangen en reden on hold ontbreken; worden niet ingevuld met aannames.
- Webhookdata: bij factuur- en projectgebeurtenissen een volledig project; bij day.changed één uitvoerdag; bij ticket.changed één ticket.
- Bevestigen: opgelost telt als gesloten; done_wachten_op_betaling blijft aandacht vragen.
- Geannuleerde uitvoerdagen en gedeeltelijk betaalde aanbetalingsfacturen hebben nog geen eenduidige status in het aangeleverde contract.
Ontbrekende bedragen en datums blijven onbekend; geen standaard betalingstermijn wordt aangenomen.
Verbinding
Elke 15 minuten vernieuwen zolang het overzicht geopend is, plus Nu synchroniseren. Altijd de volledige feed: alleen wijzigingen ophalen zou zonder eigen kopieën geen compleet overzicht opleveren.
Inkomende berichten zijn alleen een signaal; hun projectgegevens worden niet opgeslagen. Herhaalde berichten maken geen dubbele gegevens.
Alleen toegangslijst, laatste succesvolle ophaaltijd, foutcode, veilige foutmelding en laatste ontvangsttijd worden bewaard.
De ontvangst doet wat hij moet doen: een bericht met geldig token wordt geaccepteerd en de ontvangsttijd wordt bewaard, een bericht zonder geldig token wordt geweigerd.
Blijvend ontvangst-adresactief na publiceren
https://project--6a3f70d1-84c0-480a-b695-206ca96bb06f.lovable.app/api/public/hellofloor-webhookVoorlopig ontvangst-adres (deze werkversie)token nog niet actief
https://project--6a3f70d1-84c0-480a-b695-206ca96bb06f-dev.lovable.app/api/public/hellofloor-webhookHet blijvende adres verandert nooit, ook niet als de app later een andere naam krijgt. Publiceren is de stap die dit adres openzet; geef het daarna samen met het gedeelde token door aan het account van Hello Floor Operations.