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, раздел о печати