Use Cases: Client Onboarding

This section outlines possible integration scenarios to support new-client onboarding, such as retrieving client-specific master files and configuration data. These examples are not tied to any specific solution but illustrate some processes you might need to implement as part of your integration.


Each hotel can define its own categories, labels, and operational options (e.g., room types, rate plans, person types) under comboboxes configuration.

Comboboxes are dropdown menus that provide predefined options for specific fields within the system. While comboboxes typically come with a standard set of entries, they can often be customized to align with client-specific preferences.

By using the web service to load combobox values before implementation, you can verify that the client’s custom configurations are correctly received and displayed. This proactive approach helps identify any inconsistencies or missing data early in the process.

This process involves a S_COMBOBOX_SEARCH by a specific type.


Description Combobox Type
Activity area tb
Cleaning status 26
Document type PL
Guest type 92
Guarantee type GTP
Invoice status FAZOV
Language 10
Maintenence statuses 27
Person type PG
Partlistservice 09Tax
Prepaid-Type PPT
Reason for cancelation SG
Reservation source RQ
Restrictions RV
Revenue account UK
Revenue area UB
Salutation 17
VIP1 13
VIP2 vi

Description Combobox Type
Cancellation policy Sp
Market segment MA
Rate segment PS
Reservation medium RM
Reservation source RQ
Reservation type RA
Room categories 19

Description Combobox Type
Room decoration A2
Cloackroom A3
Supplier room A4
Supplier A5
Evaluation AZ
Event type B0
Reservation type B1
Room category B2
Table set-up B3
Equipment B4
Features B5
Location B6
Cost Centre B7
Banquet table decorations B8
Type of posting BA
Configuration BR
Sorting BS
Channel 6 C6
Channel 7 C7
Delivery DL
Event grouping GA
Equipment type GE
Evaluation GL
SAP-Internal order IO
Access code KC
Reason for cancellation Se
Authorised person role ap
Colour status cO
Equipment group eg
Room group rg

Sample Request – S_COMBOBOX_SEARCH

REST
{
    "TransactionID": "",
    "Search": {
        "Type": "26",
        "Language": "EN"
    }
}
SOAP
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:envgen="http://soapenvelopegenerator.eduardocastro.info/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <soapenv:Header />
    <soapenv:Body>
        <S_COMBOBOX_SEARCHRequest xmlns="http://www.gubse.com/IFS/Services_v2.0.xsd">
            <!--Optional-->
            <TransactionID></TransactionID>
            <Authentication>
                <SecurityID></SecurityID>
            </Authentication>
            <Search>
                <Type>26</Type>
                <!--Optional-->
                <Language>EN</Language>
            </Search>
        </S_COMBOBOX_SEARCHRequest>
    </soapenv:Body>
</soapenv:Envelope>

Sample Response – S_COMBOBOX_SEARCH

REST
{
    "Result": {
        "Success": true,
        "ErrorMsg": "",
        "MSG-LIST": {
            "MSG-ENTRY": []
        }
    },
    "ComboBox": {
        "Type": "26",
        "Entry": [
            {
                "Language": "EN",
                "Key": "05",
                "Value": "Additional Work",
                "Sorting": "ADDITIONAL WORK",
                "Locked": false,
                "Hidden": false
            },
            {
                "Language": "EN",
                "Key": "06",
                "Value": "Arrival Not Clean",
                "Sorting": "ARRIVAL NOT CLEAN",
                "Locked": false,
                "Hidden": false
            },
            {
                "Language": "EN",
                "Key": "01",
                "Value": "Dirty",
                "Sorting": "DIRTY",
                "Locked": false,
                "Hidden": false
            },
            {
                "Language": "EN",
                "Key": "02",
                "Value": "In Process",
                "Sorting": "IN PROCESS",
                "Locked": false,
                "Hidden": false
            },
            {
                "Language": "EN",
                "Key": "03",
                "Value": "Inspection",
                "Sorting": "INSPECTION",
                "Locked": false,
                "Hidden": false
            },
            {
                "Language": "EN",
                "Key": "04",
                "Value": "Room OK",
                "Sorting": "ROOM OK",
                "Locked": false,
                "Hidden": false
            }
        ]
    }
}
SOAP
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <SOAP-ENV:Body>
        <S_COMBOBOX_SEARCHResponse xmlns="http://www.gubse.com/IFS/Services_v2.0.xsd">
            <Result>
                <Success>true</Success>
                <ErrorMsg/>
                <MSG-LIST/>
            </Result>
            <ComboBox>
                <Type>26</Type>
                <Entry>
                    <Language>EN</Language>
                    <Key>05</Key>
                    <Value>Additional Work</Value>
                    <Sorting>ADDITIONAL WORK</Sorting>
                    <Locked>0</Locked>
                    <Hidden>0</Hidden>
                </Entry>
                <Entry>
                    <Language>EN</Language>
                    <Key>06</Key>
                    <Value>Arrival Not Clean</Value>
                    <Sorting>ARRIVAL NOT CLEAN</Sorting>
                    <Locked>0</Locked>
                    <Hidden>0</Hidden>
                </Entry>
                <Entry>
                    <Language>EN</Language>
                    <Key>01</Key>
                    <Value>Dirty</Value>
                    <Sorting>DIRTY</Sorting>
                    <Locked>0</Locked>
                    <Hidden>0</Hidden>
                </Entry>
                <Entry>
                    <Language>EN</Language>
                    <Key>02</Key>
                    <Value>In Process</Value>
                    <Sorting>IN PROCESS</Sorting>
                    <Locked>0</Locked>
                    <Hidden>0</Hidden>
                </Entry>
                <Entry>
                    <Language>EN</Language>
                    <Key>03</Key>
                    <Value>Inspection</Value>
                    <Sorting>INSPECTION</Sorting>
                    <Locked>0</Locked>
                    <Hidden>0</Hidden>
                </Entry>
                <Entry>
                    <Language>EN</Language>
                    <Key>04</Key>
                    <Value>Room OK</Value>
                    <Sorting>ROOM OK</Sorting>
                    <Locked>0</Locked>
                    <Hidden>0</Hidden>
                </Entry>
            </ComboBox>
        </S_COMBOBOX_SEARCHResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>