Работа с ATOL Web-сервер через API

30.01.21

Интеграция - ККМ

Внешняя обработка на управляемых формах предназначена для тестирования, а так же обслуживания ККТ ATOL через API Web-сервера. Включает примеры: Открытия и закрытие смены Получения информации об оборудовании Очереди печати Результата выполнения задания Печать чека Х-отчет Информация о кассовой смене Пример пробития чека для документа конфигурации УТ 11 с записью в регистр "ФискальныеОперации" Позволяет готовый модуль из обработки внедрить в конфигурацию и обращаться к нему.

Скачать файлы

Наименование Файл Версия Размер
Работа с ATOL Web-сервер через API:
.epf 17,13Kb
28
.epf 1.01 17,13Kb 28 Скачать

Внешняя обработка на управляемых формах, разрабатывалась на платформе 1С 8.3.16. Тестировалась на конфигурации УТ 11.4.13.

Драйвер ATOL 10.8.0.0

С некоторых пор появилась возможность установить Web-сервер ATOL в месте с драйвером. Это дало отличную возможность работать с ККТ через достаточно простое API.

После установки драйверов открыть веб сервис можно по адресу:

http://127.0.0.1:16732/#/devices

 

 

Веб-сервер необязательно должен быть установлен локально, может быть установлен на любой сервер в сети. Как и кассы могут быть подключены прост ок сети, т.е. к компьютеру их нужно подключать один раз для настройки IP адреса.

Чтобы тестировать ККТ, достаточно иметь кассу без фискального накопителя.

Первое подключение производится через USB шнур, затем в настройках драйвера настраивается IP адрес кассы.

 

Для разработки универсального механизма я подготовил обработку, на которой разрабатывал и тестировал API. 

 

 

Все функции для работы с веб-сервером вынесены в модуль обработки.

Обращение к модулю происходит следующим образом:

 

	_АТОЛСревер= РеквизитФормыВЗначение("Объект");
	ПараметрыПодключения= _АТОЛСревер.ПолучитьПараметрыСоединения(Адрес, Порт, , , Ложь, ИДУстройства);
	ПараметрыАТОЛ= _АТОЛСревер.ШаблонПараметровАТОЛ();
	ПараметрыАТОЛ.ПараметрыПодключения= ПараметрыПодключения;
	ПараметрыАТОЛ.НеПечататьЧек= НеПечататьЧек;

	Ответ= _АТОЛСревер.ОткрытьСмену(ПараметрыАТОЛ);
	ТекстОтвета= Ответ.ТекстСообщения;

 

Модуль подготовлен для внедрения в свою конфигурацию, его достаточно перенести в конфигурацию с названием "_АТОЛСревер" и изменить вызовы в форме.

По всем функциям передается структура "ПараметрыАТОЛ", внутри которой содержатся параметры подключения, так и другие необходимые для пробития чека параметры.

Параметр "НеПечататьЧек" позволяет отключить печать чека на ленту, будет отправляться в ОФД.

 

Обратите внимание, в обработке есть 2 кнопки:

"Пробить чек" - по этой кнопке будет пробит чеку по документу указанному в поле "Документ продажи" (например Чек ККТ или Реализация товаров).

"Пробить чек УТ 11" - по этой кнопке будет другой механизм, чек будет пробит по документу из поля "Документ оплаты" (ПКО или Экваринговая операция), а товар взят из "Документа продажи". При этом будет осуществлена запись в регистр "РегистрыСведений.ФискальныеОперации" и получен QR-код. Это реальный пример работы (работать будет только если ККТ зарегистрирована и имеет фискальный накопитель, т.е. в боевом режиме. Без ФН не доступны нужные фискальные параметры в ответе).

 

Документация по API доступна по ссылке:

https://app.swaggerhub.com/apis-docs/atol-dev/fptr-web-server/10.8.0.0#/

 

Когда я начинал разрабатывать, хороших примеров реализации не было. Надеюсь, эта обработка сэкономит кому-нибудь время.

ATOL ATOL-web АТОЛ АТОЛ-веб сервер

См. также

ККТ-ОНЛАЙН 54-ФЗ: Обработка для работы онлайн касс АТОЛ, ШТРИХ, VIKI PRINT и т.д. МАРКИРОВКА + ЭКВАЙРИНГ + БЕСПЛАТНЫЙ ДЕМО

ККМ Кассовые операции Розничная торговля Платформа 1С v8.3 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Розница 2 1С:Управление производственным предприятием 1С:Бухгалтерия государственного учреждения 1С:Бухгалтерия 1.6 1С:Бухгалтерия автономного учреждения 1С:CRM ПРОФ, КОРП Россия Платные (руб)

Универсальная обработка для обслуживания любых фискальных регистраторов (ККТ), в том числе Веб сервер АТОЛ. Работает в соответствии с 54-ФЗ. (ФФД 1.0, ФФД 1.05, ФФД 1.1). Подключайте любую онлайн кассу к практически любой конфигурации. Нет необходимости обновлять 1С. Можно бесплатно скачать и протестировать. Может работать одновременно с несколькими онлайн-кассами, либо одной с разных рабочих мест. (через RDP, TCP\IP или веб-сервер) Позволяет разделить один чек сразу на несколько ККТ или на несколько систем налогообложения. Можно настроить собственный шаблонов чека. Можно использовать эквайринг там, где он не поддерживается. Работает на LINUX и Windows ЭМУЛЯТОР + ЭКВАЙРИНГ + МАРКИРОВКА + ПОДДЕРЖКА ФФД 1.2

4800 руб.

27.02.2017    761709    4659    9495    

2780

54-ФЗ. Очередь печати для ККМ. Обработки для подключения онлайн-касс к 1С 8 (поддержка Маркировки) + Эмулятор + ФФД 1.2

ККМ Кассовые операции Розничная торговля Платформа 1С v8.3 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Розница 2 1С:Управление производственным предприятием 1С:Бухгалтерия государственного учреждения 1С:Бухгалтерия автономного учреждения Россия Платные (руб)

Обработка осуществляет обслуживание ККТ АТОЛ, Штрих и Меркурий для конфигураций "УТ 10.3", "КА 1.1", "УПП 1.3", "Розница 1.0", "БП 2.0" и других отраслевых решений, построенных на основе указанных выше конфигурациях. Поддерживает возможность параллельно пробития чеков на одной ККМ несколькими пользователями. Поддерживает Веб-сервер Атол. Соответствует требованиям 54-ФЗ. Поддерживает ФФД 1.0, 1.05, 1.1 и 1.2. Разделяет чеки по нескольким СНО. Поддерживает механизмы подключения ККТ по TCP/IP, для работы через RDP или интернет. Поддержка маркировки.

5400 руб.

25.05.2015    315963    1839    3007    

990

Печать кассовых чеков на одну ККМ с нескольких рабочих мест для 1С:УТ11.х, КА2.х, Розница 2.х, УНФ, ERP 2.х, БП 3, БГУ2

ККМ Кассовые операции Розничная торговля Обмен с ГосИС Бухгалтерский учет Оперативный учет Управляемые формы 1С:Розница 2 1С:Управление нашей фирмой 1.6 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Платные (руб)

Расширение конфигурации для УТ 11.4, 11.5, КА 2.4, 2.5, Розница 3.0, 2.3 и 2.2, УНФ 1.6, УНФ 3x, ERP 2.4, 2.5, БП 3, БГУ2 (Управляемые формы) позволяет выполнять печать кассовых чеков на одну ККМ 54-ФЗ с нескольких рабочих мест. НИКАКИХ НАСТРОЕК В РАЗРАБОТКЕ - ПОДКЛЮЧИЛ И ПЕЧАТАЙ. Если у вас несколько отделов и одна ККМ - печатайте на одной ККМ! Если у вас две ККМ и одна поломалась - печатайте на одной ККМ, пока ремонтируете другую!

4000 руб.

27.08.2018    115583    973    562    

826

Обработка 1С для печати чеков на кассе ККТ АТОЛ.ОНЛАЙН

ККМ Платформа 1С v8.3 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Розница 2 1С:Управление нашей фирмой 1.6 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Россия Платные (руб)

Печать чеков по документам 1С РеализацияТоваров (РасходнаяНакладная), КорректировкаРеализации, СчетНаОплату, ЗаказКлиента, ЧекККМ, ПоступлениеНаРС. Соответствует требованиям 54-ФЗ. Одна облачная касса может использоваться всеми подразделениями организации, без привязки к рабочим местам. Электронные чеки отправляются на email клиента и всегда доступны в 1С, по требованию можно распечатать. Легкая настройка: после регистрации кассы на сайте АТОЛ.ОНЛАЙН, в обработке необходимо указать логин, пароль и идентификатор группы ККТ (берутся в личном кабинете АТОЛ.ОНЛАЙН). Одну кассу можно использовать с 1С при расчетах с физ. и юр. лицами и для интернет-магазина. HTTPS протокол интеграции API v4 / ФФД 1.05 или API v5 / ФФД 1.2.

21600 руб.

23.08.2022    10465    27    4    

22

Интеграция Альфа Авто 5 / Альфа Авто 6 и AUTOCRM / Инфотек

Сайты и интернет-магазины WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме. Без существенных изменений типовой конфигурации. Проверено с брендами: Интеграция 1С и GEELY Интеграция 1С и HAVAL Интеграция 1С и KIA Интеграция 1С и FORD Интеграция 1С и LADA ГАРАНТИЯ 100% ВНЕДРЕНИЯ!

36000 руб.

03.08.2020    15655    9    17    

9
Комментарии
В избранное Подписаться на ответы Сортировка: Древо развёрнутое
Свернуть все
1. skyboy13 13 03.02.21 10:40 Сейчас в теме
А если все кассы сетевые, то драйвер можно поставить на виртуалку и чеки бить через него. Даже на клиентах ставить ни чего не надо.
2. opus70 73 18.04.21 17:50 Сейчас в теме
поддержку маркировки заказать можно для ШИН и сигарет
3. opus70 73 19.04.21 07:59 Сейчас в теме
может кто сталкивался

Функция ПробитьЧек(ПараметрыАТОЛ) Экспорт
УИД= XMLСтрока(ПараметрыАТОЛ.ДокументПродажи); //вот так не работает не хочет принимать сервер задания


УИД =любое число; //работает отлично


в документации не нашол ограничения ни по длине ни по типу
к примеру
{
"uuid": "0ba40014-5fa5-11ea-b5e9-037d4786a49d",
"request": [
{
"type": "openShift",
"operator": {
"name": "Иванов",
"vatin": "123654789507"
}
}
]
}
взято вот тут https://app.swaggerhub.com/apis-docs/atol-dev/fptr-web-server/10.8.0.0#/%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D1%8B%20%D0%B8%D0%BD%D­1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8%20%D0%BE%20%D­0%9A%D0%9A%D0%A2/post_api_v2_operations_queryDeviceInfo

видно что УИД может принимать длинную стоку
но в моем случае не принимает
4. FreeArcher 158 06.05.21 04:49 Сейчас в теме
(3) Я передою так же в качестве уид ссылку на документ и проблем не было у меня.
5. user1673056 01.10.21 15:22 Сейчас в теме
Добрый день, подскажите, пожалуйста, будет ли/возникнут ли сложности, с работой данной обработки и БП, касса будет использоваться Атол 42ФС
6. FreeArcher 158 03.10.21 18:14 Сейчас в теме
(5) Сам принцип не зависит от конфигурации. У нас сейчас через этот механизм даже чеки с интернет-магазина пробиваются.
7. untru 13 02.11.21 22:54 Сейчас в теме
Может кому то сильно сэкономлю время, но с драйвером 10.9.х и 10.10.х веб вервер не работает, хоть и визуально все хорошо, но устройства тупо в статусе недоступны, работает только на 10.8
8. FreeArcher 158 03.11.21 07:18 Сейчас в теме
(7) Значит поменялось API. Мы пока не обновляли.
Спасибо за информацию.
9. untru 13 07.11.21 11:46 Сейчас в теме
(8)Да нет, там вопрос не в апи в том что в интерфейсе устройства недоступны
Прикрепленные файлы:
10. aximo 2027 22.04.22 20:10 Сейчас в теме
товарищи, может кто-то сталкивался :

Атол 10.9.2

поднят веб сервер - подключена касса (проверку по запросам проходит). Но, почему-то не печатает открытие смены и закрытие, а x-отчет печатает.
Ошибок нет. Может, в настройках запроса что-то должно быть?
11. user1265542 05.01.23 17:07 Сейчас в теме
Здравствуйте. Подскажите, пожалуйста, где ид устройства взять?
12. FreeArcher 158 26.01.23 15:19 Сейчас в теме
(11) В драйвере при проверке подключения вроде был.
13. west__ 13 17.07.23 15:13 Сейчас в теме
Здравствуйте, а купить за деньги можно? Стартмани кончились..
15. FreeArcher 158 17.07.23 16:17 Сейчас в теме
(13) Так можно купить старт мани, тоже самое будет.
14. west__ 13 17.07.23 15:14 Сейчас в теме
Оставьте свое сообщение