KIU_ReadRQ / KIU_ProfileReadRS

Indice de Contenido

Objetivo

El método permite al usuario consultar el saldo y detalle de una cuenta corporativa creada en el sistema, también puede consultar saldos para Agencias de viaje.

Este método es de uso exclusivo para usuarios de líneas aéreas host.

KIU_ReadRQ

El modelo XML para la petición es:

KIU_ReadRQ - Consulta de Cuenta Corriente Corporativa

<?xml version="1.0" encoding="UTF-8"?>
<KIU_ReadRQ EchoToken="1" TimeStamp="2012-11-09T13:23:55-03:00" Target="Testing" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
    <POS>
        <Source AgentSine="NET00XXWW" TerminalID="NET00XX000"></Source>
    </POS>
    <ReadRequests>
        <ProfileReadRequest>
            <UniqueID Type="21" ID="ACME" />
        </ProfileReadRequest>
    </ReadRequests>
</KIU_ReadRQ>

KIU_ReadRQ - Consulta de Cuenta Corriente de Agencia de Viajes

<?xml version="1.0" encoding="UTF-8"?>
<KIU_ReadRQ EchoToken="1" TimeStamp="2017-10-11T13:23:55-03:00" Target="Testing" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
   <POS>
      <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" />
   </POS>
   <ReadRequests>
      <ProfileReadRequest>
         <UniqueID Type="5" ID="BUEA7760" />
      </ProfileReadRequest>
   </ReadRequests>
</KIU_ReadRQ>

Elementos del Mensaje KIU_ReadRQ

POS: Elemento que agrupa la información del Punto de Venta desde el cual se realiza la petición.
- Source: Contenedor de los datos del Punto de Venta o POS.
  - AgentSine: Alfanumérico [9]. Identificador del agente que realiza la petición.
  - TerminalID: Alfanumérico [10]. Código identificador del dispositivo desde el que se realiza la petición.
ReadRequests: Elemento que contiene la información de la consulta a efectuar.
- ProfileReadRequest: Elemento contenedor de la petición de consulta de cuenta.
  - UniqueID: Elemento que agrupa la información de la cuenta a consultar.
    - Type: Atributo. Requerido. Entero. Código identificador del tipo de cuenta (1: cuentas corporativas; 5: agencias de viaje).
      
      Para aquellos clientes que tengan implementado en sus aplicaciones el anterior código "21" de cuentas corporativas, el mismo se continuará soportando con la misma lógica del código "1".
    - ID: Atributo. Mandatorio. Alfanumérico [32]. Código de la cuenta corporativa (invoice code o custumer ID) o de la agencia de viajes (office ID).

KIU_ProfileReadRS

El modelo XML para la respuesta es:

KIU_ProfileReadRS - Cuenta Corriente Corporativa

<?xml version="1.0" encoding="UTF-8"?>
<KIU_ProfileReadRS EchoToken="1" TimeStamp="2012-11-09T20:58:34+00:00" Target="Testing" Version="3.0" SequenceNmbr="1">
    <Success />
    <Profiles>
        <ProfileInfo>
            <Profile>
                <CompanyInfo>
                    <CompanyName>ACME SA</CompanyName>
                    <Account CurrencyCode="ARS" Balance="-37" Overdraft="400" />
                </CompanyInfo>
            </Profile>
        </ProfileInfo>
    </Profiles>
</KIU_ProfileReadRS>

KIU_ProfileReadRS - Cuenta Corriente de Agencia de Viajes

<?xml version="1.0" encoding="UTF-8"?>
<KIU_ProfileReadRS EchoToken="1" TimeStamp="2017-10-11T13:33:09+00:00" Target="Testing" Version="3.0" SequenceNmbr="1">
	<Success/>
  <Profiles>
    <ProfileInfo>
      <Profile>
        <CompanyInfo>
          <CompanyName>TESTING TRAVEL AGENCY</CompanyName>
          <Account CurrencyCode="ARS" Balance="9578935.72" Overdraft="2000000.00"/>
        </CompanyInfo>
      </Profile>
    </ProfileInfo>
  </Profiles>
</KIU_ProfileReadRS>

Elementos del Mensaje KIU_ProfileReadRS

Profiles: Elemento que agrupa los perfiles consultados.
- ProfileInfo: Elemento que agrupa la información del perfil.
  - Profile: Perfil de la cuenta consultada.
    - CompanyName: Alfanumérico. Nombre registrado de la empresa a la que pertenece la cuenta corporativa o nombre de agencia de viajes.
    - Account: Elemento que contiene la información de la cuenta corporativa o cuenta corriente.
      - CurrencyCode: Alfabético [3]. Código ISO de la moneda en la cual están expresados los balances de la cuenta.
      - Balance: Decimal. Balance actual de la cuenta.
      - Overdraft: Decimal. Límite de descubierto de la cuenta (por ejemplo, si el límite es 400, la cuenta puede tener un balance de hasta -400. Si se intenta una emisión a nombre de esa cuenta que lleve el balance por debajo de ese número, la emisión devolverá error).

Posibles Mensajes de Error

Código	Mensaje	Explicación
10012	Too many IDs to process.	Se envió más de un código de cuenta corporativa. El método soporta un código por llamada.
11041	Error at parameter ID Type.	El valor del atributo Type del elemento UniqueID no se corresponde con el formato descripto (21).
11044	Error at parameter Profile ID.	El valor del atributo ID del elemento UniqueID no se corresponde con el formato descripto (alfanumérico en mayúsculas de hasta 32 caracteres).

KIU Documentación Online