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

Вибір покупця

Вибір покупця — це те, що він обрав для кожного товару: разова покупка чи підписка з певною частотою. Кнопки підписки записують його самі, а ваш кошик перетворює його на рядки замовлення одним викликом getOrderItems().

  1. Покупець додає підписку в кнопці підписки (або ваш перемикач викликає select()).
  2. Вибір зберігається в браузері покупця для кожного external_id. Він спільний для всіх сторінок і вкладок.
  3. При натисканні «Оформити» кошик викликає getOrderItems(lines) — отримує рядки з mode та інтервалом.
  4. Ваш сервер створює замовлення з цими рядками через POST /v1/shop/orders/create.
  5. Після успішної оплати віджет очищає вибір.

Кількість і ціна лишаються у вашому кошику — віджет їх не зберігає.

Від кошика до замовлення

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. Ціні з браузера не довіряйте.

Метод Опис
getOrderItems(lines) рядки кошика → items для створення замовлення
select(externalId, selection) зберегти вибір для товару
get(externalId) вибір для товару або null
all() усі вибори, ключ — external_id
remove(id | ids[]) забути вибір для товарів
clear() забути все
subscribe(fn) fn(all) при кожній зміні; повертає функцію відписки

Сигнатури й типи — у JavaScript API.

Поле Тип Обовʼязкове Опис
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

Кнопка підписки покриває вибір частоти повністю. Якщо в кошику потрібен власний перемикач — будуйте його з 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));

Повний перелік значень — у Переліках значень.