.. _arrangementen: Arrangementen ============= Huidige versie: 1.2.0 Read ---- .. http:get:: /api2/arrangementen Lijst van arrangementen in Recras Dit endpoint is ook publiek toegankelijk. Wanneer dit endpoint niet-geauthenticeerd wordt opgevraagd, worden alleen de arrangementen met het kenmerk ``mag_api`` weergegeven, daarnaast worden enkele velden verborgen: * ``mag_uitjes`` * ``mag_api`` * ``mag_online_geboekt_worden_direct_betalen`` * ``mag_online_geboekt_worden_achteraf_betalen`` * ``maximum_aantal_personen_online`` * ``mag_beschikbaarheidskalender_api`` * ``startmomentgroep_id`` * ``mag_online`` * ``onlineboeking_minimaal_vooruit`` * ``onlineboeking_maximaal_vooruit`` * Only certain fields in package-line list ``regels`` are available: * ``id``: unique identifier * ``begin``: start-time of the line * ``eind``: end-time of the line * ``beschrijving_templated``: Line description, with Recras-tags expanded * ``aantal_personen``: The number of items in the line (only for display of example programme) * ``max``: The maximum acceptable number of items for online bookings * ``onlineboeking_aantalbepalingsmethode``: The method for determining ``aantal_personen`` for online bookings. Possible values are ``invullen_door_gebruiker`` (the customer should select a number) and ``boekingsgrootte`` (to be calculated from the booking size). * ``product.id``: unique identifier of the product associated with the line * ``product.weergavenaam``: name of the product, suitable for showing to customers * ``product.beschrijving_klant``: a short description of the product, suitable for showing to customers * ``product.uitgebreide_omschrijving``: a longer description of the product, suitable for showing to customers * ``product.verkoop``: the sale price for a single unit of the product * ``product.minimum_aantal``: the minimum number of units that must be charged of this product * ``product.vereist_product``: this list will be empty * ``product.standaardbijlagen``: this list will be empty **Voorbeeld request**: .. sourcecode:: http GET /api2/arrangementen HTTP/1.1 Host: demo.recras.nl Accept: application/json **Voorbeeld response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json [ { "id": 4, "arrangement": "Boogschieten/Klimmen met Buffet", "ontvangstlocatie": "", "mag_uitjes": true, "mag_api": true, "mag_online_geboekt_worden_direct_betalen": false, "mag_online_geboekt_worden_achteraf_betalen": false, "maximum_aantal_personen_online": null, "mag_beschikbaarheidskalender_api": false, "startmomentgroep_id": null, "aantal_personen": 10, "onlineboeking_contactformulier_id": "2", "onlineboeking_minimaal_vooruit": "PT0S", "onlineboeking_maximaal_vooruit": null, "mag_online": false, "prijs_totaal_exc": 530, "prijs_totaal_inc": 561.8, "prijs_pp_exc": 53, "prijs_pp_inc": 56.18, "regels": [ { "id": 8, "locatie_id": 3, "begin": "1970-06-11T13:30:00+01:00", "eind": "1970-06-11T14:00:00+01:00", "beschrijving": "U wordt ontvangen met koffie,thee en een plak heerlijke cake", "aantal_personen": 10, "product_id": 10 }, { "id": 5, "locatie_id": 4, "begin": "1970-06-11T14:00:00+01:00", "eind": "1970-06-11T15:00:00+01:00", "beschrijving": "Leer boogschieten op onze boogschietbaan ", "aantal_personen": 10, "product_id": 7 }, { "id": 6, "locatie_id": 4, "begin": "1970-06-11T15:30:00+01:00", "eind": "1970-06-11T18:30:00+01:00", "beschrijving": "Klimmen op onze klimbaan onder begeleiding van een ervaren instructeur", "aantal_personen": 10, "product_id": 6 }, { "id": 7, "locatie_id": 1, "begin": "1970-06-11T18:30:00+01:00", "eind": "1970-06-11T20:30:00+01:00", "beschrijving": "Waan je in Zuidafrika met het Zuidafrikaanse buffet", "aantal_personen": 10, "product_id": 1 } ], "programma": [ { "omschrijving": "U wordt ontvangen met koffie,thee en een plak heerlijke cake", "aantal": 10, "begin": "PT0H0M0S", "duur": "PT0H30M0S", "eind": "PT0H30M0S" }, { "omschrijving": "Leer boogschieten op onze boogschietbaan ", "aantal": 10, "begin": "PT0H30M0S", "duur": "PT1H0M0S", "eind": "PT1H30M0S" }, { "omschrijving": "Klimmen op onze klimbaan onder begeleiding van een ervaren instructeur", "aantal": 10, "begin": "PT2H0M0S", "duur": "PT3H0M0S", "eind": "PT5H0M0S" }, { "omschrijving": "Waan je in Zuidafrika met het Zuidafrikaanse buffet", "aantal": 10, "begin": "PT5H0M0S", "duur": "PT2H0M0S", "eind": "PT7H0M0S" } ] }, { "id": 13, "arrangement": "Huur Groepsaccommodatie", "ontvangstlocatie": "", "mag_uitjes": true, "mag_api": true, "mag_online_geboekt_worden_direct_betalen": true, "mag_online_geboekt_worden_achteraf_betalen": false, "maximum_aantal_personen_online": null, "mag_beschikbaarheidskalender_api": true, "startmomentgroep_id": 3, "aantal_personen": 1, "onlineboeking_contactformulier_id": 2, "onlineboeking_minimaal_vooruit": "PT0S", "onlineboeking_maximaal_vooruit": null, "mag_online": true, "prijs_totaal_exc": 2512.5, "prijs_totaal_inc": 2663.13, "prijs_pp_exc": 2512.5, "prijs_pp_inc": 2663.13, "regels": [ { "id": 38, "locatie_id": 6, "begin": "1970-06-09T09:00:00+01:00", "eind": "1970-06-11T10:00:00+01:00", "beschrijving": "Huur accommodatie ma - woe", "aantal_personen": 1, "product_id": 53 }, { "id": 39, "locatie_id": 6, "begin": "1970-06-09T13:00:00+01:00", "eind": "1970-06-11T14:00:00+01:00", "beschrijving": "Huur accommodatie woe - vrij", "aantal_personen": 1, "product_id": 54 }, { "id": 40, "locatie_id": 6, "begin": "1970-06-09T17:00:00+01:00", "eind": "1970-06-10T18:00:00+01:00", "beschrijving": "Huur accommodatie vrij - zon", "aantal_personen": 1, "product_id": 55 }, { "id": 41, "locatie_id": 6, "begin": null, "eind": null, "beschrijving": "Aantal over nachters nacht 1", "aantal_personen": 1, "product_id": 58 }, { "id": 42, "locatie_id": 6, "begin": null, "eind": null, "beschrijving": "Aantal over nachters nacht 2", "aantal_personen": 1, "product_id": 58 }, { "id": 43, "locatie_id": 6, "begin": null, "eind": null, "beschrijving": "Huur bedlinnen", "aantal_personen": 1, "product_id": 56 }, { "id": 44, "locatie_id": null, "begin": null, "eind": null, "beschrijving": "Bij aankomst ligt de tandenborstel klaar om bepoetst te worden", "aantal_personen": 1, "product_id": 57 } ], "programma": [ { "omschrijving": "Huur accommodatie ma - woe", "aantal": 1, "begin": "PT0H0M0S", "duur": "P2DT1H0M0S", "eind": "P2DT1H0M0S" }, { "omschrijving": "Huur accommodatie woe - vrij", "aantal": 1, "begin": "PT4H0M0S", "duur": "P2DT1H0M0S", "eind": "P2DT5H0M0S" }, { "omschrijving": "Huur accommodatie vrij - zon", "aantal": 1, "begin": "PT8H0M0S", "duur": "P1DT1H0M0S", "eind": "P1DT9H0M0S" } ] } ] :statuscode 200: OK .. http:get:: /api2/arrangementen/(int:id) Een specifiek arrangement Dit endpoint is ook publiek toegankelijk. Wanneer dit endpoint niet-geauthenticeerd wordt opgevraagd, worden alleen de arrangementen met het kenmerk ``mag_api`` weergegeven, daarnaast worden enkele velden verborgen: * ``mag_uitjes`` * ``mag_api`` * ``mag_online_geboekt_worden_direct_betalen`` * ``mag_online_geboekt_worden_achteraf_betalen`` * ``maximum_aantal_personen_online`` * ``mag_beschikbaarheidskalender_api`` * ``startmomentgroep_id`` * ``mag_online`` * ``regels`` * ``onlineboeking_minimaal_vooruit`` * ``onlineboeking_maximaal_vooruit`` **Voorbeeld request**: .. sourcecode:: http GET /api2/arrangementen/4 HTTP/1.1 Host: demo.recras.nl Accept: application/json **Voorbeeld response**: .. sourcecode:: http HTTP/1.1 200 OK Content-Type: application/json { "id": 4, "arrangement": "Boogschieten/Klimmen met Buffet", "ontvangstlocatie": "", "mag_uitjes": true, "mag_api": true, "mag_online_geboekt_worden_direct_betalen": false, "mag_online_geboekt_worden_achteraf_betalen": false, "maximum_aantal_personen_online": null, "mag_beschikbaarheidskalender_api": false, "startmomentgroep_id": null, "aantal_personen": 10, "onlineboeking_contactformulier_id": 2, "onlineboeking_minimaal_vooruit": "PT0S", "onlineboeking_maximaal_vooruit": null, "mag_online": false, "prijs_totaal_exc": 530, "prijs_totaal_inc": 561.8, "prijs_pp_exc": 53, "prijs_pp_inc": 56.18, "regels": [ { "id": 8, "locatie_id": 3, "begin": "1970-06-11T13:30:00+01:00", "eind": "1970-06-11T14:00:00+01:00", "beschrijving": "U wordt ontvangen met koffie,thee en een plak heerlijke cake", "aantal_personen": 10, "product_id": 10 }, { "id": 5, "locatie_id": 4, "begin": "1970-06-11T14:00:00+01:00", "eind": "1970-06-11T15:00:00+01:00", "beschrijving": "Leer boogschieten op onze boogschietbaan ", "aantal_personen": 10, "product_id": 7 }, { "id": 6, "locatie_id": 4, "begin": "1970-06-11T15:30:00+01:00", "eind": "1970-06-11T18:30:00+01:00", "beschrijving": "Klimmen op onze klimbaan onder begeleiding van een ervaren instructeur", "aantal_personen": 10, "product_id": 6 }, { "id": 7, "locatie_id": 1, "begin": "1970-06-11T18:30:00+01:00", "eind": "1970-06-11T20:30:00+01:00", "beschrijving": "Waan je in Zuidafrika met het Zuidafrikaanse buffet", "aantal_personen": 10, "product_id": 1 } ], "programma": [ { "omschrijving": "U wordt ontvangen met koffie,thee en een plak heerlijke cake", "aantal": 10, "begin": "PT0H0M0S", "duur": "PT0H30M0S", "eind": "PT0H30M0S" }, { "omschrijving": "Leer boogschieten op onze boogschietbaan ", "aantal": 10, "begin": "PT0H30M0S", "duur": "PT1H0M0S", "eind": "PT1H30M0S" }, { "omschrijving": "Klimmen op onze klimbaan onder begeleiding van een ervaren instructeur", "aantal": 10, "begin": "PT2H0M0S", "duur": "PT3H0M0S", "eind": "PT5H0M0S" }, { "omschrijving": "Waan je in Zuidafrika met het Zuidafrikaanse buffet", "aantal": 10, "begin": "PT5H0M0S", "duur": "PT2H0M0S", "eind": "PT7H0M0S" } ] } :statuscode 200: OK :statuscode 404: Geen arrangement met dit ``id`` Changelog --------- Versie 1.2.0: velden ``onlineboeking_minimaal_vooruit`` en ``onlineboeking_maximaal_vooruit`` toegevoegd