Traslados

7 artículos Maxim Por Maxim

Traslados

Traslados: mover materiales o productos de un almacén a otro. A través de la API puedes crear, editar y eliminar traslados, cambiar su estado, y obtener la lista y los datos de un traslado. Las rutas de los métodos se indican respecto a la dirección base de la API; las reglas comunes a todos los métodos (autorización, formato de las solicitudes, edición parcial, paginación) se describen en Descripción general de la API y Reglas generales. Métodos Método Qué hace v1/transfers/add Crea un traslado v1/transfers/edit Modifica un traslado v1/transfers/delete Elimina un traslado v1/transfers/update_status Cambia el estado del traslado v1/transfers/get_list Devuelve la lista de traslados v1/transfers/get_entry Devuelve un traslado con sus líneas

Crear un traslado

Crea un traslado de materiales o productos entre almacenes. v1/transfers/add.php Parámetros Campo Tipo Obligatorio Descripción num string Sí Número source_storage_id int Sí Almacén del que se mueven los elementos target_storage_id int Sí Almacén al que se mueven los elementos materials array materials o products Materiales a mover: id o sku y amount products array materials o products Productos a mover: id o sku y amount date string No Fecha del traslado, YYYY-MM-DD. Por defecto hoy notes string No Notas Línea materials y products: Campo Tipo Obligatorio Descripción id int id o sku ID del material o del producto sku string id o sku SKU amount float Sí Cantidad, mayor que 0 notes string No Comentario de la línea Las líneas se envían en un solo array: un traslado mueve o materiales o productos. El tipo de traslado se determina por el array que se rellene. Los almacenes deben ser distintos y guardar los elementos del tipo trasladado. Un traslado nuevo se crea con el estado del ajuste Estado por defecto de los nuevos traslados. Ejemplo de solicitud { "num": "31", "source_storage_id": 3998, "target_storage_id": 4001, "date": "2026-10-06", "products": [ { "id": 512, "amount": 5, "notes": "Para el escaparate" }, { "sku": "P-CHAIR-01", "amount": 20 } ], "notes": "A la tienda de la calle Mayor" } Ejemplo de respuesta { "success": true, "transfer_id": 6967, "num": "31", "status": 0 } La respuesta devuelve el ID, el número y el código de estado del nuevo traslado. Errores Error Motivo No num in input num falta o está vacío No source_storage_id in input Falta un campo obligatorio (en lugar de source_storage_id, el nombre del campo) A transfer moves either materials or products. Create separate transfers Se enviaron materials y products No products or materials in input No se envió ninguna línea Products is not an array products no es un array (igual para materials) Line 0 of products must be an object La línea no es un objeto (en lugar de 0, el número de línea) SKU or id not set for product 0 La línea no tiene ni id ni sku Product with id 512 not found Producto no encontrado o eliminado (para un SKU: Product with SKU "P-CHAIR-01" not found) Amount must be greater than 0 for product with id 512 La cantidad no es un número o no es mayor que 0 tras redondear Invalid notes value for product with id 512. Must be a string notes de la línea no es una cadena Notes for product with id 512 are too long: maximum 10000 characters El comentario de la línea supera los 10 000 caracteres Storage ID is not set Un almacén igual a 0 o vacío Storage ID not found Almacén no encontrado o eliminado Source and target storage locations must be different Se envió el mismo almacén Storage location 4001 does not store products El almacén no guarda elementos de este tipo (para materiales: does not store materials) Date is not a valid date in format YYYY-MM-DD Formato de fecha no válido

Editar un traslado

Modifica un traslado. Solo se cambian los campos que envías, el resto se queda como estaba. Consulta la edición parcial en Reglas generales. v1/transfers/edit.php Parámetros Campo Tipo Obligatorio Descripción transfer_id int Sí ID del traslado materials array No Materiales a mover: id o sku y amount products array No Productos a mover: id o sku y amount source_storage_id int No Almacén del que se mueven los elementos target_storage_id int No Almacén al que se mueven los elementos num string No Número date string No Fecha del traslado, YYYY-MM-DD notes string No Notas Si se envía materials o products, las líneas se reemplazan por completo. Las líneas se envían en un solo array, como en v1/transfers/add; para cambiar el tipo de traslado, envía las líneas en el otro array. Si no se envía ningún array, las líneas no cambian. El estado no se cambia con este método; usa v1/transfers/update_status. Los almacenes se validan solo si se envían almacenes o líneas. Así, un traslado cuyo almacén se eliminó después se puede editar mientras no envíes almacenes ni líneas. Ejemplo de solicitud { "transfer_id": 6967, "target_storage_id": 4005, "notes": "A la tienda de la calle Gagarin" } Ejemplo de respuesta { "success": true } Errores Error Motivo No transfer_id in input Falta transfer_id Transfer not found or access denied Traslado no encontrado o eliminado A transfer moves either materials or products. Create separate transfers Se enviaron materials y products No products or materials in input Los array de líneas se enviaron pero vacíos Product with id 512 not found Producto no encontrado o eliminado Amount must be greater than 0 for product with id 512 La cantidad no es un número o no es mayor que 0 tras redondear Storage ID is not set Un almacén igual a 0 o vacío Storage ID not found Almacén no encontrado o eliminado Source and target storage locations must be different Los almacenes son el mismo Storage location 4005 does not store products El almacén no guarda elementos de este tipo Date is not a valid date in format YYYY-MM-DD Formato de fecha no válido Los demás errores de líneas son los mismos que en v1/transfers/add.

Eliminar un traslado

Elimina un traslado. v1/transfers/delete.php Parámetros Campo Tipo Obligatorio Descripción transfer_id int Sí ID del traslado La eliminación no se puede deshacer. Los elementos vuelven al almacén de origen y se quitan del de destino. Ejemplo de solicitud { "transfer_id": 6967 } Ejemplo de respuesta { "success": true } Errores Error Motivo No transfer_id in input Falta transfer_id Transfer not found or access denied Traslado no encontrado o ya eliminado

Cambiar el estado del traslado

Cambia el estado del traslado. El estado determina si los elementos se descuentan del origen y entran en el almacén de destino. v1/transfers/update_status.php Parámetros Campo Tipo Obligatorio Descripción transfer_id int Sí ID del traslado status int Sí Nuevo estado: 0 — Plan, 1 — Enviado, 2 — Recibido Ejemplo de solicitud { "transfer_id": 6967, "status": 2 } Ejemplo de respuesta { "success": true } Errores Error Motivo No transfer_id in input Falta un campo obligatorio (en lugar de transfer_id, el nombre del campo) Invalid status value. Must be one of: 0, 1, 2 Código de estado no válido Transfer not found or access denied Traslado no encontrado o eliminado

Obtener la lista de traslados

Devuelve los traslados de la empresa, de los nuevos a los antiguos: por fecha y, dentro de una misma fecha, por ID. Las líneas no se incluyen en la lista; las devuelve v1/transfers/get_entry. v1/transfers/get_list.php Parámetros Campo Tipo Obligatorio Descripción storage_id int No Solo los traslados donde este almacén es el origen o el destino date_from string No Traslados desde esta fecha inclusive, YYYY-MM-DD date_to string No Traslados hasta esta fecha inclusive, YYYY-MM-DD status int No Estado: 0 Plan, 1 Enviado, 2 Recibido limit int No Tamaño de página, de 1 a 1000 offset int No Cuántos registros omitir Sin limit se devuelve toda la lista. Consulta la paginación en Reglas generales. Respuesta Un array transfers con los campos del traslado: Campo Tipo Descripción id int ID del traslado num string Número date string Fecha del traslado, YYYY-MM-DD status int Estado: 0 Plan, 1 Enviado, 2 Recibido source_storage_id int Almacén de origen source_storage_name string Nombre del almacén de origen target_storage_id int Almacén de destino target_storage_name string Nombre del almacén de destino cost float Coste de lo trasladado price float Valor de los productos a su precio de venta. 0 en un traslado de materiales amount float Cantidad total. null si los elementos tienen unidades distintas lines int Número de líneas notes string Notas El campo total contiene el número total de traslados que cumplen los filtros. Ejemplo de solicitud { "storage_id": 4001, "status": 1, "limit": 100, "offset": 0 } Ejemplo de respuesta { "success": true, "transfers": [ { "id": 6967, "num": "31", "date": "2026-10-06", "status": 1, "source_storage_id": 3998, "source_storage_name": "Principal", "target_storage_id": 4001, "target_storage_name": "Tienda", "cost": 61500, "price": 125000, "amount": 25, "lines": 2, "notes": "A la tienda de la calle Mayor" } ], "total": 1 } Errores Error Motivo Date is not a valid date in format YYYY-MM-DD date_from o date_to no válida Invalid status value. Must be a number status no es un número Invalid limit value. Must be between 1 and 1000 limit no válido Offset requires limit se envió offset sin limit

Obtener los datos de un traslado

Devuelve un traslado con sus líneas. v1/transfers/get_entry.php Parámetros Campo Tipo Obligatorio Descripción transfer_id int Sí ID del traslado Respuesta Un objeto transfer con los campos del traslado: Campo Tipo Descripción id int ID del traslado num string Número date string Fecha del traslado, YYYY-MM-DD status int Estado: 0 Plan, 1 Enviado, 2 Recibido source_storage_id int Almacén de origen source_storage_name string Nombre del almacén de origen target_storage_id int Almacén de destino target_storage_name string Nombre del almacén de destino cost float Coste de lo trasladado price float Valor de los productos a su precio de venta. 0 en un traslado de materiales amount float Cantidad total. null si los elementos tienen unidades distintas lines int Número de líneas notes string Notas Y líneas en dos array: materials y products. Solo se rellena el array del tipo que mueve el traslado; el otro llega vacío. Campo Tipo Descripción id int ID del material o del producto sku string SKU name string Nombre amount float Cantidad unit string Unidad de medida cost float Coste de la línea position int Número de línea, desde 0 notes string Comentario de la línea. Cadena vacía si no hay Las líneas de la respuesta se pueden enviar a v1/transfers/edit sin cambios. Ejemplo de solicitud { "transfer_id": 6967 } Ejemplo de respuesta { "success": true, "transfer": { "id": 6967, "num": "31", "date": "2026-10-06", "status": 1, "source_storage_id": 3998, "source_storage_name": "Principal", "target_storage_id": 4001, "target_storage_name": "Tienda", "cost": 61500, "price": 125000, "amount": 25, "lines": 2, "notes": "A la tienda de la calle Mayor", "materials": [], "products": [ { "id": 512, "sku": "P-TABLE-01", "name": "Mesa de comedor", "amount": 5, "unit": "ud", "cost": 30500, "position": 0, "notes": "Para el escaparate" }, { "id": 540, "sku": "P-CHAIR-01", "name": "Silla", "amount": 20, "unit": "ud", "cost": 31000, "position": 1, "notes": "" } ] } } Errores Error Motivo No transfer_id in input Falta transfer_id Transfer not found or access denied Traslado no encontrado o eliminado