4. Confirmación

`POST /v1/booking`

Crea la venta a partir de un prebooking. Todas las eSIM de la venta pertenecen al titular que envíes.

Cuerpo de la petición

{
  "prebookingId": "3f1c9a52-7d1e-4a3b-9c55-0a1b2c3d4e5f",
  "agencyReference": "REF-0001",
  "holder": {
    "name": "Test",
    "surname": "Prueba",
    "documentType": "DNI",
    "documentNumber": "TEST0001",
    "email": "test@example.com",
    "phonePrefix": "+34",
    "phone": "000000000"
  }
}

Campo	Obligatorio	Descripción
`prebookingId`	Sí	UUID devuelto por el prebooking.
`agencyReference`	No	Tu referencia interna de la venta (hasta 100 caracteres).
`holder`	Sí	Objeto con los datos del titular, que son los de las filas siguientes.
`holder.name`, `holder.surname`	Sí	Nombre y apellidos del titular: texto no vacío de hasta 45 caracteres.
`holder.documentType`	Sí	Uno de `BI`, `DNI`, `NIE`, `PSP`, `NIF`, `CC`, `OTR`.
`holder.documentNumber`	Sí	Número del documento: texto no vacío de hasta 45 caracteres.
`holder.email`	No	Correo del titular (hasta 45 caracteres).
`holder.phonePrefix`, `holder.phone`	No	Prefijo (hasta 10) y teléfono (hasta 35). Juntos no pueden superar 45 caracteres.

Respuesta `200`

{
  "locator": "11346498",
  "voucherUrl": "https://pre-api.welcomesims.com/public-api/v1/sales/11346498/voucher",
  "totalPrice": "65.78",
  "currency": "EUR"
}

Campo	Presencia	Descripción
`locator`	Siempre	Localizador de la venta (número en texto). Guárdalo: identifica la venta en el resto de llamadas.
`voucherUrl`	Puede faltar	Dirección para descargar el voucher. Requiere las mismas credenciales. No aparece si la venta no tiene voucher.
`totalPrice`	Siempre	Importe de la venta confirmada, con impuestos y dos decimales (texto). Coincide con el `totalPrice` del prebooking.
`currency`	Siempre	Moneda del importe, código ISO 4217 (`EUR`).

Reintentos seguros

Si la llamada se corta por un timeout o no sabes si llegó, repítela con el mismo prebookingId: recibirás la misma respuesta y no se creará una segunda venta. Solo puede confirmar un prebooking la misma cuenta que lo creó.

Errores frecuentes

Estado	`code`	Qué hacer
`400`	`VALIDATION_ERROR`	Faltan datos del titular o tienen un valor no válido (por ejemplo un `documentType` desconocido).
`404`	`PREBOOKING_NOT_FOUND`	El prebooking no existe o no es de tu cuenta.
`409`	`CARDS_NUMBER_MISMATCH`	Las eSIM del prebooking ya no están disponibles. Vuelve a hacer el prebooking.
`5xx`	(varios)	La venta no se ha podido confirmar. Puedes reintentar con el mismo `prebookingId`.