eTIMS (KRA, Кенія)

Модуль для компаній, які продають у Кенії. Податкова служба Кенії (KRA) вимагає, щоб кожен рахунок і кожен касовий чек був зареєстрований у її системі eTIMS і мав її квитанцію: номер CU-інвойсу, підпис і QR-код, за яким покупець перевіряє документ. Без квитанції покупець-компанія не зможе зарахувати вхідний ПДВ.

ERPJS відправляє документ в eTIMS сам, одразу після проведення, через сервіс-посередник eTIMS. Людина нічого не натискає: провела рахунок — зазвичай за секунду в неї є квитанція KRA. Чек каси друкує її сам, форма рахунку — якщо в шаблон додано змінні eTIMS.

Маршрут: від проведення до квитанції в друку

Обліковий запис eTIMS (адреса посередника, ключ, зіставлення ПДВ і одиниць)
        ↓
Коди eTIMS товарів і груп товарів (класифікація KRA, тип, упаковка, одиниця, країна)
        ↓
Рахунок або касовий чек проведено → запис «Фіскалізація eTIMS» → відправка
        ↓
Квитанція KRA (CU-інвойс, підпис, QR) → на чеку каси і на друкованій формі рахунку
        ↓
Журнал обміну eTIMS — що пішло і що відповіли

Обліковий запис eTIMS — через який сервіс-посередник і з яким ключем відправляти, який тип податку KRA в кожного коду ПДВ, які коди KRA в одиниць і який тип оплати KRA мають рахунки, коли інакше не визначено. Тип оплати KRA кожного способу оплати чека каси задають не тут, а в способах оплати. Обліковий запис «за умовчанням» відправляє рахунки компанії; у каси може бути свій.
Коди eTIMS товарів і груп товарів — те, що KRA хоче знати про товар і чого немає в картці: код класифікації, тип товару, коди упаковки й одиниці, країна походження. Код групи діє на всі її товари, код товару — точніше.
Фіскалізація eTIMS — по запису на кожен проведений документ: чи відправлено його, скільки було спроб, остання помилка і квитанція KRA.
Журнал обміну eTIMS — кожен запит до посередника і його відповідь, без ключа.
Інструкція eTIMS — налаштування покроково і що робити, коли документ не пішов.

Що важливо розуміти

Документ проводиться завжди — навіть якщо eTIMS недоступний. Відправка йде після проведення, а не всередині нього. Якщо сервер eTIMS не відповів, людина бачить «Сервер eTIMS зайнятий — рахунок 77 буде перевірено пізніше», а система повторює відправку сама, зі зростаючою паузою. Друк у цей час замість QR показує позначку: форма рахунку — «Перевірка eTIMS очікується — документ буде перевірено пізніше», чек каси — «Перевірка eTIMS ще триває — чек буде перевірено пізніше».

Фіскалізований документ не можна зняти з проведення. У KRA він уже є, і зняття в ERPJS розійшлося б із податковою. Виправлення — кредит-нотою. Те саме, поки документ саме відправляється, і якщо відповідь eTIMS загубилася (таймаут, обрив зв'язку): документ, можливо, уже в KRA, і зняття заборонене, доки результат не з'ясовано.

Кредит-нота йде за своїм рахунком. Її відправляють тим самим обліковим записом, що й рахунок, із номером CU рахунку, тому в кредит-ноті має бути вказано вихідний рахунок. Доки рахунок у черзі eTIMS, нота чекає. Якщо рахунку в eTIMS немає (помилка, знято з проведення, проведено до підключення eTIMS), нота отримує помилку. Сума нот не може перевищити залишок рахунку в eTIMS.

PIN покупця береться з картки. Якщо в рахунку номер не вказано, у KRA йде «ІПН» із картки контакту. Кредит-нота несе той PIN, з яким пішов її рахунок.

Помилки — мовою того, хто провів документ. Повтори йдуть без людини, тому мова запам'ятовується під час проведення.

Модуль є лише у версії ERPJS для Кенії. В українській версії його реєстрів, полів і змінних друку немає зовсім. Версію задає налаштування сервера ERPJS, а не права ролей чи налаштування компанії. У версії для Кенії модуль діє лише з відкритим обліковим записом eTIMS: без запису «За умовчанням для компанії» (і без запису каси) реєстри й поля eTIMS видно, але документи проводяться як раніше — без запису фіскалізації, повідомлень, QR і заборони знімати проведення.

З чого почати в новій базі

Обліковий запис eTIMS — адреса й ключ посередника, прапорець «За умовчанням для компанії», зіставлення кодів ПДВ із типами податку KRA, «Перевірити з'єднання».
Коди eTIMS груп товарів — спершу групи: так коди отримають одразу всі товари.
Коди eTIMS товарів — для товарів, які відрізняються від своєї групи.
Колонка «Тип оплати eTIMS» у налаштуванні Спосіб оплати й обліковий запис каси — якщо продаєте через касу.
Провести тестовий рахунок і подивитися його запис у Фіскалізації eTIMS.

Часті задачі

Треба	Куди йти
підключити компанію до eTIMS	Облікові записи eTIMS
дати товарам коди KRA	Коди eTIMS груп товарів · товарів
дізнатися, чи пішов рахунок і чому ні	Фіскалізація eTIMS
відправити документ ще раз	Фіскалізація eTIMS → «Відправити повторно»
відповідь eTIMS загубилася — документ у KRA чи ні	Фіскалізація eTIMS → «З'ясувати невідомий результат»
подивитися, що пішло в eTIMS і що відповіли	Журнал обміну eTIMS
надрукувати QR KRA на рахунку	Інструкція eTIMS, розділ про друк