El contenido de esta pagina ha sido extraído en su totalidad de Enviar acumulación de millas | Desenvolvedores | LATAM Pass.

Enviar acumulación de millas

POST

El siguiente ejemplo contiene los campos mínimos obligatorios para realizar una acumulación de puntos. Consulte el siguiente enlace para obtener detalles completos de la interfaz: Swagger Crear Acumulación POST.

A continuación se muestra un ejemplo de CURL:

curl
--location 'https://api.latampass.com/sandbox/v1/customer/loyalty/partner/accrual' \\
--header 'client\_id: xxxxx' \\
--header 'access\_token: xxxxx' \\
--header 'Content-Type: application/json' \\
--data-raw '{
    "accrual": {
        "partner": {
            "id": "02012862000160"
        },
        "member": {
            "ffn": "93558173040",
            "email": "Bridie26@yahoo.com"
        },
        "partnerAccrualId": "1db32086-d5ab-448c-b532-1f9e6d1328a0",
        "partnerTransactionId": "39b347d9-aafb-44af-8293-83bb45562c2b",
        "partnerOriginDate": "2023-07-26T21:15:53.547Z",
        "description": "Explicabo sit est quos qui expedita.",
        "points": 6000,
        "productId": "001"
    },
    "interfaceId": 3
}'

Explicación funcional de cada campo

• partner.id → ID de registro del socio en el sistema de Latam Pass. Este contenido es proporcionado por el equipo comercial de Latam Pass.
• member.ffn → Frequent Flyer Number o número de pasajero frecuente. En BR, es el mismo del CPF. En CL, es el mismo del RUT.
• member.email → correo electrónico del socio
• partnerAccrualId → ID sistémico del socio. Puede enviar un ID de control interno. Límite 50 caracteres.
• partnerTransactionId → ID utilizado para facturación. Este dato es clave para la conciliación financiera y puede ser el mismo ID enviado en el campo partnerAccrualId. Lo más importante es que el socio tenga control de este campo para realizar la conciliación financiera cuando Latam Pass genere la factura para el pago. Límite 50 caracteres.
• partnerOriginDate → fecha y hora de solicitud de acumulación en el sistema del partner, que corresponde a la fecha y hora de la actividad del socio con el partner.
• description → campo libre. Sugerencia de envío: Acumulación de puntos del producto XYZ.
• points → cantidad de puntos a acumular.
• productId → ID de registro del producto vinculado a partner.id. Este contenido es proporcionado por el equipo comercial de Latam Pass.
• interfaceId → fijo 3.

En caso de éxito, recibirá el siguiente retorno JSON.

{
    "correlationId": "1ad7b022-47b7-4ca4-8220-432a0b258173",
    "id": 32,
    "partnerAccrualId": "6d3e64ea-e616-474c-8a4c-37fde027bdff",
    "partnerTransactionId": "50e24c15-3782-4963-acca-af58f330df2b",
    "receivedAt": "2022-06-30 16:19:06.835-0300"
}

Siempre utilizamos el ID y el correlationId para analizar todo el flujo de acumulación. Es importante guardar el ID devuelto arriba ya que es un comprobante de aceptación de LatamPass.

Regla de duplicidad

Las acumulaciones contienen datos mandatorios. Se usan algunos de ellos para validar duplicidad.

A continuación se encuentra el set de datos usados en ese proceso:

• ffn
• partner_id
• partner_transaction_id
• partner_origin_date
• points

En el caso que se encuentre una transacción con los mismos datos, se la contestará como duplicada. De no ser así, el flujo sigue para procesamiento.

Se refuerza esa regla, pues si uno de los datos se envía distinto, se considerará una nueva transacción.

Envío de fechas

Las acumulaciones se acreditan utilizando la fecha enviada por el socio y se utiliza como parámetro para cualquier acción que dependa de fechas. Por ejemplo: si tenemos una campaña para bonificar puntos, la fecha para validar si es elegible para el bono es la fecha recibida por el socio (fecha original de la solicitud de acumulación).

En este sentido, solicitamos que se envíen las fechas de la siguiente manera:

El envío de fechas debe hacerse en el formato ISO-8601, ya que de esta manera podemos preservar la zona horaria.

FORMATO CORRECTO DE ENVÍO

Con zona horaria: '1997-07-16T19:20:30-03:00'

Este punto no impide la acumulación, por lo tanto, si la fecha se envía sin la zona horaria, seguiremos las reglas internas de conversión.

Collection Postman

El siguiente enlace contiene el proyecto Postman para pruebas en Sandbox.

Acumulación PNA - Postman