Yesplan

VoordeMensen ondersteunt de Yesplan Generic API zodat je verkoopstanden in Yesplan kan inzien.

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

Het compleet beheren van je evenementen of bestellingen vanuit Yesplan kan niet: dat zul je vanuit VoordeMensen moeten blijven doen.

Om de koppeling te maken moet je in Yesplan een Generic API configureren. 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.

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.

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.

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.

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.

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
}