Изменяет заказ. Меняются только переданные поля, остальные остаются прежними.
v1/orders/edit.php
Параметры
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| order_id | int | Да | ID заказа |
| num | string | Нет | Номер заказа |
| products | array | Нет | Строки продуктов. Заменяют текущие строки целиком |
| materials | array | Нет | Строки материалов. Заменяют текущие строки целиком |
| customer_id | int | Нет | ID покупателя |
| customer_name | string | Нет | Имя покупателя и поля customer_* |
| date_placed | string | Нет | Дата заказа |
| date_shipped | string | Нет | Дата отправки. Пустая строка очищает ее |
| products_storage_id | int | Нет | Склад продуктов |
| materials_storage_id | int | Нет | Склад материалов |
| production | int | Нет | 1 включает производство под заказ, 0 выключает |
| delivery_price | float | Нет | Стоимость доставки |
| discount | float | Нет | Скидка |
| notes | string | Нет | Заметки |
Статус и статус оплаты этим методом не меняются, для них есть v1/orders/update_status и v1/orders/update_payment.
Строки заказа
Строки передаются массивами products и materials. Если передан хотя бы один из массивов, состав заменяется целиком, а непереданный считается пустым. Если не передан ни один, строки не меняются.
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
| id | int | id или sku | ID продукта или материала |
| sku | string | id или sku | Артикул. Продукт ищется и по альтернативным SKU |
| amount | float | Да | Количество |
| total | float | Да | Сумма строки (не цена за единицу) |
| notes | string | Нет | Комментарий к строке |
Строки из ответа v1/orders/get_entry можно отправить обратно без изменений.
Пример запроса
Добавить скидку и изменить заметки, не трогая строки и покупателя:
{
"order_id": 43727,
"discount": 1500,
"notes": "Скидка по промокоду"
}
Заменить состав заказа:
{
"order_id": 43727,
"products": [
{
"sku": "P001",
"amount": 3,
"total": 39000
}
]
}
Пример ответа
{
"success": true
}
Ошибки
| Ошибка | Причина |
|---|---|
| No order_id in input | Не передан order_id |
| Order not found or access denied | Заказ не найден или удален |
| Products is not an array | products не массив (так же для materials) |
| No products or materials in input | Переданы пустые products и materials |
| Materials in orders are disabled in company settings | Переданы материалы, а настройка Возможность заказа материалов выключена |
| All products have wrong SKU or id | Не найдена ни одна строка (с материалами «All products and materials have wrong SKU or id») |
| Storage ID is not set | Передан пустой склад |
| Storage ID not found | Склад не найден или удален |
| Date is not a valid date in format YYYY-MM-DD | Неверная дата |
| Invalid delivery_price value. Must be a number, 0 or greater | Стоимость доставки не число или меньше 0 |
| Invalid discount value. Must be a number, 0 or greater | Скидка не число или меньше 0 |
| Customer not found | Покупатель customer_id не найден или удален |
| Customer name must not be empty | Пустое customer_name |
| Invalid customer_type value. Must be one of: 1, 2, 3 | Неверный тип нового покупателя |
Ошибки в отдельных строках (нет amount или total, неверное количество) те же, что в v1/orders/add.