API_Datos API para tripulación (Crew)

Introducción

Además del mensaje PAXLST con los datos de los pasajeros, la línea aérea deberá generar un segundo mensaje PAXLST que contenga los datos API del personal de la línea aérea que esté viajando como parte de la tripulación.

Considerando que para la tripulación no se genera ninguna reserva (PNR) ni es aceptada en el check-in como los pasajeros, se ha creado la funcionalidad que se describe a continuación para la carga de datos API de tripulación y la generación del mensaje correspondiente.

Ingresar datos API para tripulación (PA/PABC/PACC)

La carga de datos API se realiza a través de una máscara en el módulo de check-in. Para moverse entre los campos dentro de la máscara se podrá utilizar la tecla TAB. Se requiere duty 5.

Para ingresar los datos API para la tripulación se deberá utilizar el siguiente comando:

PA(tipo de datos)(identificador)(vuelo)/(fecha)(origen)(destino)/(referencia)

PA(vuelo)/(fecha)(origen)(destino)/(referencia)

Ejemplos:

PABC17/29APRAEPMVD/CREW03

Descripción:

PA	Indicador de API
B	Tipo de datos API (B: Basic – C: Complete)
C	Identificador (P: PAX o C: CREW)
17	Número de vuelo
/	Barra separadora
29APR	Fecha de vuelo (Formato DDMMM)
AEP	Aeropuerto de origen
MVD	Aeropuerto de destino (Condicional en vuelos multileg)
/	Barra separadora
CREW03	Código de referencia del tripulante (6 caracteres alfanuméricos)

 PACC17/29APRAEPMVD/CREW03

Descripción:

PA	Indicador de API
C	Tipo de datos API (B: Basic – C: Complete)
C	Identificador (P: PAX o C: CREW)
17	Número de vuelo
/	Barra separadora
29APR	Fecha de vuelo (Formato DDMMM)
AEP	Aeropuerto de origen
MVD	Aeropuerto de destino (Condicional en vuelos multileg)
/	Barra separadora
CREW03	Código de referencia del tripulante (6 caracteres alfanuméricos)

 PA17/29APRAEPMVD/CREW03

Descripción:

PA	Indicador de API
17	Número de vuelo
/	Barra separadora
29APR	Fecha de vuelo (Formato DDMMM)
AEP	Aeropuerto de origen
MVD	Aeropuerto de destino (Condicional en vuelos multileg)
/	Barra separadora
CREW03	Código de referencia del tripulante (6 caracteres alfanuméricos)

Tipo de datos API

B	Básico
C	Completo
T	TSA (ver instructivo específico)

Identificador

P	Pasajeros
C	Tripulación (Crew)

Consideraciones

El código de referencia debe contener 6 caracteres alfanuméricos y sería el equivalente al código de reserva. Cada línea aérea podrá definir el procedimiento que considere necesario para la generación de estos códigos de referencia.
Cuando se ingresa el comando PA, el sistema verificará el tipo de datos requerido (B o C) según la tabla JJAPI desplegando la máscara que corresponda de acuerdo a la configuración indicada.
Ingresando el comando que incluye el tipo de datos (PABP o PACP), el sistema desplegará la máscara solicitada (PABP: Básica o PACP: Completa)
El sistema controlará que el mismo código ficticio no se genere dentro del mismo vuelo en el mismo punto de embarque

Respuesta:

La respuesta será la máscara vacía para completar con todos los datos de la tripulación.

Descripción:

Advanced Passenger Information	Nombre de la máscara (API)
B – C	Tipo de datos API (B: Basic – C: Complete) - Identificador (P: PAX o C: CREW)
CREW# CREW03	Código de referencia
SURNAME	Apellido
F.NAME	Primer nombre (First Name)
S.NAME	Segundo nombre (Second Name)
BIRTH DATE	Fecha de nacimiento (Formato DDMMMYY)
BIRTH PLACE	Lugar de nacimiento (código de país ISO de 3 letras)
GENDER	Género (M: Male, F: Female, U: Undisclosed)
NATIONALITY	Nacionalidad (código de país ISO de 3 letras)
CNTRY RES	País de residencia (código de país ISO de 3 letras)
D.TYPE	Tipo de documento
NUM	Número de documento
EXPIRY DATE	Fecha de vencimiento del documento (Formato DDMMMYY)
ISSUE DATE	Fecha de emisión del documento (Formato DDMMMYY)
CNTRY	País de emisión del documento (código de país ISO de 3 letras)
CITY	Ciudad de emisión del documento

Códigos de país

Es importante aclarar que todos los códigos de país ingresados en la máscara deben ser los códigos de país de 3 (tres) letras. Estos códigos estarán disponibles en la decodificación de los país (DNP<país>). Si se detectara la falta de algún código ISO3, el mismo deberá ser solicitado a Soporte Host.

Género

M	Masculino (Male)
F	Femenino (Female)
U	No informado (Undisclosed)

Tipos de documento (D. TYPE – Document Type)

P	Pasaporte
V	Visa
A	Tarjeta de Identificación
C	Tarjeta de Identificación
I	Tarjeta de Identificación
AC	Certificado de Tripulación (Crew Member Certificate)
IP	Tarjeta de Pasaporte (Passport Card)
M	Identificación Militar

Cuando la máscara desplegada sea la completa, además de los datos de la máscara básica se agregarán los siguientes campos:

Descripción:

VISA	Datos de otra documentación (SSR DOCO)
V NUM	Número de documento (visa)
EXPRIY DATE	Fecha de vencimiento del documento
ISSUE DATE	Fecha de emisión del documento
CNTRY	País de emisión del documento
CITY	Ciudad de emisión del documento
OTHERS	Otros documentos
NUM	Número del documento
EXPIRY DATE	Fecha de vencimiento del documento
ISSUE DATE	Fecha de emisión del documento
CNTRY	País de emisión del documento
CITY	Ciudad de emisión del documento
PRIMARY RESIDENCE ADDRESS	Domicilio de residencia (SSR DOCA-R)
CITY	Ciudad de residencia
STATE	Estado/Provincia de residencia
ZIP	Código Postal
CNTRY	País de residencia
DESTINATION ADDRESS	Domicilio en destino (SSR DOCA-D)
CITY	Ciudad de destino
STATE	Estado/Provincia de destino
ZIP	Código Postal
CNTRY	País de destino
D.TYPE	Tipo de tripulante
CREW LICENSE NBR	Número de licencia del tripulante

Tipo de triuplante

CR1	Cockpit Crew and Individuals in the Cockpit
CR2	Cabin Crew
CR3	Airline Operation Management with Cockpit Access
CR4	Cargo Non-Cockpit Crew and/or Non-Crew Individuals
CR5	Pilots on Aircraft but not on Duty

En la parte inferior de la máscara se encuentra el campo para ingresar la acción a seguir:

Se completan los datos API en los campos de la máscara desplegada y se procede a la grabación de los mismos indicando la acción SE (Save and Exit).

La carga de los datos API de los tripulantes se realiza de a uno por vez, por lo que para cargar los datos del siguiente tripulante se deberá volver a utilizar el comando PABC descripto anteriormente.

Ejemplo:

 PABC17/29APRAEPMVD/PILOT1

Back to top

Editar datos API ingresados para tripulación

Utilizando el código de referencia asignado al momento de ingresar los datos de la tripulación es posible ingresar en modo de edición: la máscara mostrará una barra arriba a la derecha indicando que el agente se encuentra en el modo de edición: “CHECK:RECORD ALREADY EXISTS // EDIT MODE”.

Para buscar y editar los datos API de un tripulante que hayan sido ingresados con anterioridad, se deberá buscar al tripulante a través del código asignado.

El comando sería el siguiente:

PABC(vuelo)/(fecha)(origen)(destino)/(referencia)

PA(vuelo)/(fecha)(origen)(destino)/(referencia)

Ejemplos:

 PABC17/29APRAEPMVD/PILOT1

PA17/29APRAEPMVD/PILOT1

Descripción:

PA	Indicador de API
B	Tipo de datos API (B: Basic – C: Complete)
C	Identificador (P: PAX o C: CREW)
17	Número de vuelo
/	Barra separadora
29APR	Fecha de vuelo (Formato DDMMM)
AEP	Aeropuerto de origen
MVD	Aeropuerto de destino (Condicional en vuelos multileg)
/	Barra separadora
PILOT1	Código de referencia del tripulante (6 caracteres alfanuméricos)

Respuesta:
La máscara resultante mostrará los valores cargados anteriormente y permitirá la edición de los mismos de la misma manera que en la carga original.

Al finalizar con la edición de los datos se deberá ingresar el comando de acción SE (Save and Exit) ya que los datos API de los tripulantes se cargan uno por uno.

Back to top

Listado de datos API de tripulación (PALC)

Con el comando PALC es posible desplegar un listado de los tripulantes que cuenten con los datos API para un vuelo determinado. El listado se mostrará en orden alfabético según los apellidos. Se requiere duty 5 y keyword CHKLV1.

El comando es el siguiente:

PALC(vuelo)/(fecha)(origen)

Ejemplo:

PALC17/29APRAEP

Descripción:

PA	Indicador de API
L	Indicador de Lista
C	Identificador (P: PAX o C: CREW)
17	Número de vuelo
/	Barra separadora
29APR	Fecha de vuelo (Formato DDMMM)
AEP	Aeropuerto de origen

Respuesta:

API / XX 17/29APRAEP / CREW
  REF - # T SURNAME/FIRST (/MIDDLE) DOB     POB G NAT RES ID-NUMBER EXPIR   ISSUE   I/C I/P
CREW02- 1   CREW/TWO                01DEC79 ARG F ARG ARG P 333333  01DEC15 01DEC12 ARG BUE 
PILOT1- 2   PILOT/COMMANDER         01DEC79 ARG F ARG ARG P 444444  01DEC15 01DEC12 ARG BUENOS AIRES

Descripción:

API / XX 17/29APRAEP / CREW	Título del listado API indicando vuelo, fecha y tipo de listado (PAX o CREW)
REF	Código de reserva
#	Número de PAX
T	Tránsito (no disponible)
SURNAME/FIRST	Apellido y primer nombre
(/MIDDLE)	Segundo nombre
DOB	Fecha de nacimiento (Date of Birth)
POB	Lugar de nacimiento (Place of Birth)
G	Género (Gender)
NAT	Nacionalidad (Nationality)
RES	País de residencia
ID-NUMBER	Tipo y número de documento
EXPIR	Fecha de vencimiento del documento (Expiry Date)
ISSUE	Fecha de emisión del documento
I/C	País de emisión del documento (Issue Country)
I/P	Lugar de emisión del documento (Issue Place)

Es posible utilizar el comando PALC sin indicar los datos del vuelo si el agente se encuentra ya trabajando en el check-in de un vuelo y los datos del mismo se encuentran activos en el área de trabajo.

Datos del agente

Agregando un asterisco (*) al final del comando PALC, se podrá visualizar en una línea adicional para cada registro los datos del día, hora y agente que haya realizado la última modificación sobre la máscara de API.

Esta información estará disponible con asterisco hasta el momento del cierre del vuelo (PD en todos los tramos involucrados). Luego del cierre de los vuelos (PD), la información se mostrará siempre que se recupere el listado PALC sin necesidad de agregar el asterisco.

Ejemplo:

Descripción:

//LAST MODIFIED	Indicador de última modificación
BY	Indicador de dato del agente
KIUHELPLL	ID del agente que realizó la última modificación
ON	Indicador de dato de fecha/hora
18JUL16	Día UTC en que se realizó la última modificación (DDMMMYY)
/	Barra separadora
1556Z	Hora UTC en que se realizó la última modificación (HHMM)

Back to top

Historia de datos APIS de tripulación (PAHC)

Con el comando PAHP es posible desplegar un listado de los pasajeros que cuenten o hayan contado con los datos API para un vuelo determinado. Se requiere duty 5 y keyword CHKLV1.

El comando es el siguiente:

PAHC(vuelo)/(fecha)(origen)

Ejemplo:

PAHC4340/10AUGAEP

Descripción:

PA	Indicador de API
H	Indicador de Historia
C	Identificador (P: PAX o C: CREW)
4340	Número de vuelo
/	Barra separadora
10AUG	Fecha de vuelo (Formato DDMMM)
AEP	Aeropuerto de origen

Respuesta:

API / XX4340/10AUGAEP / CREW
RECLOC-UPID  OFF SURNAME/FIRST (/MIDDLE)                      DEL
CREW01-   1  MDQ CREW/ONE                                     *
CREW02-   1  MDQ CREW/TWO                                     
PILOT1-   1  MDQ PILOT/ONE

Descripción:

API / XX4340/10AUGAEP / CREW	Título del listado API indicando vuelo, fecha y tipo de listado (PAX o CREW)
RECLOC	Código de reserva
-UPID	Número identificador de Pasajero (Unique Passenger ID)
OFF	Aeropuerto de destino del pasajero dentro del mismo vuelo
SURNAME/FIRST	Apellido y primer nombre
(/MIDDLE)	Segundo nombre
DEL	Indicador de máscara eliminada (se marca con asterisco)

Desde este listado, agregando al comando el código de PNR (RECLOC) y el identificador de tripulante dentro del PNR (UPID) es posible visualizar los diferentes datos que se hayan incluido en la máscara en los diferentes momentos. El comando es:

PAHC(vuelo)/(fecha)(origen)/(recloc)-(upid)

Ejemplo:

PAHC4340/10AUGAEP/CREW01-1

Respuesta:

API / XX4340/10AUGAEP / CREW
      RECLOC-UPID  OFF SURNAME/FIRST (/MIDDLE)                       T CHK  DHS  DOB     POB G NAT RES ID-NUMBER               EXPIR   ISSUE   I/C I/P                   CREW FN / LICENCE
DEL - CREW01-   1  MDQ CREW/ONE                                                  01DEC80 COL M COL COL P  202020               20JAN20 20JAN10 COL                       / 
                         TICKET NUMBER/CPN:
                       KIUHELPLL/10AUG16/1554Z
MOD - CREW01-   1  MDQ CREW/ONE                                                  01DEC80 COL M COL COL P  202020               20JAN20 20JAN10 COL                       / 
                         TICKET NUMBER/CPN:
                       KIUHELPLL/10AUG16/1554Z
ADD - CREW01-   1  MDQ CREW/ONE                                                  01DEC79 ARG F ARG ARG P  10101010             20DEC20 20DEC10 ARG                       / 
                         TICKET NUMBER/CPN:
                       KIUHELPLL/10AUG16/1552Z

Descripción:

API / XX4340/10AUGAEP / CREW	Título del listado API indicando vuelo, fecha y tipo de listado (PAX o CREW)
RECLOC	Código de reserva
-UPID	Número identificador de Pasajero (Unique Passenger ID)
OFF	Aeropuerto de destino del pasajero dentro del mismo vuelo
MOD	Acción tomada (ADD: Creación, MOD: Modifiación, DEL: Eliminación)
TICKET NUMBER/CPN	Número de Ticket y cupón afectado (N/A)
KIUHELPLL	ID del agente que tomó la acción
10AUG16/1554Z	Fecha y hora UTC en se realizó la acción

Consideraciones

Se incluirá la información de datos APIS del tripulante específicamente seleccionado a través del código de reserva y UPID
Se indicará el momento de creación de la máscara con ADD, si se modifica con MOD, y la eliminación de la máscar acon DEL
Se incluirán todos los datos de la máscara tal como se guardó en el momento de tomar la acción
Se deberán comparar los registros para detectar las modificaciones efectuadas
Después del cierre del vuelo (PD) se podrá seguir visualizando la historia completa con el comando PAHP sin posibilidad de filtrar por pasajero, es decir, con PAHP se mostrarán todos los registros históricos de todos los pasajeros que tuvieron al menos una máscara de APIS cargada

Back to top

Enviar mensaje PAXLST con datos API de tripulación (PALC-SEND)

Para generar el envío del mensaje PAXLST por mensajería tipo B (direcciones TTY desde y hacia configuradas en la tabla JJAPI) se deberá utilizar el mismo comando del listado (PALC) agregando el indicador -SEND al final. Se requiere duty 5 y keyword CHKLV1.

El comando es el siguiente:

PALC(vuelo)/(fecha)(origen)(destino)-SEND

Ejemplo:

 PALC17/29APRAEPMVD-SEND

Descripción:

PA	Indicador de API
L	Indicador de Lista
C	Identificador (P: PAX o C: CREW)
17	Número de vuelo
/	Barra separadora
29APR	Fecha de vuelo (Formato DDMMM)
AEP	Aeropuerto de origen
MVD	Aeropuerto de destino (Condicional en vuelos multileg)
-SEND	Indicador para generar el envío del mensaje PAXLST

Respuesta:

PAXLST MESSAGE WILL BE SENT - PLEASE CONFIRM
PALC17/29APRAEPMVD-SEND/Y

Para finalizar la generación del mensaje PAXLST se deberá confirmar el comando con /Y al final.

La respuesta luego de la confirmación será DONE y el mensaje será enviado.

Es posible utilizar el comando PALC-SEND sin indicar los datos del vuelo si el agente se encuentra ya trabajando en el check-in de un vuelo y los datos del mismo se encuentran activos en el área de trabajo.

Recordamos que el envío del mensaje es responsabilidad del agente o supervisor a cargo. Asimismo, una vez cerrado el vuelo en el check-in (PD), no será posible generar el mensaje PAXLST ni recuperar el listado de datos API.

Los mensajes PAXLST pueden enviarse más de una vez por cada vuelo siempre y cuando no se haya realizado el cierre del mismo en el check-in (PD). Las consecuencias y/o repercusiones de enviar el mensaje al destinatario más de una vez deberán ser verificadas y manejadas por la línea aérea con cada ente receptor.

Back to top

Enviar mensaje PAXLST con datos APIS de tripulación en vuelos multi-leg

Al momento de generar los mensajes PAXLST en vuelos multi-leg se deberá incluir en el comando de ingreso de datos y de generación de mensaje los aeropuertos de origen y destino correspondientes según las siguientes consideraciones:

Carga de datos

PA/PABC/PACC con origen

Guarda los datos con el origen indicado y el primer destino del vuelo desde dicho origen

PA/PABC/PACC con origen y destino

Guarda los datos con el origen y el destino indicados en el comando

Ejemplo:
Vuelo 1234 con ruta AAA-BBB-CCC-DDD

PA1234/04APRAAA/CREW01 guarda datos con ruta AAA-BBB
PABC1234/04APRBBB/CREW02 guarda datos con ruta BBB-CCC
PACC1234/04APRAAACCC/CREW03 guarda datos con ruta AAA-CCC
PA1234/04APRBBBDDD/CREW04 guarda datos con ruta BBB-DDD
Etc.

Generación de mensaje

PALC con origen

Genera el mensaje PAXLST con los PAX que tienen el origen indicado y el primer destino desde dicho origen

PALC con origen y destino

Genera el menaje PAXLST con los PAX que tiene el origen y el destino indicados en el comando

 PALC17/29APRAEPCOR-SEND

Ejemplo:
Vuelo 1234 con ruta AAA-BBB-CCC-DDD

PALC1234/04APRAAA-SEND incluye PAX con ruta AAA-BBB
PALC1234/04APRBBB-SEND incluye PAX con ruta BBB-CCC
PALC1234/04APRAAACCC-SEND incluye PAX con ruta AAA-CCC
PALC1234/04APRBBBDDD-SEND incluye PAX con ruta BBB-DDD
Etc.

Back to top

Enviar mensaje PAXLST con datos APIS de tripulación por mail

Agregando la dirección de correo directamente después del indicador -SEND se enviará el mensaje PAXLST al correo electrónico indicado.

El comando es el siguiente:

PALC(vuelo)/(fecha)(origen)-SEND(correo)

Ejemplo:

 PALC17/29APRAEP-SENDMAIL@MAIL.COM

Para finalizar la generación del mensaje PAXLST se deberá confirmar el comando con /Y al final.

La respuesta luego de la confirmación será DONE y el mensaje será enviado.

Back to top

Extracción de datos APIS de triuplación en archivo CSV

Con el indicador -FILE seguido del código de dos letras del país que requiere los datos se podrá generar un archivo CSV con las columnas y datos solicitados por las autoridades correspondientes.

El comando es el siguiente:

PALC(vuelo)/(fecha)(origen)(destino>-FILE(país)

Ejemplo:

PALC4350/18JUNAEPNQN-FILEEC

Respuesta:

PAXLST MESSAGE WILL BE SENT - PLEASE CONFIRM
PALC4350/18JUNAEPNQN-FILEEC/Y

Para finalizar la generación del archvio Excel se deberá confirmar el comando con /Y al final.

La respuesta luego de la confirmación será el link al archivo generado

PALC4350/18JUNAEPNQN-FILEEC/Y
DONE - FILE C:\RESERVAS\MYFILES\PALC_XX_4350_18JUN_AEPNQN.CSV

Los archivos podrán extraerse más de una vez por cada vuelo siempre y cuando no se haya realizado el cierre del mismo en el check-in (PD).

El cierre del vuelo (PD) se podrá ejecutar siempre y cuando se hayan generado los archivos para pasajeros y para tripulación.

Back to top

KIU Documentación Online

API_Datos API para tripulación (Crew)

Ingresar datos API para tripulación (PA/PABC/PACC)

Tipo de datos API

Identificador

Códigos de país

Género

Tipos de documento (D. TYPE – Document Type)

Tipo de triuplante

Editar datos API ingresados para tripulación

Eliminar datos API ingresados para tripulación

Listado de datos API de tripulación (PALC)

Datos del agente

Historia de datos APIS de tripulación (PAHC)

Enviar mensaje PAXLST con datos API de tripulación (PALC-SEND)

Enviar mensaje PAXLST con datos APIS de tripulación en vuelos multi-leg

Enviar mensaje PAXLST con datos APIS de tripulación por mail

Extracción de datos APIS de triuplación en archivo CSV

Países con archivos

Ecuador	PALC<vuelo>/<fecha><origen>(<destino>)-FILEEC	PALC_XX_600_19JUN_AEPNQN.CSV