Introdução

A API PNA Accrual LATAM Pass é a forma pela qual os nossos parceiros fazem a gestão do acúmulo não aéreo que é entregue aos clientes LATAM Pass correspondente ao acordo comercial entre as partes.

Os clientes LATAM Pass interagem com os nossos parceiros, por exemplo, comprando os seus produtos ou contratando os seus serviços e, esgotado o prazo em que essa interação pode ser desfeita total ou parcialmente (por exemplo, devolvendo um produto comprado ou não tomando um serviço contratado), realizam a solicitação de acúmulo. Esse prazo deve ser respeitado por não se cancelar um acúmulo já concedido.

Para poder realizar requisições à API, deve-se primeiro obter o token de acesso. Consulte a documentação Autenticação para todas as informações.

Solicitar acúmulo

Cronograma base

Acesse por meio dos itens abaixo o cronograma base de cada tipo de parceria do programa:

Requisição

Há três possibilidades de solicitar um acúmulo:

Apenas por código de identificação do cliente LATAM Pass ou Frequent Flyer Number (ffn);
Apenas por dados do documento de identificação (document);
Por ffn e document.

No último caso, se não for encontrado um cliente LATAM Pass com o ffn informado, os dados informados em document serão considerados na solicitação de acúmulo.

Cabeçalho

client_id: valor obtido a partir do menu Dev Tools > Minhas Apps > Client ID e obrigatório em todas as requisições
access_token: token de acesso obtido anteriormente
x-latam-test: fixo LatamPass, a ser utilizado apenas em ambiente de teste, ou seja, não deve ser utilizado em ambiente de produção

Resposta

A resposta, para todos os efeitos, é considerada uma indicação de ciência de que a API:

Recebeu a solicitação de acúmulo;
Começou o seu processamento, que é assíncrono; e
Entregou dados necessários para a Notificação do acúmulo ou para o parceiro Consultar acúmulo.

Portanto, não é recomendado que a experiência do cliente seja tal que ele permaneça esperando o resultado da sua solicitação de acúmulo enquanto o mesmo é processado, mas que de posse dos dados entregues, o parceiro informe ao cliente que a sua solicitação foi submetida com sucesso, dando-lhe outra oportunidade de ser atualizado da informação quando, então, terminar o processamento de sua solicitação.

Com base nas transações recebidas entre 01Jan24 e 10Mai24, 88% são processadas em até 6", sendo quase ¾ delas, em até 4" e quase metade, em até 3".

Erros mais comuns

httpStatus 5xx Erro no Servidor

Se a resposta da solicitação de acúmulo for acompanhada de um Erro no Servidor, ou seja, de um httpStatus 5xx, o mesmo acúmulo deve ser novamente solicitado, quer dizer, com os mesmos dados da solicitação anterior.

Não há necessidade de antes consultá-lo e tão pouco o mesmo será notificado, haja vista que a solicitação nesta condição não foi sequer registrada pela API PNA Accrual LATAM Pass.

Campos obrigatórios ausentes ou 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` ou algum outro 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"
}

Documentação técnica

Clique aqui para acessá-la.

Solicitar acúmulo (v2)