Ir al contenido

Error Codes

Todos los errores de la API siguen esta forma:

{
"eventId": "...",
"error": {
"code": "<numeric code>",
"type": <error type>,
"message": "<human-readable description>"
}
}
Type Descripción
SYSTEM Error interno del sistema
VALIDATION Error de validación de entrada
APPLICATION Error de lógica de negocio
SECURITY Error de autenticación / permisos
Code Significado
UNKNOW_INTERNAL Error interno desconocido
UNAVAILABLE_SERVICE Servicio no disponible
TIME_OUT La resolución de la petición expiró
INVALID_FORMAT Formato de datos inválido
INVALID_DATA Valor inválido en el contenido de datos
UNAUTHORIZED Sin acceso a la aplicación
FORBIDDEN Privilegios insuficientes
INVALID_TOKEN Token inválido o expirado
NOT_FOUND El recurso solicitado no existe
SOLD_OUT Producto ya no disponible
PRICE_MISMATCH La tarifa cambió
PAYMENT_PROCESS Error en el procesamiento del pago
NOT_PAYABLE No se puede pagar con la información proporcionada
INVALID_BOOKING Petición de reserva inválida
CANCELLED Reserva cancelada
LIMIT_EXEEDED Demasiadas peticiones

Code HTTP Mensaje Causa / Solución
900 401 The authorization header is invalid Falta el prefijo Bearer
902 401 The authorization token is invalid Token corrupto o firmado por otro tenant
903 401 The authorization token has expired Genera un token nuevo
1001 401 No authorization token provided Falta el header Authorization
1003 401 The channel id <X> is not enabled to be used in <env> Channel no provisionado en este entorno — escala a PT. Se devuelve después del token, no por el token.
Code HTTP Mensaje Causa / Solución
1003 400 invalid_client Credenciales rechazadas — id, secret o credenciales inactivas. La respuesta no distingue. Ver Autenticación.
1004 400 invalid_client_id_for_env_<env> Usar credenciales de otro entorno
1005 400 invalid_client_secret Secret incorrecto — verifica la rotación
Code HTTP Mensaje Causa / Solución
429 429 Request rate limit per minute exceeded Reduce el ritmo de peticiones; aumenta el retardo
1002 401 agency configuration not Found Configuración de channel/agencia pendiente — escala
1003 400 Invalid agency templateId Template de agencia no configurado
3001 400 CheckIn can not be a past date Usa la fecha de hoy o futura
3002 400 CheckOut can not be earlier or equal to CheckIn Corrige las fechas
3003 400 Can’t quote more than 28 days Divide en múltiples consultas
3004 400 All rooms must contain at least one adult (18+) Agrega un adulto al criterio de habitación
4001 500 Invalid Channel Id on Rate Limiter Interno — escala con eventId
5001 500 Miss-match of channel Id Discrepancia de channel — escala
Code HTTP Mensaje Causa / Solución
1002 401 agency configuration not Found Configuración de channel/agencia pendiente
1003 400 Invalid agency templateId Template de agencia no configurado
4001 400 The RateKey must be valid rateKey expirado, corrupto o vacío
4002 400 More hotels than expected El rateKey contiene múltiples hoteles — inválido aquí
4003 400 You don’t have enough credit Crédito/saldo de línea del channel agotado
4004 400 RateKey older than 60 minutes Vuelve a buscar vía /hotels/rates
4005 200 No results Tarifa ya no disponible — agotada
4006 200 <provider message> (p. ej. “not allotment for the rate”) Error específico del proveedor — vuelve a buscar
5001 500 Miss-match of channel Id Interno — escala
5007 401 Mismatch of channel id. Channel id from previous step: <X> El rateKey se generó con las credenciales de otro channel. Ejecuta todo el flujo, desde HotelRates, con las mismas credenciales.
Code HTTP Mensaje Causa / Solución
201 500 Invalid booking id / reservation number. Only numbers are allowed bookingId debe ser numérico
1101 400 The provided key has already been used previously BookingHold: rateKey reutilizado — obtén uno nuevo
1101 500 The provided key has already been used previously. BookingNew: bookingKey ya utilizado. No obtengas una clave nueva para reiniciar el flujo — ver BookingNew
1201 500 The itinerary does not contain valid services Reserva corrupta — escala
1202 500 Locator’s not found for the requested channel Reserva no visible desde este channel
3003 500 Cannot get a valid response from the cancellation service Fallo del proveedor — escala
3005 500 Cancellation timeout Reintenta tras 1-2 min, verifica con BookingGet
4001 400 Invalid Hold Request, can not parse the rateKey rateKey corrupto o mal codificado
4002 400 You cannot invoke ‘Hold’ without first performing a ‘CheckRates’ Usa el rateKey de CheckRates, no de Rates
4003 400 Hold rateKey older than 20 min Repite CheckRates
4008 400 The requested rate is no longer available. No definida. La respuesta no indica el motivo. Observado en una respuesta. La petición de Hold se envió menos de 20 segundos después de un CheckRates exitoso. 4008 y 4009 devuelven el mismo mensaje; la diferencia entre ellos no está definida. Solicita un rateKey nuevo repitiendo Rates y CheckRates. No uses el código para distinguir la causa.
4009 400 The requested rate is no longer available. No definida. La respuesta no indica el motivo. Observado en una respuesta. La petición de Hold se envió menos de 20 segundos después de un CheckRates exitoso. 4008 y 4009 devuelven el mismo mensaje; la diferencia entre ellos no está definida. Solicita un rateKey nuevo repitiendo Rates y CheckRates. No uses el código para distinguir la causa.
5001 500 Invalid Policy Interno — escala
6001 400 Invalid New Request, can not parse the BookingKey bookingKey corrupto/expirado
6002 400 You cannot use the 'New' operation if more than 20 minutes have passed since obtaining the BookingKey from 'Hold'. No definida. BookingNew devolvió este código con este mensaje; la condición que lo dispara no está definida. Obtén un bookingKey nuevo con BookingHold. No uses el código ni el número del mensaje para distinguir la causa.
6102 400 Invalid range, only 31 days are allowed BookingReservations devolvió este código con este mensaje. El mensaje indica que el rango no es válido y da un número de días permitidos; cómo se cuentan los días no está definido. Reduce el rango o divide el periodo en varias peticiones.
7001 400 A valid client data was not provided name, surname o contactData faltantes/inválidos
7002 400 A valid credit card was not provided El objeto Payment está deprecado: no lo envíes
Code HTTP Mensaje Causa / Solución
1001 404 hotel not found hotelId inválido
1002 400 hotelId must be an integer Parámetro de ruta no numérico

Un mismo código numérico puede significar cosas distintas según la operación que lo devolvió, así que el código por sí solo no basta para ramificar — léelo junto con el endpoint que llamaste. La tabla siguiente recoge solo las variantes verificadas contra capturas; no es la lista completa de lugares donde estos códigos aparecen en la API. Para la variante de token del 1003, la respuesta no distingue entre un id incorrecto, un secret incorrecto y credenciales inactivas — ver Autenticación.

Code Operación HTTP Significado en ese contexto
1003 Token 400 invalid_client, sin eventId y sin message — la respuesta no indica qué comprobación de credenciales falló
1003 HotelRates 401 The channel id <X> is not enabled to be used in <env> — lo devuelve la llamada posterior al token, no el token
1101 BookingNew 500 The provided key has already been used previously. — el bookingKey ya fue usado por un BookingNew anterior. No obtengas una clave nueva para reiniciar el flujo; 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 también devuelven 200)
301 Redirect La URL es incorrecta — revisa el slash final
400 Client error Datos o estructura inválidos
401 Auth Token faltante/inválido
403 Forbidden Sin acceso al recurso
404 Not found El recurso no existe
406 Not acceptable Header Accept incorrecto
410 Gone Recurso permanentemente no disponible
415 Unsupported media Content-Type incorrecto
429 Rate limited Demasiadas peticiones
500 Server Error interno de la API
502 Bad gateway Error del proveedor upstream
503 Unavailable API temporalmente caída
504 Gateway timeout Timeout del upstream
513 App error Error de los servicios internos
596 Not found El endpoint no existe

Cuando veas un error, pregúntate:

  1. ¿Cuál es el estado HTTP? (filtra la categoría)
  2. ¿Cuál es el error.code? (especifica la causa dentro de la categoría)
  3. ¿Qué endpoint? (algunos códigos cambian de significado según el endpoint, p. ej. 4001)
  4. ¿Cuál es el eventId? (inclúyelo siempre al escalar a PT)
  5. ¿Se respetan las ventanas de tiempo? (60 min / 20 min / 5 min / 90 s)

Ante la duda, escala con: endpoint, request completo, response completo, eventId y timestamp.

Para un resultado incierto de BookingNew sin bookingId, incluye clientReference, el timestamp del intento en UTC y eventId si está disponible.