Create
First, let’s create a new meeting room reservation ‘Demo reservation’. As the BO UsrReservationMeetingRoom has one main BomAdd method, we will use that one: /execute/UsrReservationMeetingRoom/BomAdd.
There are five fields required to be filled in for a reservation:
• Start date & time
• End date & time
• Order group
• Property
• Reservation unit
As order group, property, and reservation unit are references to other BOs, they must contain the unique syscode value pointing to a record in their respective BOs.
• 6 refers to order group ‘05, Project management’
• 8 refers to property ’14, Columbus Square’
• 90 refers to reservation unit ‘0.33 Bach’
The POST request /execute/UsrReservationMeetingRoom/BomAdd then looks like this:
{
"values": {
"BeginDateTime": {
"date": "2022-12-01",
"time": "14:00:00"
},
"EndDateTime": {
"date": "2022-12-01",
"time": "16:00:00"
},
"OrderGroupRef": 6,
"PropertyRef": 8,
"ReservationUnitRef": 90,
"Description": "DEMO reservation"
}
}
The response contains many more fields that were filled automatically by the Planon application based on the values given in the request. This is identical to what happens when this request is entered in the Planon application manually:
{
"records": [
{
"AllSubOrdersCompleted": false,
"AppointmentBooking": false,
"BeginDateTime": {
"date": "2022-12-01",
"time": "14:00:00"
},
"BeginDateTimeUser": "2022-12-01T14:00:00Z",
"BusinessObjectDefinitionRef": 730,
"BusinessObjectStateRef": 229,
"CumulativeTotalActualCostExclVAT": 25,
"CumulativeTotalActualCostsInclVAT": 25,
"Description": "DEMO reservation",
"DeskConfigurationRef": 20,
"EHSRequired": false,
"EndDateTime": {
"date": "2022-12-01",
"time": "16:00:00"
},
"EndDateTimeUser": "2022-12-01T16:00:00Z",
"EngineerSignOffRequired": false,
"ExcludeFromInvoiceApproval": false,
"FloorRef": 123,
"GroupedInvoice": false,
"HighPriority": false,
"IncludeRevenueEstimations": true,
"InsertDateTime": "2022-12-01T10:58:00Z",
"InsertSourceSystemRef": 8,
"Interest": false,
"InternalCoordinatorPersonRef": 306,
"LastStateChangedDateTime": "2022-12-01T10:58:00Z",
"OrderGroupRef": 6,
"OrderNumber": "266.00",
"PropertyRef": 8,
"ProposalStateDateTime": "2022-12-01T10:58:00Z",
"RefBODefinitionUserDefined": 2918,
"RefBOStateUserDefined": 1045,
"ReservationUnitRef": 90,
"SharedId": "A11B63BD-0C34-4333-9EF3-2E57B44F5E91",
"SignOffRequired": false,
"SpaceRef": 262,
"SysAccountRef": 1,
"Syscode": 575,
"SysDataSectionRef": "BP",
"SysIsArchived": false,
"SysIsDeleted": false,
"SysIsStandardOrder": false,
"SysMutationDateTime": "2022-12-01T10:58:17Z",
"SysOrderID": 266,
"SysUpdateCount": 0,
"TotalActualCostExclVAT": 25,
"TotalActualCostsInclVAT": 25
}
]
}