This changelog lists integration-relevant changes, in chronological order.

2024-03-25

Improvements

2023-09-26

Improvements

2023-05-16

Deprecations

  • Deprecate RoomSetup.bedLinenChange field

2023-03-23

Breaking Changes

  • graphql query errors no longer include extensions.category=graphql
Before After

{
“errors”: [
{
“message”: “Syntax Error”,
“extensions”: {
“category”: “graphql”
},
}
]
}

{
“errors”: [
{
“message”: “Syntax Error”
}
]
}

There is no change for other category errors. There is no change for queries that dont result in an error.

2023-02-13

Improvements

  • Adds External Sales API:
    • Type ExternalSalesProduct added
    • Mutation createExternalSalesProduct added
    • Mutation updateExternalSalesProduct added
    • Mutation createExternalSale added
    • Query externalSalesProducts added

Documentation

2023-02-06

Improvements

  • Added check_in and check_out to RoomStayFilter. Allows to, for example, retrieve all checked in rooms that have not yet checked out.

2023-02-01

Breaking Changes

  • Union RoomAccessKey replaced with an interface of the same name. No queries are expected to break, but tools inspecting the schema might be affected.

Improvements

  • Query roomAccessKeys added to retrieve all room access keys your integration is allowed to grant/revoke to rooms
  • MutationcreateRoomAccessKey added to create a room access key - room pin or key storage (pin,compartment) pair
  • Mutation addRoomAccessKey added to assign a room access key to a room
  • Mutation removeRoomAccessKey added to remove room access key from a room
  • Mutation deleteRoomAccessKey added to delete a room access key
  • Type RoomAccessKeyStorage added for reading (pin, compartment) pairs. A sibling type to RoomAccessPin
  • Added configuration error category, for errors that must not be visible to guests, but should be shown for hotel staff.

Documentation

2023-01-23

Improvements

  • Field Reservation.selfcheckinStatus added
    • Returns an enum with values DISABLED, ENABLED, AVAILABLE, COMPLETED

Deprecations

  • Field Reservation.selfcheckinEnabled deprecated in favour of Reservation.selfcheckinStatus

2022-12-19

Improvements

  • Field RoomStay.roomAccessKey added to allow retrieving room pin code for hotels with salto integration set up.

2022-11-14

Improvements

  • Field Reservation.totalAmount added
  • Field Reservation.openAmount added

2022-10-27

Breaking Changes

  • Client type was split into Person and Company types. Most existing queries are expected to continue working, this will affect your integration if __typename is used.

Improvements

  • Query clientTitles added - a list of all active client titles
  • Query communicationLanguages added - a list of available communication languages, ordered by hotel’s preference.
  • Mutation addRoomStayGuest added - allows adding an existing client as a guest to a room
  • Mutation removeRoomStayGuest added - allows removing a client as a guest to a room
  • Mutation createClient added - allows creating new Person clients.
  • Mutation updateClient added - allows updating any existing client
  • New fields to Person type added - clientTitle, street, zipcode, city, country, fax, preferences, nationality, passportNumber, idCardNumber, issuingAuthority
  • New fields to Company type added - street, zipcode, city, country, fax, preferences
  • Add a @chain directive to allow using a result from one operation as input for the next operation, within one request.

Deprecations

  • Deprecate Person.title field in favour of Person.clientTitle
  • Deprecate Person.company field - value is always empty
  • Deprecate Company.firstname field - value is always empty
  • DeprecateCompany.lastname field - value is always empty
  • Deprecate Company.title field - value is always empty
  • Deprecate Company.carPlateNumber field - value is always empty
  • Deprecate Company.birthday field - value is always null
  • Deprecate Company.birthdayGreetingsEnabled field - value is always false
  • Deprecate Client.title, Client.firstname, Client.lastname, Client.carPlateNumber, Client.birthday, Client.birthdayGreetingsEnabled - use the implementation Person type
  • Deprecate Client.company - use the implementation Company type.

< 2022-10-27

Changes before 2022-10-27 are not tracked.