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: точный состав движений и подключённых ЭД для каждого значения
ТипПервичногоДокумента— задаётся настройками отражения операций в учётной политике организации.