Introducción

La API PNA Accrual LATAM Pass es la forma por la cual nuestras alianzas gestionan la acumulación no aérea que se entrega a los socios LATAM Pass correspondiente al acuerdo comercial entre las partes.

Los socios LATAM Pass interactúan con nuestras alianzas, por ejemplo, comprando sus productos o contratando sus servicios y, después de la fecha límite en la que esta interacción puede deshacerse total o parcialmente (por ejemplo, devolviendo un producto comprado o no tomando un servicio contratado), realizan la solicitud de acumulación. Este plazo deberá respetarse por no cancelarse una acumulación ya concedida.

Para poder realizar peticiones a la API, primero se debe obtener el token de acceso. Consulte la documentación Autenticación para obtener toda la información.

Carta Gantt base

Accede a la carta Gantt base para cada tipo de alianza con el programa utilizando los siguientes enlaces:

1. Nuevas alianzas;
2. Alianzas vigentes que migran a la API PNA LATAM Pass.

Petición

Hay tres posibilidades para solicitar una acumulación:

1. Únicamente mediante el código de identificación del socio LATAM Pass o Frequent Flyer Number (ffn);
2. Únicamente mediante los datos del documento de identificación (document);
3. Por ffn y document.

En este último caso, si no se encuentra un socio LATAM Pass con el ffn proporcionado, se considerarán los datos del document para procesar la solicitud de acumulación.

Encabezado

• client_id: valor obtenido desde el menú Dev Tools > Mis Apps > Client ID, obligatorio en todas las peticiones.
• access_token: token de acceso obtenido previamente.
• x-latam-test: valor fijo LatamPass, para usarse solo en el entorno de pruebas, es decir, no debe usarse en el entorno de producción.

Respuesta

La respuesta, para todos los efectos, se considera una indicación de ciencia de que la API:

1. Recibió la petición de acumulación;
2. Empezó su procesamiento, que es asíncrono; y
3. Entregó los datos necesarios para la Notificación de acumulación o para la alianza Consultar acumulación.

Por lo tanto, no se recomienda que la experiencia del socio sea tal que permanezca esperando el resultado de su solicitud de acumulación mientras se procesa, sino que, en posesión de los datos entregados, la alianza informe al socio que su solicitud ha sido enviada con éxito, brindándole otra oportunidad de recibir información actualizada cuando su solicitud termine de procesarse.

Según las transacciones recibidas entre el 1 de enero de 2024 y el 10 de mayo de 2024, un 88% se procesa dentro de 6", con casi ¾ de ellas dentro de 4" y casi la mitad dentro de 3".

Errores más comunes

httpStatus 5xx Error de Servidor

Si la respuesta a la solicitud de acumulación viene acompañada de un Error de Servidor, o sea, un httpStatus 5xx, se deberá solicitar nuevamente la misma acumulación, es decir, con los mismos datos que la solicitud anterior.

No es necesario consultarlo previamente y no será notificado, ya que la solicitud en esta condición ni siquiera fue registrada por la API PNA Accrual LATAM Pass.

Campos obligatorios ausentes o valores inválidos

{
  "message": "Request payload has problems with validation",
  "code": 99,
  "instructions": null,
  "details": {
    "nonAirAccrual.partner": "must not be null",
    "nonAirAccrual.quantity": "must not be null"
  },
  "issueDateTime": "2024-11-27T21:19:15.282436798Z"
}

correlationId o algún otro campo único enviado duplicado

{
  "correlationId": "24697ee0-2719-4f81-becf-34b3568c43a7",
  "httpStatus": "BAD_REQUEST",
  "code": 8,
  "instructions": "Verify if one or more unique fields were sent twice.",
  "issueDateTime": "2024-11-27T21:21:26.315632490Z"
}

Documentación técnica

Haz clic aquí para acceder.