ДокументацияОформление заказа и счета

Оформление заказа и счета

5 минПоследнее обновление: 2026-03-31

Атомарное оформление заказа

Все оформление заказа выполняется в одной транзакции базы данных. Если какой-либо шаг завершается ошибкой, все изменения откатываются, и частично созданных заказов не бывает:

  1. Проверка корзины: все позиции по-прежнему доступны, цены совпадают
  2. Проверка остатков: товара достаточно для всех позиций
  3. Адреса: проверка платежного адреса и адреса доставки
  4. Доставка: расчет стоимости доставки по зоне и весу
  5. Резервирование товара: атомарное уменьшение остатка (SELECT...FOR UPDATE)
  6. Создание заказа: формирование заказа с позициями и итоговыми суммами
  7. Формирование счета: создание счета с уникальным последовательным номером
  8. Генерация PDF: формирование счета в виде PDF для скачивания
  9. Применение скидки: учет использования промокода, если он есть
  10. Очистка корзины: корзина клиента очищается
  11. Уведомления: отправка письма с подтверждением заказа (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 покупателя. Сохраненные адреса подставляются автоматически. История заказов доступна в аккаунте.

Была ли эта статья полезна?