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
- Open je accountpagina in het beheerportaal en ga naar het vak Je klanten exporteren.
- 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.
- Je krijgt een e-mail op het adres van je login zodra het klaar is, meestal binnen enkele minuten.
- 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.
| Bestand | Wat erin zit |
|---|---|
customers.json | Je 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.
| Bestand | Wat erin zit |
|---|---|
wallets.json | Het puntensaldo van elke klant. |
ledger_entries.json | Elke beweging van punten, met het type, het saldo erna en de aankoop die ze veroorzaakte. |
transactions.json | Elke aankoop, met de lijnen erop, de vestiging en de punten die ze opleverde. |
rewards.json | Je beloningen, met hun voorraad en geldigheid. Ook de verwijderde staan erin, als verwijderd gemarkeerd. |
redemptions.json | Elke beloning die een klant inwisselde, met de code en de status. |
vendor.json | Het 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.json | De adressen van je vestigingen, met de coördinaten die we ervoor vonden. |
branches.json | Je vestigingen, met het externe id dat jouw systemen ervoor gebruiken. |
users.json | De logins op je omgeving: naam, e-mailadres, rol en taal. Nooit een wachtwoord. |
products.json | Je producten. Ook de verwijderde staan erin, als verwijderd gemarkeerd. |
earn_rules.json | Je spaarregels en de geschiedenis van wijzigingen eraan. |
campaigns.json | Je campagnes en hun planning. Ook de verwijderde staan erin, als verwijderd gemarkeerd. |
campaign_awards.json | De punten die een campagne bij een aankoop toekende. |
campaign_moment_awards.json | De punten die een campagne bij een moment toekende, zoals een verjaardag. |
campaign_vouchers.json | De vouchers die campagnes uitdeelden, met hun code en of ze gebruikt zijn. |
invoices.json | De facturen die Puntjes je stuurde: nummer, datum, bedrag en status. |
api_clients.json | Je API-clients: id, label en vestiging. Nooit een secret. |
audit_log.json | Wie 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.