# VoordeMensen — Volledige Documentatie
> White-label ticketplatform voor theaters, concertzalen, festivals en evenementen. Gebouwd door mensen uit de cultuursector, zonder commissie per ticket.

VoordeMensen is al 14+ jaar actief, bedient 50+ theaters en festivals, en heeft meer dan 1.000.000 tickets verkocht. Opgericht vanuit de praktijk door mensen van Holland Festival, Bimhuis en Amsterdam Fringe Festival.

---

## Inhoudsopgave

- [Over VoordeMensen](#over-voordemensen)
- [Platform & Features](#platform--features)
- [Kosten](#kosten)
- [Klanten](#klanten)
- [Tickets bestellen (bezoekersflow)](#tickets-bestellen-bezoekersflow)
- [Integraties](#integraties)
- [API Documentatie](#api-documentatie)
- [Server architectuur](#server-architectuur)
- [Contact](#contact)

---

## Over VoordeMensen

VoordeMensen is een compleet ticketplatform specifiek voor de cultuursector. Het systeem is white-label: bezoekers kopen tickets op de website van het theater of festival zelf, zonder redirect naar een extern platform.

### Kernwaarden
- **Persoonlijk contact** — Geen helpdesk of ticketnummers. Direct telefonisch contact met teamleden die je situatie kennen. Support ook buiten kantoortijden.
- **Innovatie voorop** — Continu doorontwikkeling van features, slimmere workflows en betere integraties.
- **Eén voor allen** — Features die één klant aanvraagt komen beschikbaar voor alle klanten.
- **Praktijkervaring** — 30+ jaar gecombineerde ervaring in theaters en festivals. Gebouwd vanuit echte behoeften.

### Team
- **Chiel** — Oprichter & dagelijkse operatie. Achtergrond: Bimhuis, Holland Festival, Amsterdam Fringe Festival.
- **Jay** — Developer & technisch brein. Bouwt complexe integraties en features.

---

## Platform & Features

### Webshop & Checkout
- Insluiten als booking module op eigen website (geen redirect nodig)
- Geen account of registratie nodig voor bezoekers
- Betaalmethodes: iDEAL, creditcard, Bancontact, Apple Pay
- Directe digitale ticketlevering per e-mail (PDF met QR-code)
- Apple Wallet en Google Wallet integratie (één klik)
- Stoelkeuze op interactieve plattegrond bij zaalvoorstellingen
- Beste-stoelen-algoritme: wijst automatisch eerlijk de beste beschikbare plekken toe
- Kortingscodes en promotiemogelijkheden
- Cadeaubonnen
- Seizoenskaarten en passen
- Wachtlijst bij uitverkochte voorstellingen met automatische melding

### Dashboard & Beheer
- Realtime inzicht in bezetting, omzet en bezoekersdata
- Evenementen aanmaken en prijsbeheer
- Terugbetalingen en omboekingen in 3 klikken
- Geautomatiseerde facturen voor promotors
- Data-export naar Excel en PDF
- Custom rapportages
- Metabase BI-integratie voor datavisualisatie en patronen ontdekken
- Geldstroom rechtstreeks naar eigen Mollie-account van het theater/festival

### Kassa & Scanning
- Browser-based webkassa voor deurverkoop
- Pinbetaling via PayPal/Zettle of SumUp
- Digitale ticketlevering of lokaal printen (Boca/Star printers)
- Gratis iOS & Android scan-app met offline modus
- Intuïtief genoeg voor vrijwilligers zonder training

### Omzet & Groei
- **Smart Upsell** — Verkoop snacks, drankjes, parkeerkaarten, merchandise direct in de checkout
- **Kortingscodes** — Promotiecodes om publiek te trekken
- **Donatiemodule** — Bezoekers kunnen bijdragen tijdens aankoop
- **Cross-selling** — Aanbeveling van gerelateerde evenementen op basis van koopgedrag

### Bezoekservaring
- Geen login of verificatiecodes nodig
- Zelf omboeken naar andere datum zonder contact met box office
- VIP- en gastenlijsten met speciale links en toegang tot afgeschermde secties
- Wachtlijst met automatische notificatie bij beschikbaarheid

### E-mail & Communicatie
- Ingebouwde service- en info-mails
- Segmentatie en automatisering
- Of integratie met Mailchimp of Brevo voor geavanceerde campagnes

### Styling & Branding
- Volledig aanpasbare checkout, tickets en e-mails
- Template-based of volledig eigen HTML/CSS
- White-label: alles in de huisstijl van het theater/festival

---

## Kosten

### Voor Podia & Theaters
- **€225 per maand**
- Volledig softwarepakket inclusief alle features
- Setup-ondersteuning en advies
- Telefonische, e-mail en on-site support
- Per kwartaal opzegbaar
- **Geen commissie per ticket**

### Voor Festivals & Evenementen
- **€2.250 per editie**
- Volledig softwarepakket inclusief alle features
- Setup-ondersteuning en advies
- Telefonische, e-mail en on-site support
- Kleine maatwerk-aanpassingen inbegrepen
- **Geen commissie per ticket**

### Overige kosten
- Online betalingsverwerking via Mollie: ~€0,15 per ticket (gaat rechtstreeks naar venue)
- Pinbetalingen aan de deur: ~2% transactiekosten
- Transactiekosten kunnen worden doorberekend aan bezoekers
- Donatiemodule kan softwarekosten (deels) dekken

---

## Klanten

### Theaters & Podia
- Theater Bellevue — Amsterdam, 3 zalen
- Bostheater — Openluchttheater Amsterdam
- Rijksakademie — Kunstacademie en expositieruimte
- De Brakke Grond — Vlaams Cultuurhuis
- Theater Perdu — Experimenteel theater
- De Richel — Cabaret en klein theater
- De Sloot — Culturele creatieve ruimte
- Scala — Dinnertheater & Foodbar

### Festivals & Evenementen
- Nederlands Film Festival
- LUBACH
- RTL Tonight
- De Slimste Mens
- IMPAKT Festival — Media art
- Karavaan — Cultureel festival
- Kaeskoppenstad — Historisch festival
- Gaudeamus Muziekweek — Hedendaagse muziek
- Read My World — Literair festival

### Klantervaringen
> "Sinds 2023 zijn we heel blij met VoordeMensen. Zeer gebruiksvriendelijk aan zowel de voor- als achterkant. Het team reageert supersnel met zorgvuldige oplossingen. Ze denken mee en verbeteren het systeem continu." — **Theater Bellevue**

> "Wat vroeger een fulltime baan was — handmatig ~2.400 publiek per seizoen indelen — is nu geautomatiseerd. De interface is heel gebruiksvriendelijk en de klantenservice is mega snel en vriendelijk. Zou niet meer zonder willen." — **De Slimste Mens**

> "We gebruiken VoordeMensen al een paar jaar. We hebben specifieke wensen, maar VoordeMensen staat altijd voor ons klaar. 24/7 bereikbaar, heel betrokken, professioneel én persoonlijk contact." — **Scala Theater & Foodbar**

---

## Tickets bestellen (bezoekersflow)

### Stap 1: Evenement kiezen
- Bekijk het overzicht op de website van het theater/festival
- Klik op een evenement voor details (datum, tijd, prijs, beschrijving)

### Stap 2: Tickets selecteren
- Kies kaartsoort (regulier, korting, CJP, 65+, etc.)
- Selecteer aantal tickets
- Bij zaalvoorstellingen: kies stoelen op interactieve plattegrond
- Optioneel: voeg upsell-producten toe (drankjes, parkeren, etc.)
- Optioneel: voer kortingscode in

### Stap 3: Gegevens invullen
- E-mailadres (verplicht, voor ticketlevering)
- Voornaam en achternaam
- Geen account aanmaken nodig

### Stap 4: Betalen
- Kies betaalmethode: iDEAL, Bancontact, creditcard, Apple Pay
- Na betaling: tickets direct per e-mail als PDF met QR-code
- Optioneel: toevoegen aan Apple Wallet of Google Wallet

### Na aankoop
- Tickets zijn direct geldig (QR-code wordt gescand bij de deur)
- Zelf omboeken naar andere datum via link in bevestigingsmail
- Bij uitverkocht: automatisch op wachtlijst plaatsen

---

## Integraties

### CMS & Website
- **WordPress** — Kant-en-klare plugin voor embedden van booking module
- Elke website — Universele embed-code (iframe/JavaScript)

### Marketing & E-mail
- **Mailchimp** — Synchroniseer bezoekers, segmenten en campagnes
- **Brevo** — E-mailautomatisering
- Ingebouwde e-mailtools voor service- en infomails

### CRM & Planning
- **DIP** — Theatermanagement-integratie
- **Culturesuite** — Culturele sector CRM
- **Yesplan** — Planningssoftware
- Custom API-koppelingen mogelijk

### Analytics & Tracking
- **Google Analytics 4** — Bezoekersgedrag en conversies
- **Meta Pixel** — Facebook/Instagram advertentie-tracking
- **Matomo** — Privacy-vriendelijke analytics

### Business Intelligence
- **Metabase** — Datavisualisatie en rapportages

### Betalingen
- **Mollie** — Primaire payment provider (geld gaat direct naar venue)
- **PayPal/Zettle** — Pinterminal voor deurverkoop
- **SumUp** — Pinterminal voor deurverkoop

### API & Webhooks
- REST API voor alle data (evenementen, tickets, bestellingen)
- Webhooks voor realtime notificaties
- OpenAPI specificatie beschikbaar

---

## API Documentatie

### Referenties
- OpenAPI specificatie: https://tickets.voordemensen.nl/openapi.yaml
- API-documentatie: https://docs.voordemensen.nl/api/introduction
- Gebruikersdocumentatie: https://docs.voordemensen.nl

### Base URL
```
https://api.voordemensen.nl/v1/voordemensen/
```

### Publieke endpoints (geen authenticatie vereist)

#### Evenementen ophalen
```
GET /events
```
Retourneert een lijst van alle beschikbare evenementen.

```
GET /events/{id}
```
Retourneert details van een specifiek evenement (naam, datum, locatie, beschrijving, prijzen).

```
GET /events/{id}/avail
```
Retourneert beschikbaarheid voor een evenement (aantal vrije plaatsen, stoelen).

#### Kaartsoorten & Kortingen
```
GET /tickettypes/{event_id}
```
Retourneert beschikbare kaartsoorten voor een evenement (regulier, korting, CJP, etc.) met prijzen.

```
GET /discounts/{event_id}
```
Retourneert beschikbare kortingen voor een evenement.

#### Betaalmethodes
```
GET /paymentmethods
```
Retourneert beschikbare betaalmethodes (iDEAL, creditcard, Bancontact, etc.) met hun `payment_id`.

#### Locaties & Evenementtypes
```
GET /locations
```
Retourneert alle locaties/zalen.

```
GET /eventtypes
```
Retourneert alle evenementtypes/categorieën.

### Bestelflow

De bestelflow bestaat uit 4 stappen: winkelwagen aanmaken, tickets toevoegen, bestelling plaatsen, status controleren.

#### Stap 1: Winkelwagen aanmaken
```
POST /cart

Response:
{
  "cart_id": "abc123..."
}
```
Maakt een nieuwe winkelwagen aan. Bewaar de `cart_id` voor vervolgstappen.

#### Stap 2: Tickets toevoegen
```
POST /cart/{cart_id}

Body:
{
  "event_id": 123,
  "numberoftickets": 2,
  "discount_id": "encoded_hashid"
}
```
Voegt tickets toe aan de winkelwagen. `discount_id` is optioneel en verwijst naar een kaartsoort/korting uit het `/tickettypes` of `/discounts` endpoint.

#### Winkelwagen bekijken
```
GET /cart/{cart_id}
```
Retourneert de inhoud van de winkelwagen (tickets, prijzen, totaal).

#### Ticket verwijderen uit winkelwagen
```
DELETE /cart/{cart_id}/{seat_id}
```
Verwijdert een specifiek ticket/stoel uit de winkelwagen.

#### Stap 3: Bestelling plaatsen
```
POST /order/create
Content-Type: application/x-www-form-urlencoded

cart_id=abc123...
payment_id=33
email=klant@voorbeeld.nl
firstname=Jan
lastname=Jansen

Response:
{
  "url": "https://www.mollie.com/checkout/...",
  "order_key": "uuid-here"
}
```
Plaatst de bestelling en retourneert een Mollie betaal-URL. Redirect de gebruiker naar `url` om te betalen. Bewaar `order_key` om de status te controleren.

Parameters:
- `cart_id` (verplicht) — ID van de winkelwagen
- `payment_id` (verplicht) — ID van betaalmethode (uit `/paymentmethods`)
- `email` (verplicht) — E-mailadres voor ticketlevering
- `firstname` (verplicht) — Voornaam
- `lastname` (verplicht) — Achternaam

#### Stap 4: Bestellingstatus controleren
```
GET /order/{order_key}
```
Retourneert de status van een bestelling (betaald, in afwachting, geannuleerd) en ticketgegevens.

---

## Server architectuur

| Server | URL | Functie |
|--------|-----|---------|
| API | api.voordemensen.nl | Lumen API voor alle endpoints |
| Tickets | tickets.voordemensen.nl | Orderverwerking en betalingen |

**Let op:** Sommige GET endpoints redirecten naar de tickets-server. Configureer je HTTP-client om redirects automatisch te volgen.

---

## Contact

- **E-mail**: info@voordemensen.nl
- **Telefoon**: +31 20 427 27 28
- **WhatsApp**: beschikbaar
- **Adres**: Nieuwe Achtergracht 74, 1018 XZ Amsterdam
- **Website**: https://voordemensen.nl