GET/v1/trains/order/:gdsprovider/:orderId/refundable-items

Consultar ítems reembolsables de tren

Encuentra los ítems de la orden que pueden seleccionarse para reembolso.

Autenticación y headers

Header	Descripción
`Authorization`	`Bearer <secret_key>`. Conserva el secret en el servidor y nunca lo escribas en logs del cliente.
`X-Travelandz-Id`	`<public_key>:<profile_code>`, donde el profile code persistido tiene el formato `dp_<12 alfanuméricos>`.
`Content-Type`	`application/json` para peticiones con body JSON.

Petición

Parámetros de path: gdsprovider actualmente es 0; orderId viene de la creación de la orden.

Schema de parámetros

gdsprovider

enum

0

Sí

Currently 0

orderId

stringSí

Order id returned by order creation.

Respuesta exitosa

Devuelve items[] con ids, importes reembolsables y los tramos de viaje afectados.

Schema de respuesta

items

arraySí

items[]id

stringSí

items[]amountToRefund

objectSí

items[]amountToRefundamount

numberSí

items[]amountToRefundcurrency

stringSí

items[]refundOfferParts

arraySí

items[]refundOfferParts[]segments

arraySí

items[]refundOfferParts[]segments[]departureAt

string

Formato: ISO 8601

Sí

items[]refundOfferParts[]segments[]arrivalAt

string

Formato: ISO 8601

Sí

items[]refundOfferParts[]segments[]durationInMinutes

numberSí

items[]refundOfferParts[]segments[]transport

enum

trainbusferry

Sí

items[]refundOfferParts[]segments[]identifier

stringSí

Errores

400 por validación o campos desconocidos.
401 o 403 por credenciales API inválidas.
500 internal_communication_error o unknown_error por fallos del proveedor.
order_not_found cuando la orden no existe.

Notas de uso

Guarda cada items[].id seleccionado y envía esos ids al endpoint de reembolso.

Ejemplo cURL

bash

curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/trains/order/0/order_123/refundable-items" \
  --header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  --header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"