Dotykacka — касова система (POS) для магазинів, кав'ярень і закладів; поширена в Чехії, Словаччині та Польщі. Якщо у вас є офлайн-точка на цій касі, продажі там живуть окремо від інтернет-каталогу: каса знає, що продано, а облік — ні. Elbuz закриває цей розрив у два боки: забирає з каси оплачені чеки й покупців, а назад вивантажує категорії й товари, щоб на касі був той самий асортимент, що й у каталозі.
Це не маркетплейс, тому загальний огляд імпорту замовлень через API тут допоможе лише частково — механіка каси відчутно своя, і саме про неї ця стаття.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «dotykacka.pl (POS)». Файл не потрібен. У картці «Підключення» заповнюються два поля:
| Поле | Що вписати |
|---|---|
| ID інстанса | Номер вашої хмари Dotykacka (cloud ID). Його видно в адресі кабінету після /cloud/ |
| Токен | Refresh-токен доступу до API, створений у кабінеті Dotykacka |
Dotykacka видає довгоживучий refresh-токен, який сам по собі запитів не робить: ним отримують короткий робочий доступ. Elbuz робить цей обмін автоматично перед кожною операцією — тому в шаблоні зберігається саме refresh-токен, і жодних щоденних продовжень від вас не потрібно.
Документація каси: Dotykacka API. Токен створюється в кабінеті хмари, в розділі налаштувань доступу до API.
1
Поле «Токен»2
Поле «ID інстанса (api_instance_id)»- Токен — refresh-токен каси, який видає Dotykacka.
- ID інстанса (api_instance_id) — номер хмари каси.
Які чеки забираються
Elbuz бере з каси тільки оплачені продажні чеки. Усе інше — чернетки, службові документи, неоплачені рахунки — пропускається: у облік має потрапляти факт продажу, а не проміжні стани касової зміни.
При регулярних запусках забираються чеки, створені після минулого завантаження, з запасом у дванадцять годин назад — на випадок розбіжності годинників і затримок синхронізації каси з хмарою. Уже завантажені документи при цьому не дублюються.
Один чек — три документи
Це головна відмінність каси від маркетплейсу, і зрозуміти її варто до першого запуску. Продаж на касі — подія, у якої три різні наслідки для обліку: товар пішов зі складу, гроші прийшли в касу, продаж треба порахувати у виторзі. Тому з кожного чека Elbuz створює три документи:
| Документ | Навіщо |
|---|---|
| Видаткова накладна | Списання проданого товару зі складу |
| Прибутковий ордер | Облік грошей, що надійшли за чеком |
| Замовлення покупця | Облік самого продажу: виторг, позиції, покупець |
Усі три посилаються на один і той самий чек, тож зв'язок між ними видно завжди. Не лякайтеся, побачивши після першого завантаження втричі більше документів, ніж було чеків, — так і має бути.
Позиції й товари
З кожного рядка чека беруться назва, кількість, ціна з ПДВ, сума рядка, відсоток знижки, одиниця виміру й категорія товару з каси. Остання деталь важливіша, ніж здається: більшість маркетплейсів категорію не передають, і невідомі товари лягають у службову категорію. Каса категорію передає — тому товар, якого ще немає в каталозі, створюється в правильній категорії, а не в загальній купі.
Перед першим завантаженням звірте назви категорій на касі з деревом каталогу. Збіг назв означає, що товари з каси одразу ляжуть у ваші категорії й не доведеться потім перетягувати їх вручну.
Види оплати
Каса передає спосіб оплати кодом, і Elbuz розкладає основні в свої види оплат:
| Оплата на касі | Вид оплати в Elbuz |
|---|---|
| готівка | Готівка |
| платіжна картка | Банківська картка |
| банківський переказ | Банківський переказ |
| онлайн-оплата | Онлайн-оплата |
Крім них Dotykacka знає ще з пів сотні способів — талони на харчування, подарункові сертифікати, QR-код, а також оплати від служб доставки їжі (Glovo, Bolt Food, Wolt, Foodora та інших). Їхні назви Elbuz зберігає в документі як є, тож у звітах видно, звідки прийшли гроші, навіть якщо окремого виду оплати під це у вас немає. Статус оплати в усіх випадках — «Оплачено»: чек оплачений за визначенням.
Покупці з каси
Перед чеками Elbuz забирає картотеку покупців каси — тих, кого на касі заводять для знижок і програм лояльності. Приходять ім'я та прізвище, телефон, пошта, адреса, індекс, країна, місто, дата народження, накопичені бали й примітка.
Заводяться при цьому тільки нові покупці. Elbuz звіряє картотеку каси зі своєю базою контрагентів за трьома ознаками: за ідентифікатором покупця в касі, за телефоном і за поштою — причому пошта порівнюється в канонічному вигляді, тож адреси на кшталт ivan.petrov+shop@gmail.com і ivanpetrov@gmail.com впізнаються як одна. Це важливо для точки, де один і той самий клієнт купує і в залі, і на сайті: дубль контрагента не з'явиться.
Номери з каси нормалізуються: дев'ять цифр без коду країни отримують польський код 48. Зроблено це під основний сценарій — торгову точку в Польщі. Якщо ваші покупці мають номери інших країн, вписуйте їх на касі повністю, з кодом країни: так вони збережуться без змін і коректно зіставляться з наявними контрагентами.
Зворотний бік: товари з Elbuz у касу
Окремим шаблоном вивантаження типу «dotykacka.pl» Elbuz заводить на касі категорії й товари з вашого каталогу. Працює це так: спершу їдуть категорії, потім товари; нове створюється, наявне оновлюється. Зв'язок Elbuz запам'ятовує, тож повторне вивантаження не плодить дублікатів на касі.
Кілька особливостей, які варто знати:
- Ціна рахується у двох варіантах. Каса зберігає ціну з ПДВ і без ПДВ окремо, тому Elbuz за ставкою податку товару обчислює ціну без ПДВ сам.
- Одиниці виміру приводяться до переліку каси. Dotykacka приймає лише свій закритий список одиниць (штука, кілограм, літр, метр і так далі); ваші позначення зіставляються з ним, а все нерозпізнане стає штукою.
- Пачками по сто. І категорії, і товари відправляються блоками, тож великий каталог іде передбачувано, без перевантаження каси.
Навіщо зводити касу в Elbuz
Офлайн-точка й інтернет-магазин майже завжди торгують тим самим товаром з того самого складу. Поки каса живе окремо, залишок доводиться звіряти вручну, а виторг точки бачити тільки у звітах каси. Коли продажі приїжджають у Elbuz, картина складається: товар списується зі складу тим самим механізмом, що й інтернет-замовлення, гроші лягають у касові документи, а покупець із зали потрапляє в ту саму базу контрагентів, що й покупець із сайту — з історією покупок в обох каналах.
Часті питання
Де взяти ID інстанса й токен Dotykacka?
ID інстанса — це номер вашої хмари, він видно в адресі кабінету після /cloud/. Токен створюється в кабінеті хмари, в розділі доступу до API: це refresh-токен, з якого Elbuz сам отримує робочий доступ перед кожною операцією.
Чому з одного чека створюються три документи?
Тому що продаж на касі має три наслідки для обліку: товар списується зі складу (видаткова накладна), гроші надходять (прибутковий ордер) і продаж рахується у виторзі (замовлення покупця). Усі три документи посилаються на один чек, тож зв'язок між ними видно завжди.
Чому завантажилися не всі чеки?
Elbuz забирає тільки оплачені продажні чеки. Чернетки, службові документи й неоплачені рахунки пропускаються навмисно: в облік має потрапляти факт продажу. Також при регулярному запуску береться період від минулого завантаження з запасом у дванадцять годин, а не вся історія каси.
Чи створюються товари з каси в правильній категорії?
Так, на відміну від маркетплейсів каса передає категорію позиції, тому новий товар створюється саме в ній. Щоб він одразу ліг у ваше дерево, звірте назви категорій на касі з каталогом.
Чи можна віддати товари з Elbuz на касу?
Так, для цього заводиться окремий шаблон вивантаження типу dotykacka.pl: спершу їдуть категорії, потім товари, наявне оновлюється, нове створюється. Ціну без ПДВ Elbuz рахує сам за ставкою податку, а одиниці виміру зіставляє з закритим переліком каси.