SesionAbrir

 

This message allows authenticating the user in the platform Hotetec. A session identifier (ideses) is assigned, which must be included in all request messages sent to the XML platform.


The session expires after 30 minutes of inactivity. Once this time has elapsed, the current ideses cannot be used anymore. If the session has expired, you will receive an error message indicating so in the response. 


 

SesionAbrirPeticion

 

SesionAbrirPeticion: log in request. 

 

Element

M

Type

Values/Format

Description

versys

String

max length: 10

XML version. (1.0)

codsys

String

max length: 3

System code

codage

String

max length: 10

Agency code

idtusu

String

max length : 16

User identifier

pasusu

String

max length : 16

Password

codidi

Enumeration

DE, EN, ES, FR, IT, NL, PT

Language code 

ISO 639-1 codes are used for languages, and currently, only the enumerated values are accepted.

iphost

String

regular expression:

[0-9]+(\.[0-9]+){3}

IP address

 

<SesionAbrirPeticion> 

<codsys>XML</codsys> 

<codage>TEST</codage>  

<idtusu>TESTUSER</idtusu>  

<pasusu>PASSUSER</pasusu>  

</ SesionAbrirPeticion> 

 


SesionAbrirRespuesta

 

SesionAbrirRespuesta: log in response.

 

Element

M

Type

Values/Format

Description

ideses

String

max length: 40

Session identifyer

error

error (Group)

View definition

View definition

 

<SesionAbrirRespuesta> 

<ideses>XML#14#581605736840847</ideses>  

</SesionAbrirRespuesta>

 

SesiónCerrar

 

This message closes the current session by invalidating the ideses identifyer. Onces processed, the ideses is no longer valid. 

 


SesionCerrarPeticion

 

SesionCerrarPeticion: request message for closing session.

 

Element

M

Type

Values/Format

Description

ideses

Y

String

max length: 40

Session identifyer

 

<SesionCerrarPeticion> 

<ideses>XML#17#442106373838493</ideses>  

</SesionCerrarPeticion> 


 

SesionCerrarRespuesta

 

SesionCerrarRespuesta: response message for closing session. 

 

Element

M

Type

Values/Format

Description

ideses

Y

String

max length: 40

Session identifyer

error

N

error (Group)

View definition 

View definition

 

After receiving this message, the current ideses will no longer be valid, and therefore cannot be used in any other message. 

 

<SesionCerrarRespuesta> 

<ideses>XML#17#442106373838493</ideses>  

</SesionCerrarRespuesta>

 


Sesión Estado

 

Once a session is opened with specific validation credentials, the generated ideses has an associated configuration. For example, if a session is opened with a user configured in Spanish, whenever this ideses is used, the language used in all transactions will be Spanish.

 

Through the session status request, the associated configuration for an ideses can be queried. In addition to querying, it can also be used to modify certain parameters of the configuration, such as the language code and currency.


Request message:  If only the ideses is provided in the SesionEstadoPeticion, the platform will return in the response the configuration associated with the ideses sent in the request (language, currency, etc.).


Modification message: The modifications supported by the session status message are the language code and/or the current currency code. These elements should be provided in the SesionEstadoPeticion message. The new value is indicated, and the response message will return the requested information, confirming the change.

 


SesionEstadoPeticion

 

SesionEstadoPeticion: session policy request message. 

 

Element

M

Type

Values/Format

Description

ideses

Y

String

max length: 40

Session identifyer

codidi

N

Enumeration

DE, EN, ES, FR, IT, NL, PT

Language code.

ISO 639-1 codes are used for languages, and currently, only the enumerated values are accepted.

coddiv

N

Enumeration

EUR, USD, GBP, EGP, MXN, CHF

Currency code.

ISO 4217 codes are used for currencies, and currently, only the enumerated values are accepted.

 

Examples: 

 

Query Request message:

 

<SesionEstadoPeticion> 

<ideses>XML#17#442106373838493</ideses>  

</SesionEstadoPeticion> 

 

Modification Request message. The used ideses would be updated to use the language EN and the currency GBP:


<SesionEstadoPeticion> 

<ideses>XML#17#442106373838493</ideses>  

<codidi>EN</codidi>  

<coddiv>GBP</coddiv>  

</SesionEstadoPeticion>


 

SesionEstadoRespuesta


SesionEstadoRespuesta: session policy response message. 

 

Element

M

Type

Values/Format

Description

ideses

Y

String 

max length: 40

Session identifyer

infses

Y

Infses

View definition

View definition

error

N

error (Group)

View definition

View definition

 


Sub-element Infses: dynamic Session Status information.

 

Element

M

Type

Values/Format

Description

codidi

Y

Enumeration

DE, EN, ES, FR, IT, NL, PT

Language code.

ISO 639-1 codes are used for languages, and currently, only the enumerated values are accepted.

coddiv

Y

Enumeration

EUR, USD, GBP, EGP, MXN, CHF

Currency code.

ISO 4217 codes are used for currencies, and currently, only the enumerated values are accepted.

 


Used in: 

SesionEstadoRespuesta 

 

Examples: 

Query Response message

 

<SesionEstadoRespuesta> 

<ideses>XML#17#442106373838493</ ideses> 

<infses> 

<codidi>ES</codidi> 

</infses> 

<coddiv>EUR</coddiv>  

</SesionEstadoRespuesta> 

 

Modification Response message (following the previous example): 

 

<SesionEstadoRespuesta> 

<ideses>XML#17#442106373838493</ ideses> 

<infses> 

<codidi>EN</codidi>  

</infses> 

<coddiv>GBP</coddiv>  

</SesionEstadoRespuesta>

 


Sesión Ignorar

 

The message clears the current state of the ongoing reservation. 

 

All information in the state of actions taken so far, such as availabilities, blocks, etc., will be erased. However, the ideses will still be valid, so it can be used in subsequent messages. 

 


SesionIgnorarPeticion

 

SesionIgnorarPeticion: ignore Session Request message.

 

Element

M

Type

Values/Format

Description

ideses

Y

String

max length: 40

Session identifyer

codtou

Y

String

 

Tour operator code

 

<SesionIgnorarPeticion> 

<ideses>XML#17#442106373838493</ideses>   

<codtou>HTT</codtou>  

</SesionIgnorarPeticion> 

 


SesionIgnorarRespuesta

 

SesionIgnorarRespuesta: ignore Session response message

 

Element

M

Type

Values/format

Description

ideses

S

String

max length: 40

Session identifyer

codtou

S

String

 

TTOO code

error

N

error (Group)

View definition

View definition

 

<SesionIgnorarRespuesta> 

<ideses>XML#17#442106373838493</ideses>   

<codtou>HTT</codtou>  

</SesionIgnorarRespuesta>