3. Prebooking

`POST /v1/prebooking`

Reserva las eSIM del plan que encontró una búsqueda de disponibilidad, en el número que elijas, y devuelve un identificador (prebookingId) que usarás para confirmar la venta. Aún no se ha creado ninguna venta.

No tienes que repetir la búsqueda: el plan, el precio, los países, la fecha de inicio y los días viajan dentro del token. Tú solo indicas cuántas eSIM quieres.

Cuerpo de la petición

{
  "token": "eyJwbGFuSWQiOjE2NywicGxhblByaWNlSWQiOjE0MjksImNvdW50cnlJZHMiOls4M10sInN0YXJ0RGF0ZSI6IjIwMjYtMTItMDEiLCJkYXlzIjoxNX0",
  "cardsNumber": 2
}

Campo	Obligatorio	Descripción
`token`	Sí	Texto no vacío, de hasta 2000 caracteres: el `token` del plan que devolvió la disponibilidad, tal cual. La reserva se hace siempre con tus credenciales, no con datos del `token`.
`cardsNumber`	Sí	Entero de 1 a 100: el número de eSIM que quieres reservar.

Petición

curl -s -u "mi-usuario:mi-secreto" -X POST \
  "https://pre-api.welcomesims.com/public-api/v1/prebooking" \
  -H "Content-Type: application/json" \
  -d '{"token":"eyJwbGFuSWQiOjE2NywicGxhblByaWNlSWQiOjE0MjksImNvdW50cnlJZHMiOls4M10sInN0YXJ0RGF0ZSI6IjIwMjYtMTItMDEiLCJkYXlzIjoxNX0","cardsNumber":2}'

Respuesta `200`

{
  "prebookingId": "3f1c9a52-7d1e-4a3b-9c55-0a1b2c3d4e5f",
  "cardsNumber": 2,
  "pricePerCard": "32.89",
  "totalPrice": "65.78",
  "currency": "EUR"
}

Los cinco campos vienen siempre. Los importes son texto con dos decimales.

Campo	Descripción
`prebookingId`	UUID, identificador para confirmar la venta. Guárdalo: es lo único que necesitas del siguiente paso.
`cardsNumber`	Número de eSIM reservadas.
`pricePerCard`	Precio de una eSIM para toda la duración, con impuestos y dos decimales: el `price.totalPrice` que viste en la disponibilidad.
`totalPrice`	Importe de la reserva (`pricePerCard` por `cardsNumber`), con impuestos y dos decimales.
`currency`	Moneda de los importes, código ISO 4217 (`EUR`).

El importe es el de la reserva, no una estimación: es el mismo que tendrá la venta al confirmarla.

Errores frecuentes

Estado	`code`	Qué hacer
`400`	`VALIDATION_ERROR`	Falta el `token` o el `cardsNumber`, o este no está entre 1 y 100; el campo `errors` indica cuál.
`400`	`INVALID_TOKEN`	El `token` no es válido: está incompleto, modificado o no es uno devuelto por la disponibilidad. Repite la búsqueda.
`400`	`INVALID_REQUEST`	La fecha de inicio de la búsqueda ya ha pasado (por ejemplo, un `token` de ayer para hoy). Repite la búsqueda.
`404`	`NOT_FOUND`	El plan del `token` ya no está activo o ya no se vende como eSIM. Repite la búsqueda de disponibilidad.
`409`	`NO_STOCK`	No hay suficientes eSIM disponibles. Prueba con menos o más tarde.