Maxim

Maxim

Última actualización el Nov 3, 2026

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