Pular para o conteúdo

Error Codes

Todos os erros da API seguem esta forma:

{
"eventId": "...",
"error": {
"code": "<numeric code>",
"type": <error type>,
"message": "<human-readable description>"
}
}
Type Descrição
SYSTEM Erro interno do sistema
VALIDATION Erro de validação de entrada
APPLICATION Erro de lógica de negócio
SECURITY Erro de autenticação / permissão
Code Significado
UNKNOW_INTERNAL Erro interno desconhecido
UNAVAILABLE_SERVICE Serviço não disponível
TIME_OUT A resolução da requisição expirou
INVALID_FORMAT Formato de dados inválido
INVALID_DATA Valor inválido no conteúdo de dados
UNAUTHORIZED Sem acesso à aplicação
FORBIDDEN Privilégios insuficientes
INVALID_TOKEN Token inválido ou expirado
NOT_FOUND O recurso solicitado não existe
SOLD_OUT Produto não mais disponível
PRICE_MISMATCH A tarifa mudou
PAYMENT_PROCESS Erro no processamento do pagamento
NOT_PAYABLE Não é possível pagar com as informações fornecidas
INVALID_BOOKING Requisição de reserva inválida
CANCELLED Reserva cancelada
LIMIT_EXEEDED Requisições em excesso

Code HTTP Mensagem Causa / Solução
900 401 The authorization header is invalid Falta o prefixo Bearer
902 401 The authorization token is invalid Token corrompido ou assinado por outro tenant
903 401 The authorization token has expired Gere um novo token
1001 401 No authorization token provided Falta o header Authorization
1003 401 The channel id <X> is not enabled to be used in <env> Channel não provisionado neste ambiente — escale à PT. É retornado depois do token, não pelo token.
Code HTTP Mensagem Causa / Solução
1003 400 invalid_client Credenciais rejeitadas — id, secret ou credenciais inativas. A resposta não distingue. Ver Autenticação.
1004 400 invalid_client_id_for_env_<env> Usar credenciais de outro ambiente
1005 400 invalid_client_secret Secret incorreto — verifique a rotação
Code HTTP Mensagem Causa / Solução
429 429 Request rate limit per minute exceeded Reduza o ritmo das requisições; aumente o atraso
1002 401 agency configuration not Found Configuração de channel/agência pendente — escale
1003 400 Invalid agency templateId Template de agência não configurado
3001 400 CheckIn can not be a past date Use hoje ou data futura
3002 400 CheckOut can not be earlier or equal to CheckIn Corrija as datas
3003 400 Can’t quote more than 28 days Divida em várias consultas
3004 400 All rooms must contain at least one adult (18+) Adicione um adulto ao critério de quarto
4001 500 Invalid Channel Id on Rate Limiter Interno — escale com eventId
5001 500 Miss-match of channel Id Divergência de channel — escale
Code HTTP Mensagem Causa / Solução
1002 401 agency configuration not Found Configuração de channel/agência pendente
1003 400 Invalid agency templateId Template de agência não configurado
4001 400 The RateKey must be valid rateKey expirado, corrompido ou vazio
4002 400 More hotels than expected O rateKey contém vários hotéis — inválido aqui
4003 400 You don’t have enough credit Crédito/saldo de linha do channel esgotado
4004 400 RateKey older than 60 minutes Busque novamente via /hotels/rates
4005 200 No results Tarifa não mais disponível — esgotada
4006 200 <provider message> (p. ex. “not allotment for the rate”) Erro específico do fornecedor — busque novamente
5001 500 Miss-match of channel Id Interno — escale
5007 401 Mismatch of channel id. Channel id from previous step: <X> O rateKey foi gerado com as credenciais de outro channel. Execute todo o fluxo, a partir do HotelRates, com as mesmas credenciais.
Code HTTP Mensagem Causa / Solução
201 500 Invalid booking id / reservation number. Only numbers are allowed bookingId deve ser numérico
1101 400 The provided key has already been used previously BookingHold: rateKey reutilizado — obtenha um novo
1101 500 The provided key has already been used previously. BookingNew: bookingKey já utilizado. Não obtenha uma nova chave para reiniciar o fluxo — ver BookingNew
1201 500 The itinerary does not contain valid services Reserva corrompida — escale
1202 500 Locator’s not found for the requested channel Reserva não visível a partir deste channel
3003 500 Cannot get a valid response from the cancellation service Falha do fornecedor — escale
3005 500 Cancellation timeout Tente novamente após 1-2 min, verifique com o BookingGet
4001 400 Invalid Hold Request, can not parse the rateKey rateKey corrompido ou mal codificado
4002 400 You cannot invoke ‘Hold’ without first performing a ‘CheckRates’ Use o rateKey de CheckRates, não de Rates
4003 400 Hold rateKey older than 20 min Repita o CheckRates
4008 400 The requested rate is no longer available. Não definida. A resposta não indica o motivo. Observado em uma resposta. A requisição de Hold foi enviada menos de 20 segundos após um CheckRates bem-sucedido. 4008 e 4009 retornam a mesma mensagem; a diferença entre eles não está definida. Solicite um novo rateKey repetindo o Rates e o CheckRates. Não use o código para distinguir a causa.
4009 400 The requested rate is no longer available. Não definida. A resposta não indica o motivo. Observado em uma resposta. A requisição de Hold foi enviada menos de 20 segundos após um CheckRates bem-sucedido. 4008 e 4009 retornam a mesma mensagem; a diferença entre eles não está definida. Solicite um novo rateKey repetindo o Rates e o CheckRates. Não use o código para distinguir a causa.
5001 500 Invalid Policy Interno — escale
6001 400 Invalid New Request, can not parse the BookingKey bookingKey corrompido/expirado
6002 400 You cannot use the 'New' operation if more than 20 minutes have passed since obtaining the BookingKey from 'Hold'. Não definida. O BookingNew retornou este código com esta mensagem; a condição que o dispara não está definida. Obtenha um novo bookingKey com o BookingHold. Não use o código nem o número na mensagem para distinguir a causa.
6102 400 Invalid range, only 31 days are allowed O BookingReservations retornou este código com esta mensagem. A mensagem indica que o intervalo não é válido e informa um número de dias permitidos; como os dias são contados não está definido. Reduza o intervalo ou divida o período em várias requisições.
7001 400 A valid client data was not provided name, surname ou contactData ausentes/inválidos
7002 400 A valid credit card was not provided O objeto Payment está obsoleto: não o envie
Code HTTP Mensagem Causa / Solução
1001 404 hotel not found hotelId inválido
1002 400 hotelId must be an integer Parâmetro de rota não numérico

Um mesmo código numérico pode significar coisas diferentes conforme a operação que o retornou, portanto o código sozinho não basta para ramificar — leia-o junto com o endpoint que você chamou. A tabela abaixo reúne apenas as variantes verificadas contra capturas; não é a lista completa dos lugares onde esses códigos aparecem na API. Para a variante de token do 1003, a resposta não distingue entre um id incorreto, um secret incorreto e credenciais inativas — ver Autenticação.

Code Operação HTTP Significado nesse contexto
1003 Token 400 invalid_client, sem eventId e sem message — a resposta não indica qual verificação de credenciais falhou
1003 HotelRates 401 The channel id <X> is not enabled to be used in <env> — é retornado pela chamada posterior ao token, não pelo token
1101 BookingNew 500 The provided key has already been used previously. — o bookingKey já foi usado por um BookingNew anterior. Não obtenha uma nova chave para reiniciar o fluxo; ver BookingNew
1203 BookingDelete 400 Your reservation is currently being created. Please wait a moment before accessing it.

HTTP Tipo Significado
200 Success OK (nota: 4005/4006 também retornam 200)
301 Redirect A URL está incorreta — verifique a barra final
400 Client error Dados ou estrutura inválidos
401 Auth Token ausente/inválido
403 Forbidden Sem acesso ao recurso
404 Not found O recurso não existe
406 Not acceptable Header Accept incorreto
410 Gone Recurso permanentemente indisponível
415 Unsupported media Content-Type incorreto
429 Rate limited Requisições em excesso
500 Server Erro interno da API
502 Bad gateway Erro do fornecedor upstream
503 Unavailable API temporariamente fora do ar
504 Gateway timeout Timeout do upstream
513 App error Erro dos serviços internos
596 Not found O endpoint não existe

Quando você vir um erro, pergunte-se:

  1. Qual é o status HTTP? (filtra a categoria)
  2. Qual é o error.code? (especifica a causa dentro da categoria)
  3. Qual endpoint? (alguns códigos mudam de significado por endpoint, p. ex. 4001)
  4. Qual é o eventId? (inclua sempre ao escalar à PT)
  5. As janelas de tempo estão sendo respeitadas? (60 min / 20 min / 5 min / 90 s)

Na dúvida, escale com: endpoint, requisição completa, resposta completa, eventId e timestamp.

Para um resultado incerto do BookingNew sem bookingId, inclua clientReference, o timestamp da tentativa em UTC e eventId, se disponível.