Arrangementen

Huidige versie: 1.2.0

Read

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:

GET /api2/arrangementen HTTP/1.1
Host: demo.recras.nl
Accept: application/json

Voorbeeld response:

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"
         }
      ]
   }
]
Status Codes:
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:

GET /api2/arrangementen/4 HTTP/1.1
Host: demo.recras.nl
Accept: application/json

Voorbeeld response:

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"
      }
   ]
}
Status Codes:

Changelog

Versie 1.2.0: velden onlineboeking_minimaal_vooruit en onlineboeking_maximaal_vooruit toegevoegd