Wijzigingshistorie
De wijzigingshistorie (ook wel auditlog genoemd) in Tesoro CRM houdt automatisch bij welke wijzigingen er worden aangebracht aan uw woningen. Elke wijziging wordt vastgelegd met de oude en nieuwe waarde, de bron van de wijziging, de verantwoordelijke gebruiker en het exacte tijdstip. Dit biedt u een volledig transparant overzicht van alle mutaties.
Wat is de wijzigingshistorie?
Section titled “Wat is de wijzigingshistorie?”De wijzigingshistorie is een auditlogboek dat automatisch op de achtergrond draait. Wanneer een woning wordt bijgewerkt, vergelijkt Tesoro CRM de nieuwe gegevens met de vorige versie van het record. Alle gevonden verschillen worden opgeslagen als afzonderlijke wijzigingsregels in een aparte update_history-collectie in de database.
De wijzigingshistorie wordt bijgehouden ongeacht de bron van de wijziging: handmatige bewerkingen, feed-imports, API-aanroepen, AI-bewerkingen en systeemacties worden allemaal geregistreerd.
Wat wordt bijgehouden?
Section titled “Wat wordt bijgehouden?”De volgende woningvelden worden bijgehouden in de wijzigingshistorie:
Basisgegevens
Section titled “Basisgegevens”| Veld | Beschrijving |
|---|---|
| Naam | De naam/titel van de woning |
| Slug | De URL-slug van de woning |
| Referentie | Het oorspronkelijke referentienummer |
| Tesoro-referentie | Het Tesoro-referentienummer |
| Status | De publicatiestatus van de woning |
| Transactie | Het transactietype (verkoop, verhuur, etc.) |
| Type woning | Het type woning (appartement, villa, etc.) |
Financieel
Section titled “Financieel”| Veld | Beschrijving |
|---|---|
| Prijs | De vraagprijs van de woning |
| Valuta | De valuta van de prijs |
| Eigenaar-nettoprijs | De nettoprijs voor de eigenaar |
| Commissiepercentage | Het percentage commissie |
| Berekening commissievlag | Instelling voor commissieberekening |
| Prijssynchronisatie met commissie | Of de prijs automatisch synchroniseert met de commissie |
| Tegenbiedingen accepteren | Of tegenbiedingen worden geaccepteerd |
Afmetingen
Section titled “Afmetingen”| Veld | Beschrijving |
|---|---|
| Bebouwde oppervlakte | De bebouwde oppervlakte in m² |
| Nuttige oppervlakte | De nuttige/bruikbare oppervlakte in m² |
| Perceelgrootte | De totale perceelgrootte in m² |
| Verdieping | Het type verdieping |
| Verdiepingsnummer | Het verdiepingsnummer |
Kamers
Section titled “Kamers”| Veld | Beschrijving |
|---|---|
| Aantal slaapkamers | Het aantal slaapkamers |
| Aantal badkamers | Het aantal badkamers |
| Toiletten | Het aantal toiletten |
Adres en locatie
Section titled “Adres en locatie”| Veld | Beschrijving |
|---|---|
| Adres | Het volledige adres (straat, stad, postcode, land, etc.) |
| Locatie | GPS-coördinaten van de woning |
Beschrijvingen
Section titled “Beschrijvingen”| Veld | Beschrijving |
|---|---|
| Beschrijvingen | Titel en tekst per taal (bijv. Nederlands, Engels, Spaans) |
Kenmerken en staat
Section titled “Kenmerken en staat”| Veld | Beschrijving |
|---|---|
| Kenmerken | Woningkenmerken zoals terras, zwembad, garage, etc. |
| Uitrusting | De uitrusting van de woning |
| Staat | De staat van het pand (nieuw, gerenoveerd, etc.) |
| Uitzichttype | Het type uitzicht (zee, bergen, stad, etc.) |
| Extra voorzieningen | Aanvullende voorzieningen |
Energie en kadaster
Section titled “Energie en kadaster”| Veld | Beschrijving |
|---|---|
| Energielabel | Energieverbruik en uitstootclassificatie |
| Kadastrale gegevens | Kadastrale locatiegegevens |
| Kadastrale data | Gedetailleerde kadastrale informatie |
| Kadastrale referentie | Het kadastrale referentienummer |
Publicatie en media
Section titled “Publicatie en media”| Veld | Beschrijving |
|---|---|
| Weergave op website | Of de woning zichtbaar is op de website |
| Publicatiedatum | De datum waarop de woning is gepubliceerd |
| Verwijderd uit feed | De datum waarop de woning uit een feed is verwijderd |
| Verwijderd op | De datum waarop de woning is verwijderd |
| Videoplatform | Het platform van de video (YouTube, Vimeo, etc.) |
| Video-URL | De URL van de video |
| Virtuele tour-URL | De URL van de virtuele rondleiding |
Relaties en koppelingen
Section titled “Relaties en koppelingen”| Veld | Beschrijving |
|---|---|
| Eigenaar | De eigenaar van de woning |
| Contactpersoon eigenaar | Het contactpersoon dat als eigenaar is gekoppeld |
| Relatie | De gekoppelde relatie |
| Gekoppelde contacten | Contacten die aan de woning zijn gekoppeld |
| Gekoppelde deals | Deals die aan de woning zijn gekoppeld |
Overig
Section titled “Overig”| Veld | Beschrijving |
|---|---|
| Notities | Interne notities bij de woning |
| Nieuwbouw | Of het een nieuwbouwwoning betreft |
| Erfpacht | Of er sprake is van erfpacht |
| Deeleigendom | Of er sprake is van deeleigendom |
| Bezichtigingen | Bezichtigingsgegevens (inclusief afspraak-ID, contact-ID en deal-ID) |
| MLS-status | De status op het MLS-portaal |
| Geïnteresseerd | Of er interesse is geregistreerd |
Wijzigingshistorie bekijken
Section titled “Wijzigingshistorie bekijken”-
Open de detailpagina van een woning.
-
Scroll naar het onderdeel Wijzigingshistorie (History).
-
De wijzigingen worden weergegeven, gegroepeerd per maand (meest recente eerst).
-
Binnen elke maand zijn de wijzigingen verder gegroepeerd per datum, met het tijdstip van elke wijziging.
Weergave op de detailpagina
Section titled “Weergave op de detailpagina”Op de detailpagina van een woning ziet u een compacte weergave van de meest recente wijzigingen. Standaard worden de eerste drie wijzigingen van de meest recente dag getoond. Als er meer wijzigingen zijn op die dag, kunt u op “Show whole day” klikken om alle wijzigingen van die dag te bekijken.
Uitgebreide weergave
Section titled “Uitgebreide weergave”De volledige wijzigingshistorie is beschikbaar via een apart historieoverzicht. Hier worden alle wijzigingen getoond, gegroepeerd per maand. Elke maand kan worden in- of uitgeklapt met de + en - knoppen. U kunt verder filteren op een specifieke maand.
Een wijzigingsregel begrijpen
Section titled “Een wijzigingsregel begrijpen”Elke wijzigingsregel bevat de volgende informatie:
| Gegeven | Beschrijving |
|---|---|
| Tijdstip | Het tijdstip waarop de wijziging is doorgevoerd, weergegeven in het tijdformaat uit uw persoonlijke instellingen. |
| Omschrijving | Een leesbare omschrijving van de wijziging, bijvoorbeeld: “The property price has been updated from €250.000 to €275.000 by Jan Jansen.” |
| Oude waarde | De vorige waarde van het veld. |
| Nieuwe waarde | De huidige waarde van het veld. |
Details bekijken
Section titled “Details bekijken”Bij wijzigingen waar de oude en nieuwe waarde relevant zijn (aangegeven met de tekst “show details”), kunt u klikken om een zijpaneel te openen. Dit zijpaneel toont:
- Content — de volledige omschrijving van de wijziging.
- Aangemaakt op — de datum en het tijdstip van de wijziging, in het datum- en tijdformaat uit uw persoonlijke instellingen.
- Oude waarde — de volledige oude waarde van het veld.
- Nieuwe waarde — de volledige nieuwe waarde van het veld.
Bronnen van wijzigingen
Section titled “Bronnen van wijzigingen”Elke wijziging wordt geregistreerd met de bron die de aanpassing heeft veroorzaakt. Tesoro CRM onderscheidt vijf bronnen:
| Bron | Label in de historie | Beschrijving |
|---|---|---|
| Handmatig | By CRM User | De wijziging is handmatig aangebracht door een gebruiker in Tesoro CRM. De naam van de gebruiker wordt weergegeven. |
| Feed | By CRM Feed | De wijziging is afkomstig van een geïmporteerde feed (bijv. een XML-import of MLS-portaal). |
| AI | By CRM AI | De wijziging is uitgevoerd door een AI-functie binnen Tesoro CRM. |
| Systeem | By CRM System | De wijziging is automatisch doorgevoerd door het systeem (bijv. een achtergrondtaak of geplande opdracht). |
| Open API | By Open API Client | De wijziging is doorgevoerd via de Tesoro Open API door een externe applicatie. |
Bij handmatige wijzigingen wordt de volledige naam van de gebruiker weergegeven. Bij Open API-wijzigingen wordt “Open API” als naam getoond. Bij feed-wijzigingen zonder specifieke gebruiker wordt het label van de feed-bron weergegeven.
Velden met goedkeuring (feed-bescherming)
Section titled “Velden met goedkeuring (feed-bescherming)”Tesoro CRM beschermt handmatig bewerkte velden tegen overschrijving door automatische feed-imports. Dit mechanisme werkt als volgt:
-
Wanneer u een veld handmatig bijwerkt, wordt dit geregistreerd als een handmatige wijziging in de historie.
-
Als een latere feed-import een andere waarde voorstelt voor datzelfde veld, wordt de handmatige waarde beschermd en blijft de feed-waarde ongewijzigd.
-
De voorgestelde feed-wijziging wordt opgeslagen als wachtend op goedkeuring (
fields_update_pending_approval). -
U kunt de voorgestelde wijzigingen bekijken en beslissen of u deze wilt accepteren of negeren.
Datering en tijdzone
Section titled “Datering en tijdzone”Alle tijdstippen in de wijzigingshistorie worden geconverteerd naar de tijdzone van uw bedrijf. De weergave van datums en tijden volgt de datum- en tijdnotatie uit uw persoonlijke instellingen.
Wijzigingen worden gegroepeerd per maand in het formaat “Maand-Jaar” (bijv. “January-2025”). Binnen elke maand worden wijzigingen op datum gegroepeerd en in aflopende volgorde getoond, zodat de meest recente wijzigingen bovenaan staan.
Gegevensretentie
Section titled “Gegevensretentie”De volledige wijzigingshistorie wordt onbeperkt bewaard. Er is geen tijdslimiet: alle wijzigingen worden opgeslagen vanaf het moment dat de wijzigingshistorie actief is voor uw omgeving. De gegevens worden opgeslagen in een aparte databasecollectie (update_history), los van de woninggegevens zelf.
Veelgestelde vragen
Section titled “Veelgestelde vragen”Kan ik wijzigingen ongedaan maken via de historie? Nee. De wijzigingshistorie is een auditlog en biedt geen functionaliteit om wijzigingen terug te draaien. U kunt de oude waarde bekijken en deze handmatig herstellen in het woningformulier.
Worden beschrijvingen in meerdere talen apart bijgehouden? Ja. Wijzigingen in beschrijvingen worden per taal bijgehouden, inclusief titel en tekst afzonderlijk. Zo ziet u precies welke taalversie is aangepast.
Wat gebeurt er als de volgorde van beschrijvingen verandert? Een wijziging in de volgorde van taalbeschrijvingen (zonder inhoudelijke aanpassing) wordt niet geregistreerd als wijziging. Het systeem vergelijkt beschrijvingen op basis van de taalcode, niet op basis van de positie in de lijst.
Wat gebeurt er als ik een veld handmatig aanpas en daarna een feed-import binnenkomt? Uw handmatige waarde wordt beschermd. De feed-waarde wordt opgeslagen als “wachtend op goedkeuring” zodat u kunt beslissen of u deze wilt overnemen.
Worden wijzigingen via batch-updates bijgehouden? Ja. Wanneer u meerdere woningen tegelijk bijwerkt via een batch-update, wordt voor elke woning afzonderlijk een wijzigingshistorie aangemaakt.
Hoe worden wijzigingen aan bezichtigingen vastgelegd? Bezichtigingswijzigingen worden gedetailleerd bijgehouden, inclusief koppelingen naar de afspraak (meeting), het contact en de deal die bij de bezichtiging horen.
Wie heeft toegang tot de wijzigingshistorie?
Toegang tot de wijzigingshistorie wordt beheerd via het rechtensysteem van Tesoro CRM. Gebruikers hebben de permissie api/update-history/update-history/fetch nodig om de historie te kunnen bekijken.