Перейти до вмісту

Гроші та округлення

Цілі копійки, лише гривня

Section titled “Цілі копійки, лише гривня”

Кожна сума в API, документі замовлення, кнопці підписки та листах — ціле число копійок. 249000 — це 2 490,00 ₴. Валюта одна — UAH; поля валюти немає.

  • Сервер магазину називає price кожної позиції (до знижки) у POST /v1/shop/orders/create. Каталог Neocarts цін не зберігає.
  • Neocarts рахує discounted_price, subtotal, total позицій і totals замовлення. Саме ці числа йдуть провайдеру оплати.
  • Віджет грошей не рахує й завжди показує суми із сервера. Єдиний виняток — попередній перегляд ціни на кнопці підписки та в її вікні, порахований за тією ж формулою.

Знижка discount_percent — ціле число 0–100 з налаштувань магазину (порожнє поле = знижки немає). Вона копіюється в замовлення в момент створення й далі в підписку; пізніша зміна налаштування не змінює відкриті замовлення.

discounted_price = round(price × (100 − discount_percent) / 100)

Округлення — до цілої копійки за одиницю товару, половина — вгору. Застосовується лише до позицій mode = subscription; для one_time discounted_price = price.

Приклад: 249000 при 7 % → 249000 × 93 / 100 = 231570 (2 315,70 ₴).

Приклад з округленням: 99999 при 7 % → 92999,07 → 92999.

Суми позиції й замовлення

Section titled “Суми позиції й замовлення”
Поле Формула
items[].subtotal price × quantity
items[].total discounted_price × quantity
totals.items_total Σ subtotal
totals.total Σ total — списується сьогодні
totals.discount_total items_total − total

Знижка округлюється за одиницю, а потім множиться на кількість, тому discount_total може відрізнятися від «відсотка від суми» на кілька копійок. Це очікувано — звіряйте з полями документа, а не перераховуйте самостійно.

Вартість доставки. Neocarts її не знає і не списує; покупець розраховується з перевізником при отриманні.

PUT /v1/shop/products/{external_id}/price змінює price у підписках, а discounted_price перераховується за тією ж формулою з відсотком, збереженим у кожній підписці. Нова сума діє з наступного списання; уже виставлене й не оплачене замовлення не переоцінюється — під час наступної спроби списання його скасовують і створюють нове. Деталі — у Білінгу.