Розділ1: Інтеграція ПЗ та ККТ «АТОЛ» з використанням бібліотек Драйвера ККМ 2
Розділ2: Інтеграція програмного забезпечення з використанням Протоколу обміну команд нижнього рівня. 3
Розділ1: Інтеграція ПЗ та ККТ «АТОЛ» з використанням бібліотек Драйвера ККМ
Підтримка 54-ФЗ реалізована у версіях драйверів, починаючи від 8.10.2.0 для ДТО8 та 9.7.0. для ДТО9.Для інтеграції потрібна наявність дистрибутивів Драйверів ККМ:
"АТОЛ: Драйвер ККМ 8"
Драйвер являє собою зовнішню компоненту для системи «1С:Підприємство» та сервер OLE Automation і ActiveX, що працює під керуванням ОС Windows 2003 x86 / XP x86 / Vista x86 / 7 x86 / 7 x64 / 8 x86 / 8 x64. Він може використовуватися в будь-яких середовищах розробки OLE Automation, що підтримують технологію.
Драйвера торгового обладнання 8 доступні для скачування за посиланням:
Встановлення
Запустити інсталяційний файл DTO _8_12_ Full . exe . Виконати інсталяцію драйвера, дотримуючись інструкцій. Рекомендовано залишити всі значення за промовчанням. У разі запиту системою підтвердження встановлення додаткового програмного забезпечення відповісти ствердно.
Під час інсталяції запуститься програма керування драйверами (за замовчуванням встановлюється в:
C:\Program Files(x86)\ATOL\Drivers8\
У стовпці «Режим» має бути встановлене значення « Безкоштовна версія», інакше потрібно встановити необхідне значення, натиснувши на кнопку «…» у стовпці «Безкоштовна версія». Документ «Керівництво програміста» входить у дистрибутив. Після встановлення ДТО8 доступний наступним шляхом (за замовчуванням):
C:\Program Files (x86)\ATOL\Drivers8\Doc\Drivers8_FprnM_PM.pdf
У драйвері роботу з ФЗ-54 підтримують такі моделі:
Таблиця 1
| Модель | Код моделі |
| АТОЛ 30Ф (АТОЛ FPrint-30ЕНВД) | 61 |
| АТОЛ 77Ф (АТОЛ FPrint-77ЕНВД) | 69 |
| АТОЛ FPrint-22ПТК (АТОЛ FPrint-22ЕНВД) | 63 |
| АТОЛ 55ПТК (АТОЛ FPrint-55ЕНВД) | 62 |
| АТОЛ 11Ф (АТОЛ FPrint-11ЕНВД) | 67 |
| АТОЛ 5200Ф (АТОЛ FPrint-5200ЕНВД) | 64 |
| АТОЛ 25Ф | 57 |
Робота моделей, зазначених у Таблиці 1, підтримується за Протоколу 3.х
і вище.
Після успішної установки ДТО необхідно встановити з'єднання драйвера з контрольно-касовою технікою. Для цього необхідно скористатися документацією:
Підключення Проектів у різних середовищах Програмування
Після встановлення ДТО8 копіюються приклади Підключення у різних середовищах, що полегшить Розробникам софту процес інтеграції.
C:\Program Files (x86)\ATOL\Drivers8\Samples\FprnM
Інструкція з експлуатації
FPrint
-22ПТК
:
на прикладі моделі АТОЛ FPrint-22ПТК (АТОЛ FPrint-22ЕНВД). У даному документіописані процеси встановлення ДТО, підключення, пошуку та налаштування обладнання. Для кожного конкретної моделінеобхідно скористатися документацією Посібник з експлуатації для використовуваної вами моделі ККТ.
"АТОЛ: Драйвер ККМ 9"
Драйвер є набір бібліотек (*.dll) для операційних системсімейства Windows NT/Windows CE, або (*.so) для Linux, призначених для використання у додатках, написаних мовою C++.
Драйвера торгового обладнання 9 доступні для скачування за посиланням:
1. Розпакувати завантажений архів X _X. zip у будь-яке доступне місце. Далі розпакувати архів, що містить папки:
android- бібліотеки для Android
doc- Документація
include– заголовні файли
linux-armhf– бібліотеки для архітектури arm
linux-x64- бібліотеки для Linux x64
linux-x86- бібліотеки для Linux x32
nt-x86-mingw- бібліотеки для Windows
samples– приклади використання
2. У папці Драйвери_торгівельного_обладнання_9_X_X\docрозпакувати архів doxygen.tar.bz2в docs. Усередині папки docs\htmlу браузер відкрити файл index.html- Відкриється Головна сторінкадокументації з докладним описомвнутрішнього устрою ДТО9. Також описані відмінності під час роботи з ФЗ-54 сумісними моделями.
У розділі АТОЛ:Драйвер ККМ є приклади використання драйвера та підключення в деяких ((C++), (Java), (Android)) середовищах розробки програмного забезпечення:
Розділ2: Інтеграція програмного забезпечення з використанням Протоколу обміну команд нижнього рівня.
Для взаємодії програмного забезпечення з контрольно-касовою технікою виробництва АТОЛ за Протоколом необхідно використовувати документ
Протокол роботи ККМ 3.
x
- Керівництво програміста
– цей протокол описує взаємодію програмної та апаратної частини за допомогою команд нижнього рівня, включаючи нові протокольні команди. Також тут описані основні моменти щодо підключення та налаштування ККТ на обмін з ОФД.
Існує два види протоколу Нижнього рівня.
Нижній Рівень v2 – стор.10
Нижній Рівеньv3 – стор.19 Перероблений протокол із зміненим алгоритмом взаємодії нижнього рівня.
Обидва протоколи підтримують як реалізацію 54-ФЗ, і старого порядку.
Додаток 1: Примітки та посилання для завантаження додаткового ПЗ:
Утиліта реєстрації ККТ вбудована у дистрибутив ДТО8. Інструкція після встановлення ДТО8 доступна наступним шляхом:
Для встановлення з'єднання з ККТ, необхідно перевести ФР на Протокол ККТ 3.0, запрограмувавши значення Таблиці2 Ряд1 Поле85 – 2. Або скористатися сервісним меню.
Утиліта EoU для передачі даних в ОФД за допомогою Ethernet вбудована в Утиліту Управління драйверами. Канал обміну з ПК – USB.COM
Перш ніж інсталювати драйвер, необхідно перевести в потрібний режим касовий апарат. Для цього пристрій потрібно вимкнути, після чого натиснути кнопку протягування стрічки та утримуючи її, знову увімкнути апарат. Піде 4 звукових сигналу. Через кілька секунд, але до того, як настане 5 сигнал, кнопку протягування стрічки потрібно відпустити. Апарат видасть чек, на якому буде надруковано перелік доступних опцій у сервісному режимі. Один з можливих варіантівпредставлений на наступному зображенні:
1- Вихід, 2 - Канал обміну, 3 - Протокол обміну
Вибір потрібного режиму здійснюється відповідною кількістю натискань на кнопку протягування стрічки. Так, у наведеному вище прикладі натискання кнопки 1 раз спричинить вихід із сервісного режиму, 2 натискання відкриють доступ до налаштування каналу обміну, а 3 натискання – доступ до налаштування протоколу обміну.
Для встановлення драйвера касу необхідно перевести в режим "Канал обміну". У нашому прикладі слід двічі натиснути кнопку протягування стрічки. Користувач побачить доступні канали обміну, наприклад, список може виглядати так:
- Вихід
- RS-232
З наведеного списку необхідно вибрати USB. У нашому прикладі для цього знадобиться тричі натиснути на кнопку протягування стрічки. Якщо все зроблено правильно, апарат підтвердить увімкнення USB:
Тепер таким же методом слід вибрати протокол обміну – Атол 3.0. Для цього потрібно в меню сервісного режиму вибрати пункт «Протокол обміну». У прикладі це пункт 3, отже, на кнопку протяжки стрічки потрібно натиснути тричі. Апарат видасть перелік доступних протоколів, наприклад, як у наступному зображенні:
Тепер тричі натиснувши кнопку протяжки стрічки (у разі), потрібно вибрати протокол Атол 3.0. На підтвердження вибору апарат роздрукує повідомлення «Атол 3.0 включений».
Тепер можна вийти із сервісного режиму. Для цього в нашому прикладі потрібно натиснути кнопку протягування стрічки один раз (пункт меню "Вихід"). Апарат повідомить, що готовий до роботи:
Отже, до встановлення драйвера все готово.
Якщо попередніх етапах щось йде негаразд, рекомендується виконати весь алгоритм від початку. Якщо ККТ не вдається переключити в потрібний режим, зверніться до виробника.
Встановлення драйвера
Драйвер для ККТ Атол розташований за адресою https://install.kontur.ru/atol
Після натискання кнопки "Далі" користувач може вибрати компоненти для встановлення або встановити їх за замовчуванням: 
Коли інсталяцію завершено, комп'ютер необхідно перезавантажити:
Тепер драйвер встановлено та готовий до налаштування.
Налаштування драйвера
Насамперед необхідно відкрити диспетчер пристроїв Windows: "Пуск" - "Панель управління" - "Диспетчер пристроїв". Далі потрібно розкрити елемент списку "Порти (COM і LTP)" і вибрати "Послідовний порт (COM)" (або "Пристрій з послідовним інтерфейсом (COM)"). Натисніть правою кнопкою миші меню, в якому потрібно вибрати пункт «Оновити драйвер»: 
У вікні вибрати «Виконати пошук драйверів на цьому комп'ютері»: 
Далі натиснути «Вибрати драйвер зі списку встановлених драйверів»: 
На наступному етапі потрібно натиснути кнопку «Встановити з диска…»: 
У віконці необхідно вказати шлях до драйвера Атол. За замовчуванням це C:\Program Files (x86)\ATOL\Drivers8\USB_Drivers. Коли вибрано драйвер, натисніть кнопку «OK»: 
У вікні, яке з'явиться на екрані, потрібно зняти галочку з пункту «Тільки сумісні пристрої»:
Користувач побачить меню вибору драйвера. У лівій колонці слід вибрати "ATOL group", а в правій - "ATOL FPrint USB": 
Після натискання кнопки "Далі" система видасть попередження - користувачеві слід натиснути кнопку "Так": 
Система встановить драйвер, і якщо все пройде благополучно, у «Диспетчері пристроїв» у розділі «Порти (COM та LTP)» з'явиться його найменування: 
Ту ж операцію потрібно повторити для другого порту: 
Налаштування Ethernet over USB
Щоб зв'язати ККТ Атол з оператором фіскальних даних, знадобиться налаштувати службу Ethernet over USB (EoU). Але необхідно переконатися, що всі файли цієї служби встановлені. Потрібно відкрити папку C:Program Files (x86)ATOLEthOverUsb і перевірити, що вона має структуру, як на зображенні нижче:
Якщо всі файли на місці, можна перейти до налаштування служби.
Знадобиться стандартний Блокнот Windows, який слід запустити від імені адміністратора. У блокноті потрібно відкрити файл settings.ini і поправити рядок number=«число». Потрібно вписати номер COM-порту, яким працюватиме служби. Щоб дізнатися, знадобиться звірити дані з утиліти реєстрації каси Атол і «Диспетчера пристроїв». У прикладі апарат підключений до порту COM3, а утиліта показує COM4. Це значення потрібно змінити у файлі settings.ini і прописати його так, як показано на малюнку нижче:
Драйвера АТОЛ – це спеціальна програма, необхідна взаємодії касового апарату з комп'ютером. Це програмне забезпеченнязначно прискорить процес виплати покупцю, і навіть спростить ведення фінансового обліку.
Можливості та функціонал
АТОЛ необхідний для того, щоб будь-який користувач, що навіть має мінімальний набір знань по роботі з ККМ, міг успішно з ним взаємодіяти. Завдяки цьому ПЗ Ви зможете керувати фіскальним апаратом, вносячи інформацію про всі витрати та доходи в спеціальну програму. Для роботи з АТОЛ немає потреби створювати особистий профільабо виконувати додаткові налаштування– усі готові конфігурації можна знайти у меню. Їх потрібно лише правильно відрегулювати. Встановлені параметри будуть автоматично збережені та відновлені у разі системних збоїв.
Програма вміє здійснювати пошук підключеного обладнання, підтримує роботу з кількома ККМ, підключеними до одного комп'ютера, а також може працювати з віддаленими касовими апаратами, підключеними до ПК через мережу. При управлінні касовим апаратом користувачеві доступне проведення операцій продажу, оплати, повернення, друку та скасування друку чека, обнулення лічильників, скидання налаштувань, отримання різних відліків та виконання багатьох інших дій.
Сумісність
Драйвери АТОЛ сумісні з такими фіскальними реєстраторами - АТОЛ, Штрих-М, Пілот, Іскра, МультиСофт, СервісПлюс, IKC-Техно, NCR, Резонанс, НПФ Юнісистем та Newton. Щодо програм, з якими він може "уживатися", можна перерахувати продукти компанії 1С, Microsoft Office, Microsoft Visual FoxPro/Basic/C++/C# та інші.
Ключові особливості
- підтримує Windows 7 і більше ранні версіїданої ОС;
- необхідний автоматизованої роботи з касовим апаратом;
- дає можливість роботами з віддаленим обладнанням;
- сумісний із програмними продуктами від 1С;
- дозволяє працювати не тільки до ККМ АТОЛ, а й іншими касовими апаратами;
- може взаємодіяти з кількома пристроями, підключеними одного ПК.
Є працююча 1с 8.3х32 і всі драйвера ККТ Атола 8 працюють!
ПК:
Windows Server 2008 x64, режим RDP
1С:Підприємство 8.3 х32 (8.3.11.2867)
Бухгалтерія підприємства, редакція 3.0 (3.0.54.20)
ККТ Атол-FPrint-22ПТК
драйвер Атол 8.15.3.8197
Встановлюємо 1С:Підприємство 8.3х64 в надії використовувати ДТО 8 від Атола, і отримуємо це "Не встановлений на поточному комп'ютері. Не визначено тип: AddIn.ATOL_KKM_1C82_54FZЕ" :
І в 1С:Підприємство 8.3 х32ТЕПЕР ТЕЖ отримуємо це.
Переустановка 1С:Підприємство 8.3х32 не допомагає.
Тільки ЗНОСИМО 1С:Підприємство 8.3х64і навіть без перезавантаження ВІДРАЗУ все нормально працює!
Пошуки в інтернеті нічого не дають (як не дивно, 2017р.)
Відповідь надходить досить дурним чином. Завантажуючи нові драйвери ДТП 10.1.1після розпакування було помічено татка installer, в якій лежать в тому числі дистрибутив KKT10-10.1.1.0-windows64-setup.exe (і KKT10-10.1.1.0-windows32-setup.exe).
Запускаємо KKT10-10.1.1.0-windows64-setup.exeі далі наприклад у 1С: Підприємство 8.3 (8.3.11.2867) x64драйвера чудово встановлюються і ККТ працює (визначаються драйвера як чомусь 9).
Якщо запустити 1с 8.3х32, то там драйвера ДТО 9 не працюватимуть. Навіщо це треба - допустимо у вас ще й Штрих-М фР використовується (він тільки під 1С 8.3х32) працює. Потрібно щоб усе разом працювало - тоді відкочуємо 1С на х32.
Повертаємо драйвера Атол для 1С х32. Якщо паралельно KKT10-10.1.1.0-windows64-setup.exe зробити установку KKT10-10.1.1.0-windows32-setup.exe, то в 1с 8.3 х32 як і ДТО 9 і ДТО 8 працювати не будуть.
Допомогло лише повне вичищення ПК від Атола. Причому в утиліті видалення програм WindowsАтол шифрується і пише, що він Атол - наприклад драйвер ККТ 10....). Будьте уважні. У мене, наприклад, виявилося і ДТО6, і ДТО8, і ДТО9, і ДТО10 (два рази встановлені). Ще якийсь майстер ліцензій.
Примітка:Ця стаття написана для ККТ АТОЛ, які відповідають ФЗ-54 (Онлайн-кас). Якщо у Вас ККТ старої моделі, то в пунктах 3 та 6 у Вас буде один COM-порт, пункти 11-13 пропускаєте.
1. Встановіть драйвер АТОЛ під адміністратором. Дотримуйтесь рекомендацій установника:
2. Підключіть пристрій через USB кабельдо ПК.
3. Відкрийте «Диспетчер пристроїв», ККТ АТОЛ має відобразитись як « Невідомий пристрій», або як показано на малюнку (при підключенні ККТ АТОЛ через USB кабель має відображатися два пристрої):
4. Натисніть правою кнопкоюмиші на кожний із пристроїв і виберіть «оновити драйвер».
5. Виберіть «Здійснити пошук драйверів на цьому комп'ютері»:
6. Встановлюйте драйвера з наступної папки: C:\Program Files\ATOL\Drivers8\USB_Drivers. При правильної установкидрайвера у пристрої з'явиться позначка ATOL:
7. Тепер відкриваємо «Драйвер ККМ» (можна знайти пошуком по комп'ютеру) та натискаємо «Налаштування властивостей»:
8. Тепер вибираємо пункт «Пошук обладнання»:
9. У параметрах пошуку вказуємо модель Вашого ККТ і натискаємо пошук. Драйвер повинен знайти пристрій, вказати швидкість його роботи та COM-порт:
10. Далі в параметрах зв'язку вказуємо ті ж значення, що видав нам драйвер у попередньому пункті (у пошуку обладнання), а також вказуємо модель Вашого пристрою і натискаємо перевірка зв'язку. Якщо все налаштовано правильно, то в рядку «Результат» з'явиться Ваш пристрій:
12. Тепер запускаємо «Управління драйверами» з-під адміністратора. У полі ККМ прописується довільна інформація, що визначає ККМ. У полі COM-порт прописується номер порту для обміну з ОФД (Це другий з портів, який відображається у Вас в диспетчері пристроїв, не задіяний в драйвері ККМ) Встановлюєте галочку Автозапуск і натискаєте кнопку Запустити:
13. Перевіряєте по логах, що порт правильно налаштований. У логах має бути запис, що порт визначився правильно:
14. Тепер встановлюємо програму Subtotal, дотримуючись інструкцій установника:
15. Після запуску програми Subtotal, відкриваємо «Налаштування» та вибираємо розділ «ККМ»:
16. Вибираємо «підключити фіскальний реєстратор» та вводимо головний логін та пароль від Subtotal, вибираємо магазин та точку продажів:
17. У заключному налаштуванні вказуєте драйвер АТОЛ, коди оплат «0» і «1». Далі натискаєте на синю шестерню у вказуєте параметри точно так само як і в «драйвер ККМ» (пункт 10):
18. Натискаєте «Finish» та «ok», програма перезавантажиться – на цьому налаштування завершено.