DEL
/api/mod/productos/{espacio}/inventory/reservations/{reserva}Libera una reserva
Devuelve al disponible lo que retenía una reserva activa: el carrito se abandonó o se canceló.
- PERMISOescribe
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Productos. |
| reserva | string | SÍ | El id de la reserva: el que devolvió crearla (32 caracteres hexadecimales). |
RESPUESTA 200
La reserva, liberada.
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id · variant_id · bodega | string | La reserva y qué retiene. |
| cantidad | string | Lo retenido. |
| estado | string | Ver estados. |
| session_id · sale_ref | string | null | Los que diste. |
| expires_at · created_at | number | Cuándo vence y cuándo se creó, en segundos desde 1970. |
| released_at | number | null | Cuándo dejó de retener. null mientras está activa. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Productos | módulo no habilitado para este espacio. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
| 404 | No existe, o ya no está activa (liberada, consumida o expirada) | reserva no encontrada o no estaba activa. |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.