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.
Primera llamada sin
cursor: devuelve todas las producciones del centro enchanges. Para empezar desde un día concreto, envíachangedSince.Mientras
hasMoreseatrue, vuelve a llamar con elcursorrecibido.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
cursorstring · opcional — Cursor de la llamada anterior. Si se envía, se ignoranchangedSincey$filter.changedSincedate · opcional — Cambios desde este día, en formatoAAAA-MM-DD. No puede ser posterior a hoy.$filterstring · 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.rowsinteger · 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:
idstring — Identificador de la producción del elaborado. Es elidProductionComponentde la API de producciones.idProductionstring — Identificador de la producción del día a la que pertenece.dateStarteddate — Cuándo empieza la producción. En ese momento salen del almacén los ingredientes.nullsi todavía no ha empezado.dateDonedate — Cuándo termina la producción. En ese momento entra en el almacén el producto acabado, que ya se puede vender.nullsi todavía no ha terminado.idComponentstring — Identificador del producto que se produce.descrstring — Nombre del producto.typenumber — Tipo de producto:1elaboración ·3plato.createdAt,updatedAtdate — Creación y última modificación.listUnitsarray — Cantidades por unidad.
Cada cantidad (listUnits):
idUnit,descrUnitstring — Unidad: id y nombre.quantitynumber — Cantidad prevista a producir.quantityRealnumber — Cantidad producida realmente.nullsi 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 pordateDone, por ejemplodateDone ne null.Hay producciones de larga duración (por ejemplo, una curación de varios meses). Entre
dateStartedydateDonepueden pasar meses, y la producción sale enchangescada vez que se modifica.Empezar, terminar o reabrir una producción es una modificación: sale en
changescon el mismoid. Al reabrirla,dateDonevuelve a sernull.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
idsale 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,changedSinceyrows, como en/changes. No admite$filter: devuelve todas las producciones eliminadas del centro. Elimina losidque tengas e ignora el resto.Sin
cursornichangedSince, 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
externalIdstring · obligatorio — Referencia del movimiento en tu sistema, hasta 128 caracteres. Si se envía otra vez la misma, no se duplica (ver Reintentos).idStorestring · obligatorio — Almacén (ver Almacenes). Debe ser del centro de coste activo.datedate · obligatorio — Fecha del movimiento. El stock se recalcula a partir de esta fecha.commentstring · opcional — Motivo o comentario.linesarray · obligatorio — De 1 a 100 líneas.
Cada línea (lines):
idComponentstring · obligatorio — Producto o elaboración. Si todavía no está en el almacén, se añade.idUnitstring · obligatorio — Unidad de la cantidad. Debe ser una unidad del producto.quantitynumber · obligatorio — Positiva para una entrada y negativa para una salida. No puede ser 0.costnumber · opcional — Coste por unidad. Sin coste, se usa el coste actual del producto.lotstring · 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
}idstring — Identificador del movimiento en tSpoonLab.externalIdstring — La referencia enviada.createdboolean —truesi se ha registrado ahora yfalsesi 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
externalIdnuevo.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.
