Skip to main content
Los endpoints de reservas de stock te permiten gestionar las reservas de inventario vinculadas a pedidos de venta, órdenes de producción y otros documentos en A3ERP. Con esta API puedes consultar qué stock está comprometido, crear nuevas reservas para garantizar la disponibilidad y eliminarlas cuando ya no sean necesarias.

​
GET — Consultar reservas de stock

Devuelve los datos de la reserva de stock indicada. El parámetro {id} es opcional: si lo omites, obtendrás todas las reservas registradas y podrás aplicar filtrado y ordenación. Ejemplo con identificador:
Cabecera requerida Parámetros de ruta
​
string
El identificador de la reserva de stock. Opcional: omítelo para obtener todas las reservas.
Campos de la respuesta
​
integer
Identificador único de la reserva de stock en la base de datos.
​
string
Tipo de documento que originó la reserva (p. ej. PV para pedido de venta).
​
string
Tipo de contabilización asociado al documento.
​
string
Serie del documento, cuadrada a 8 caracteres.
​
integer
Número de documento dentro de la serie.
​
string
Número de documento completo (serie/año/número).
​
string
Referencia externa del documento. Cadena vacía si no aplica.
​
string
Código del artículo reservado, cuadrado a 15 caracteres.
​
string
Descripción del artículo reservado.
​
string
Código del almacén donde se efectúa la reserva, cuadrado a 8 caracteres.
​
string
Descripción del almacén.
​
string
Fecha de entrada prevista de la mercancía en formato ISO 8601.
​
string
Fecha del documento que originó la reserva en formato ISO 8601.
​
integer
Unidades que entran según la reserva.
​
integer
Unidades que salen según la reserva.
​
integer
Unidades comprometidas por pedidos de compra.
​
integer
Unidades comprometidas por pedidos de venta.
​
integer
Unidades comprometidas por órdenes de producción internas.
​
integer
Unidades comprometidas por órdenes externas.
​
string
Código del tercero (cliente o proveedor) cuadrado a 8 caracteres.
​
string
Nombre o razón social del tercero vinculado a la reserva.
​
string
Número de lote de la reserva. Cadena vacía si no aplica.
​
string
Número de serie de la reserva. Cadena vacía si no aplica.
​
string
Fecha de caducidad del lote en formato ISO 8601.
​
string
Ubicación física del artículo en el almacén. Puede ser null.
Ejemplo de respuesta

​
POST — Crear una reserva de stock

Crea una nueva reserva de stock. El cuerpo de la petición debe incluir un objeto json con el almacén, la fecha del documento y un array de líneas con los artículos a reservar. Cabecera requerida Cuerpo de la petición
Descripción de los campos del cuerpo
​
string
required
Código del almacén en el que se registra la reserva.
​
string
required
Fecha del documento de reserva en formato DD/MM/YYYY.
​
array
required
Array de líneas de reserva. Cada elemento representa un artículo a reservar.
​
string
required
Código del artículo que quieres reservar.
​
string
required
Descripción o motivo de la reserva, que quedará registrado en el histórico.
​
string
required
Unidades de stock a reservar. Usa valor positivo para reservar entradas y negativo para liberar salidas.
​
string
required
Unidades comerciales a reservar. Usa el mismo signo que unidadesstock.
Respuesta
​
string
Identificador de la reserva de stock recién creada. Guárdalo para poder consultar o eliminar la reserva posteriormente.

​
DELETE — Eliminar una reserva de stock

​
Eliminar todos los registros de una reserva

Elimina por completo la reserva de stock indicada, borrando todos sus registros asociados. Ejemplo:
Parámetros de ruta
​
string
required
El identificador de la reserva de stock que quieres eliminar por completo.

​
Eliminar una línea concreta de una reserva

Elimina únicamente la línea indicada dentro de la reserva, manteniendo el resto de líneas intactas. Ejemplo:
Parámetros de ruta
​
string
required
El identificador de la reserva de stock que contiene la línea a eliminar.
​
string
required
El identificador de la línea concreta dentro de la reserva que quieres eliminar.