Оформление заказа и счета
5 минПоследнее обновление: 2026-03-31
Атомарное оформление заказа
Все оформление заказа выполняется в одной транзакции базы данных. Если какой-либо шаг завершается ошибкой, все изменения откатываются, и частично созданных заказов не бывает:
- Проверка корзины: все позиции по-прежнему доступны, цены совпадают
- Проверка остатков: товара достаточно для всех позиций
- Адреса: проверка платежного адреса и адреса доставки
- Доставка: расчет стоимости доставки по зоне и весу
- Резервирование товара: атомарное уменьшение остатка (SELECT...FOR UPDATE)
- Создание заказа: формирование заказа с позициями и итоговыми суммами
- Формирование счета: создание счета с уникальным последовательным номером
- Генерация PDF: формирование счета в виде PDF для скачивания
- Применение скидки: учет использования промокода, если он есть
- Очистка корзины: корзина клиента очищается
- Уведомления: отправка письма с подтверждением заказа (fire-and-forget)
Формирование счетов
Каждый счет получает уникальный последовательный номер благодаря атомарному SELECT...FOR UPDATE на счетчике номеров счетов. Счет содержит: данные магазина, данные клиента, позиции с ценами, промежуточный итог, доставку, скидку и итоговую сумму.
Формат валюты соответствует балканскому стандарту: точка как разделитель тысяч, запятая как десятичный разделитель (например, 7.457,00 RSD).
Подтверждение оплаты
При оплате банковским переводом продавец подтверждает платеж:
POST /api/v1/storefront/merchant/invoices/:id/verify
{
"verified": true,
"notes": "Payment received via bank statement"
}
Подтверждение запускает событие воркфлоу payment_verified и переводит заказ в статус confirmed.
Гостевое оформление и оформление с аккаунтом
- Гость: используется заголовок
X-Cart-Session. Аккаунт не нужен. Клиент указывает email для уведомлений о заказе. - Покупатель с аккаунтом: аутентификация по JWT покупателя. Сохраненные адреса подставляются автоматически. История заказов доступна в аккаунте.