Перемещения

7 статьи Максим От Максим

Методы для перемещений между складами

Перемещения

Перемещения: перенос материалов или продуктов с одного склада на другой. Через API перемещения можно создавать, редактировать и удалять, менять их статус, получать список и данные перемещения. Пути методов указаны относительно базового адреса API, а общие для всех методов правила (авторизация, формат запросов, частичное редактирование, постраничная выдача) описаны в статьях Обзор API и Общие правила. Методы | Метод | Что делает | |---|---| | v1/transfers/add | Создает перемещение | | v1/transfers/edit | Изменяет перемещение | | v1/transfers/delete | Удаляет перемещение | | v1/transfers/update_status | Меняет статус перемещения | | v1/transfers/get_list | Возвращает список перемещений | | v1/transfers/get_entry | Возвращает перемещение со строками |

Создание перемещения

Создает перемещение материалов или продуктов между складами. v1/transfers/add.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | num | string | Да | Номер | | source_storage_id | int | Да | Склад, с которого перемещаются позиции | | target_storage_id | int | Да | Склад, на который перемещаются позиции | | materials | array | materials или products | Перемещаемые материалы: id или sku и amount | | products | array | materials или products | Перемещаемые продукты: id или sku и amount | | date | string | Нет | Дата перемещения, YYYY-MM-DD. По умолчанию сегодня | | notes | string | Нет | Заметки | Строка materials и products: | Поле | Тип | Обязательное | Описание | |---|---|---|---| | id | int | id или sku | ID материала или продукта | | sku | string | id или sku | Артикул | | amount | float | Да | Количество, больше 0 | | notes | string | Нет | Комментарий к строке | Строки передаются только в одном массиве: перемещение переносит либо материалы, либо продукты. Тип перемещения определяется по заполненному массиву. Склады должны различаться и хранить позиции перемещаемого типа. Новое перемещение создается в статусе из настройки Статус нового перемещения по умолчанию. Пример запроса { "num": "31", "source_storage_id": 3998, "target_storage_id": 4001, "date": "2026-10-06", "products": [ { "id": 512, "amount": 5, "notes": "Для витрины" }, { "sku": "P-CHAIR-01", "amount": 20 } ], "notes": "В магазин на Ленина" } Пример ответа { "success": true, "transfer_id": 6967, "num": "31", "status": 0 } В ответе приходят ID, номер и код статуса нового перемещения. Ошибки | Ошибка | Причина | |---|---| | No num in input | Не передан num или он пустой | | 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 после округления | | Invalid notes value for product with id 512. Must be a string | notes в строке не строка | | Notes for product with id 512 are too long: maximum 10000 characters | Комментарий строки длиннее 10 000 символов | | 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 | Неверный формат даты |

Редактирование перемещения

Изменяет перемещение. Меняются только переданные поля, остальные остаются прежними. Подробнее о частичном редактировании в статье Общие правила. v1/transfers/edit.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | transfer_id | int | Да | ID перемещения | | materials | array | Нет | Перемещаемые материалы: id или sku и amount | | products | array | Нет | Перемещаемые продукты: id или sku и amount | | source_storage_id | int | Нет | Склад, с которого перемещаются позиции | | target_storage_id | int | Нет | Склад, на который перемещаются позиции | | num | string | Нет | Номер | | date | string | Нет | Дата перемещения, YYYY-MM-DD | | notes | string | Нет | Заметки | Если передан materials или products, строки заменяются целиком. Строки передаются только в одном массиве, как в v1/transfers/add; чтобы сменить тип перемещения, передайте строки в другом массиве. Если не передан ни один массив, строки остаются прежними. Статус этим методом не меняется, для него есть v1/transfers/update_status. Склады проверяются, только если переданы склады или строки. Поэтому перемещение со складом, который позже удалили, можно изменить, если не передавать склады и строки. Пример запроса { "transfer_id": 6967, "target_storage_id": 4005, "notes": "В магазин на Гагарина" } Пример ответа { "success": true } Ошибки | Ошибка | Причина | |---|---| | No transfer_id in input | Не передан transfer_id | | Transfer not found or access denied | Перемещение не найдено или удалено | | A transfer moves either materials or products. Create separate transfers | Переданы и materials, и products | | No products or materials in input | Массивы строк переданы, но пустые | | Product with id 512 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 4005 does not store products | Склад не хранит позиции этого типа | | Date is not a valid date in format YYYY-MM-DD | Неверный формат даты | Остальные ошибки строк такие же, как в v1/transfers/add.

Удаление перемещения

Удаляет перемещение. v1/transfers/delete.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | transfer_id | int | Да | ID перемещения | Удаление нельзя отменить. Позиции возвращаются на склад-источник и убираются со склада-получателя. Пример запроса { "transfer_id": 6967 } Пример ответа { "success": true } Ошибки | Ошибка | Причина | |---|---| | No transfer_id in input | Не передан transfer_id | | Transfer not found or access denied | Перемещение не найдено или уже удалено |

Смена статуса перемещения

Меняет статус перемещения. От статуса зависит, списаны ли позиции со склада-источника и поступили ли на склад-получатель. v1/transfers/update_status.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | transfer_id | int | Да | ID перемещения | | status | int | Да | Новый статус: 0 — План, 1 — Отправлено, 2 — Получено | Пример запроса { "transfer_id": 6967, "status": 2 } Пример ответа { "success": true } Ошибки | Ошибка | Причина | |---|---| | No transfer_id in input | Не передано обязательное поле (вместо transfer_id будет имя поля) | | Invalid status value. Must be one of: 0, 1, 2 | Неверный код статуса | | Transfer not found or access denied | Перемещение не найдено или удалено |

Получение списка перемещений

Возвращает перемещения компании, от новых к старым: по дате, а внутри одной даты по ID. Строки в список не входят, их возвращает v1/transfers/get_entry. v1/transfers/get_list.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | storage_id | int | Нет | Только перемещения, где этот склад источник или получатель | | date_from | string | Нет | Перемещения с этой даты включительно, YYYY-MM-DD | | date_to | string | Нет | Перемещения по эту дату включительно, YYYY-MM-DD | | status | int | Нет | Статус: 0 План, 1 Отправлено, 2 Получено | | limit | int | Нет | Размер страницы, от 1 до 1000 | | offset | int | Нет | Сколько записей пропустить | Без limit возвращается весь список. Подробнее о постраничной выдаче в статье Общие правила. Ответ Массив transfers с полями перемещения: | Поле | Тип | Описание | |---|---|---| | id | int | ID перемещения | | num | string | Номер | | date | string | Дата перемещения, YYYY-MM-DD | | status | int | Статус: 0 План, 1 Отправлено, 2 Получено | | source_storage_id | int | Склад, с которого перемещаются позиции | | source_storage_name | string | Название склада-источника | | target_storage_id | int | Склад, на который перемещаются позиции | | target_storage_name | string | Название склада-получателя | | cost | float | Себестоимость перемещенного | | price | float | Стоимость продуктов по цене продажи. У перемещения материалов 0 | | amount | float | Общее количество. null, если у позиций разные единицы измерения | | lines | int | Количество строк | | notes | string | Заметки | Поле total содержит общее число перемещений, подходящих под фильтры. Пример запроса { "storage_id": 4001, "status": 1, "limit": 100, "offset": 0 } Пример ответа { "success": true, "transfers": [ { "id": 6967, "num": "31", "date": "2026-10-06", "status": 1, "source_storage_id": 3998, "source_storage_name": "Главный", "target_storage_id": 4001, "target_storage_name": "Магазин", "cost": 61500, "price": 125000, "amount": 25, "lines": 2, "notes": "В магазин на Ленина" } ], "total": 1 } Ошибки | Ошибка | Причина | |---|---| | Date is not a valid date in format YYYY-MM-DD | Неверный формат date_from или date_to | | Invalid status value. Must be a number | status не число | | Invalid limit value. Must be between 1 and 1000 | Неверный limit | | Offset requires limit | Передан offset без limit |

Получение данных перемещения

Возвращает перемещение с его строками. v1/transfers/get_entry.php Параметры | Поле | Тип | Обязательное | Описание | |---|---|---|---| | transfer_id | int | Да | ID перемещения | Ответ Объект transfer с полями перемещения: | Поле | Тип | Описание | |---|---|---| | id | int | ID перемещения | | num | string | Номер | | date | string | Дата перемещения, YYYY-MM-DD | | status | int | Статус: 0 План, 1 Отправлено, 2 Получено | | source_storage_id | int | Склад, с которого перемещаются позиции | | source_storage_name | string | Название склада-источника | | target_storage_id | int | Склад, на который перемещаются позиции | | target_storage_name | string | Название склада-получателя | | cost | float | Себестоимость перемещенного | | price | float | Стоимость продуктов по цене продажи. У перемещения материалов 0 | | amount | float | Общее количество. null, если у позиций разные единицы измерения | | lines | int | Количество строк | | notes | string | Заметки | И строки в двух массивах: materials и products. Заполнен только массив того типа, который переносит перемещение, второй приходит пустым. | Поле | Тип | Описание | |---|---|---| | id | int | ID материала или продукта | | sku | string | Артикул | | name | string | Название | | amount | float | Количество | | unit | string | Единица измерения | | cost | float | Себестоимость строки | | position | int | Порядковый номер строки, с 0 | | notes | string | Комментарий к строке. Пустая строка, если его нет | Строки из ответа можно отправить в v1/transfers/edit без изменений. Пример запроса { "transfer_id": 6967 } Пример ответа { "success": true, "transfer": { "id": 6967, "num": "31", "date": "2026-10-06", "status": 1, "source_storage_id": 3998, "source_storage_name": "Главный", "target_storage_id": 4001, "target_storage_name": "Магазин", "cost": 61500, "price": 125000, "amount": 25, "lines": 2, "notes": "В магазин на Ленина", "materials": [], "products": [ { "id": 512, "sku": "P-TABLE-01", "name": "Стол обеденный", "amount": 5, "unit": "шт", "cost": 30500, "position": 0, "notes": "Для витрины" }, { "id": 540, "sku": "P-CHAIR-01", "name": "Стул", "amount": 20, "unit": "шт", "cost": 31000, "position": 1, "notes": "" } ] } } Ошибки | Ошибка | Причина | |---|---| | No transfer_id in input | Не передан transfer_id | | Transfer not found or access denied | Перемещение не найдено или удалено |