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 según el acuerdo comercial entre las partes.

Después de Solicitar acumulación, las alianzas realizan la consulta de acumulación para obtener el estado de su procesamiento, ya que es asíncrono.

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

Consultar Acumulación

Carta Gantt base

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

Petición

Para consultar la acumulación, debe utilizar la identificación de la alianza (partnerIdentifier). Además, puede utilizar uno de los siguientes filtros, todos parte de la solicitud de acumulación:

Código de identificación del correlativo indicado por la alianza o, en caso de no indicarlo, generado por LATAM Pas para fines de trazabilidad (correlationId)
Código de identificación de transacción del lado de la alianza (partnerTransactionId)
Código de identificación de transacción del lado de la alianza para fines de conciliación de facturación (partnerAccrualId)

Directriz

La siguiente directriz debe seguirse, considerándola como tiempos mínimos, al enviar solicitudes para consultar la acumulación (el 'Estado final' se calculó en base a las transacciones recibidas entre el 1 de enero de 2024 y el 10 de mayo de 2024):

Intento	Después de la solicitud	Después de la última consulta	Estado final (~)
1º	15"	-	93,0%
2º	30"	15"	93,5%
3º	60"	30"	94,0%
4+	-	60"	100,0%

Encabezado

client_id: valor obtenido del menú API Tools > Mis Apps > Client ID y obligatorio en todas las solicitudes
access_token: token de acceso obtenido previamente
x-latam-test: fijo LatamPass, para ser utilizado solo en el ambiente de prueba, es decir, no debe utilizarse en el ambiente de producción

Respuesta

Los siguientes estados son parte de la respuesta de consulta de acumulación:

Estados:
- Intermedio (definido tan pronto como la transacción es recibida de la alianza):
  - PROCESSING: solicitud en procesamiento.
- Finales (definidos cuando se completa el procesamiento de la transacción):
  - CANCELLED: solicitud rechazada. La acumulación solicitada no se acreditó en la cuenta del socio para la composición de su saldo. Este es el único estado a considerar para la reversión de la transacción del lado de la alianza;
  - PROCESSED: acumulación concedida. La acumulación solicitada se acreditó en la cuenta del socio para la composición de su saldo y será parte del próximo archivo de facturación.

Motivos para rechazar una solicitud

Razón	Código	Mensaje	Instrucciones para alianzas
La fecha de la actividad con la alianza, en el momento de solicitar la acumulación, era futura. (`partnerOriginalDateTime`)	101	ActivityDateGreater ThanCurrentDate	Validate your request because some date is greater than current date
Código de identificación de la alianza no registrado. (`partnerId`)	108	PartnerDoesNotExist	Partner doesn't exist. Please contact our LATAM team to set up the necessary configurations.
Código de identificación del producto no registrado o no vinculado a la alianza o vencido al momento de solicitar la acumulación. (`productId`)	110	IACOD	Accrual code is expired or invalid
Programa no válido para el país de residencia del socio. (`ffn`)	111	CCIE - Invalid country of residence	Invalid program. Please contact our LATAM team to set up the necessary configurations.
Socio no encontrado con los datos informados (`ffn`,`document`), pero dirección de correo vinculada a otra cuenta ya existente (`email`).	112	DuplicateMemberProfiles ExistsAsPerAlgorithm	Member: Contact LATAM to update your data
Código de identificación del socio (`ffn`) no es válido para su país de residencia (`residenceCountryCode`).	113	Incorrect CPF format validated by the Core System	Fix the CPF number
Socio con estado de cuenta inválido para acumulación. (`ffn`)	114	Invalid member status	Member: Contact LATAM to update your data
No se pudo procesar la solicitud de acumulación del socio. (`ffn`, `document`)	204	Member already exists	Member: Contact LATAM to update your data
Código de identificación del socio (`ffn`) no es válido para su país de residencia (`residenceCountryCode`).	205	Incorrect CPF format validated by the Core System	Fix the CPF number
No se pudo procesar la solicitud de acumulación del socio. (`ffn`, `document`)	206	Member already exists	Member: Contact LATAM to update your data

Errores más comunes

`partnerIdentifier` no informado

{
  "correlationId": "9630db93-1e20-4736-ad4c-d939635db91f",
  "httpStatus": "BAD_REQUEST",
  "code": 99,
  "instructions": "PartnerIdentifier is Null or Empty",
  "issueDateTime": "2024-11-27T21:05:16.260318404Z"
}

`correlationId`, `partner_transactionId` ou `partnerAccrualId` no informado

{
    "correlationId": "1334f9f1-cc70-4469-937a-fd46e4df0a62",
    "httpStatus": "BAD_REQUEST",
    "code": 99,
    "message": "Request payload has problems with validation",
    "instructions": "Other filters is null or empty, please provide at least
one filter - partnerAccrualId, partnerTransactionId or correlationId",
    "issueDateTime": "2024-11-27T21:05:16.260318404Z"
}

Solicitud de acumulación no encontrada

{
    "code": 11,
    "message": "No accrual found in this request",
    "instructions": "Verify the provided parameters",
    "issuedDateTime": "2024-10-31T21:41:13.168947164Z",
    "details": null,
}

Documentación técnica

Haga clic aquí para acceder.