HOTAPI

The universal hotel interface for: 3RPMS, Apaleo (powered by Omniboost), ASA Hotel Software, Casablanca, Citadel, Guestline, HOPE, HOTEL.PROFI, hotline®, HS/3® HOTEL SOFTWARE, ibelsa.rooms, infor, Mews (powered by Omniboost), protel hotel software, RoomRaccoon, SIHOT, SoftTec Cloud, Swoppen, ZimmerSoftware (You can find more information about the individual providers on our website: www.gastronovi.com/schnittstellen .

Benefits

  • Book directly from the POS system to the guest’s room
  • Transfer all invoice items to your PMS
  • Available in conjunction with select PMS systems

    Overview of Interfaces

    Here you'll find an overview of all active interfaces (green) and their functions, as well as interfaces in the pilot phase (yellow).

    Settings

    !!Don’t forget: If you’re using HOTAPI and are already live, you must update the master data whenever changes are made to it (product categories, cost centers, or payment methods).

    Unlock & Activate HOTAPI

    To activate and use HOTAPI, the integration must first be unlocked for your account. Unlocking is done through Gastronovi—please contact your sales representative.

    The “Room Reservation” payment method is automatically added by the system when the HOTAPI integration is activated. It is listed as inactive to prevent errors in the booking process. If a start date was specified in the settings during HOTAPI setup, the “Room Booking” payment method will automatically be activated at the selected time. If the integration was set up without a start date, check whether the “Room Booking” payment method is active before going live .

    Manage HOTAPI

    After you’ve activated HOTAPI, you can manage the integration at any time, synchronize master data, or deactivate HOTAPI.

    Integrations: powered by Omniboost

    All of our integrations that bear the powered by Omniboost label—such as Mews and Apaleo —were developed in collaboration with our partner company, Omniboost. This means that they are also set up and maintained by Omniboost.

    Prerequisites

    To use a HOTAPI interface in collaboration with Omniboost, please note the following requirements and information:* Book the HOTAPI interface via Gastronovi

    • Activate the Gastronovi (powered by Omniboost) interface in your selected PMS (e.g., Mews or Apaleo)
    • Interface provided by Omniboost for mapping and support

    If you have any questions about the requirements, prerequisites, and/or the process, your designated support contacts will be happy to assist you. Please feel free to contact us.

    FAQ – HOTAPI

    Here you’ll find the FAQ for the HOTAPI interfaces:

    3RPMS

    Who initiates the mapping?

    Mapping is performed via 3RPMS.

    What is required for the integration?

    An API key must be entered in Gastronovi under Integrations; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    No.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Is all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    No.

    Apaleo (powered by Omniboost)

    Omniboost as middleware

    For some interfaces with hotel software, Gastronovi collaborates with Omniboost, which acts as an intermediary between the systems. For these interfaces, customers need the Omniboost interface in addition to the interfaces provided by Gastronovi and the PMS provider.

    Cost of the Omniboost Interface

    In addition to the cost of the hotel interface provided by Gastronovi, a paid interface from Omniboost is required for use. This can be obtained either through the Omniboost website ( https://omniboost.io/integrations ) or is automatically requested once the interface setup with Gastronovi is complete.

    Mapping Within the Interface

    Since the information from Gastronovi must be organized and imported into the revenue and payment accounts in the PMS, mapping of the account structure is required. Where mapping was previously required by Gastronovi or the PMS providers, Omniboost can now perform this automatically via the Omniboost Datahub. This is set up jointly by Omniboost during the interface onboarding process.

    ASA Hotel Software

    Who initiates the mapping?

    Mapping is performed via ASA Hotel Software.

    What is required for the integration?

    An API key must be entered in Gastronovi under “Integrations”; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests’/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Are all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    Yes.

    What should be noted regarding “Miscellaneous” items?

    The interface between ASA Hotel Software and Gastronovi Back Office transfers booked items to the guest’s bill with precise line-item detail. If “Miscellaneous” items are booked, these are not recognized by the interface and are transferred to a fallback item in ASA Hotel Software.

    To ensure the interface operates smoothly, we do not recommend any workflows based on “Miscellaneous” items. If you need assistance with this, your ASA Hotelsoftware partner company will be happy to help.

    Casablanca

    Who sets up the mapping?

    Mapping is performed via Casablanca.

    What is required for the integration?

    An API key must be entered in Gastronovi under Integrations; please contact Gastronovi Support.

    Is it possible to retrieve current guests from the PMS and display them in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Is all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    Yes.

    Citadel

    Who initiates the mapping?

    Mapping is performed via Citadel.

    What is required for the integration?

    An API key must be entered in Gastronovi under “Integrations”; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to a room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS?

    No.

    Are all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    Yes.

    Guestline

    Who initiates the mapping?

    Mapping is performed via Guestline.

    What is required for the integration?

    An API key must be entered in Gastronovi under Integrations; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Is all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    Yes.

    HOPE

    Who initiates the mapping?

    Mapping is performed via Hope PMS.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post invoices from the POS to a room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer all invoices from the POS—regardless of the payment method?

    All sales from Gastronovi Back Office are transferred to HOPE PMS in the form of reports. Therefore###, even if not all invoices are transferred, accounting can still be performed within HOPE.

    Is all master data (payment methods, product groups, tax rates, and cost centers) transferred?

    No.

    Are the cumulative daily report and shift reports from the POS system transmitted?

    Yes.

    Hotel.Profi

    Who initiates the mapping?

    It is initiated by Gastronovi; a work order is required—please contact your consultant for this.

    Is it possible to retrieve current guest data from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes. The data is provided in its entirety, but this depends on the PMS and its processing capabilities.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    No.

    Is it possible to transfer tips?

    You can enable or disable tip transfer in the settings as needed.

    Are the cumulative daily report and shift reports transferred from the POS system?

    Yes.

    Hotline

    Who initiates the mapping?

    It is initiated by Gastronovi; a request is required—please contact your account manager for this.

    What is required for the integration?

    The path to the exchange folder.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes. The data is provided in its entirety, but this depends on the PMS and its processing capabilities.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    No.

    Are the cumulative daily report and shift reports transferred from the POS?

    No.

    HS/3

    Who initiates the mapping?

    It is initiated by Gastronovi; a request is required—please contact your consultant for this.

    What is required for the integration?

    The path to the exchange folder.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes. The data is provided in its entirety, but this depends on the PMS and its processing capabilities.

    Is it possible to transfer all invoices from the POS system—regardless of the payment method?

    No.

    Are the cumulative daily report and shift reports from the POS system transmitted?

    No.

    Ibelsa.rooms

    Who initiates the mapping?

    Mapping is performed via ibelsa.

    What is required for the integration?

    An API key must be entered in Gastronovi under Integrations; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes, but tips are not assigned to any specific payment method.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS?

    Yes.

    Are product categories transferred?

    Yes.

    Please note that after a change to product groups (VAT rates, titles, and accounting accounts), accounting accounts, or payment methods, a new mapping is required.

    Infor

    Who initiates the mapping?

    Mapping can be performed on either side, but a request is required—please contact your Gastronovi consultant for this.

    What is required for the integration?

    The cost center IDs. Display cost center ID

    Which changes within the Gastronovi Back Office must be reported?

    When creating additional cost centers, the respective ID is also required here.

    Is it possible to retrieve current guests from the PMS and display them in the POS system?

    Yes, there is an option for an explicit search. (Not a display of all guests at a glance.)

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes. The data is provided in its entirety, but this depends on the PMS and its processing capabilities.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Mews (powered by Omniboost)

    Omniboost as middleware

    For some interfaces with hotel software, Gastronovi collaborates with Omniboost, which acts as an intermediary between the systems. For these interfaces, customers need the Omniboost interface in addition to the interfaces provided by Gastronovi and the PMS provider.

    Cost of the Omniboost Interface

    In addition to the cost of the hotel interface provided by Gastronovi, a paid interface from Omniboost is required for use. This can be obtained either through the Omniboost website ( https://omniboost.io/integrations ) or is automatically requested once the interface setup with Gastronovi is complete.

    Mapping Within the Interface

    Since the information from Gastronovi must be organized and imported into the revenue and payment accounts in the PMS, mapping of the account structure is required. Where mapping was previously required by Gastronovi or the PMS providers, Omniboost can now perform this mapping independently via the Omniboost Datahub. This is set up jointly by Omniboost during the interface onboarding process.

    Protel

    Who initiates the mapping?

    A request is required—please contact your Gastronovi consultant.

    Which areas can be mapped?

    Cost centers (including sub-cost centers), product groups (plus VAT rates), employees, and payment methods.

    What are the special considerations?

    Protel is the overarching program; no accounting account assignments need to be made in Gastronovi Back Office.

    How are tips and expenses transferred?

    Tips are transferred with the type Gratuity, and expenses with the type Expense. Both fields are explicitly defined in Protel.

    Why do all invoices from Gastronovi show VAT rates?

    All invoices from Gastronovi must show a VAT rate. In Protel, invoices can be marked as pass-through items to avoid double taxation.

    How are discounts transferred?

    Since protel does not provide a line item for discounts, these are applied to the individual line items, and only the reduced amounts are transferred.

    Which changes within the Gastronovi Back Office must be reported?

    Changes to the mapped areas. These are updated by re-exporting the master data and then sending it via email to protel.

    Is it possible to retrieve current guests from the PMS and display them in the POS system?

    Yes, there is the option for an explicit search (not a display of all guests at a glance).

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes. The data is provided in its entirety, but this depends on the PMS and its ability to process the data.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    RoomRaccoon

    Who initiates the mapping?

    Mapping is performed via RoomRaccoon.

    What is required for the integration?

    An API key must be entered in Gastronovi under Integrations; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests’/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    No.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Is all master data (payment methods, product groups, tax rates, and cost centers) transferred?

    No.

    SIHOT

    Who initiates the mapping?

    Mapping can be initiated on either side, but a request is required—please contact your Gastronovi consultant for this.

    Can multiple Paymaster accounts be linked?

    No.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes, there is the option to perform an explicit search by room number. (Not a list of all guests at a glance.)

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes. The data is provided in its entirety, but this depends on the PMS and its processing capabilities.

    Is it possible to transfer all invoices from the POS system—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Caution: Special characters

    These could prevent a sale from being transferred to SIHOT. To prevent this scenario, all special characters except the following are removed before transfer to SIHOT:

    • a-z
    • A-Z
    • 0-9
    • Space
    • ßÀÁÂÃÄÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜàáâãäçèéêëìíîïñòóôõöùúûü- > < . , + - _ ° ! “ & / ) ( ? `´ @ ' |

    SoftTec Cloud

    Who initiates the mapping?

    Mapping is performed via SoftTec Cloud.

    What is required for the integration?

    An API key must be entered in Gastronovi under Integrations; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS?

    No.

    Is all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    Yes.

    Swoppen

    Who initiates the mapping?

    Mapping is performed via Swoppen.

    What is required for the integration?

    An API key must be entered in Gastronovi under “Integrations”; contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to a room or to guests/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    Yes.

    Are the cumulative daily report and shift reports transferred from the POS?

    No.

    Are all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    Yes.

    ZimmerSoftware

    Who initiates the mapping?

    Mapping is performed via ZimmerSoftware.

    What is required for the integration?

    An API key must be entered in Gastronovi under Integrations; please contact Gastronovi Support.

    Is it possible to retrieve current guest information from the PMS and display it in the POS system?

    Yes.

    Can I post bills from the POS to the room or to guests’/virtual accounts?

    Yes.

    Is it possible to transfer tips?

    Yes.

    Is it possible to transfer all bills from the POS—regardless of the payment method?

    No.

    Are the cumulative daily report and shift reports transferred from the POS system?

    No.

    Is all master data (payment methods, product categories, tax rates, and cost centers) transferred?

    No.

    !!Don’t forget: If you’re using HOTAPI and are already live, you must update the master data whenever changes are made to it (product categories, cost centers, or payment methods).

Please note that the English translation is currently under construction.
The Support-Portal makes no claim to completeness. Design and specifications are subject to change without notice.

These contents were translated by machine.