SpaceTegoed

Sample nodes

Wat is het SpaceTegoed

Het SpaceTegoed is het betaalsysteem van de Makerspace.

Het is te zien als je eigen rekening bij de Space. Het is een alternatief naast (en dus geen vervanger van) de Zwarte Pot op de tafel in de kleine ruimte. Omdat meer en meer mensen geen kleingeld meer op zak hebben.

Voorbeelden

Je kunt er je kop koffie of je biertje van betalen.

Je kunt er andere mensen van tracteren op een kop koffie of een biertje.

Je kunt er een gift aan de space mee doen, bv omdat je je schuldig voelt over de vele troep je gemaakt hebt.

Je kunt een mede lid 25 cent betalen omdat je een schroefje van haar gekregen hebt.

Als je een pak koffie of een krat bier voor de space gehaald hebt, kun je dat declareren waardoor je tegoed weer stijgt.

En in de toekomst kunnen we wellicht meer dingen toevoegen, zoals boetes voor projecten die te lang in de weg blijven liggen :-)

Storten

Als je SpaceTegoed te veel zakt kun je ook fysiek geld storten in je SpaceTegoed.

Opnemen

Geld opnemen van je SpaceTegoed kan door een verzoek daarvoor in te dienen. Een bestuurslid maakt het dan naar je over.

Veiligheid

De meeste transacties zijn virtueel en het gaat over het algemeen om kleine bedragen.

Elke maand wordt er een overzicht van alle rekening standen naar de deelnemers lijst gestuurd.

Bij het opnemen zijn altijd bestuursleden betrokken, er wordt uitsluitend geld overgemaakt naar het rekeningnummer waarvan het lidmaatschap wordt afgeboekt, en er is altijd een wachttijd van een week.

Verder zijn alle transacties openbaar, wanneer iemand de boel probeert te belazeren is dat voor de gehele gemeenschap zichtbaar.

Tot slot krijg je als eigenaar altijd een e-mailtje van je transacties: één keer direct na de transactie en één keer per maand met een overzicht en je balans aan het eind van de maand.

In deze mailtjes staat ook een link in waarmee je een transactie kunt terugdraaien. In dat geval krijgen alle bij de transactie betrokken partijen een e-mailtje dat jij dat gedaan hebt.

Wanneer je je lidmaatschap opzegt wordt het saldo van je SpaceTegoed overgemaakt naar je rekening, mits dit positief is. Bij een negeatief saldo wordt je verzocht dit eerst aan te zuiveren.

Retentie

Op de eerste van elke maand worden alle transacties die ouder zijn dan 3 maanden uit de transacties lijst gewist. De saldo stand aan het einde van de opgerolde periode blijft in stand ([rudimentair script].

Dus als je in maand één 10 euro inbracht, in maand twee 3 euro uitgaf dan is aan het eind van maand drie je saldo 7 euro. Als je dan in maand zes bent zie je van maand een-tot-drie alleen nog dat eindsaldo van 7 euro op de eerste dag van maand 4.

Omdat we backups hebben zijn deze nog wel voor het bestuur inzichtelijk voor een nog te bepalen periode (een stichting moet normaal gesproken dit soort dingen ten minste zeven (afgeronde belasting) jaren bewaren).

Hoe werkt het voor deelnemers

Er zijn 6 hoofdfuncties, waarvan je sommige op meerdere manieren kunt aanspreken.

1. Inzien van je transacties
2. Gerapporteerd krijgen van je transacties
3. Geld storten op je SpaceTegoed
4. Geld opnemen van je SpaceTegoed
5. Artikel betalen aan de space
6. Artikel declareren bij de space
7. SpaceTegoed overmaken aan een andere deelnemer
8. Correctie doen op een betaling

Inzien van je transacties

Dit doe je als je nieuwsgierig bent naar de transacties die er de afgelopen tijd gedaan zijn op je SpaceTegoed.

1. Log in op het CRM van de space en ga naar de pagina voor je SpaceTegoed
2. Hier zie je de hoogte van je tegoed en een overzicht van de de transacties van de afgelopen 3 maanden

Gerapporteerd krijgen van je transacties

Dit krijg je als trigger zodat je zelf kunt ontdekken of er onverwachtte transacties op je SpaceTegoed zijn geweest en/of als je de transacties langer wil kunnen bewaren.

1. Iedere maand krijg je een overzicht van je tegoed en alle transacties van de afgelopen 3 maanden.

NB: Om te voorkomen dat iedereen gespamt wordt, ook als je geen SpaceTegoed gebruikt, krijg je deze mail alleen als er de afgelopen drie maanden überhaubt transacties geweest zijn of wanneer je saldo negatief is.

Geld storten op je SpaceTegoed

Dit doe je als je bijvoorbeeld erg in de min staat op je SpaceTegoed en niet verwacht dat je binnenkort iets bij de space zult declareren.

Denk er aan dit deze actie tijd kost van bestuursleden, dus maak er niet te vaak gebruik van.

1. Stort het bedrag op bankrekening ##### van de space onder vermelding van "Storting SpaceTegoed <<LidNummer>>" (1)
2. Wacht tot de storting automatisch verwerkt is. NB: Omdat dit handwerk is voor de penningmeester kan dit even duren, tot maximaal 14 dagen.
3. Zodra dat verwerkt is - zie je dit terug in je SpaceTegoed -en- je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt.
4. De penningmeester krijgt een mailtje met de verwerkte transacties.
5. De penningmeester krijgt een mailtje met de stortingen die niet automatisch herkend werden (bijvoorbeeld omdat de text Storting SpaceTegoed ontbrak; of omdat het lidnummer niet herkend werd.

Let op: stortingen die niet de juiste omschrijving hebben ("Storting SpaceTegoed <<LidNummer>>") kunnen niet automatisch verwerkt worden en de penningmeester is niet altijd in staat dit te herkennen en te corrigeren.
Wanneer je niet binnen 14 dagen een mailtje krijgt van de verwerkte transactie, controleer dan eerst of je de juiste omschrijving hebt gegeven en neem dan pas contact op met de penningmeester (#####@MakerSpaceLeiden.nl).

(1) Voor een aantal banken staat er, in je maandelijkse overzicht en op je persoonlijke webpagina, een Qr code met alle details al ingevuld. Deze Qr code is *persoonlijk*; je <<LidNummer>> zit er in.

Geld opnmenen van je SpaceTegoed

Dit doe je als je bijvoorbeeld erg krap bij kas zit en je nog wel veel geld op je SpaceTegoed hebt staan.

Denk er aan dit deze actie tijd kost van bestuursleden, dus maak er niet te vaak gebruik van.

Methode 1: Via de mail

1. Stuur het bestuur (hetbestuuur@makerspace.nl) een mailtje dat je een bepaald bedrag wil opnemen, met de titel "Opname SpaceTegoed"
2. Na een paar dagen wordt het bedrag door het bestuur van je SpaceTegoed overgemaakt op je bankrekening
3. Je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt
4. Het geld staat op je bankrekening (kan even duren als de bank er lang over doet)

Let op: Voor de veiligheid wordt het bedrag alleen overgemaakt naar het bij het bestuur bekende bankrekeningnummer van de deelnemer Let op: Voor de veiligheid is er altijd een wachttijd van minimaal 7 dagen voordat het geld wordt overgemaakt

Methode 2: Via het CRM

1. Log in op het CRM en kies bij 'SpaceTegoed' voor de optie 'Geld opnemen van je SpaceTegoed'
2. Na een paar dagen wordt het bedrag door het bestuur van je SpaceTegoed overgemaakt op je bankrekening
3. Je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt
4. Het geld staat op je bankrekening (kan even duren als de bank er lang over doet)

Let op: Voor de veiligheid wordt het bedrag alleen overgemaakt naar het bij het bestuur bekende bankrekeningnummer van de deelnemer Let op: Voor de veiligheid is er altijd een wachttijd van minimaal 7 dagen voordat het geld wordt overgemaakt

Todo: formuliertje in CRM Todo: taak-record met timestamp maken in CRM Todo: aftrap maken voor notificatie voor penningmeester in CRM Todo: optie maken om taak-record af te vinken voor penningmeester in CRM

Artikel betalen aan de space

Dit doe je als je bijvoorbeeld een biertje uit de koelkast pakt of materialen (inclusief gas, stroom, enzovoort) van de makerspace hebt gebruikt.

Methode 1: Via een Betaalterminal

1. Ga naar een betaalterminal van de Space en doe de betaling
2. De betaling wordt van je SpaceTegoed afgeschreven en bijgeboekt op het SpaceTegoed van de space
3. Je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt

Methode 2: Via het CRM

1. Log in op het CRM van de space en doe de betaling
2. De betaling wordt van je SpaceTegoed afgeschreven en bijgeboekt op het SpaceTegoed van de space
3. Je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt

Artikel declareren bij de space

Dit doe je als je iets gekocht hebt voor de space, bijvoorbeeld een pak koffie of een krat bier.

Declaratie van grotere betalingen zoals een gasflesvulling of een rekening van HBM, moet nog via de oude manier.

Methode 1: Via een Betaalterminal

1. Ga naar een betaalterminal van de Space die geschikt is voor declaraties en doe daar de declaratie
2. De betaling wordt direct op je SpaceTegoed bijgeschreven en afgeboekt van het Spacetegoed van de space
3. Je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt

Let op: niet iedere betaalterminal is geschikt voor declaraties en/of niet vooraf ingestelde bedragen en/of grotere bedragen.

Methode 2: Via het CRM

1. Log in op het CRM van de space en doe de declaratie
2. De betaling wordt direct op je SpaceTegoed bijgeschreven en afgeboekt van het SpaceTegoed van de space
3. Je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt

SpaceTegoed overmaken naar een andere deelnemer

Dit doe je als je een andere deelnemer geld schuldig bent, bijvoorbeeld voor materialen.

1. Log in op het CRM van de space en doe de betaling naar de andere deelnemer.
2. De betaling wordt direct van je SpaceTegoed afgeschreven en bijgeschreven op het SpaceTegoed van de andere deelnemer.
3. Je krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt.
4. Ook de andere deelnemer krijgt op dat moment automatisch een mailtje waarin deze transactie vermeld wordt.

Correctie doen op een betaling

Dit doe je als je iets verkeerds hebt gedaan en dit ongedaan wil maken. Ga hier echter spaarzaam mee om, anders wordt het al gauw onoverzichtelijk.

1. Log in op het CRM van de space en verwijder de betreffende transactie.
2. De transactie wordt direct ongedaan gemaakt waardoor ook het saldo van jouw SpaceTegoed en dat van de tegenpartij aangepast wordt.
3. Je krijgt op dat moment automatisch een mailtje waarin het verwijderen van de transactie vermeld wordt.
4. Ook de tegenpartij krijgt op dat moment automatisch een mailtje waarin het verwijderen van de transactie vermeld wordt.

F: Moeten we dit echt wel ondersteunen? Correctieboekingen lijkt me veel overzichtelijker. DW: Ga even puzzelen - een correctie boeking is meer het Italiaanse/EU boekhoudsysteem - we zitten nu met een meer USA achtige monies aanpak.

Hoe werkt het voor het bestuur

Er zijn 6 hoofdfuncties, waarvan je sommige op meerdere manieren kunt aanspreken.

1. Inzien van de transacties
2. Gerapporteerd krijgen van de transacties
3. Verwerken van stortingen naar SpaceTegoed
4. Uitkeren van opnames uit SpaceTegoed
5. Correctie doen op een betaling
6. Handelingen bij nieuw lid
7. Handelingen bij opzegging lidmaatschap

Inzien van de transacties

Dit doe je als je nieuwsgierig bent naar de transacties die er de afgelopen tijd gedaan zijn op het SpaceTegoed van de MakerSpace

1. Log in op het CRM van de space en ga naar de pagina voor het SpaceTegoed van de MakerSpace
2. Hier zie je de hoogte van het tegoed en een overzicht van de transacties van de afgelopen 3 maanden

Gerapporteerd krijgen van de transacties

Dit krijg je als trigger zodat je zelf kunt ontdekken of er onverwachtte transacties op je SpaceTegoed zijn geweest en/of als je de transacties langer wil kunnen bewaren.

1. Iedere maand krijg het bestuur een overzicht van het tegoed en alle transacties van de afgelopen 3 maanden.

Verwerken van stortingen

Dit gebeurd wanneer een deelnemer een storting voor diens SpaceTegoed wil doen.

1. Download een overzicht van de mutaties op de bankrekening
2. Log in op het CRM en trap de automatische verwerking hiervan af
3. Van alle goed te verwerken stortingen krijgt de deelnemer een mailtje waarin deze transactie vermeld wordt
4. Van alle niet goed te verwerken stortingen wordt een overzicht getoond
   1. Verwerk de 'echte' stortingen handmatig in het CRM; deze worden dan alsnog verwerkt
   2. Vink de 'valse' stortingen af in het CRM; deze worden dan alleen gewist

Todo: verwerkingsscript in CRM Todo: niet goed te verwerken stortingen in lijstje zetten Todo: lijstje tonen aan penningmeester Todo: verwerkingsfuncties voor 'echte' stortingen Todo: verwerkingsfuncties voor 'valse' stortingen

Todo: mailnotificatie wanneer er taken voor de penningmeester openstaan in het CRM?

Uitkeren van opnames

Dit gebeurd wanneer een deelnemer om een opname uit diens SpaceTegoed wil doen.

Methode 1: Trigger via de mail

1. Je ontvangt een mailtje met in de titel "Opname SpaceTegoed" (case insensitive).
2. Markeer het mailtje als af te handelen binnen 7 dagen
3. Wacht tot je een herinnering hiervan krijgt
4. Maak het geld over op de rekening van de deelnemer onder vermelding van "Opname SpaceTegoed"
5. Log in op het CRM en registreer de opname.
6. Zowel het bestuur als de betreffende deelnemer krijgen direct een mailtje waarin deze transactie vermeld wordt.

Methode 2: Trigger via het CRM

1. Wanneer je inlogt op het CRM verschijnt er een waarschuwing dat er taken openstaan; hier kun je op doorklikken.
2. Voor iedere taak met de titel 'Uitkering opname':
   1. Controleer of er geen verdachte zaken zijn
   2. Maak het geld over op de rekening van de deelnemer onder vermelding van "Opname SpaceTegoed"
   3. Vink de taak af als zijnde afgerond
   4. Zowel het bestuur als de betreffende deelnemer krijgen direct een mailtje waarin deze transactie vermeld wordt.

Todo: waarschuwing in CRM dat er openstaande taken zijn in CRM Todo: overzicht van taken in CRM Todo: functie voor het afvinken in het CRM

Todo: mailnotificatie aan penningmeester wanneer er openstaande taken zijn in het CRM?

Correctie doen op een betaling

Dit doe je als je iets verkeerds hebt gedaan en dit ongedaan wil maken. Ga hier echter spaarzaam mee om, anders wordt het al gauw onoverzichtelijk.

1. Log in op het CRM van de space en verwijder de betreffende transactie.
2. De transactie wordt direct ongedaan gemaakt waardoor ook het saldo van het SpaceTegoed van de MakerSpace en dat van de tegenpartij aangepast wordt.
3. Het bestuur krijgt op dat moment automatisch een mailtje waarin het verwijderen van de transactie vermeld wordt.
4. Ook de tegenpartij krijgt op dat moment automatisch een mailtje waarin het verwijderen van de transactie vermeld wordt.

Moeten we dit echt wel ondersteunen? Correctieboekingen lijkt me veel overzichtelijker.

Handelingen bij nieuw lid

1. Registreren van Lidnummer, Naam, E-mail adres, Rekeningnummer

In welk systeem?

Wat zou er verder moeten gebeuren?

Handelingen bij opzegging lidmaatschap

Wanneer een lid zijn lidmaatschap opzegt moet het volgende gebeuren:

1. Log in op het CRM van de space en zoek het lid op.
2. Bij een positief saldo: maakt het saldo over op de rekening van de deelnemer
3. Bij een negatief saldo: vraag het lid om het saldo aan te zuiveren

Pas bij een nul-saldo mag het lid daadwerkelijk uitgeschreven worden.

Het koppelen van betaalterminals aan het betaalsysteem

Er is een abstractie tussen een betaal station en de daadwerkelijke fysieke terminal die er op dat moment 'aan hangt'.

Dit is omdat sommige stations van alles kunnen (inclusief in de toekomst misschien arbitraire bedragen) en anderen alleen één artikel of een paar artikelen uit een beperkte lijst kunnen afrekenen.

Registreren bestuurslid als Pettycash Beheerder

Het is noodzakelijk dat je door een bestuurslid aangemerkt wordt als Pettycash Beheerder:

1. Bestuurslid logt in met haar eigen account.
2. Bestuurslid doet 'sudo' en loopt door de GDPR audit/procedure.
3. Bestuurslid gaat naar 'raw database access', dan naar 'Users' en zoekt op de persoon haar naam.
4. In het details record van de persoon wordt een lidmaadschap van de groep 'Pettycash Beheerder' aan de persoon toegevoegd. En dan Save.

De gebruiker krijgt onmiddellijk deze rechten.

Aansluiten fysieke payment terminal

Een fysieke payment terminal maakt zich bij eerste opstarten automatisch aan. Het moet echter wel expliciet geaccordeerd worden.

1. Zet het apparaat (voor de eerste keer) aan.
2. Op het scherm verschijnt (indien de wifi werkt, etc) de text 'swipe to connect'. Als dit niet gebeurt heeft het apparaat nog een geldige verbinding.
3. Een Pettycash Beheerder heeft nu 100 seconden om zijn of haar tag te gebruiken om akkoord te geven op de connectie. Indien je te laat bent begin je gewoon op stap nummer 1.
4. Alle Pettycash Beheerder krijgen een mailtje als dit gebeurt.
5. De Pettycash Beheerder logt nu in op het CRM.
6. Selecteer de optie 'Terminal beheer'. Hier wordt een lijst getoond van de recent aangemelde (nieuwe) terminals.
7. Selecteer het juiste station. Een eventueel vorige terminal toekenning wordt overschreven.
8. Alle Pettycash Beheerder krijgen een mailtje dat dit gebeurt is.

Het apparaat is nu bekend bij het CRM. Het moet nu aan een betaal station gekoppeld worden.

Aanmaken nieuw Betaal Station

1. Log in met eigen account.
2. Pettycash Beheerder doet 'sudo' en loopt door de GDPR audit/procedure.
3. Pettycash Beheerder ziet nu een stel extra opties in de normale lijst op https://makerspaceleiden.nl/crm/
4. Selecteer de optie 'Station beheer'; en dan 'voeg station toe'
5. Indien het station alleen bepaalde dingen kan verkopen; vink deze dan aan. Je kan ook niets aanvinken; bijvoorbeeld bij een betaal terminal die arbitraire bedragen toelaat.
6. Indien relevant - kies het 'default' product waar de terminal telkens naar terug springt (na opstarten, na 5 minuten idle). Bijvoorbeeld 'koffie' voor de unit naast de Senseo; of 'bier' voor de unit naast de IJskast.
7. Koppel het station aan een van de fysieke payment terminals uit de lijst.
8. Herstart / reset / powercycle de fysieke payment terminal.

Omzetten bestaand betaal station naar nieuwe hardware

1. Doorloop eventueel de stappen uit `Pairen fysieke payment terminal` indien het station nieuw is.
2. Log in met eigen account.
3. Pettycash Beheerder doet 'sudo' en loopt door de GDPR audit/procedure.
4. Pettycash Beheerder ziet nu een stel extra opties in de normale lijst op https://makerspaceleiden.nl/crm/
5. Selecteer de optie 'Station beheer'; en dan 'modify station'
6. Her-koppel het station aan een van de fysieke payment terminals uit de lijst.
7. Herstart / reset / powercycle de fysieke payment terminal.

Typen betaalterminals

• Payment Terminal with 4 seven segment displays waar je maar voor één ding kan betalen.
• Payment Terminal with TFT screen waar je kan kiezen waarvoor of wat je betaald.

REST protocol

Current prefix: pettycash/api/v1

1. Connecting/registering
   1. call to <prefix>/register?name=<name>. If already registered/accepted; a 200-OK is given along with the registration details as a JSON. Otherwise a 401 is returned with a NONCE
   2. call to <prefix>/register?response=<256 bit sha256 as hex>. the SHA256 of the nonce, tag, client-sha256 and server-256 is provided. If correct, a 200-OK is given along with the registration details as a JSON. Otherwise a 400 or 500 is given; depending on the error.

The JSON consists of the actual name, descriptive string and, where applicable, the priceless.

Mail templates

De template voor het mailtje direct na een transactie: https://github.com/MakerSpaceLeiden/makerspaceleiden-crm/blob/master/pettycash/templates/email_tx.txt

De template aan het eind van de maand: https://github.com/MakerSpaceLeiden/makerspaceleiden-crm/blob/master/pettycash/templates/balance-email.txt

Het template naar de deelnemers lijst https://github.com/MakerSpaceLeiden/makerspaceleiden-crm/blob/master/pettycash/templates/balance-overview-email.txt

Consolidate oude transacties -- not yet done - rudimentair script: https://github.com/MakerSpaceLeiden/makerspaceleiden-crm/blob/master/pettycash/management/commands/pettycash-consolidate.py