KIU_TravelerApiInfo



Objetivo


El presente es utilizado para enviar el contenido de la mascara que se construye a partir del método KIU_GetTravelerAPIInfoRS. Este método es el encargado de enviar la informacion de cada pasajero al host para procesar la API. La misma va a devolver un succes o un error señalando que campo que produjo dicho error con la descripción del mismo.

Es importante destacar que para el proceso de API, se envía un formulario por cada pasajero. No acepta lista de pasajeros.



KIU_AirTravelerApiInforRQ


Modelo del Mensaje

<?xml version="1.0" encoding="UTF-8"?>
<KIU_TravelerAPIInfoRQ EchoToken="1" TimeStamp="2012-04-20T15:45:07-03:00" Target="Testing" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
    <POS>
        <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" ISOCountry="AR"/>
    </POS>
    <TravelerAPIInfo>
        <KIU_Interpreter>
        <Controles control="FormType" value="C"/>
        <Controles control="FormMode" value="P"/>
        <Controles control="SecuenciaPax" value="001"/>
        <Controles control="RecLoc" value="IBXHWY"/>
        <Controles control="VersionPax" value="1" />
        <Controles control="Header" value="XX 903020170625EZEMIA A99902200042751 END"/>
        <Controles control="SurName" value="GUERERE"/> 
        <Controles control="FirstName" value="JUAN"/> 
        <Controles control="SecondName" value="MR"/> 
        <Controles control="BirthDate" value="16SEP74"/> 
        <Controles control="BirthPlace" value="ARG"/> 
        <Controles control="Gender" value="M"/> 
        <Controles control="Nationality" value="ARG"/> 
        <Controles control="CountryOfRes" value="ARG"/> 
        <Controles control="TypeDoc" value="00"/> 
        <Controles control="NumDoc" value="445544545"/> 
        <Controles control="ExpDate" value="25DEC16"/> 
        <Controles control="IssueDate" value="DDMMMYY"/> 
        <Controles control="CountryDoc" value="AR"/> 
        <Controles control="CityDoc" value=""/> 
        <Controles control="VisaNum" value=""/> 
        <Controles control="VisaExpDate" value="DDMMMYY"/> 
        <Controles control="VisaIssueDate" value="DDMMMYY"/> 
        <Controles control="VisaCountry" value="ARG"/> 
        <Controles control="VisaCity" value=""/> 
        <Controles control="Others" value=""/> 
        <Controles control="OthersNum" value=""/> 
        <Controles control="OthersExpDate" value="DDMMMYY"/> 
        <Controles control="OthersIssueDate" value="DDMMMYY"/> 
        <Controles control="OthersCountry" value=""/> 
        <Controles control="OthersCity" value=""/> 
        <Controles control="PrimResAddress" value=""/> 
        <Controles control="CityAddress" value=""/>
        <Controles control="StateAddress" value=""/>
        <Controles control="ZipAddress" value=""/>
        <Controles control="CountryAddress" value=""/>
        <Controles control="DestAddress" value=""/>
        <Controles control="DestCityAddress" value=""/>
        <Controles control="DestStateAddress" value=""/> 
        <Controles control="DestZipAddress" value=""/>
        <Controles control="DestCountryAddress" value=""/>
        <Controles control="EmergContName" value=""/>
        <Controles control="EmergContTel" value=""/>
        </KIU_Interpreter>
    </TravelerAPIInfo>
</KIU_TravelerAPIInfoRQ>

 

Elementos del mensaje KIU_TravelerAPIInfoRQ

  • KIU_Interpreter: Mandatorio. Elemento que contiene la información proveniente de la mascara de API construida en base a KIU_GetTravelerAPIInfoRS
    • Controles: Mandatorio. Elemento que enumera cada campo a enviar como informacion de API. Debe existir un elemento por cada campo de la mascar de acuerdo a la API que se esta procesando. 
      • Control: Atributo. Mandatorio. Nombre del campo de la mascara.
      • Value: Mandatorio. Valor correspondiente al campo de referencia en el atributo control.


Volver al indice


KIU_TravelerAPIInfoRS


Modelo del Mensaje

KIU_TravelerAPIInfoRS
<?xml version="1.0" encoding="UTF-8"?>
<KIU_TravelerAPIInfoRS TimeStamp="2012-04-20T15:45:07-03:00" Target="Testing" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
    <Success>
        <Status >OK</Status>
        <Code>DONE</Code>
    </Success>
    <Warnings>
        <Warning Code="">
            <Text/>
        </Warning>
    </Warnings>
    <Errors>
        <Extra></Extra> <!-- Extra: Optional - User in furhter implementations -->
         <Value>
            <TypeError></TypeError>
        </Value>
    </Errors>
    <ErrorMaskFields>
        <BookingInformation>
            <BookingReferenceID>
                <ID>XXXXXX</ID>
            </BookingReferenceID>
        </BookingInformation>
        <ErrorByField>
            <FormType>
                <Value>B</Value> <!-- Value admitido B - Básico / C - Completo -->
                <Extra></Extra> <!-- Optional: For future processes -->
            </FormType>
            <FormMode>
                <Value>P</Value> <!-- Value: Admite P - Passenger / C - Crew -->
                <Extra></Extra> <!-- Optional: For future processes -->
            </FormMode>
            <SecuenciaPax>
                <Value>001</Value> <!-- Nro de Secuencia del pax, Response KIU_AirCheckIN-->
                <Extra></Extra> <!-- Optional: For future processes -->
            </SecuenciaPax>
            <RecLoc>
                <Value>XXXXXX</Value> <!-- Value: Codigo de la reserva = BookingReferenceID => ID -->
                <Extra></Extra> <!-- Optional: For future processes -->
            </RecLoc>
            <VersionPax>
                <Value>001</Value> <!-- Value: = UPID del pax, proveniente de KIU_AirTravellerCheckInRS -->
                <Extra></Extra> <!-- Optional: For Future Process -->
            </VersionPax>
            <Header>
                <Value>XX 903020170625EZEMIA     A99902200042751 END</Value> <!-- Comming from the API Mask processed on System-->
                <Extra></Extra> <!-- Optional: For future process -->
            </Header>
            <Title>
                <Value>Advanced Passenger Information. MASK / C-P</Value>
                <Extra></Extra> <!-- Optional: For future information -->
            </Title>
            <TypePax>
                <Value>PAX: IBXHWY 1</Value>
                <Exra></Exra> <!-- Optional: for future information -->
            </TypePax>
            <APIFormMask>
                <!-- The APIFormMask, pull back the information entered. 
Each element included will have the name of the mask processed. All fields have a Status element. When the value is X, means that field has an                error. The application should prepolutate the information on the HTML Mask and return to fillup the data and highlight those with X as Error -->
                <Surname>
                    <Extra></Extra> <!-- For Future process -->
                    <Length>70</Length> <!-- MaxSize of field - Alfabetical -->
                    <Status></Status> <!-- Status allows: Vacio= No action/ X = Error on field data --> 
                    <Value>GUERERE</Value> <!-- Passenger Last Name -->
                </Surname>
                <FirstName>
                    <Extra></Extra> <!-- For future process -->
                    <Length>35</Length>
                    <Status></Status>
                    <Value>ROBINSON</Value> <!-- Passenger Name -->
                </FirstName>
                <SecondName>
                    <Extra></Extra>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>MR</Value>
                </SecondName>
                <BirthDate>
                    <Extra></Extra> <!-- For future process -->
                    <Length>7</Length>
                    <Status>X</Status> <!-- Status: The X means this field has an error -->
                    <Value>DDMMMYY</Value> <!-- DateFormat: Ej. 12NOV16 -->
                </BirthDate>
                <BirthPlace>
                    <Extra></Extra>
                    <Length>3</Length>
                    <Status></Status>
                    <Value></Value> <!-- Expected City ISO code ej: BUE -->
                </BirthPlace>
                <Gender>
                    <Extra></Extra>
                    <Length>2</Length>
                    <Status></Status>
                    <Values> <!-- Display DropDownList - Enable only posible value M-Male / F - Female /U - Unknown// Code is the returnData -->
                        <Value>
                            <Text>M</Text>
                            <Code>M</Code>
                        </Value>
                        <Value>
                            <Text>F</Text>
                            <Code>F</Code>
                        </Value>
                        <Value>
                            <Text>U</Text>
                            <Code>U</Code>
                        </Value>
                    </Values>
                </Gender>
                <Nationality>
                    <Extra></Extra>
                    <Length>3</Length>
                    <Status></Status>
                    <Value></Value>
                </Nationality>
                <CountryOfRes>
                    <Extra></Extra>
                    <Length>3</Length>
                    <Status></Status>
                    <Value></Value>
                </CountryOfRes>
                <TypeDoc>
                    <Extra></Extra>
                    <Values>
                        <Value>
                            <Text>P</Text>
                            <Code>00</Code>
                        </Value>
                        <Value>
                            <Text>V</Text>
                            <Code>01</Code>
                        </Value>
                        <Value>
                            <Text>A</Text>
                            <Code>02</Code>
                        </Value>
                        <Value>
                            <Text>C</Text>
                            <Code>03</Code>
                        </Value>
                        <Value>
                            <Text>I</Text>
                            <Code>04</Code>
                        </Value>
                        <Value>
                            <Text>AC</Text>
                            <Code>05</Code>
                        </Value>
                        <Value>
                            <Text>IP</Text>
                            <Code>06</Code>
                        </Value>
                        <Value>
                            <Text>M</Text>
                            <Code>07</Code>
                        </Value>
                    </Values>
                    <Value></Value>
                </TypeDoc>
                <NumDoc>
                    <Extra></Extra>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>12345679891</Value>
                </NumDoc>
                <ExpDate>
                    <Extra></Extra>
                    <Length>7</Length>
                    <Status></Status>
                    <Value>DDMMMYY</Value>
                </ExpDate>
                <IssueDate>
                    <Length>7</Length>
                    <Status></Status>
                    <Value>DDMMMYY</Value>
                </IssueDate>
                <CountryDoc>
                    <Length>3</Length>
                    <Status></Status>
                    <Value></Value>
                </CountryDoc>
                <CityDoc>
                    <Length>35</Length>
                    <Status></Status>
                    <Value></Value> <!-- Name of the City example: BUENOS AIRES-->
                </CityDoc>
                <VisaNum>
                    <Length>35</Length>
                    <Status></Status>
                    <Value></Value>
                </VisaNum>
                <VisaExpDate>
                    <Length>7</Length>
                    <Status></Status>
                    <Value>DDMMMYY</Value>
                </VisaExpDate>
                <VisaIssueDate>
                    <Length>7</Length>
                    <Status></Status>
                    <Value>DDMMMYY</Value>
                </VisaIssueDate>
                <VisaCountry>
                    <Length>3</Length>
                    <Status></Status>
                    <Value></Value>
                </VisaCountry>
                <VisaCity>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>NAME OF THE CITY</Value>
                </VisaCity>
                <OthersNum>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>Nbr of the other doc</Value>
                </OthersNum>
                <OthersExpDate>
                    <Length>7</Length>
                    <Status></Status>
                    <Value>DDMMMYY</Value>
                </OthersExpDate>
                <OthersIssueDate>
                    <Length>7</Length>
                    <Status></Status>
                    <Value>DDMMMYY</Value>
                </OthersIssueDate>
                <OthersCountry>
                    <Length>3</Length>
                    <Status></Status>
                    <Value>USA</Value>
                </OthersCountry>
                <OthersCity>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>Name of the City</Value>
                </OthersCity>
                <PrimResAddress>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>Direccion de Residencia</Value>
                </PrimResAddress>
                <CityAddress>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>Name of the city</Value>
                </CityAddress>
                <StateAddress>
                    <Length>35</Length>
                    <Status></Status>
                    <Value>Name of the State</Value>
                </StateAddress>
                <ZipAddress>
                    <Length>17</Length>
                    <Status></Status>
                    <Value>Alfanumérico</Value>
                </ZipAddress>
                <CountryAddress>
                    <Length>3</Length>
                    <Status></Status>
                    <Value></Value>
                </CountryAddress>
                <DestAddress>
                    <Length>35</Length>
                    <Status></Status>
                    <Value></Value>
                </DestAddress>
                <DestAddress>
                    <Length>35</Length>
                    <Status></Status>
                    <Value></Value>
                </DestAddress>
                <DestCity>
                    <Length>35</Length>
                    <Status></Status>
                    <Value></Value>
                </DestCity>
                <DestStateAddress>
                    <Length>35</Length>
                    <Status></Status>
                    <Value></Value>
                </DestStateAddress>
                <DestZipAddress>
                    <Length>17</Length>
                    <Status></Status>
                    <Value></Value>
                </DestZipAddress>
                <DestCountryAddress>
                    <Length>3</Length>
                    <Status></Status>
                    <Value>ARG</Value>
                </DestCountryAddress>
                <EmergContName>
                    <Length>21</Length>
                    <Status></Status>
                    <Value>Person Name</Value>
                </EmergContName>
                <EmergContTel>
                    <Length>16</Length>
                    <Status></Status>
                    <Value></Value>
                </EmergContTel>
            </APIFormMask>
        </ErrorByField>
    </ErrorMaskFields>
</KIU_TravelerAPIInfoRS>


Elementos del mensaje KIU_TravelerAPIInfoRS

  • Success: Elemento que contiene la información del procesamiento del mensaje. 
    • Status: Elemento indicador del procesamiento del mensaje.
    • Code: Descripción del resultado del procesamiento. 

  • Warnings: Elemento que contiene las advertencias en caso de existir sobre el procesamiento del mensaje
    • Warning: Elemento puntual de cada Advertencia que se recibe. Repetitivo. 
      • Code: Código del mensaje de advertencia
      • Text: Descripción de la advertencia. Mensaje.

  • Errors: Opcional. Elemento que contiene la información relacionada a los errores de campos o procesamiento del mensaje. Presente únicamente en caso de error de procesamiento.
    • Extra: Opcional, para usos futuros.
    • Value: Valor del error
    • TypeError: Descripción del tipo de error.

  • ErrorMaskFields: Elemento que enumero los errores referentes al pasajero procesado. 
    • BookingInformation: Elemento que contiene informacion de la reserva que contiene al pasajero informado. 
      • ID: Alfanumérico (7). Código de reserva.
    • ErrorByField: Elemento que enumera todos los campos que contiene la mascara procesada. 
      • FormyType: Elemento que hace referencia al tipo de mascara procesada
        • Values: Código de tipo de mascara. (B=Basico / C= Completa)
        • Extra: Para usos futuros. N/A.
      • FormMode: Mandatorio. Información de modo de mascara
        • Value: Elemento que indica el modo de la mascara (P=Passenger/C=Crew)
        • Extra: Para usos futuros. N/A.
      • SecuenciaPax: Elemento que contiene la informacion del Número de secuencia del pasajero. Es un ID indicador referenciado entre los métodos proveniente del sistema.
        • Value: Entero (4). Número de secuencia del pasajero. 
        • Extra: Para usos futuros. N/A.
      • RecLoc: Elemento que contiene el identificador/localizador de la reserva.
        • Value: Alfanumerico (7). Código de reserva donde se encuentra el pasajero. 
        • Extra: Para usos futuros. N/A.
      • VersionPax: Elemento que informa el ID del pasajero proveniente del sistema
        • Value: Entero (4). ID de referencia del pasajero en el sistema.
        • Extra: Para usos futuros. N/A.
      • Header: Elemento que contiene la información del encabezado de la mascara de API.
        • Value: Alfanumérico (50). Mandatorio. Encabezado de la mascara de API. 
        • Extra: Para usos futuros. N/A.
      • Title: Elemento que contiene el título de la mascara.
        • Value: Alfanumérico (20). Título de la mascara.
        • Extra: Para usos futuros. N/A.
      • TypePax: Elemento que contiene la asociación al PNR y cantidad de pasajeros a procesar.
        • Value: Alfanumérico especial. Código de reserva y cantidad.
        • Extra: Para usos futuros. N/A.
      • APIFormMask: Elemento que contiene cada campo, el valor, tamaño del campo y estado del mismo
        • Elemento: Cada elemento va a tomar el nombre del campo de referencia de la mascara. Ver ejemplo del método. 
          • Extra: Para usos futuros. N/A.
          • Length: Entero. Tamaño del campo.
          • Status: Devuelve un valor de procesamiento de la información del campo. 
                        X - El campo tiene un error y se debe revisar.
                        Vacío - El valor recibido es correcto.
          • Values: En caso de lista de posibles valores tipo lista desplegable.

 

Volver al indice