--- title: "Документ «Первичный документ» (Documents.ПервичныйДокумент) — техническое описание" country: KZ lang: ru author: Сапа Т.И. (https://buhgpt.kz/authors/sapa-ti) date: 2026-09-23 canonical: https://buhgpt.kz/suraqtar/dokument-pervichnyy-dokument-documents-pervichnyydokument-tehnicheskoe source: BuhGPT --- # Документ «Первичный документ» (Documents.ПервичныйДокумент) — техническое описание > **TL;DR:** 1. Идентификация Параметр Значение Тип объекта Документ (Documents) Имя ПервичныйДокумент Полное имя Документ.ПервичныйДокумент Синоним «Первичный документ» Конфигурация Управление торговлей для Казахстана, редакция 3.4.5.21 Нумерация Строка, длина 11, периодичность — год Разд --- 1. Идентификация Параметр Значение Тип объекта Документ (Documents) Имя ПервичныйДокумент Полное имя Документ.ПервичныйДокумент Синоним «Первичный документ» Конфигурация Управление торговлей для Казахстана, редакция 3.4.5.21 Нумерация Строка, длина 11, периодичность — год Раздел Прочие операции Основной пользователь Бухгалтер Назначение. «Первичный документ» — универсальный документ для регистрации произвольной первичной операции, не имеющей специализированного вида в конфигурации. Позволяет отразить нестандартную операцию (закуп, реализация, взаиморасчёты и т. п.) с нужной аналитикой, когда типовой документ не подходит. Тип конкретной операции задаётся реквизитом ТипПервичногоДокумента, а сумма влияет на оперативный (управленческий) и регламентированный учёт. Где найти: навигационная ссылка на список — e1cib/list/Документ.ПервичныйДокумент; открытие конкретного документа — e1cib/data/Документ.ПервичныйДокумент. 2. Реквизиты и табличные части 2.1 Реквизиты шапки Имя Тип Обяз. Назначение Организация СправочникСсылка.Организации Да Юрлицо, от имени которого оформляется документ. Обычно подставляется основная организация из настроек. Партнер СправочникСсылка.Партнеры Да Компания-контрагент как бизнес-единица. Выбирается первым: по партнёру подтягиваются контрагент, соглашение и условия. Контрагент СправочникСсылка.Организации, СправочникСсылка.Контрагенты Да Конкретное юрлицо, на которое выписываются документы (у партнёра может быть несколько юрлиц). Договор СправочникСсылка.ДоговорыМеждуОрганизациями, СправочникСсылка.ДоговорыКонтрагентов Да Договор, в рамках которого идёт операция. Обязателен при расчётах по договорам. Валюта СправочникСсылка.Валюты Да Валюта цен строк. По умолчанию тенге (₸); подтягивается из соглашения. СуммаДокумента Число Да Итоговая сумма документа в валюте документа. Рассчитывается автоматически по строкам. СуммаРегл Число Да Сумма документа в валюте регламентированного учёта (тенге). Используется для регламентированных движений. НомерВходящегоДокумента Строка Да Номер входящего документа контрагента. ДатаВходящегоДокумента Дата Да Дата входящей накладной/платёжки контрагента. ТипПервичногоДокумента ПеречислениеСсылка.ТипыПервичныхДокументов Да Вид отражаемой операции; определяет логику заполнения и состав движений. ПорядокРасчетов ПеречислениеСсылка.ПорядокРасчетов Да Порядок расчётов с контрагентом (по договорам / по заказам / по накладным). ГруппаФинансовогоУчета СправочникСсылка.ГруппыФинансовогоУчетаРасчетов Нет Группа финансового учёта расчётов для настройки счетов учёта. НаправлениеДеятельности СправочникСсылка.НаправленияДеятельности Нет Аналитика доходов/расходов по направлениям бизнеса. Подразделение СправочникСсылка.СтруктураПредприятия Нет Подразделение организации (аналитика по подразделениям). Комментарий Строка Нет Произвольный комментарий. 2.2 Табличные части В выгрузке структуры отдельные табличные части объекта не зафиксированы: реквизиты СуммаДокумента и СуммаРегл рассчитываются по строкам ввода на форме документа, а состав движений формируется по данным шапки и переданным суммам. Товарная детализация попадает в регистры через связанные механизмы партионного учёта (см. раздел 5). Требует проверки в конкретной сборке 3.4.5.21: наличие и состав товарной табличной части зависит от выбранного ТипПервичногоДокумента — для товарных операций строки товаров могут заполняться, для расчётных — нет. 3. Формы Форма Назначение Состав ФормаДокумента Основная форма ввода и проведения документа. 115 элементов, 17 полей ввода, 2 кнопки. Команда ПровестиИЗакрыть. ФормаСписка Рабочий список документов раздела «Прочие операции»; групповые операции. 77 элементов, 4 поля ввода, таблица Список, кнопка. Команда ИзменитьВыделенные. ФормаВыбора Выбор документа из других объектов (подбор ссылки). 85 элементов, 5 полей ввода, таблица Список. 4. Ключевые процедуры модуля объекта (ObjectModule) Обработчики зафиксированы статическим анализом BSL-модуля (parse_bsl / build_bsl_digest), имена — дословно из выгрузки. Обработчик Объём Назначение ОбработкаПроверкиЗаполнения ~32 стр. Проверяет заполнение обязательных реквизитов (Организация, Партнер, Контрагент, Договор, Валюта, суммы, ТипПервичногоДокумента, ПорядокРасчетов) и согласованность данных перед записью; формирует отказ и сообщения об ошибках. ПередЗаписью ~10 стр. Предзаписные проверки и подготовка данных (контроль дат, статусов, прав), возможен отказ записи. ПриЗаписи ~11 стр. Действия в транзакции записи: синхронизация связанных данных, регистрация изменений для обмена. ОбработкаЗаполнения ~11 стр. Заполнение реквизитов при создании/вводе на основании: подстановка организации, партнёра, контрагента, валюты, порядка расчётов из данных-основания и настроек. ПриКопировании ~4 стр. Очистка/переустановка реквизитов при копировании (номера входящего документа, служебных полей). Зависимости от общих модулей: ОбщегоНазначения (2 вызова), ЗначениеНастроекПовтИсп (2), ПартнерыИКонтрагенты (1), ОбщегоНазначенияУТКлиентСервер (1), ОбщегоНазначенияКлиентСервер (1). Это типовой набор для получения настроек, реквизитов партнёра/контрагента и сервисных функций платформы. 5. Проведение и движения Это торговая конфигурация: документ ведёт оперативный учёт через регистры накопления, а не напрямую формирует проводки Дт/Кт. По данным RegisterRecords документ является регистратором для регистров: Регистр Тип Что отражает ДетализацияПартийТоваровДляНДСиУСН Накопления Партионная детализация для целей НДС и спецрежимов; основа для корректного зачёта/начисления НДС. СебестоимостьТоваров Накопления Движения по себестоимости товаров (списание/оприходование стоимости партий). 5.1 Соответствие регламентированному учёту (план счетов РК) Оперативные движения при закрытии периода и отражении в регламентированном учёте трансформируются в проводки по типовому плану счетов РК. Для типовых операций «Первичного документа»: Операция Дебет Кредит Реализация товаров (доход) 1210 «Краткосрочная ДЗ покупателей» 6010 «Доход от реализации» НДС по реализации (16%) 1210 3130 «НДС к уплате» Списание себестоимости 7010 «Себестоимость реализации» 1330 «Товары» Поступление товаров 1330 «Товары» 3310 «КЗ поставщикам» НДС по приобретению (16%) 1420 «НДС к возмещению» 3310 Оплата поставщику 3310 1030 «Деньги на текущих счетах» Поступление оплаты от покупателя 1030 1210 Ставка НДС — 16% (РК, 2026). Сумма НДС в строках рассчитывается от налоговой базы по ставке 16%; итог влияет на СуммаДокумента и СуммаРегл (в тенге). 5.2 Электронные документы По товарным операциям, отражаемым документом, может формироваться ЭСФ (электронная счёт-фактура в ИС ЭСФ) и при необходимости СНТ (сопроводительная накладная на товары). Конкретный набор ЭД зависит от ТипПервичногоДокумента и настроек организации. 6. Связанные объекты и ввод на основании - Справочники-источники: Организации, Партнеры, Контрагенты, ДоговорыКонтрагентов / ДоговорыМеждуОрганизациями, Валюты, ГруппыФинансовогоУчетаРасчетов, НаправленияДеятельности, СтруктураПредприятия. - Перечисления: ТипыПервичныхДокументов, ПорядокРасчетов. - Ввод на основании: через ОбработкаЗаполнения документ может заполняться на основании данных партнёра/контрагента и настроек. Как источник — служит основанием для формирования ЭСФ/СНТ и связанных расчётных документов. - Регистры-потребители: ДетализацияПартийТоваровДляНДСиУСН, СебестоимостьТоваров, а также подсистемы взаиморасчётов и денежных средств при отражении в учёте. 7. Точки расширения - Обработчики модуля объекта (ОбработкаЗаполнения, ОбработкаПроверкиЗаполнения, ПередЗаписью, ПриЗаписи) — расширяйте через механизм расширений конфигурации, а не правкой типового кода. - Формы ФормаДокумента / ФормаСписка — добавление реквизитов формы, команд и обработчиков событий через расширение. - Дополнительные реквизиты/сведения — используйте механизм «Свойства» для добавления аналитики без изменения структуры. - Правила учёта — счета и группы финансового учёта настраиваются данными (ГруппыФинансовогоУчетаРасчетов), без изменения кода. - Обмен данными — регистрация изменений в ПриЗаписи позволяет включить документ в планы обмена. Требует проверки в 3.4.5.21: точный состав движений и подключённых ЭД для каждого значения ТипПервичногоДокумента — задаётся настройками отражения операций в учётной политике организации. --- _BuhGPT — ИИ-помощник для бухгалтеров Казахстана: https://buhgpt.kz_