|
||
---|---|---|
.. | ||
client.md | ||
company.md | ||
correction_info.md | ||
documents.md | ||
items.md | ||
kkt.md | ||
monitoring.md | ||
payments.md | ||
readme.md | ||
vats.md |
Документация к библиотеке
Общий алгоритм
- Задать настройки ККТ
- Собрать данные о покупателе
- Собрать данные о продавце
- Собрать данные о предметах расчёта (товары, услуги и пр.)
- Создать документ, добавив в него покупателя, продавца и предметы расчёта
- Отправить документ на регистрацию:
6.1. Необязательно: задатьcallback_url
, на который АТОЛ отправит HTTP POST о состоянии документа. - Запомнить
uuid
из пришедшего ответа, поскольку он пригодится для последующей проверки статуса фискализации.Если с документом был передан
callback_url
, то ответ придёт на этот самый URL.
Если с документом НЕ был переданcallback_url
либо callback от АТОЛа не пришёл в течение 300 секунд (5 минут), нужно запрашивать вручную поuuid
, пришедшему от АТОЛа в ответ на регистрацию документа. - Проверить состояние документа:
8.1. взятьuuid
ответа, полученного на запрос фискализации;
8.2. отправить его в запросе состояния документа.Данные о документе можно получить только в течение 32 суток после успешной фискализации.
В зависимости от специфики бизнеса, в документах можно/нужно передавать также и другую информацию. Подробности в документациях и исходниках.
Об отправке электронного чека покупателю
После успешной фискализации документа покупатель автоматически получит уведомление от ОФД, который используется в связке с вашей ККТ:
- по email, если в документе указан email клиента;
- по смс:
- если в документе указан номер телефона клиента;
- если на стороне ОФД необходима и подключена услуга СМС-информирования (уточняйте подробности о своего ОФД).
Если заданы email и телефон, то ОФД отдаёт приоритет email.
Подготовка документа
- Работа с клиентами (покупателями)
- Работа с компанией (продавцом)
- Работа с оплатами
- Работа со ставками НДС
- Работа с предметами расчёта
- Работа с данными коррекции
- Работа с документами
- Работа с ККТ
- Мониторинг ККТ
Если вы нашли опечатку или какое-то несоответствие — делайте pull-request.