Ir al contenido principal

REST API: Sincronización de producciones y movimientos de almacén

Documentación provisional para obtener los cambios y eliminados de las producciones y registrar entradas y salidas de almacén.

Documentación provisional. Estos endpoints todavía no están implementados y pueden sufrir cambios antes de publicarse.

Mantén una copia sincronizada de las producciones y registra entradas y salidas de stock en un almacén.

GET  /integration/productions/changes
GET /integration/productions/deletes
POST /integration/stores/movements

Antes de empezar

URL base: https://app.tspoonlab.com/recipes/api

Cabeceras

  • rememberme · obligatorio — Token de sesión que devuelve el login.

  • order · opcional — Id del centro de coste (Centros de coste). Por defecto, el centro activo del usuario.

Login — Devuelve el token en texto plano.

curl https://app.tspoonlab.com/recipes/api/login \
-d [email protected] \
-d password=XXXXXXX

Permisos — Para las producciones, permiso para ver la producción. Para los movimientos de almacén, permiso para editar almacenes.

Fechas — Se devuelven en milisegundos desde 1970 (epoch). Al enviarlas se aceptan en milisegundos o en ISO 8601 completo (2026-10-30T09:00:00.000+01:00).

Las respuestas pueden incluir otros campos además de los documentados. Usa solo los documentados.


Sincronizar producciones

Funciona igual que la sincronización de compras y ventas: /changes devuelve las producciones creadas o modificadas y /deletes, las eliminadas. Cada uno tiene su propio cursor.

  1. Primera llamada sin cursor: devuelve todas las producciones del centro en changes. Para empezar desde un día concreto, envía changedSince.

  2. Mientras hasMore sea true, vuelve a llamar con el cursor recibido.

  3. Guarda el último cursor. En la siguiente sincronización, llama con él: solo recibirás lo que haya cambiado.

GET /integration/productions/changes

Parámetros de consulta

  • cursor string · opcional — Cursor de la llamada anterior. Si se envía, se ignoran changedSince y $filter.

  • changedSince date · opcional — Cambios desde este día, en formato AAAA-MM-DD. No puede ser posterior a hoy.

  • $filter string · opcional — Filtro OData, con la misma sintaxis que en compras y ventas. Queda guardado en el cursor: solo se envía en la primera llamada.

  • rows integer · opcional — Producciones por página, de 1 a 100. Por defecto, 100.

Campos de $filter: dateStarted, dateDone (fecha), idComponent (id), descr (texto), type (número, con eq, ne e in).

Ejemplo — Producciones terminadas desde el 1 de enero de 2026:

curl -G https://app.tspoonlab.com/recipes/api/integration/productions/changes \
-H "rememberme: $TOKEN" \
--data-urlencode '$filter=dateDone ge 2026-01-01'

Respuesta

{
"changes": [
{
"id": "3515834441676562996102020301",
"idProduction": "3515834441676562996102020302",
"dateStarted": 1767258000000,
"dateDone": 1767272400000,
"idComponent": "3515834441676562996102020303",
"descr": "Salsa de tomate",
"type": 1,
"createdAt": 1767254400000,
"updatedAt": 1767272400000,
"listUnits": [
{
"idUnit": "3515834441676562996102020304",
"descrUnit": "kg",
"quantity": 20.0,
"quantityReal": 18.5
}
]
}
],
"cursor": "MjAyNi0wMS0wMSAxMzowMDowMC4wfDM1MTU4MzQ0NDE2NzY1NjI5OTYxMDIwMjAzMDE",
"hasMore": false
}

Cada producción de changes:

  • id string — Identificador de la producción del elaborado. Es el idProductionComponent de la API de producciones.

  • idProduction string — Identificador de la producción del día a la que pertenece.

  • dateStarted date — Cuándo empieza la producción. En ese momento salen del almacén los ingredientes. null si todavía no ha empezado.

  • dateDone date — Cuándo termina la producción. En ese momento entra en el almacén el producto acabado, que ya se puede vender. null si todavía no ha terminado.

  • idComponent string — Identificador del producto que se produce.

  • descr string — Nombre del producto.

  • type number — Tipo de producto: 1 elaboración · 3 plato.

  • createdAt, updatedAt date — Creación y última modificación.

  • listUnits array — Cantidades por unidad.

Cada cantidad (listUnits):

  • idUnit, descrUnit string — Unidad: id y nombre.

  • quantity number — Cantidad prevista a producir.

  • quantityReal number — Cantidad producida realmente. null si no se ha informado.

A tener en cuenta

  • Salen todas las producciones, también las que no han empezado o no han terminado. La fecha que marca la entrada del producto acabado en el almacén es dateDone. Para recibir solo las terminadas, filtra por dateDone, por ejemplo dateDone ne null.

  • Hay producciones de larga duración (por ejemplo, una curación de varios meses). Entre dateStarted y dateDone pueden pasar meses, y la producción sale en changes cada vez que se modifica.

  • Empezar, terminar o reabrir una producción es una modificación: sale en changes con el mismo id. Al reabrirla, dateDone vuelve a ser null.

  • Un cambio en las cantidades (listUnits) también es una modificación de la producción.

  • Las tareas de producción, que no producen ningún producto, no salen.

  • Los cambios de los últimos 5 minutos llegan en la siguiente llamada. Cada id sale una sola vez por página.

Eliminadas — Las producciones eliminadas están en /integration/productions/deletes.

curl -G https://app.tspoonlab.com/recipes/api/integration/productions/deletes \
-H "rememberme: $TOKEN" \
--data-urlencode cursor=$CURSOR_DELETES
{
"deletes": [
{ "id": "3515834441676562996102020309", "deletedAt": 1767268800000 }
],
"cursor": "djJ8LXwyMDI2LTAxLTAxIDEyOjAwOjAwLjB",
"hasMore": false
}
  • Parámetros: cursor, changedSince y rows, como en /changes. No admite $filter: devuelve todas las producciones eliminadas del centro. Elimina los id que tengas e ignora el resto.

  • Sin cursor ni changedSince, empieza por la eliminada más antigua que se conserva.

  • Una producción que se reabre no se ha eliminado: sale en /changes.

Errores — Un cursor, changedSince o $filter no válido, o un rows fuera de rango, devuelve 400 con code, message y params.


Registrar entradas y salidas de almacén

Suma o resta cantidades de productos en un almacén. Cada llamada es un movimiento con una o varias líneas. Las cantidades positivas son entradas y las negativas, salidas. Se registran como movimientos manuales de stock, igual que un ajuste hecho desde tSpoonLab.

POST /integration/stores/movements

Cuerpo

  • externalId string · obligatorio — Referencia del movimiento en tu sistema, hasta 128 caracteres. Si se envía otra vez la misma, no se duplica (ver Reintentos).

  • idStore string · obligatorio — Almacén (ver Almacenes). Debe ser del centro de coste activo.

  • date date · obligatorio — Fecha del movimiento. El stock se recalcula a partir de esta fecha.

  • comment string · opcional — Motivo o comentario.

  • lines array · obligatorio — De 1 a 100 líneas.

Cada línea (lines):

  • idComponent string · obligatorio — Producto o elaboración. Si todavía no está en el almacén, se añade.

  • idUnit string · obligatorio — Unidad de la cantidad. Debe ser una unidad del producto.

  • quantity number · obligatorio — Positiva para una entrada y negativa para una salida. No puede ser 0.

  • cost number · opcional — Coste por unidad. Sin coste, se usa el coste actual del producto.

  • lot string · opcional — Lote.

Ejemplo

curl -X POST https://app.tspoonlab.com/recipes/api/integration/stores/movements \
-H "rememberme: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"externalId": "A3-MOV-2026-000123",
"idStore": "3515834441676562996102020101",
"date": "2026-01-15T10:00:00.000+01:00",
"comment": "Regularización",
"lines": [
{ "idComponent": "3515834441676562996102020303", "idUnit": "3515834441676562996102020304", "quantity": 12.5, "lot": "L260115" },
{ "idComponent": "3515834441676562996102020305", "idUnit": "3515834441676562996102020304", "quantity": -3 }
]
}'

Respuesta

{
"id": "3515834441676562996102020310",
"externalId": "A3-MOV-2026-000123",
"created": true
}
  • id string — Identificador del movimiento en tSpoonLab.

  • externalId string — La referencia enviada.

  • created boolean — true si se ha registrado ahora y false si ya se había recibido antes.

Reintentos — Si no recibes respuesta, vuelve a enviar el mismo movimiento con el mismo externalId. Si ya se había registrado, la respuesta devuelve el mismo id con created a false y no se suma otra vez.

A tener en cuenta

  • El movimiento se registra entero o no se registra: si una línea no es válida, no se guarda ninguna.

  • Para corregir un movimiento, envía otro con la cantidad contraria y un externalId nuevo.

  • Para mover stock entre almacenes o centros, usa los traspasos. Para registrar una producción, usa la API de producciones.

Errores — Un campo obligatorio que falta, un almacén, producto o unidad que no existe o no es del centro, o una cantidad 0, devuelve 400 con code, message y params.

¿Necesitas ayuda? Escríbenos desde el chat de soporte, en la esquina inferior derecha.

¿Ha quedado contestada tu pregunta?