Документ «Сведения о незачисленных взносах, отчислениях, платежах»

Конфигурация: «Зарплата и управление персоналом для Казахстана 3.1» (ZupKZ31). ✅ Казахстанская специфика: документ обслуживает контур соцплатежей РК — взносов и отчислений (ОПВ/СО/ВОСМС и пр., перечисляемых через Госкорпорацию «Правительство для граждан»), что видно по связке с документом ВедомостьНаПеречислениеВзносовОтчислений и регистру НалогиВзносыОтчисленияРасчетыСБюджетомИФондами; конкретные виды платежей в карте не детализированы. Комментарий из метаданных: «Сведения о незачисленных/ошибочно перечисленных взносах, отчислениях, платежах». В JSON-карте нет форм, BSL-модулей и сводок (forms=[], bsl_static=[], bsl_summaries=[]) — карточка построена строго на метаданных.

1. Назначение и место в учёте

Документ регистрирует факт, что перечисленные по ведомости взносы/отчисления/платежи не были зачислены получателем или были перечислены ошибочно и подлежат возврату (синоним колонки суммы — «К возврату»). Шапка привязана к документу Ведомость (вид — «Ведомость на перечисление взносов, отчислений»), а табличная часть Сотрудники детализирует возвраты по физлицам: месяц налогового периода, сумма к возврату и регистрация в налоговом органе. Проведение корректирует единственный регистр расчётов с бюджетом и фондами — суммы перестают числиться перечисленными. Используется расчётчиком зарплаты эпизодически — при возвратах от Госкорпорации/банка или выявлении ошибочных перечислений. Место в меню по данным карты не определено.

2. Структура объекта

Нумерация: number_type = String, длина 11, периодичность — Year (номер уникален в пределах года).

2.1 Реквизиты шапки

Все 6 реквизитов из metadata.attributes, без пропусков.

2.2 Табличные части

ТЧ Сотрудники — детализация незачисленных/возвращаемых сумм по физлицам.

ТЧ ДополнительныеРеквизиты — стандартный механизм доп. реквизитов (подсистема «Свойства» БСП).

2.3 Формы

В metadata.forms и секции forms JSON-карты формы отсутствуют — (не определено); используются стандартные представления, ключевую форму по карте указать нельзя.

3. Сценарии работы

BSL-логика и команды в карте отсутствуют — сценарии синтезированы из метаданных (based_on, обязательность полей, состав ТЧ, регистр движения); автозаполнения и серверные проверки помечены как (не определено).

3.1 Сценарий: «Ввод на основании ведомости на перечисление взносов/отчислений» (основной путь)

• Когда применяется: Госкорпорация/банк вернул(а) часть платежа по взносам/отчислениям либо выявлено ошибочное перечисление по конкретной ведомости.
• Шаги пользователя: 1. Открыть документ «Ведомость на перечисление взносов, отчислений», по которому был возврат. 2. Команда «Создать на основании» → «Сведения о незачисленных взносах, отчислениях, платежах» (based_on: Document.ВедомостьНаПеречислениеВзносовОтчислений). 3. Проверить автозаполненные Организация и Ведомость (механика автозаполнения в карте не определена, но связь «на основании» предусмотрена метаданными). 4. В ТЧ Сотрудники оставить только тех физлиц и те строки (МесяцНалоговогоПериода, РегистрацияВНалоговомОргане), по которым платёж не зачислен; указать суммы НалогВзнос («К возврату»). 5. Провести документ.
• Поля/внимание: суммы здесь вводятся (в отличие от парного документа «Сведения о незачисленной зарплате») — частичный возврат по строке возможен на уровне структуры данных (валидация в карте не определена).
• Проверки: платформенная обязательность Организация и Ведомость (ShowError); прочее — (не определено).
• После «Провести»: движение по регистру НалогиВзносыОтчисленияРасчетыСБюджетомИФондами — указанные суммы перестают числиться перечисленными в бюджет/фонды (детальная логика записей в карте не представлена).

3.2 Сценарий: «Ручное создание документа» (Create)

• Когда применяется: документ заводится из журнала, без перехода из ведомости.
• Шаги: создать новый документ → указать Организация (обязательно) → выбрать Ведомость (обязательно; тип один — «Ведомость на перечисление взносов, отчислений», выбора вида документа не будет) → заполнить ТЧ Сотрудники построчно → провести.
• Внимание: соответствие строк ТЧ составу выбранной ведомости метаданными не контролируется — (не определено); сверяй вручную.

3.3 Сценарий: «Просмотр / поиск» (Read)

• Когда применяется: контроль зарегистрированных возвратов по соцплатежам.
• Шаги: открыть список документов → ориентироваться по номеру (уникален в пределах года), Организация, Ведомость и строке КраткийСоставДокумента (показывает состав сотрудников в списке).

3.4 Сценарий: «Исправление сумм/состава и перепроведение» (Update)

• Когда применяется: уточнена сумма возврата или состав физлиц.
• Шаги: открыть документ → исправить строки ТЧ (НалогВзнос, МесяцНалоговогоПериода, РегистрацияВНалоговомОргане) → перепровести.
• После перепроведения: движения по регистру переформируются.

3.5 Сценарий: «Отмена ошибочно введённого документа»

• Когда применяется: возврат зарегистрирован ошибочно (платёж на самом деле зачислен).
• Шаги: отменить проведение (движение по регистру удаляется) → при необходимости пометить на удаление.
• После отмены: расчёты с бюджетом и фондами возвращаются к состоянию «перечислено».

3.6 Сценарий: «Повторное перечисление возвращённых сумм»

• Когда применяется: после фиксации возврата суммы нужно перечислить заново (например, с исправленными реквизитами).
• Шаги: документ проведён → задолженность по перечислению снова видна в регистре НалогиВзносыОтчисленияРасчетыСБюджетомИФондами → сформировать новую «Ведомость на перечисление взносов, отчислений» стандартным механизмом.
• Внимание: из этого документа ничего «на основании» не создаётся (inverse_based_on пуст) — новая ведомость делается отдельно.

4. Per-field reference

Обработчики ПриИзменении в карте отсутствуют (bsl_static пуст) — влияние полей описано по семантике метаданных.

• Организация (cfg:CatalogRef.Организации): организация-плательщик; обязателен (ShowError); логически совпадает с организацией ведомости (автоконтроль — не определено).
• Ведомость (cfg:DocumentRef.ВедомостьНаПеречислениеВзносовОтчислений): документ-источник перечисления; обязателен (ShowError); тип единственный — диалог выбора типа не появляется; определяет, какие физлица/периоды/суммы корректны в ТЧ; типичное значение — ведомость, по которой пришёл возврат от Госкорпорации/банка.
• Подразделение (cfg:CatalogRef.ПодразделенияОрганизаций): необязательная аналитика «Структурное подразделение».
• КраткийСоставДокумента (xs:string): служебная строка-представление состава (синоним «Сотрудники»); формируется системой (порядок — не определено), вручную не редактировать.
• Ответственный (cfg:CatalogRef.Пользователи): стандартный реквизит «кто ведёт документ».
• Комментарий (xs:string): свободный текст — фиксируй причину незачисления/ошибочного перечисления.
• ТЧ Сотрудники.ФизическоеЛицо (cfg:CatalogRef.ФизическиеЛица): по кому возврат; ключевое поле строки.
• ТЧ Сотрудники.МесяцНалоговогоПериода (xs:dateTime): месяц, за который был платёж; вводится как месяц (дата внутри месяца), важен для привязки возврата к налоговому периоду.
• ТЧ Сотрудники.НалогВзнос (xs:decimal): сумма «К возврату» — сколько по физлицу за период не зачислено/возвращено; единственная суммовая колонка документа.
• ТЧ Сотрудники.РегистрацияВНалоговомОргане (cfg:CatalogRef.РегистрацииВНалоговомОргане): по какой регистрации в налоговом органе шёл платёж; КЗ-аналитика, обязательная для корректной адресации движения по регистру (требование на уровне метаданных не задано — DontCheck по умолчанию для колонок ТЧ).

5. Бизнес-логика

• Обработчики событий: (не определено) — bsl_static и bsl_summaries пусты.
• Движения при проведении: единственный регистр — AccumulationRegister.НалогиВзносыОтчисленияРасчетыСБюджетомИФондами (расчёты организации с бюджетом и фондами по налогам, взносам и отчислениям). Состав ТЧ (физлицо + месяц периода + сумма + регистрация в налоговом органе) соответствует аналитике этого регистра; конкретная логика записей (сторно/расход) в карте не представлена — (не определено).
• Валидации (ОбработкаПроверкиЗаполнения): по метаданным — обязательность Организация и Ведомость (ShowError); серверный код — (не определено).
• Зависимости от других модулей: (не определено) по карте; по типам реквизитов задействованы подсистема перечисления взносов/отчислений (ведомость) и доп. реквизиты (БСП).

6. Связи с другими объектами

6.1 Документы-основания (metadata.based_on)

• Document.ВедомостьНаПеречислениеВзносовОтчислений — основной способ ввода: открыть ведомость, по которой был возврат, и выполнить «Создать на основании» → данный документ; связь дублируется обязательным реквизитом шапки Ведомость.

6.2 Кто создаётся на основании этого

metadata.inverse_based_on пуст — ничего не создаётся (по данным карты).

6.3 Регистры движения (metadata.register_records, имя дословно)

1. AccumulationRegister.НалогиВзносыОтчисленияРасчетыСБюджетомИФондами — расчёты с бюджетом и фондами по налогам, взносам, отчислениям (КЗ-контур соцплатежей).

6.4 Ссылочные связи через реквизиты (из типов метаданных)

• Документ: ВедомостьНаПеречислениеВзносовОтчислений.
• Справочники: Организации, ПодразделенияОрганизаций, Пользователи, ФизическиеЛица, РегистрацииВНалоговомОргане (в ТЧ).
• ПВХ: ДополнительныеРеквизитыИСведения.

7. Заметки для ИИ-агента

1. Два обязательных поля — Организация и Ведомость (оба ShowError); предпочтительный путь создания — «Создать на основании» из документа «Ведомость на перечисление взносов, отчислений» (based_on), тогда шапка привязывается к источнику сразу.
2. Ведомость имеет один тип (ВедомостьНаПеречислениеВзносовОтчислений) — в отличие от парного документа «Сведения о незачисленной зарплате» диалога выбора вида документа не будет; не закладывай лишний шаг в сценарий кликов.
3. В ТЧ Сотрудники колонка с суммой называется в UI «К возврату», но имя реквизита — НалогВзнос: для DOM-селекторов/программного доступа используй имя, для поиска по заголовку — синоним.
4. Здесь суммы вводятся вручную (НалогВзнос) и обязательно указывается МесяцНалоговогоПериода и РегистрацияВНалоговомОргане — без них движение по регистру расчётов с бюджетом будет неадресным; согласованность с ведомостью метаданными не проверяется — сверяй сам.
5. Документ проводимый: пишет в НалогиВзносыОтчисленияРасчетыСБюджетомИФондами — после проведения суммы перестают числиться перечисленными; не проводи «на пробу» в рабочей базе.
6. КраткийСоставДокумента — служебное представление состава, не редактируй руками.
7. Это КЗ-специфичный документ контура взносов/отчислений (ОПВ/СО/ВОСМС, перечисление через Госкорпорацию); не путай с RU-наследным «Сведения о незачисленной зарплате», который работает с НДФЛ-регистрами и зарплатными ведомостями.