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

2024-10-14

Improvements

  • Added Person.stayPreferences and person.mealPreferences as a replacement for Person.preferences
  • Added Company.stayPreferences as a replacement for Company.preferences

Deprecations

  • Deprecated Person.preferences , Company.preferences, and Client.preferences.

2024-09-11

Improvements

  • Mutation updateRoomSetup added.
    • At the moment, the only field that can be updated is cleaningStatus

2024-09-05

Improvements

  • Add pagination arguments for RoomStay.dailyRates connection

2024-07-17

Improvements

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.