Связь с кассой, API и перенос базы

Всё, что связывает программу с чужими системами, живёт в разделе «Интеграции». В нём пять вкладок — в порядке работы: сначала ключ, потом то, что с ним делают.

Ключи API

Ключ — это пароль для программы, а не для человека: с ним касса или сайт проводит чеки, находит карты гостей и заводит новых от имени заведения. На вкладке две части.

• «Для своей интеграции» — касса, товароучёт или собственный код, который ходит в открытый API. Впишите «Название ключа» (например, «Касса на Тверской») и нажмите «Создать ключ». Один ключ — на одну программу: так видно, кто что сделал, и отозвать можно одну, не трогая остальные. Открытый API доступен с тарифа «Про»; на младших вместо формы стоит замок с названием нужного тарифа.
• Ключ для интернет-магазина выдаётся на любом тарифе, включая бесплатный, но кнопка появляется, только если прийти по ссылке из настроек плагина Shop-Script или модуля 1С-Битрикс: «Создать ключ для магазина» или «Создать ключ для сайта на Битриксе». Без этой ссылки на том же месте рассказано о Shop-Script и стоит кнопка «Открыть магазин на Shop-Script».

Выпущенные ключи

Список всех ключей заведения. У каждого — название, начало ключа (по нему его узнают в настройках кассы) и дата последнего использования либо «ещё не использовался». У ключей плагина Shop-Script рядом виден адрес магазина, который им ходит: чужой адрес здесь — повод отозвать ключ.

Кнопка «Отозвать» спрашивает подтверждение, и после него ключ перестаёт работать сразу — касса или сайт, которые им пользовались, больше не смогут проводить чеки. Отозванный ключ не восстанавливается, только выдаётся новый.

Вебхуки

Вебхук — это уведомление о событии, которое «Снова» сама отправляет на адрес вашей системы: CRM, склада, аналитики. Так ей не нужно опрашивать нас в цикле. Вебхуки доступны с тарифа «Про».

• Впишите «Адрес», отметьте события и нажмите «Добавить вебхук». События на выбор: чек проведён, возврат покупки, гость получил карту, карта сохранена в телефон, гость сменил уровень, баллы сгорели, баллы поправлены вручную.
• После добавления один раз показывается секрет: им ваша система проверяет подпись каждого запроса и убеждается, что он пришёл от нас.
• Кнопка «Доставки» у вебхука показывает последние отправки: доставлено и с каким ответом, ждёт в очереди или почему не дошло — «адрес не отвечает», «адрес не ответил вовремя», код ответа сервера.
• Неудачная отправка повторяется с растущей паузой — всего до восьми попыток за два с небольшим часа: если ваш сервер полежал полчаса, события не потеряются.

Формат запросов и проверка подписи — на странице «Вебхуки».

Перенос базы

Если программа лояльности уже была, гостей и их баллы можно перенести файлом CSV. Перенос идёт в два шага: сначала «Снова» показывает, что распознала, и только потом заводит гостей.

1. Выгрузите базу из прежней системы в CSV. Нужна колонка с телефоном — «телефон» или «phone». Имя, фамилию, почту, дату рождения и баланс «Снова» подхватит, если они есть (колонки «имя», «фамилия», «почта», «дата рождения», «баланс», «баллы» или «бонусы»). Разделитель — запятая или точка с запятой — определяется сам, файл до 4 МБ.
2. На вкладке «Перенос базы» нажмите «Выбрать файл». Галочка «Перенести остатки баллов» включена сразу; снимите её, если баллы переносить не нужно.
3. Нажмите «Проверить файл». Экран покажет, сколько гостей распознано и сколько строк с ошибками, первые строки таблицей (телефон, имя, баллы) и причины первых ошибок.
4. Если всё встало на свои места — «Перенести N гостей». В конце — итог: сколько заведено, сколько уже было в базе и сколько пропущено.

Каждому перенесённому гостю сразу заводится карта с его баллами. Чтобы положить её в телефон, гость вводит свой номер на странице выдачи карты — и получает карту, на которой баланс уже есть. Пластик и штрихкоды прежней системы в Wallet не превращаются.

• Сначала заполните реквизиты оператора — название и ИНН в «Настройки → Реквизиты»: без них карты не выдаются, и перенос откажет целиком.
• Лимит карт тарифа действует и здесь: гости сверх него не заведутся и попадут в «пропущено».
• Приветственные баллы перенесённым не начисляются — они уже клиенты, их баллы переносятся отдельно.
• Перенесённые баллы не сгорают: срок начался в прежней системе, и назначить его задним числом нельзя.
• Загрузить тот же файл второй раз безопасно: баланс повторно не начислится.

Кассы и системы

Сверху — вопрос «Чем вы пробиваете чеки?». Отметьте всё, чем пользуетесь: кассу в зале, сайт, свою программу — ниже откроются карточки именно этих систем, с тем, как их подключить. Отметить можно несколько: касса Эвотор и сайт на 1С-Битрикс у одного заведения — обычное дело. Ответ запоминается в этом браузере, поменять его можно в любой момент.

Система, по которой уже шёл обмен, — пришёл чек, касса обратилась к «Снове», ключом пользовались, — отмечена сама, с подписью «Подключено», и её карточка открыта всегда; снять такую отметку нельзя. Выданный, но ещё ни разу не использованный ключ подключением не считается: такую систему отметьте сами. Если кассы у вас нет вовсе, отметьте «Кассы нет»: баллы начисляются на экране «Касса» в кабинете или в приложении «Снова» на телефоне, подключать ничего не нужно.

Эвотор

Смарт-терминал присылает чеки в своё облако, а облако — нам. Ставить что-то на саму кассу не нужно: приложение «Снова» устанавливается в личном кабинете Эвотора, в разделе «Мои приложения». Установка сама заводит компанию в «Снове» и пускает владельца в кабинет без второго пароля.

После установки карточка Эвотора показывает:

• состояние — «Чеки приходят», «Приём чеков выключен вами» или «Приложение отключено», — дату установки и время последнего чека;
• чеки за 30 дней, выручку по кассе и возвраты;
• «Магазины и точки продаж» — у каждого магазина Эвотора выберите вашу точку, и выручка кассы ляжет в отчёт по точкам. Магазины появляются с первым чеком или по кнопке «Обновить список магазинов»;
• «Последние чеки» — продажи и возвраты с суммой, скидкой и магазином.

Кнопка «Перестать принимать чеки» останавливает приём, не удаляя приложение в Эвоторе; вернуть — «Снова принимать чеки». Удалить само приложение можно только в кабинете Эвотора.

МойСклад

Касса МойСклад сама находит гостя по телефону или карте из кошелька, показывает баланс, считает скидку, списывает и начисляет баллы прямо в чеке — наш экран кассы для этого не нужен. Решение ставится из каталога решений МойСклада и привязывается к компании в его окне; в нашем кабинете ничего подключать не нужно. Подробно, со снимками кассы и окна решения, — на отдельной странице.

После подключения карточка показывает состояние связи с кассой, время последнего запроса кассы и последнего чека, чеки за 30 дней — сколько из них прошло через программу, — выручку и возвраты. Ниже — связь точек МойСклада с вашими точками, блок «Код на кассе» (подтверждать кодом номер нового гостя и списание баллов) и последние чеки с пометкой «с картой» или «мимо программы».

Frontol 6 (Атол)

Frontol 6 сам обращается к «Снове» за гостем, потолком списания и скидкой и проводит чек и возврат — без приложения на кассе и без нашего экрана. Нужен тариф Frontol «Полный». В карточке впишите «Название подключения» и нажмите «Выдать подключение»: кабинет покажет адрес сервера и ключ доступа, которые интегратор вписывает в настройки кассы. Как именно и что видно в карточке потом — на отдельной странице.

Интернет-магазин на Shop-Script

Для Webasyst Shop-Script есть бесплатный плагин: оплата баллами в оформлении заказа, начисление за оплаченный заказ, карта в телефон покупателя по галочке, возвраты. Карта одна: баллы, накопленные на сайте, гость тратит у кассы, и наоборот. Ключ плагин попросит сам — ссылкой из своих настроек.

Интернет-магазин на 1С-Битрикс

Для «1С-Битрикс: Управление сайтом» есть бесплатный модуль: та же механика, что у плагина Shop-Script. Скидка баллами идёт штатным правилом корзины, поэтому видна менеджеру в заказе и покупателю в итогах; «Мои баллы» — в личном кабинете. Ставится из Маркетплейса, ключ модуль попросит сам — ссылкой из своих настроек.

Своя касса или программа

Открытый API умеет всё, что умеет экран кассира: провести чек, начислить и списать баллы, найти карту гостя. Так подключаются 1С, самописные кассы и товароучётные программы. Ключ — на вкладке «Ключи API» (с тарифа «Про»), запросы и примеры — в описании API, попробовать без своих данных можно в песочнице.

Частые вопросы