Создание заказа

Создает заказ. Статус заказа берется из настройки Статус нового заказа по умолчанию, а от статуса зависит, списываются ли продукты и материалы сразу (см. Заказы).

v1/orders/add.php

Параметры

Каждая строка в products и materials содержит id или sku, количество amount и сумму строки total. Поля покупателя, склады и производство под заказ описаны в статье Заказы.

Как работает

• Номер. К num добавляется префикс подключения: «1001» сохранится как «A-1001».
• Ненайденные позиции. Строка с неизвестным id или артикулом пропускается, а сообщение о ней дописывается в notes. Если не найдена ни одна строка, заказ не создается.
• Покупатель. С customer_name каждый запрос создает нового покупателя, даже если такое имя уже есть. ID покупателя возвращается в ответе: сохраните его и передавайте customer_id в следующих заказах.
• Даты. Движения по складу датируются датой отправки, а если она не задана, датой заказа.
• Суммы. subtotal равен сумме строк, total равен subtotal плюс delivery_price минус discount. Себестоимость заказа Controlata считает сама.
• Производство под заказ. С production со значением 1 Controlata создает связанное производство, продукты не списываются со склада.

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

{
    "num": "1001",
    "date_placed": "2026-10-06",
    "customer_name": "Иван Петров",
    "customer_phone": "+7 900 123-45-67",
    "customer_email": "ivan@example.com",
    "customer_address_real": "г. Москва, ул. Лесная, д. 5, кв. 12",
    "products": [
        {
            "sku": "P001",
            "amount": 2,
            "total": 26000
        },
        {
            "id": 816,
            "amount": 1,
            "total": 4500
        }
    ],
    "delivery_price": 500,
    "discount": 1000,
    "notes": "Заказ с сайта"
}

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

{
    "success": true,
    "order_id": 43727,
    "customer_id": 512
}

customer_id содержит ID покупателя заказа: найденного по customer_id или созданного по customer_name.

Ошибки

В текстах ошибок строк вместо product будет material для строк материалов, а вместо SKU "P001" будет id 816, если строка передана по id.