# 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.  

![](/files/-MZicfqm-sK6w32TwH2F)

{% 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
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.voordemensen.nl/dashboard/koppelingen/yesplan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.