1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | НастройкиИнтеграцииWebKassa |
| Полное имя | Справочник.НастройкиИнтеграцииWebKassa |
| Синоним | Настройки интеграции 1С:WebKassa |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0 (версия 3.0.74.2) |
| Назначение | Хранение параметров подключения к сервису фискализации WebKassa — казахстанской системе онлайн-передачи фискальных чеков (данных ККМ) в органы государственных доходов (КГД МФ РК). |
Справочник хранит параметры интеграции с WebKassa в разрезе организаций. Каждый элемент привязан к одной организации и содержит адрес фискального сервиса и список имён пользователей информационной базы, через которых система выполняет обращения к фискальному оператору.
Ключевая особенность: для одной организации допустима только одна активная (не помеченная на удаление) настройка интеграции. Это обеспечивает однозначность выбора параметров подключения при фискализации.
Где найти в 1С: раздел «Интеграция 1С:WebKassa» → «Настройки интеграции 1С:WebKassa».
Навигационная ссылка: e1cib/list/Справочник.НастройкиИнтеграцииWebKassa
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Организация | СправочникСсылка.Организации | ShowError (обязателен) | Организация, для которой настраивается интеграция с WebKassa. Ключевое поле уникальности настройки — по нему определяется, чьи параметры подключения применять при фискализации. |
| АдресСервиса | Строка (xs:string) | ShowError (обязателен) | URL адрес сервиса WebKassa, к которому обращается система для фискализации документов. Используется при формировании HTTP-запросов к фискальному оператору. |
Стандартные поля наследуются от механизма справочников: Код, Наименование, ПометкаУдаления, Предопределённый, Ссылка.
2.2 Табличные части
Пользователи — список пользователей, имеющих доступ к работе с WebKassa для данной организации.
| Имя | Тип | Назначение |
|---|---|---|
| ИмяПользователя | Строка (xs:string) | Имя пользователя информационной базы, которому разрешено выполнять операции фискализации через настроенный сервис. Используется для разграничения прав доступа к интеграции. |
3. Формы
В конфигурации собственные формы объекта не определены (массив forms пуст). Платформа использует автогенерируемые формы:
| Форма | Назначение |
|---|---|
| Форма элемента (авто) | Ввод/редактирование настройки: выбор организации, ввод адреса сервиса, заполнение таблицы пользователей. |
| Форма списка (авто) | Просмотр перечня настроек по всем организациям, отбор, пометка на удаление. |
| Форма выбора (авто) | Подбор элемента при программном/интерактивном выборе настройки. |
При необходимости кастомизации (например, кнопка «Проверить соединение») форму элемента следует создать явно — см. раздел 7.
4. Ключевые процедуры модулей
Evidence с текстом BSL-модулей не приложен, поэтому ниже — типовые обработчики данного вида объекта, реализующие описанную бизнес-логику (единственность настройки на организацию).
| Обработчик | Модуль | Что делает (типовая логика) |
|---|---|---|
ОбработкаПроверкиЗаполнения |
Модуль объекта | Проверяет заполнение обязательных Организация и АдресСервиса; при необходимости — корректность URL и непустоту таблицы Пользователи. |
ПередЗаписью |
Модуль объекта | Контроль уникальности: запросом к справочнику проверяет отсутствие другого не помеченного на удаление элемента с той же организацией; при нарушении — Отказ = Истина и сообщение пользователю. |
ОбработкаЗаполнения |
Модуль объекта | Заполнение значений по умолчанию (например, организация из настроек текущего пользователя). |
АдресСервисаПриИзменении |
Форма элемента (при явной форме) | Нормализация введённого URL (обрезка пробелов, проверка схемы http/https). |
Функции обращения к сервису (формирование HTTP-запроса, авторизация, отправка чека) в типовой конфигурации вынесены в общие модули подсистемы интеграции WebKassa, а не в модуль самого справочника: справочник выступает источником параметров подключения.
5. Проведение и движения
Справочник не является документом и не проводится. Записи в регистрах бухгалтерии и в регистрах накопления он не формирует, бухгалтерских проводок не делает.
Хозяйственный результат фискализации (реализация через ККМ) отражается связанными документами конфигурации, которые используют данный справочник как источник параметров. По стандартной логике учёта в РК формируются проводки (типовой план счетов РК, ставка НДС 16%, валюта — тенге ₸):
| Операция | Дт | Кт |
|---|---|---|
| Признание дохода от реализации | 1210 «Краткосрочная ДЗ покупателей» / 1030 «Деньги на текущих счетах» | 6010 «Доход от реализации» |
| Начисление НДС (16%) | 1210 / 1030 | 3130 «НДС к уплате» |
| Списание себестоимости товара | 7010 «Себестоимость реализации» | 1330 «Товары» |
Пример: продажа на 116 000 ₸ с НДС → доход 100 000 ₸ (Кт 6010), НДС 16 000 ₸ (Кт 3130). Фискальный чек при этом уходит в WebKassa по параметрам из справочника.
Электронные документы, сопутствующие обороту: ЭСФ (ИС ЭСФ) и СНТ — оформляются отдельными объектами конфигурации и с настройкой WebKassa напрямую не связаны.
6. Связанные объекты и ввод на основании
- Справочник.Организации — владелец параметров (реквизит
Организация). - Пользователи ИБ — таблица
Пользователиссылается на имена пользователей информационной базы. - Документы фискализации (чеки ККМ / отчёты о розничных продажах) — потребители настройки: при пробитии чека система по организации документа находит активную настройку и обращается к WebKassa по её
АдресСервиса. - Общие модули подсистемы «Интеграция 1С:WebKassa» — используют элемент справочника как источник URL и списка доступов.
Ввод на основании для данного справочника типовыми механизмами не предусмотрен (это объект настроек, а не первичный документ).
7. Точки расширения
- Проверка соединения. Добавить собственную форму элемента с командой, вызывающей тестовый HTTP-запрос к
АдресСервисаи выводящей результат. - Хранение токенов/секретов. Логины/пароли или API-ключи WebKassa хранить не в открытом реквизите, а в защищённом хранилище (
ХранилищеОбщихНастроек/ регистр с ограничением доступа); таблицаПользователизадаёт лишь перечень имён. - Подписка на события
ПередЗаписью/ОбработкаПроверкиЗаполнения— для донастройки контроля уникальности и валидации URL без изменения модуля объекта. - Расширение конфигурации — безопасный способ добавить реквизиты (например, ИИН/БИН кассы, номер ККМ, номер смены) и логику без снятия типовой с поддержки.
Требует проверки для конкретной сборки: точный состав общих модулей подсистемы интеграции и наличие предопределённого контроля уникальности в
ПередЗаписью— они версионно-зависимы и в разных релизах 3.0.7x могут отличаться.