Revisión del 11:50 18 jul 2014

Sumario

1 Introducción
2 Mensajes soportados
3 Documentos XML
4 Pruebas de implementación
5 Códigos y Descripciones

Introducción

El Web Service permite al cliente conectarse de manera transparente a la aplicación a través de un conjunto de funciones que pueden ser llamadas desde las páginas web de sus sitios.

A través del servicio web un mayorista podrá buscar reservas de hoteles, aéreos o paquetes; solicitar información detallada de reservas, cambiar el estado del pago de reservas y consultar información de agencias. Todo a través de una interfaz única basada en el intercambio de documentos XML, que será descripta en esta guía de uso.

Además de este manual, están disponibles los esquemas XML (.XSD) para validar los mensajes antes de ser enviados al Web Service, así como también mensajes XML de ejemplo para cada función.

Interfaz Cliente Simplificada

El API va a usar protocolos HTTP estandard. Lo único que se requiere es un pedido de POST del HTTP.

Esto le otorgará las siguientes ventajas:

Protocolos estandards de su empresa
No se requiere de ningún componente adicional

Requisitos de los clientes

Los pedidos de los clientes deben ser hechos desde una dirección pública y estática que esté registrada con NEMO.
Los pedidos del cliente deben ser hechos a través de un pedido POST de HTTP.
Toda la información enviada y recibida a través de la interface va a ser guardada en UTF-8

Autenticación del Cliente

Los headers del POST deben contener autenticación HTTP de tipo basic estandar, con nombre y usuario habilitado de Navigator (las mismas credenciales que se usan para ingresar en el backend).

Acceso

URL del servicio = API URL + nombre del mensaje

API URL (según entorno):

Entorno de Test: http://certnav.psurfer.net/backend.php/api/
Entorno de producción: Consulte a soporte

Nombre del mensaje:

BookingsQueryRQ : Búsqueda de reservas
BookingsDetailsRQ : Pedido de detalle de reservas
AgencyQueryRQ : Pedido de detalle de agencias
BookingPaymentStatusRQ : Cambio de estado de reserva a pagado

Ejemplo de pedido de reservas al servidor de test: http://certnav.psurfer.net/backend.php/api/BookingsQueryRQ

El POST debe llevar adjunto un archivo XML con igual nombre al mensaje (BookingsQueryRQ.xml) cuyo contenido será el de la consulta que se quiere hacer al WebService. Para ver un ejemplo: BookingsQueryRQ

Ejemplos de acceso

Script Bash

!/bin/sh

URL='http://certnav.psurfer.net/backend.php/api/BookingsQueryRQ'

credenciales

USER=nombreDeUsuario
PASS=password

path del archivo RQ

FILE='/ruta/al/archivo/BookingsQueryRQ.xml'

POST

curl -u $USER:$PASS -X POST -F 'BookingsQueryRQ=@'$FILE $URL

PHP <?php

$backend_url = 'http://certnav.psurfer.net/backend.php/api/BookingsQueryRQ'; $login = 'nombreDeUsuario'; $password = 'password'; $file_path = '/ruta/al/archivo/BookingsQueryRQ.xml';

$post = array('BookingsQueryRQ' => '@' . $file_path);

$ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $backend_url); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_HEADER, 1); curl_setopt($ch, CURLOPT_USERPWD, $login . ":" . $password); curl_setopt($ch, CURLOPT_POSTFIELDS, $post); $result = curl_exec($ch); curl_close($ch);

?>

Para ver un ejemplo del archivo de consulta BookingsQueryRQ

Códigos de respuesta de la petición HTTP

La respuesta del WebService puede tomar diferentes códigos, a continuación se detalla el significado de cada una.

Código	Respuesta
200	OK
400	No valida el XML de la consulta
401	Fallo de autenticación
404	No se encontró el archivo XML de la consulta
404	No se encontraron agencias con los parámetros de búsqueda ingresados
404	No se encontraron reservas con los parámetros de búsqueda ingresados
503	Error interno

Por cualquier consulta recuerde dirigirse al mail de Soporte Técnico: support@pricenavigator.net

Mensajes soportados

Buscar reservas (BookingsQueryRQ)

Búsqueda de reservas en un rango de fechas determinado. Retorna un listado de reservas correspondientes a las fechas ingresadas.

Recibe BookingsQueryRQ, retorna BookingsQueryRS.

La búsqueda incluye aéreos, hoteles y paquetes.

Se pueden ingresar como parámetros para la búsqueda:

fecha de creación
fecha de checkin
identificador de la agencia
nombre de pasajero
nombre de cliente
estado de la reserva
estado del item de la reserva
nivel de detalle de la respuesta
fecha de último cambio de estado

Solicitar información detallada de reservas (BookingsDetailsRQ)

Consulta de información detallada de una reserva determinada especificando un identificador de la reserva.

Recibe BookingsDetailsRQ, retorna BookingsDetailsRS.

Cambiar estado del pago de reservas (BookingPaymentStatusRQ)

Cambio de estado de pago de una reserva. Retorna el resultado de la transacción. Podrá indicar si el cambio fue realizado con éxito o en caso contrario notificar qué evento se produjo por el cual no pudo realizarse el cambio.

Recibe BookingPaymentStatusRQ, retorna BookingPaymentStatusRS.

Consultar info de agencia (AgencyQueryRQ)

Consulta de información detallada de una agencia determinada especificando el ID de agencia o el nombre de la misma.

Recibe AgencyQueryRQ, retorna AgencyQueryRS.

Documentos XML

Mensaje BookingsQuery: Buscar reservas

La búsqueda de reservas permite obtener un listado de reservas con toda la información referida a cada reserva en particular.

El método BookingsQuery recibe un documento BookingsQueryRQ y retorna un documento BookingsQueryRS.

BookingsQueryRQ

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>
<BookingsQueryRQ xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='AEXCEV_Main.xsd'>
    <GeneralParameters>
        <PreferedLanguage LanguageCode="es-AR"/>
    </GeneralParameters>
    <Details>
        <Criterion>
            <AgencyId>12113</AgencyId>
            <CreationDate>
                <DateFrom>2013-11-03</DateFrom>
                <DateTo>2013-11-05</DateTo>
            </CreationDate>
            <CheckinDate>
                <DateFrom>2013-11-20</DateFrom>
                <DateTo>2013-11-22</DateTo>
            </CheckinDate>
            <GuestName>JUANA PEREZ</GuestName>
            <ClientName>juan perez</ClientName>
            <BookingState>
        <Code>NMO.GBL.BST.CNF</Code>
            </BookingState>
            <BookingItemState>
                <Code>NMO.HTL.BST.CNF</Code>                
            </BookingItemState>
            <DetailLevel>full</DetailLevel>
            <LastChangeDate>
        <DateFrom>2013-11-04T13:00:00</DateFrom>
        <DateTo>2013-12-06T14:00:00</DateTo>
            </LastChangeDate>
        </Criterion>
    </Details>
</BookingsQueryRQ>

Parámetro	Obligatorio	Descripción
GeneralParameters	Si	Parámetros generales de configuración de la consulta.
PreferedLanguage	Si	Establece el lenguaje requerido para la respuesta. Atributos: LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Web Services.
Details	Si	Detalle del mensaje de búsqueda.
Criterion	Si	Indica los distintos parámetros de la búsqueda.
AgencyId	No	Indica el número de agencia para buscar.
CreationDate	No	Indica el rango de fechas de creación de la reserva.
DateFrom	No	Fecha de creación desde.
DateTo	No	Fecha de creación hasta.
CheckinDate	No	Indica el rango de las fechas de checkin de la reserva.
DateFrom	No	Fecha de checkin desde.
DateTo	No	Fecha de checkin hasta.
GuestName	No	Identifica el nombre del huésped para la habitación.
ClientName	No	Persona que realiza la reserva.
BookingState	No	Estado de la reserva.
Code	No	Código de estado de la reserva.
BookingItemState	No	Estado del item de reserva.
Code	No	Código de estado del item de la reserva.
DetailLevel	No	Indica el nivel de detalle de la respuesta. Opciones: basic y full.
LastChangeDate	No	Indica el rango de fecha y hora del último cambio de estado de la reserva.
DateFrom	No	Fecha del último cambio de estado de la reserva desde.
DateTo	No	Fecha del último cambio de estado de la reserva hasta.

BookingsQueryRS

ATENCIÓN: Para visualizar el estado actual de su reserva debe llamar a BookingsDetailsRQ con el nodo <ProviderRQ> en true

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>    
<BookingsQueryRS xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='AEXCEV_Main.xsd'>
    <Echo>
        <GeneralParameters>
            <PreferedLanguage LanguageCode="es-AR"/>
        </GeneralParameters>
        <Details>
            <Criterion>
                <AgencyId>12113</AgencyId>
                <CreationDate>
                    <DateFrom>2013-11-03</DateFrom>
                    <DateTo>2013-11-05</DateTo>
                </CreationDate>
                <CheckinDate>
                    <DateFrom>2013-11-20</DateFrom>
                    <DateTo>2013-11-22</DateTo>
                </CheckinDate>
                <GuestName>JUANA PEREZ</GuestName>
                <ClientName>juan perez</ClientName>
                <BookingState>
                    <Code>NMO.GBL.BST.CNF</Code>
                </BookingState>
                <BookingItemState>
                    <Code>NMO.HTL.BST.CNF</Code>                
                </BookingItemState>
                <DetailLevel>full</DetailLevel>
                <LastChangeDate>
                    <DateFrom>2013-11-04T13:00:00</DateFrom>
                    <DateTo>2013-12-06T14:00:00</DateTo>
                </LastChangeDate>
            </Criterion>
        </Details>
    </Echo>
    <Details>
        <Bookings ItemsCount="1">
            <Booking Sequence="1" ContractId="12221" AgencyId="12113">
                <BookingReferences ItemsCount="1">
                    <BookingReference ReferenceType="NMO.GBL.BRT.NAV">QN_0075J</BookingReference>
                </BookingReferences>                    
                <BookingState ItemsCount="1">
                    <BookingState>
                        <Code>NMO.GBL.BST.CNF</Code>
                        <Description>Confirmado</Description>                            
                        <StateDateTime>2013-12-05T13:42:51</StateDateTime>                    
                    </BookingState>
                </BookingState>
                <BookingCreationDate>2013-11-04</BookingCreationDate>
                <ClientName>juan perez</ClientName>            
                <Price PriceType="PVP">
                    <Amount CurrencyCode="USD">614.78</Amount>
                </Price>
                <Price PriceType="NMO.HTL.RPT.AFP">
                    <Amount CurrencyCode="USD">17.54</Amount>
                </Price>
                <Comments>Observaciones...</Comments>
                <BookingItems>      
                    <Hotels ItemsCount="1">
                        <Hotel Sequence="1">
                            <BookingReference ReferenceType="NMO.HTL.RPT.PRS.PS2">QN_0075J-1</BookingReference>

Si el nodo DetailLevel es full, se agrega lo siguiente al RS

                            <BookingStates ItemsCount="1">                                                
                                <BookingState>
                                    <Code>NMO.HTL.BST.CNF</Code>
                                    <Description>Confirmado</Description>            
                                    <StateDateTime>2013-12-05T13:39:11</StateDateTime>
                                </BookingState>
                            </BookingStates>
                            <Prices ItemsCount="3">
                                <Price PriceType="NMO.GBL.RPT.GRS" Sequence="1">
                                    <Amount CurrencyCode="USD">614.78</Amount>
                                </Price>
                                <Price PriceType="NMO.HTL.RPT.NET" Sequence="2">
                                    <Amount CurrencyCode="USD">87.68</Amount>
                                </Price>
                                <Price PriceType="NMO.HTL.RPT.AFP" Sequence="3">
                                    <Amount CurrencyCode="USD">17.54</Amount>
                                </Price>
                            </Prices>
                            <Deadline>2013-11-18</Deadline>

                        </Hotel>                
                    </Hotels>
                </BookingItems>    
            </Booking>
        </Bookings>
    </Details>
</BookingsQueryRS>

Parámetro	Obligatorio	Descripción
GeneralParameters	Si	Parámetros generales de configuración de la consulta.
PreferedLanguage	Si	Establece el lenguaje requerido para la respuesta. Atributos: LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Web Services.
Details	Si	Detalle de la respuesta del mensaje de búsqueda.
Criterion	Si	Indica los distintos parámetros de la búsqueda.
AgencyId	No	Indica el número de agencia para buscar.
CreationDate	No	Indica el rango de las fechas de creación de la reserva.
DateFrom	No	Fecha de creación desde.
DateTo	No	Fecha de creación hasta.
CheckinDate	No	Indica el rango de las fechas de checkin de la reserva.
DateFrom	No	Fecha de checkin desde.
DateTo	No	Fecha de checkin hasta.
GuestName	No	Identifica el nombre del huésped para la habitación.
ClientName	No	Persona que realiza la reserva.
BookingState	No	Estado de la reserva.
Code	No	Código de estado de la reserva.
BookingItemState	No	Estado del item de reserva.
Code	No	Código de estado del item de la reserva.
DetailLevel	No	Indica el nivel de detalle de la respuesta. Opciones: basic y full.
LastChangeDate	No	Indica el rango de fecha y hora del último cambio de estado de la reserva.
DateFrom	No	Fecha del último cambio de estado de la reserva desde.
DateTo	No	Fecha del último cambio de estado de la reserva hasta.
Bookings	Si	Detalle de las reservas encontradas.
BookingReference	Si	Lista de referencias asociadas a la reserva.
BookingState	Si	Estado de la reserva.
Code	Si	Código de estado de la reserva.
Description	Si	Descripción del estado de la reserva.
StateDateTime	Si	Fecha del cambio de estado.
BookingCreationDate	Si	Fecha de creación de la reserva.
ClientName	Si	Nombre del cliente que realizó la reserva.
Price	Si	Precio y tipo de precio de la reserva.
Amount	Si	Monto del precio de la reserva.
BookingItems	Si	Detalle de los items de la reserva.
Hotels	Si	Items de hoteles.
BookingReference	Si	Lista de referencias asociadas a la reserva.

Mensaje BookingsDetails: Solicitar información detallada de reservas

La solicitud de información detallada de reservas permite obtener detalles de los datos por cada reserva.

El método BookingsDetails recibe un documento BookingsDetailsRQ y retorna un documento BookingsDetailsRS.

BookingsDetailsRQ

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>
<BookingsDetailsRQ xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='AEXCEV_Main.xsd'>
    <GeneralParameters>
        <PreferedLanguage LanguageCode="es-AR"/>
    </GeneralParameters>
    <Details>
        <Bookings ItemsCount="1">
            <Booking Sequence="1">
                <BookingReference ReferenceType="NMO.GBL.BRT.NAV">QN_00787</BookingReference>
            </Booking>   
        </Bookings>
        <ProviderRQ>true</ProviderRQ>
    </Details>
</BookingsDetailsRQ>

Parámetro	Obligatorio	Descripción
GeneralParameters	Si	Parámetros generales de configuración de la consulta.
PreferedLanguage	Si	Establece el lenguaje requerido para la respuesta. Atributos: LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Web Services.
Details	Si	Detalle del mensaje de pedido de reservas.
Bookings	Si	Reservas pedidas.
BookingReference	Si	Lista de referencias asociadas a la reserva.
ProviderRQ	No	Actualiza la información de la reserva desde el Proveedor. Opciones: true y false.

BookingsDetailsRS

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>
<BookingsDetailsRS xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='AEXCEV_Main.xsd'>         
    <Echo>
        <GeneralParameters>
            <PreferedLanguage LanguageCode="es-AR"/>
        </GeneralParameters>
        <Details>
            <Bookings ItemsCount="1">
                <Booking Sequence="1">
                    <BookingReference ReferenceType="NMO.GLB.BRT.NAV">QN_00787</BookingReference>
                </Booking>   
            </Bookings>
        </Details>
    </Echo>
    <Details>
        <Bookings ItemsCount="1">
            <Booking Sequence="1" ContractId="12221">
                <BookingReferences ItemsCount="1">
                    <BookingReference ReferenceType="NMO.GBL.BRT.NAV">QN_00787</BookingReference>
                </BookingReferences>
                <BookingCreationDate>2013-11-20T19:19:52</BookingCreationDate>
                <ClientName>Ana Gomez</ClientName>
                <Agency AgencyId="12113">
                    <Name>Operador Veronica</Name>
                    <CreationUser>ADMINISTRADOR NEMO PRODUCCION</CreationUser>                    
                </Agency>
                <User UserId="16035">
                    <Name>Veronica Vergara</Name>
                    <Login>veronica.vergara</Login>
                </User>
                <BookingState ItemsCount="1">
                    <BookingState>
                        <Code>NMO.GBL.BST.CNF</Code>
                        <Description>Confirmado</Description>                                    
                        <StateDateTime>2013-11-21T14:00:52</StateDateTime>
                    </BookingState>
                </BookingState>
                <Payments ItemsCount="1">
                    <Payment Sequence="1" Type="NMO.CTR.WKF.CAC">
                        <Amount CurrencyCode="USD">384.10</Amount>
                    </Payment>
                </Payments>
                <Comments>Observaciones...</Comments>
                <BookingItems>
                    <Hotels ItemsCount="1">
                        <Hotel Sequence="1" HotelId="120470" Name="Aida" SupplierID="BOL">
                            <BookingReferences ItemsCount="3">
                                <BookingReference Sequence="1" ReferenceType="NMO.HTL.RPT.MPH">QN_00787-1</BookingReference>
                                <BookingReference Sequence="2" ReferenceType="NMO.HTL.RPT.PRS.PS1">102</BookingReference>
                                <BookingReference Sequence="3" ReferenceType="NMO.HTL.RPT.PRS.PS2">4027242</BookingReference>
                            </BookingReferences>
                            <DestinationDetails ItemsCount="2">
                                <Destination Sequence="1" DestinationType="NMO.HTL.DST.CTR" DestinationCode="139">España</Destination>
                                <Destination Sequence="2" DestinationType="NMO.HTL.DST.CTY" DestinationCode="2262">Madrid</Destination>
                            </DestinationDetails>
                            <CheckIn>2013-12-17</CheckIn>
                            <CheckOut>2013-12-18</CheckOut>
                            <Deadline>2013-12-16</Deadline>
                            <Boards ItemsCount="1">
                                <Board Sequence="1" BoardCode="14">Solo habitacion</Board>
                            </Boards>
                            <Passengers ItemsCount="3">
                                <Passenger Sequence="1" AgeType="NMO.GBL.AGT.ADT" Identifier="30456789" CountryOfResidence="arg" Nationality="Argentino">ANA GOMEZ</Passenger>
                                <Passenger Sequence="2" AgeType="NMO.GBL.AGT.ADT" Identifier="30456321" CountryOfResidence="klñ" Nationality="Argentino">ANAS GOMEZ</Passenger>
                                <Passenger Sequence="3" AgeType="NMO.GBL.AGT.CHD" Identifier="304564654" CountryOfResidence="hghg" Nationality="Argentino">ANAD GOMEZ</Passenger>
                            </Passengers>
                            <Rooms ItemsCount="1">
                                <Room Sequence="1" RoomType="NMO.HTL.RMT.DBL">Doble</Room>
                            </Rooms>
                            <Description>Aida checkin 2013-12-17 checkout 2013-12-18, 1 Doble</Description>
                            <BookingStates ItemsCount="1">
                                <BookingState>
                                    <Code>NMO.HTL.BST.CNF</Code>
                                    <Description>Confirmado</Description>                        
                                    <StateDateTime>2013-11-20T19:19:55</StateDateTime>
                                </BookingState>
                            </BookingStates>
                            <Prices ItemsCount="3">
                                <Price PriceType="NMO.GBL.RPT.GRS" Sequence="1">
                                    <Amount CurrencyCode="USD">384.10</Amount>
                                </Price>
                                <Price PriceType="NMO.HTL.RPT.NET" Sequence="2">
                                    <Amount CurrencyCode="USD">47.21</Amount>
                                </Price>
                                <Price PriceType="NMO.HTL.RPT.AFP" Sequence="3">
                                    <Amount CurrencyCode="USD">9.44</Amount>
                                </Price>
                            </Prices>
                        </Hotel>
                    </Hotels>                        
                </BookingItems>
            </Booking>
        </Bookings>
    </Details>
</BookingsDetailsRS>

Parámetro	Obligatorio	Descripción
GeneralParameters	Si	Parámetros generales de configuración de la consulta.
PreferedLanguage	Si	Establece el lenguaje requerido para la respuesta. Atributos: LanguageCode: Código de lenguaje correspondiente a los códigos de lenguaje estándar provistos por Web Services.
Details	Si	Detalle de la consulta de reservas.
Bookings	Si	Reservas de la consulta.
BookingReference	Si	Lista de referencias asociadas a la reserva que se consulta.
Details	Si	Detalle de la respuesta al mensaje de pedido de reservas.
Bookings	Si	Detalle de las reservas encontradas.
BookingReference	Si	Lista de referencias asociadas a la reserva.
BookingCreationDate	Si	Fecha de creación de la reserva.
ClientName	Si	Nombre del cliente de la reserva.
Agency	Si	Agencia que realizó la reserva.
Name	Si	Nombre de la agencia que realizó la reserva.
CreationUser	Si	Usuario de la agencia que realizó la reserva.
User	Si	Usuario que realizó la reserva.
Name	Si	Nombre del usuario que realizó la reserva.
Login	Si	Login del usuario que realizó la reserva.
BookingState	Si	Estado de la reserva.
Code	Si	Código de estado de la reserva.
Description	Si	Descripción del estado de la reserva.
StateDateTime	Si	Fecha y hora del cambio de estado de la reserva.
Payments	No	Pagos efectuados de la reserva.
Amount	No	Monto del pago efectuado por la reserva.
BookingItems	Si	Detalle de los items de la reserva.
Hotels	Si	Detalle de los items de hoteles de la reserva.
BookingReferences	Si	Lista de referencias asociadas al item de la reserva.
DestinationDetails	Si	Destino del item de la reserva.
Destination	Si	Detalle del destino del item de la reserva.
CheckIn	Si	Fecha de checkin del item de la reserva.
CheckOut	Si	Fecha de checkout del item de la reserva.
Boards	Si	Regimenes del item de la reserva.
Passengers	Si	Pasajeros del item de la reserva.
Rooms	Si	Habitaciones del item de la reserva.
Description	Si	Descripción del item de la reserva.
BookingStates	Si	Estados del item de la reserva.
Code	Si	Código de estado del item de la reserva.
Description	Si	Descripción del estado del item de la reserva.
StateDateTime	Si	Fecha y hora del cambio de estado del item de la reserva.
Prices	Si	Precios del item de la reserva.
Amount	Si	Monto del precio del item de la reserva.

Resolución AFIP

El impuesto para destinos internacionales se muestra en la sección de precios con el código "NMO.HTL.RPT.AFP":

<Prices ItemsCount="3">

   <Price PriceType="NMO.GBL.RPT.GRS" Sequence="1">
       <Amount CurrencyCode="USD">384.10</Amount>
   </Price>
   <Price PriceType="NMO.HTL.RPT.NET" Sequence="2">
       <Amount CurrencyCode="USD">47.21</Amount>
   </Price>
   <Price PriceType="NMO.HTL.RPT.AFP" Sequence="3">
       <Amount CurrencyCode="USD">9.44</Amount>
   </Price>

</Prices>

Mensaje BookingPaymentStatus: Cambiar estado del pago de reservas

El cambio de estado del pago de reservas permite obtener el resultado de la transacción. Si éste se realizó con éxito o, caso contrario, notificar porqué no pudo realizarse.

El método BookingPaymentStatus recibe un documento BookingPaymentStatusRQ y retorna un documento BookingPaymentStatusRS.

BookingPaymentStatusRQ

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>
<BookingPaymentStatusRQ  xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='AEXCEV_Main.xsd'>
    <Details>
        <Bookings ItemsCount="1">
            <Booking Sequence="1">
                <BookingReference ReferenceType="NMO.GBL.BRT.NAV">DN_0000Y</BookingReference>
                <BookingItems>                    
                    <Hotels ItemsCount="1">
                        <Hotel Sequence="1">
                            <BookingReference ReferenceType="NMO.FLT.BRT.NAV">DN_0000Y-1</BookingReference>                            
                        </Hotel>
                    </Hotels>                                
                </BookingItems>
            </Booking>
        </Bookings>
    </Details>
</BookingPaymentStatusRQ>

Parámetro	Obligatorio	Descripción
Details	Si	Detalle del cambio de estado en las reservas.
Bookings	Si	Reservas con pedido de cambio de estado.
BookingReference	Si	Lista de referencias asociadas a la reserva.
Hotels	No	Detalle de los items de hoteles de la reserva.
BookingReference	Si	Lista de referencias asociadas al item de hotel de la reserva.
Flights	No	Detalle de los items de aéreos de la reserva.
BookingReference	Si	Lista de referencias asociadas al item de aéreos de la reserva.

BookingPaymentStatusRS

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>
<BookingPaymentStatusRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="AEXCEV_Main.xsd">
    <Notifications ItemsCount="1">
        <Notification Sequence="1">
            <NotificationId>DN_0000Y-1</NotificationId>
            <NotificationType>Success</NotificationType>
            <NotificationMessage>Se informÃ³ el pago del item.</NotificationMessage>
        </Notification>
    </Notifications>
</BookingPaymentStatusRS>

Parámetro	Obligatorio	Descripción
Notifications	Si	Notificaciones del envío del mensaje.
NotificationId	Si	Id del item de la reserva que se envió el aviso de pago.
NotificationType	Si	Respuesta del envió del mensaje.
NotificationMessage	Si	Descripción de la respuesta al mensaje.

Mensaje AgencyQuery: Consultar info de agencia

La consulta de información de agencia permite obtener información detallada de una agencia en particular.

El método AgencyQuery recibe un documento AgencyQueryRQ y retorna un documento AgencyQueryRS.

AgencyQueryRQ

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>
<AgencyQueryRQ xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xsi:noNamespaceSchemaLocation='AEXCEV_Main.xsd'>
    <Details>
        <Agencies ItemsCount="1">
            <Agency Sequence="1" AgencyId="2">Operador Mariana Dos</Agency>
        </Agencies>
    </Details>
</AgencyQueryRQ>

Parámetro	Obligatorio	Descripción
Details	Si	Detalle de la consulta de agencias.
Agencies	Si	Agencias de las que se quiere obtener información.

AgencyQueryRS

Ejemplo


<?xml version="1.0" encoding="UTF-8"?>
<AgencyQueryRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="AEXCEV_Main.xsd">
    <Echo>
        <Details>
            <Agencies ItemsCount="1">
                <Agency Sequence="1">Operador Mariana Dos</Agency>
            </Agencies>
        </Details>
    </Echo>
    <Details>
        <Agencies ItemsCount="1">
            <Agency AgencyId="11539">
                <Name>Operador Mariana Dos</Name>
                <CreationUser>ADMINISTRADOR NEMO PRODUCCION</CreationUser>
                <Identifiers ItemsCount="1">
                    <Identifier Sequence="1" Type="NMO.PRS.IDT.CUI">0413641121</Identifier>
                </Identifiers>
                <Emails ItemsCount="2">
                    <Email Sequence="1" Value="nemo" />
                    <Email Sequence="2" Value="cesar.palmieri@nemogroup.net" />
                </Emails>
                <Addresses ItemsCount="1">
                    <Address Sequence="1">sarmiento</Address>
                </Addresses>
                <TelephoneNumbers ItemsCount="1">
                    <Telephone Sequence="1" TelephoneType="TelÃ©fono Principal">4475869</Telephone>
                </TelephoneNumbers>
                <Destinations Sequence="1" DestinationType="NMO.HTL.DST.CTY" DestinationCode="5735">Rosario</Destinations>
                <PostalCode CountryCode="5735" />
            </Agency>
        </Agencies>
    </Details>
</AgencyQueryRS>

Parámetro	Obligatorio	Descripción
Details	Si	Detalle de la respuesta a la consulta de agencias.
Agencies	Si	Agencias de las que se obtiene información.
Name	Si	Nombre de la agencia.
CreationUser	Si	Usuario que la creó.
Emails	Si	Emails de la agencia.
Addresses	Si	Direcciones de la agencia.
TelephoneNumbers	Si	Números telefónicos de la agencia.
Destinations	Si	Ciudad de la agencia.
PostalCode	Si	Código postal de la agencia.

Pruebas de implementación

Para realizar pruebas pueden usar un plugin de Chrome que permite hacer Request con archivos atachados. El plugin se puede descargar desde:

https://chrome.google.com/webstore/detail/advanced-rest-client/hgmloofddffdnphfgcellkdfbfbjeloo

Asimismo, pueden utilizar cualquier script que permita realizar un POST con headers y contenidos modificados.

Ejemplos de pasos para hacer una prueba:

* Como hacer una consulta de reservas:

URL: http://certnav.psurfer.net/backend.php/api/BookingsQueryRQ

Method: POST

Headers: Campo "Authorization" con user y password.

Data (File):

File field name: BookingsQueryRQ

Archivo: (ver ejemplo de BookingsQueryRQ)

* Para los otros mensajes el procedimiento es el mismo, hay que adjuntar el archivo XML y setear el nombre (file field name) al mensaje que se esté llamando, estos son:

Detalle de reserva:

http://certnav.psurfer.net/backend.php/api/BookingsDetailsRQ

Aviso de pago de la reserva:

http://certnav.psurfer.net/backend.php/api/BookingPaymentStatusRQ

Búsqueda de Agencia:

http://certnav.psurfer.net/backend.php/api/AgencyQueryRQ

Códigos y Descripciones

Precio

Código	Descripción
NMO.GBL.RPT.GRS	Bruto
NMO.GBL.RPT.NBP	Neto Proveedor
NMO.GBL.RPT.TAX	Tax
NMO.GBL.RPT.TBC	Tasa Antes de la Conversión de Moneda
NMO.HTL.RPT.ACH	Cargo adicional
NMO.HTL.RPT.CAN	Cancellation charges
NMO.HTL.RPT.CNB	Neto antes de la conversión, para cargos de cancelación
NMO.HTL.RPT.CNF	Neto para el marketer para cargos de cancelacion
NMO.HTL.RPT.CNG	Bruto para cargos de cancelacion
NMO.HTL.RPT.CNN	Neto para cargos de cancelacion
NMO.HTL.RPT.COM	Comision
NMO.HTL.RPT.FEE	Honorario
NMO.HTL.RPT.GWD	Bruto Sin Descuento
NMO.HTL.RPT.IOD	Descuento ofrecido incluido
NMO.HTL.RPT.MKP	Margen de beneficio
NMO.HTL.RPT.NBC	Neto antes de la conversión de moneda
NMO.HTL.RPT.NET	Neto
NMO.HTL.RPT.NFM	Neto para el Marketer
NMO.HTL.RPT.SFE	Honorario de Servicio
NMO.HTL.RPT.AFP	Percepción AFIP para destinos internacionales

Código de Referencia

Código	Descripción
NMO.FLT.BRT.EXT	Price Surfer Vuelos
NMO.FLT.BRT.EXT.FLT	Referencia Externa
NMO.FLT.BRT.PRS	Proveedor de Aerolíneas
NMO.FLT.BRT.PRS.PS1	Sistema Proveedor de Aerolineas 1
NMO.FLT.BRT.PRS.PS2	Sistema Proveedor de Aerolineas 2
NMO.FLT.BRT.PRS.PS3	Sistema Proveedor de Aerolineas 3
NMO.FLT.BRT.PRS.PS4	Sistema Proveedor de Aerolineas 4
NMO.FLT.BRT.PRS.PS5	Sistema Proveedor de Aerolineas 5
NMO.FLT.BRT.PRS.PS6	Sistema Proveedor de Aerolineas 6
NMO.FLT.BRT.PRS.PS7	Sistema Proveedor de Aerolineas 7
NMO.FLT.BRT.PRS.PS8	Sistema Proveedor de Aerolineas 8
NMO.FLT.BRT.PRS.PS9	Sistema Proveedor de Aerolineas 9
NMO.GBL.BRT.NAV	Price Surfer
NMO.HTL.RPT.AIS	Sistema de Facturación de agente
NMO.HTL.RPT.CIN	Sistema de Facturación de cliente
NMO.HTL.RPT.ICF	Confirmación de ítem
NMO.HTL.RPT.ISO	Iso
NMO.HTL.RPT.MPH	Price Surfer Hoteles
NMO.HTL.RPT.PRS	Sistema Proveedor
NMO.HTL.RPT.PRS.PS1	Sistema Proveedor
NMO.HTL.RPT.PRS.PS2	Sistema Proveedor
NMO.HTL.RPT.PSI	Sistema Facturación

Estado de reserva

Reserva global

Código	Descripción
NMO.GBL.BST.CAN	Cancelada
NMO.GBL.BST.CNE	Fallo en Cancelación
NMO.GBL.BST.CNF, NMO.HTL.BST.CNF	Confirmada
NMO.GBL.BST.CNP	Pendiente de cancelación
NMO.GBL.BST.INI	Inicial
NMO.GBL.BST.MIX	Mixto
NMO.GBL.BST.PEN	Pendiente de confirmación
NMO.GBL.BST.RJT	Confirmación Rechazada
NMO.GBL.BST.RQF	Fallo en confirmación

Item hotel

Código	Descripción
NMO.HTL.BST.CAC	Cancelada con cargos adicionales
NMO.HTL.BST.CAN	Cancelado
NMO.HTL.BST.CNE	Error en la cancelación - Contacte Soporte
NMO.HTL.BST.CNF	Confirmado
NMO.HTL.BST.CNP	Pendiente de cancelacion
NMO.HTL.BST.CWE	Confirmada con errores
NMO.HTL.BST.DEL	Presupuesto eliminado
NMO.HTL.BST.DLL	Expiración levantada
NMO.HTL.BST.EFT	Listo para facturar
NMO.HTL.BST.EIS	Error en envio a Sistema de Facturacion
NMO.HTL.BST.FAT	Facturada
NMO.HTL.BST.MIX	Mixta
NMO.HTL.BST.NEF	No está listo para facturar
NMO.HTL.BST.NEW	Presupuesto nuevo
NMO.HTL.BST.NIS	No enviado a Sistema de Facturacion
NMO.HTL.BST.PCS	Pendiente
NMO.HTL.BST.PEN	Pendiente de confirmacion
NMO.HTL.BST.PRE	Pago realizado
NMO.HTL.BST.RFT	Error en facturacion
NMO.HTL.BST.RJT	Rechazado
NMO.HTL.BST.RQF	Fallo la solicitud
NMO.HTL.BST.SIS	Enviado a Sistema de Facturacion

Item vuelo

Código	Descripción
NMO.FLT.BST.CAN	Cancelada
NMO.FLT.BST.CNE	Error en la cancelación - Contacte Soporte
NMO.FLT.BST.CNF	Confirmada
NMO.FLT.BST.CNP	Pendiente de cancelación
NMO.FLT.BST.PAI	Reserva de Aéreo Pagada
NMO.FLT.BST.PEN	Pendiente de confirmación
NMO.FLT.BST.RJT	Rechazado
NMO.FLT.BST.RQF	Fallo la solicitud
NMO.FLT.TKS.AVL	Disponible para emisión
NMO.FLT.TKS.MAN	Disponible para Emisión Manual

Item Paquete

Código	Descripción
NMO.PCK.BST.CAN	Cancelado
NMO.PCK.BST.CNF	Confirmado
NMO.PCK.BST.CNP	Pendiente de cancelación
NMO.PCK.BST.PEN	Pendiente de confirmación
NMO.PCK.OWP.CAN	Cancelado
NMO.PCK.OWP.CNF	Confirmado
NMO.PCK.OWP.CNP	Pendente de Cancelación
NMO.PCK.OWP.MIX	Mixta
NMO.PCK.OWP.PEN	Pendiente de Confirmación
NMO.PCK.OWP.RQF	Fallo la solicitud

@@ Línea 1038: / Línea 1038: @@
 |NMO.GBL.BST.CNE ||    Fallo en Cancelación
 |-
-|NMO.GBL.BST.CNF ||    Confirmada
+|NMO.GBL.BST.CNF, NMO.HTL.BST.CNF ||    Confirmada
 |-
 |NMO.GBL.BST.CNP ||    Pendiente de cancelación

Diferencia entre revisiones de «Price Surfer - Export contable»

Revisión del 11:50 18 jul 2014

Sumario

Introducción

Interfaz Cliente Simplificada

Requisitos de los clientes

Autenticación del Cliente

Acceso

Ejemplos de acceso

Códigos de respuesta de la petición HTTP

Mensajes soportados

Buscar reservas (BookingsQueryRQ)

Solicitar información detallada de reservas (BookingsDetailsRQ)

Cambiar estado del pago de reservas (BookingPaymentStatusRQ)

Consultar info de agencia (AgencyQueryRQ)

Documentos XML

Mensaje BookingsQuery: Buscar reservas

BookingsQueryRQ

BookingsQueryRS

Mensaje BookingsDetails: Solicitar información detallada de reservas

BookingsDetailsRQ

BookingsDetailsRS

Resolución AFIP

Mensaje BookingPaymentStatus: Cambiar estado del pago de reservas

BookingPaymentStatusRQ

BookingPaymentStatusRS

Mensaje AgencyQuery: Consultar info de agencia

AgencyQueryRQ

AgencyQueryRS

Pruebas de implementación

Códigos y Descripciones

Precio

Código de Referencia

Estado de reserva

Reserva global

Item hotel

Item vuelo

Item Paquete

Menú de navegación

Buscar