# Yesplan

Yesplan is veelgebruikte planningssoftware in de culturele sector. Je kan vanuit Yesplan een koppeling met VoordeMensen maken om bijvoorbeeld verkoopstanden op te vragen. 

{% hint style="info" %}
Het compleet beheren van je evenementen of bestellingen vanuit Yesplan kan niet: dat zul je vanuit VoordeMensen moeten blijven doen.
{% endhint %}

Om de koppeling te maken moet je in Yesplan een [Generic API configureren](https://manual.yesplan.be/nl/integraties/generic-ticketing-configuration/). Volg de stappen in de handleiding van Yesplan. In het VoordeMensen dashboard vind je de gegevens die je van ons nodig hebt: het URL, de username en het password.  

![](https://1413156064-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ld8rUL_Nw-xlkKkoLIA%2F-MZibiDDAEnvApd8I93z%2F-MZicfqm-sK6w32TwH2F%2Fimage.png?alt=media\&token=8cd4ef53-40f9-40e4-b539-457f4629eb33)

{% hint style="warning" %}
VoordeMensen ondersteunt op dit moment nog geen *productions*, maar wel *deletion* en *retrieving by month*. Bij het configureren van je Generic API kun je dus het eerste vinkje uitzetten, al gebeurt er niets geks als je het aan laat staan.
{% endhint %}

### Koppelen

In het VoordeMensen dashboard kun je  evenementen koppelen met Yesplan (op het Yesplan event-id en/of production-id). Zo weten wij, wat zij bedoelen als ze met ons praten. En andersom. Wanneer je vanuit Yesplan een evenement pusht naar VoordeMensen wordt bovenstaande tabel automatisch ingevuld. 

{% hint style="info" %}
Bij het aanmaken van evenementen vanuit Yesplan in VoordeMensen maken we automatisch één main en één sub-evenement aan, met een capaciteit van 0 en een prijs van 0. Met andere woorden: na het aanmaken in Yesplan zul je naar VoordeMensen moeten om de gegevens aan te vullen.
{% endhint %}

### Opvragen gegevens

Om gegevens uit VoordeMensen te tonen in Yesplan moet je zg. Remote Data velden koppelen aan je eigen datavelden. Zie voor meer informatie [de handleiding van Yesplan](https://manual.yesplan.be/nl/integraties/generic-ticketing-configuration/). 

VoordeMensen stuurt de volgende gegevens terug die je kan koppelen aan je eigen Yesplan-velden:

```
{
    "event-id": "3432391937-1483009247",
    "production-id": "3432391937-1483009248",
    "name": "VoordeMensen Demo Event",
    "location": "Theater de Cameleon",
    "starttime": "2022-04-01T20:30:00+02:00",
    "endtime": "2022-04-01T22:30:00+02:00",
    "in-sale": true,
    "closed": false,
    "vdm_event_id": 95,
    "vdm_event_main_id": 94,
    "event_capacity": 1000,
    "event_free": 956,
    "tickets_paid": 36,
    "tickets_complimentary": 8,
    "tickets_reserved": 2,
    "event_paid_revenue": 793,
    "event_paid_revenue_currency": "EUR",
    "event_paid_ticket_types": [
        {
            "ticket_type": null,
            "ticket_price": "5.00",
            "ticket_total": 2
        },
        {
            "ticket_type": null,
            "ticket_price": "24.50",
            "ticket_total": 5
        },
        {
            "ticket_type": "CJP",
            "ticket_price": "23.50",
            "ticket_total": 3
        },
        {
            "ticket_type": "stadspas",
            "ticket_price": "18.38",
            "ticket_total": 4
        },
        {
            "ticket_type": "Standaard",
            "ticket_price": "24.50",
            "ticket_total": 21
        },
        {
            "ticket_type": "Uitflits",
            "ticket_price": "2.00",
            "ticket_total": 1
        },
        {
            "ticket_type": "VoordeMensen",
            "ticket_price": "0.00",
            "ticket_total": 8
        }
    ],
    "event_reserved_revenue": 49
}
```