DigitalKassa: чеки 54-ФЗ для сайта детского сада
После каждой онлайн-оплаты сайт отправляет чек в DigitalKassa по API v2.1. DigitalKassa передаёт его кассе и в ОФД и отправляет родителю на почту или телефон, а сайт забирает результат.
- Что вписать в админке
- actor_id, токен и номер группы касс
- API
- v2.1, номер чека выбирает сайт
- Ответ кассы
- 200 — чек пробит, 202 — в очереди
- С какими банками
- С любым из пяти
Как подключить DigitalKassa
Три значения из личного кабинета DigitalKassa. На снимке выше они вымышленные.
-
Ключи API
Личный кабинет DigitalKassa, раздел API: actor_id и токен. Там же номер группы касс (c_group_id).
-
Настройки → Чеки 54-ФЗ
«Кто пробивает чек» — «Чек пробивает отдельная онлайн-касса», онлайн-касса — DigitalKassa, дальше actor_id, токен и номер группы.
В админке: Кто пробивает чек Онлайн-касса actor_id Токен Номер группы касс
-
Налоги и название
Систему налогообложения, НДС и признак расчёта выбирает бухгалтер, начало названия услуги — тоже.
В админке: Система налогообложения НДС Признак расчёта Начало названия в чеке
-
Проверить кассу
Сайт запрашивает группу касс по номеру. Если actor_id и токен верны и группа есть, DigitalKassa её отдаёт, и сайт пишет, что ключи приняты.
В админке: Проверить кассу
Как чек уходит в ОФД и к родителю
Чек создаётся по адресу группы касс, результат сайт забирает по тому же адресу.
Оплата подтверждена
Чек встаёт в очередь сразу после оплаты.
Чек в группу касс
Сайт создаёт чек в группе касс под своим номером, у каждой попытки он новый. В чеке позиция «услуга», мера количества, НДС, способ расчёта, признак интернет-расчёта и место расчётов — адрес сайта.
Ответ
200 или 201 — чек пробит, 202 — чек в очереди, и сайт заберёт результат позже.
Родителю
DigitalKassa отправляет чек на почту родителя или на телефон, если почты нет. Ссылка на чек сохраняется у счёта.
Ошибка
Описание ошибки от DigitalKassa видно у счёта. Сайт повторяет отправку и после восьми неудач пишет сотрудникам.
Когда касса удобнее чека от банка
- Касса уже в DigitalKassa
- Если касса сада уже подключена в DigitalKassa, сайт отправляет чеки в её группу касс.
- Любой банк
- DigitalKassa пробивает чеки по оплатам через Т-Банк, ЮKassa, CloudPayments, Robokassa и Точку: касса от банка не зависит.
- Статус чека
- Статус и ошибка каждого чека видны у счёта, чек с ошибкой отправляется ещё раз кнопкой «Чек ещё раз».
- Когда проще банк
- Если банк сада сам пробивает чеки, отдельная касса не нужна: выберите «Чек пробивает банк». Банки
Частые вопросы
Не нашли ответ — напишите нам.
Где взять actor_id и токен?
В личном кабинете DigitalKassa, в разделе API. Номер группы касс (c_group_id) — там же.
Что значит «чек в очереди»?
DigitalKassa ответила 202: чек принят, но ещё не пробит. Сайт сам спросит результат через несколько минут.
Какой ФФД?
DigitalKassa переводит чек в формат ФФД своей кассы сама. Сайт передаёт в позиции меру количества — тег 2108, который требует ФФД 1.2.
Попадут ли в кассу наличные?
Нет. Касса сайта получает чеки только по онлайн-оплатам, наличные и переводы, внесённые вручную, в неё не уходят.
DigitalKassa для детского сада и центра
DigitalKassa берёт на себя работу с кассами: держит очередь чеков, распределяет нагрузку, передаёт чеки в ОФД. Сайту сада остаётся отправить чек и забрать результат. Подключение — три значения из личного кабинета: actor_id, токен и номер группы касс.
Номер чека выбирает сайт
Чек создаётся по адресу группы касс с номером в конце, и номер придумывает сам сайт: из номера счёта и номера попытки. По этому же адресу сайт потом узнаёт, пробит ли чек, отдельный идентификатор от кассы ему не нужен. У повторной попытки номер новый.
Что уходит в чек
Чек прихода с системой налогообложения из настроек, признаком интернет-расчёта и местом расчётов — адресом сайта сада. Позиция одна: услуга на сумму оплаты с мерой количества «штуки», ставкой НДС и способом расчёта. Если у семьи есть почта, чек уходит на неё, если нет — на телефон. Название услуги складывается из начала, которое задал бухгалтер, и назначения счёта.
Ответы и ошибки
Ответ 200 или 201 значит, что чек уже пробит, 202 — что он в очереди. На ошибку DigitalKassa отвечает описанием, и сайт показывает его у счёта в «Онлайн-оплатах». Пока сервис недоступен, сайт ждёт и спрашивает снова, а через двое суток без ответа пишет сотрудникам.
Кассу выбирают в «Чеках 54-ФЗ», и она работает с любым банком из подключённых к сайту. Сменить банк можно, не трогая настройки чеков. Наличные и переводы, внесённые вручную, в DigitalKassa не уходят: касса сайта видит только онлайн-оплаты.
Проверка и ссылка на чек
Кнопка «Проверить кассу» запрашивает группу касс по номеру из настроек. Если actor_id или токен неверны, DigitalKassa отказывает, если группы нет, сайт так и пишет. Ссылка на пробитый чек, если DigitalKassa её вернула, сохраняется у счёта: её видят сотрудники в «Онлайн-оплатах» и родитель в истории оплат.
Другие банки, кассы и переводы
Нет вашего банка или кассы?
Напишите — добавим в ближайшем обновлении. Укажите банк или сервис касс и что у сада уже подключено: эквайринг, касса, ОФД.
Написать намОплатите счёт в демо
В демо включена тестовая оплата. Войдите в кабинет родителя, нажмите «Оплатить» — деньги не спишутся — и найдите оплату в админке, в разделе «Онлайн-оплаты». Настройки банков и касс в демо открыты для просмотра.
