Вибір покупця
Вибір покупця — це те, що він обрав для кожного товару: разова покупка чи підписка з певною частотою. Кнопки підписки записують його самі, а ваш кошик перетворює його на рядки замовлення одним викликом getOrderItems().
Як працює
Section titled “Як працює”- Покупець додає підписку в кнопці підписки (або ваш перемикач викликає
select()). - Вибір зберігається в браузері покупця для кожного
external_id. Він спільний для всіх сторінок і вкладок. - При натисканні «Оформити» кошик викликає
getOrderItems(lines)— отримує рядки зmodeта інтервалом. - Ваш сервер створює замовлення з цими рядками через
POST /v1/shop/orders/create. - Після успішної оплати віджет очищає вибір.
Кількість і ціна лишаються у вашому кошику — віджет їх не зберігає.
Від кошика до замовлення
Section titled “Від кошика до замовлення”const lines = cart.map((l) => ({ external_id: l.sku, quantity: l.quantity }));
const items = NeocartsSubscription.getOrderItems(lines);// [{ external_id: 'food', quantity: 1, mode: 'subscription', interval_value: 4, interval_unit: 'week' },// { external_id: 'bowl', quantity: 2, mode: 'one_time' }]
const order = await fetch('/api/neocarts/order', { // ваш сервер method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ items }),}).then((r) => r.json());
await NeocartsSubscription.open({ orderId: order.id });getOrderItems() додає до кожного рядка mode, а для підписки — interval_value і interval_unit. Товар без вибору стає one_time. Інші поля рядка не змінюються.
З браузера на ваш сервер ідуть лише external_id, кількість і вибір. Назву, варіант, зображення, посилання й ціну сервер бере зі своєї бази за external_id і збирає з них рядки POST /v1/shop/orders/create. Ціні з браузера не довіряйте.
Методи
Section titled “Методи”| Метод | Опис |
|---|---|
getOrderItems(lines) |
рядки кошика → items для створення замовлення |
select(externalId, selection) |
зберегти вибір для товару |
get(externalId) |
вибір для товару або null |
all() |
усі вибори, ключ — external_id |
remove(id | ids[]) |
забути вибір для товарів |
clear() |
забути все |
subscribe(fn) |
fn(all) при кожній зміні; повертає функцію відписки |
Сигнатури й типи — у JavaScript API.
Формат вибору
Section titled “Формат вибору”| Поле | Тип | Обовʼязкове | Опис |
|---|---|---|---|
mode |
рядок | так | one_time або subscription |
interval_value |
ціле | для subscription |
1–365 (межі магазину). Приклад: 4 |
interval_unit |
рядок | для subscription |
day або week |
NeocartsSubscription.select('food', { mode: 'subscription', interval_value: 2, interval_unit: 'week' });NeocartsSubscription.select('food', { mode: 'one_time' });Невалідний вибір (порожній externalId, невідомий mode, інтервал поза межами магазину) кидає TypeError:
[Neocarts] select(): interval_value must be an integer 1–365, got 400Власний перемикач
Section titled “Власний перемикач”Кнопка підписки покриває вибір частоти повністю. Якщо в кошику потрібен власний перемикач — будуйте його з config().intervals і пишіть у те саме сховище через select(). Кнопки підписки одразу покажуть новий вибір.
const nc = window.NeocartsSubscription;const { intervals } = await nc.config();// intervals.presets: [{ interval_value: 1, interval_unit: 'week' }, ...]// intervals.min, intervals.max, intervals.units
chip.onclick = () => nc.select('food', { mode: 'subscription', ...intervals.presets[1] });oneTime.onclick = () => nc.select('food', { mode: 'one_time' });
// перемальовувати перемикачі з єдиного джерелаnc.subscribe((all) => renderPickers(all));Повний перелік значень — у Переліках значень.