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:
<?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>
<?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.
- Source: Contenedor de los datos del Punto de Venta o POS.
- 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).
- UniqueID: Elemento que agrupa la información de la cuenta a consultar.
- ProfileReadRequest: Elemento contenedor de la petición de consulta de cuenta.
KIU_ProfileReadRS
El modelo XML para la respuesta es:
<?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>
<?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).
- Profile: Perfil de la cuenta consultada.
- ProfileInfo: Elemento que agrupa la información del perfil.
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). |