v1/transfers/add: создание перемещения в Controlata

Создает перемещение материалов или продуктов между складами.

v1/transfers/add.php

Параметры

Поле	Тип	Обязательное	Описание
source_storage_id	int	Да	Склад, с которого перемещаются позиции
target_storage_id	int	Да	Склад, на который перемещаются позиции
materials	array	materials или products	Перемещаемые материалы: id или sku и amount
products	array	materials или products	Перемещаемые продукты: id или sku и amount
num	string	Нет	Номер. По умолчанию следующий по порядку
date	string	Нет	Дата перемещения, YYYY-MM-DD. По умолчанию сегодня
notes	string	Нет	Заметки

Строка materials и products:

Поле	Тип	Обязательное	Описание
id	int	id или sku	ID материала или продукта
sku	string	id или sku	Артикул
amount	float	Да	Количество, больше 0

Передайте строки только в одном массиве: перемещение переносит либо материалы, либо продукты. Тип перемещения определяется по заполненному массиву. Как указывать позицию по id или артикулу, описано в статье Общие правила.

Как работает

Статус берется из настройки Статус нового перемещения по умолчанию. От него зависит, списаны ли позиции с источника и поступили ли на получатель (см. Перемещения).
Склады должны различаться и хранить позиции типа перемещения.
Себестоимость считается на складе-источнике по FIFO и переносится на склад-получатель.

Пример запроса

{
    "source_storage_id": 3998,
    "target_storage_id": 4001,
    "date": "2026-10-06",
    "products": [
        {
            "id": 512,
            "amount": 5
        },
        {
            "sku": "P-CHAIR-01",
            "amount": 20
        }
    ],
    "notes": "В магазин на Ленина"
}

Пример ответа

{
    "success": true,
    "transfer_id": 6967,
    "num": "31",
    "status": 0
}

В ответе приходят ID, номер и код статуса нового перемещения.

Ошибки

Ошибка	Причина
No source_storage_id in input	Не передано обязательное поле (вместо source_storage_id будет имя поля)
A transfer moves either materials or products. Create separate transfers	Переданы и materials, и products
No products or materials in input	Не передано ни одной строки
Products is not an array	products не массив (так же для materials)
Line 0 of products must be an object	Строка не объект (вместо 0 будет номер строки)
SKU or id not set for product 0	В строке нет ни id, ни sku
Product with id 512 not found	Продукт не найден или удален (для артикула: Product with SKU "P-CHAIR-01" not found)
Amount must be greater than 0 for product with id 512	Количество не число или не больше 0 после округления
Storage ID is not set	Склад равен 0 или пустой
Storage ID not found	Склад не найден или удален
Source and target storage locations must be different	Передан один и тот же склад
Storage location 4001 does not store products	Склад не хранит позиции этого типа (для материалов: does not store materials)
Date is not a valid date in format YYYY-MM-DD	Неверный формат даты