Гроші та округлення
Цілі копійки, лише гривня
Section titled “Цілі копійки, лише гривня”Кожна сума в API, документі замовлення, кнопці підписки та листах — ціле число копійок. 249000 — це 2 490,00 ₴. Валюта одна — UAH; поля валюти немає.
Хто рахує
Section titled “Хто рахує”- Сервер магазину називає
priceкожної позиції (до знижки) уPOST /v1/shop/orders/create. Каталог Neocarts цін не зберігає. - Neocarts рахує
discounted_price,subtotal,totalпозицій іtotalsзамовлення. Саме ці числа йдуть провайдеру оплати. - Віджет грошей не рахує й завжди показує суми із сервера. Єдиний виняток — попередній перегляд ціни на кнопці підписки та в її вікні, порахований за тією ж формулою.
Формула знижки
Section titled “Формула знижки”Знижка 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 може відрізнятися від «відсотка від суми» на кілька копійок. Це очікувано — звіряйте з полями документа, а не перераховуйте самостійно.
Що не входить у total
Section titled “Що не входить у total”Вартість доставки. Neocarts її не знає і не списує; покупець розраховується з перевізником при отриманні.
Переоцінка підписок
Section titled “Переоцінка підписок”PUT /v1/shop/products/{external_id}/price змінює price у підписках, а discounted_price перераховується за тією ж формулою з відсотком, збереженим у кожній підписці. Нова сума діє з наступного списання; уже виставлене й не оплачене замовлення не переоцінюється — під час наступної спроби списання його скасовують і створюють нове. Деталі — у Білінгу.