Introducción

La API PNA Member LATAM Pass es la forma por la cual nuestras alianzas pueden acceder a los datos de nuestros socios LATAM Pass de acuerdo con las Leyes de Protección de Datos Personales de los países en los que operamos y habiendo sido considerados esenciales para el correcto funcionamiento de la alianza.

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.

Petición

Hay tres posibilidades para buscar un socio:

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

Encabezado

  • client_id: valor obtenido del menú Dev Tools > Mis Apps > Client ID y obligatorio en todas las peticiones
  • access_token: token de acceso obtenido previamente
  • x-scope: lista de scopes separados por coma (,)
  • x-latam-test: fijo LatamPass, para usarse solo en el entorno de prueba, es decir, no debe usarse en el entorno de producción

Scopes

Los datos del socio serán devueltos si, y sólo si, son esenciales para el correcto funcionamiento de la alianza. Si se consideran personales o confidenciales, deben contar con el consentimiento del socio y estar respaldados por contrato y/o términos y condiciones del programa o alianza, que serán definidos por Data Protect.

  • Genéricos:
    • member-balance: saldo en cuenta de millas canjeables
    • member-coalition: coalición de programa
    • member-enrollment: fecha de inscripción en el programa
    • member-language: idioma(s) del socio
    • member-segment: segmento(s) vinculado(s) a la cuenta
    • member-status: estado de la cuenta
    • member-tier: categoría en el programa y su duración
  • Personal o sensible:
    • member-address: dirección(es) del socio, residencia y/o negocio
    • member-birthdate: fecha de nacimiento del socio
    • member-document: documento(s) vinculado(s) a la cuenta
    • member-email: dirección(es) de correo electrónico vinculada(s) a la cuenta
    • member-gender: género del socio
    • member-marital: estado civil del socio
    • member-name: nombres del socio
    • member-nationality: nacionalidad del socio
    • member-phone: número(s) de teléfono del socio, fijo y/o móvil

Respuesta

Errores más comunes

Scopes no válidos o no definidos para el cliente

{
  "error": {
    "code": "INVALID_SCOPE",
    "message": "Invalid scopes [member-xx], The provided scope is not allowed.",
    "instructions": "Contact Latam team, to get allowed scopes."
  }
}

No se encontró ningún socio con los datos proporcionados

"error": {
   "code": "MEMBER_NOT_EXISTS",
   "message": "MemberDoesNotExist: Member does not exist.",
   "instructions": "Try with other FFN",
   "issuedDateTime": "2024-10-21T18:38:00.101662Z",
   "details": null
}

Campos obligatorios ausentes o valores inválidos

"error": {
    "code": "METHOD_ARGUMENT_NOT_VALID",
    "message": "MethodArgumentNotValid: Invalid request for one or more fields",
    "instructions": "Please see the details and retry the request",
    "issuedDateTime": "2024-10-21T18:55:08.950649Z",
    "details": {
        "member.ffn": "must not be null"
    }
}

Documentación técnica

Haga clic aquí para acceder.