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.