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 (обязателен) | WebKassa қызметінің URL адресі, жүйе құжаттарды фискализациялау үшін сұрау жасайды. Фискалдық операторға 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-сұрау шақыратын командамен жеке форма қосу. - Токендер/құпияларды сақтау. WebKassa логиндері/парольдері немесе API-кілттерін ашық реквизитте емес, қорғалған қоймада (
ХранилищеОбщихНастроек/ шектеулі қолжетімділігі бар регистрде) сақтау;Пользователикестесі тек аттар тізімін анықтайды. - Оқиғаларға жазылу
ПередЗаписью/ОбработкаПроверкиЗаполнения— уникалдылықты бақылау және URL валидациясын модуль объектісін өзгертпей донастройка үшін. - Конфигурацияны кеңейту — реквизиттерді (мысалы, кассаның ИИН/БИН, ККМ нөмірі, ауысым нөмірі) және логиканы қауіпсіз түрде қосу, типтік қолдаудан шығармай.
Нақты жинақ үшін тексеруді талап етеді: интеграцияның жалпы модульдерінің нақты құрамы және
ПередЗаписьюмодуліндегі алдын ала анықталған уникалдылық бақылауы — олар версияға тәуелді және 3.0.7x әртүрлі релиздерінде ерекшеленуі мүмкін.