Handleidingen

Je omgeving exporteren

Alles wat Puntjes voor je zaak bijhoudt, kun je meenemen: wanneer je wilt, op elk plan, zonder kosten. De knop op je accountpagina geeft je meteen je klantenbestand; elk ander onderdeel krijg je door het te vragen. Deze pagina is meteen ook het overzicht van wat dat betekent en in welk formaat.


Zo vraag je het aan

  1. Open je accountpagina in het beheerportaal en ga naar het vak Je klanten exporteren.
  2. Klik op Mijn klanten exporteren. Puntjes maakt het bestand op de achtergrond, dus je mag de pagina sluiten. Wil je meer dan je klantenbestand, mail dan het adres dat in het vak staat.
  3. Je krijgt een e-mail op het adres van je login zodra het klaar is, meestal binnen enkele minuten.
  4. Download het op je accountpagina. Meld je eerst aan: het archief bevat persoonsgegevens van je klanten, dus de link werkt alleen voor een beheerder van je omgeving.

Een archief blijft zeven dagen beschikbaar en wordt daarna verwijderd. Je kunt één export per uur aanvragen, en je accountpagina toont de laatste. Alleen een beheerder van de omgeving kan dat; een gewone login niet. Een archief dat we maken omdat je erom mailde, volgt dezelfde regels zodra het klaar is.


Wat zit er in het archief

Het archief is een zipbestand. Elk bestand erin is één JSON-array, in UTF-8, met datums als ISO 8601 en bedragen in centen. De veldnamen zijn dezelfde als in de API, dus een programma dat de API al leest, leest ook het archief. manifest.json noemt elk bestand met zijn aantal rijen, het moment waarop de export is gemaakt en welke van de twee je hebt gevraagd.

Wat je met de knop krijgt

Eén bestand: je klantenbestand. Dat is wat een zaak vraagt als ze haar klanten terug wil, en het is het enige dat de accountpagina zelf meegeeft.

BestandWat erin zit
customers.jsonJe klanten met hun identifiers, de code van hun klantenkaart, en de toestemming voor marketingmail met wanneer en hoe die is gegeven of ingetrokken. Geanonimiseerde klanten zitten er niet in, want daar is niets meer van over.

Wat je krijgt als je het vraagt

De achttien bestanden hieronder zijn ook van jou, gratis. Mail het adres op je accountpagina en we maken het volledige archief voor je, ten laatste binnen dertig dagen. We vragen dat via mail en niet via een knop omdat in die bestanden je logins, je facturen en de geschiedenis van wie wat wijzigde zitten, en bijna niemand ze nodig heeft tot hij vertrekt.

BestandWat erin zit
wallets.jsonHet puntensaldo van elke klant.
ledger_entries.jsonElke beweging van punten, met het type, het saldo erna en de aankoop die ze veroorzaakte.
transactions.jsonElke aankoop, met de lijnen erop, de vestiging en de punten die ze opleverde.
rewards.jsonJe beloningen, met hun voorraad en geldigheid. Ook de verwijderde staan erin, als verwijderd gemarkeerd.
redemptions.jsonElke beloning die een klant inwisselde, met de code en de status.
vendor.jsonHet profiel van je zaak: namen, contactgegevens, btw-nummer, factuuradres, de instellingen van je programma en je eigen verzenddomein als je er een hebt ingesteld.
addresses.jsonDe adressen van je vestigingen, met de coördinaten die we ervoor vonden.
branches.jsonJe vestigingen, met het externe id dat jouw systemen ervoor gebruiken.
users.jsonDe logins op je omgeving: naam, e-mailadres, rol en taal. Nooit een wachtwoord.
products.jsonJe producten. Ook de verwijderde staan erin, als verwijderd gemarkeerd.
earn_rules.jsonJe spaarregels en de geschiedenis van wijzigingen eraan.
campaigns.jsonJe campagnes en hun planning. Ook de verwijderde staan erin, als verwijderd gemarkeerd.
campaign_awards.jsonDe punten die een campagne bij een aankoop toekende.
campaign_moment_awards.jsonDe punten die een campagne bij een moment toekende, zoals een verjaardag.
campaign_vouchers.jsonDe vouchers die campagnes uitdeelden, met hun code en of ze gebruikt zijn.
invoices.jsonDe facturen die Puntjes je stuurde: nummer, datum, bedrag en status.
api_clients.jsonJe API-clients: id, label en vestiging. Nooit een secret.
audit_log.jsonWie wat wanneer veranderde in je omgeving.

Na een opzegging

Opzeggen verwijdert je gegevens niet. Je omgeving blijft bestaan tot het einde van de periode die je hebt betaald en de bewaartermijn daarna, en zolang kun je een export aanvragen. Hoelang dat is, en wat er op het einde wordt verwijderd, lees je op de pagina over je gegevens. Wil je je gegevens sneller kwijt, dan verwijder je je account en je omgeving op je accountpagina.