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 |