Документ «Электронный счет-фактура (ЭСФ)»

ЭСФ — ключевой электронный налоговый документ Республики Казахстан. Он обеспечивает отправку сведений о реализации в ИС ЭСФ (исходящие) и получение сведений от поставщиков (входящие). В отличие от обычного счета-фактуры, ЭСФ делает движения по виртуальным складам (регистры накопления ТоварыНаВиртуальныхСкладах и ТоварыВиртуальногоСкладаВРезерве), но бухгалтерских проводок (Дт/Кт) не формирует.

Бухгалтерия для Казахстана, ред. 3.0 · v3.0.72.1 · обновлено 2026-06-05

🎯 Что это и зачем

В Казахстане электронные счета-фактуры (ЭСФ) обязательны для большинства налогоплательщиков. Документ ЭСФ в 1С: - Формирует XML-структуру и передает ее в государственную систему ИС ЭСФ; - Позволяет получать входящие документы от поставщиков по API; - Хранит официальный регистрационный номер ИС ЭСФ и статус документа; - Реализует учет товаров на виртуальных складах (прослеживаемость импорта, производства и реализации).

Кто работает: бухгалтеры, ежедневно. Документ создается на основании внутренних счетов-фактур или загружается при синхронизации с порталом.

🧭 Где найти в программе

Документ доступен в разделе «ЭСФ/ЭАВР» → пункт «Электронные счета-фактуры». В зависимости от роли и настроек, вы можете открыть: - Список полученных (входящих) ЭСФ — форма ФормаСпискаВходящих; - Список выданных (исходящих) ЭСФ — форма ФормаСпискаИсходящих.

📷 СКРИН 01
СКРИН 01 — Раздел «ЭСФ/ЭАВР», журнал «Электронные счета-фактуры» с раздельными вкладками Входящие/Исходящие. (AccountingKZ30 во Fresh; маршрут: ЭСФ/ЭАВР → Электронные счета-фактуры)

👤 Часть 1. Для пользователя

Пошаговые инструкции по полному циклу обмена: создание, отправка, сопоставление товаров, корректировка и отклонение документов.

Урок 1. Создание и отправка исходящего ЭСФ

Когда: вы реализовали ТМЗ/услугу контрагенту и должны выписать ЭСФ в регламентированный срок.

Шаг 1. Создаем ЭСФ на основании

Лучший способ — открыть внутренний документ Счет-фактура выданный и нажать кнопку «Создать на основании» → «Электронный счет-фактура (исходящий)». Программа автоматически заполнит: - Направление = «Исходящий»; - Организация и Контрагент; - Табличную часть Товары (номенклатура, коды ТН ВЭД, признаки происхождения, количество и суммы); - Склад — виртуальный склад вашей организации.

📷 СКРИН 02
СКРИН 02 — Создание ЭСФ на основании документа «Счет-фактура выданный».

Шаг 2. Проверяем реквизиты

В открывшейся ФормаДокумента убедитесь, что заполнены: - Дата оборота — дата совершения оборота по реализации (критично для периода НДС); - ВалютаКод — трехзначный код валюты (по умолчанию KZT); - Склад — выбран ваш Виртуальный склад; - Договор поставки (номер и дата).

Шаг 3. Валидация перед отправкой

Нажмите кнопку «Проверить» на командной панели. Если в данных есть логические ошибки (неверный ИИН/БИН, незаполненный признак происхождения товара, не сходится сумма), они отобразятся в табличной части «Ошибки».

Шаг 4. Подписание и отправка

  1. Нажмите «Записать».
  2. Нажмите кнопку «Отправить».
  3. Система откроет окно для выбора сертификата ЭЦП (подпись подсистемы ИС ЭСФ). Выберите ключ и введите пароль.

После успешной отправки ИС ЭСФ присвоит документу Регистрационный номер (формата XXXXXXXXXXXX-XXXX), а статус изменится на «Отправлен» или «Принят».


Урок 2. Получение и регистрация входящего ЭСФ

Когда: поставщик выписал ЭСФ на ваше имя, и вам нужно принять НДС к зачету и отразить товар на виртуальном складе.

Шаг 1. Синхронизация с порталом

Откройте список полученных ЭСФ и нажмите кнопку «Получить электронные счета-фактуры из ИС ЭСФ» (команда Синхронизировать). Программа свяжется с сервером ИС ЭСФ по вашему токену/паролю и загрузит все новые документы. В списке появятся записи со статусом «Получен».

📷 СКРИН 03
СКРИН 03 — Кнопка «Синхронизировать» в списке входящих ЭСФ.

Шаг 2. Сопоставление с учетной базой

  1. Откройте новый входящий ЭСФ.
  2. Проверьте данные поставщика и перечень товаров/услуг.
  3. Свяжите ЭСФ со счетом-фактурой поставщика. В поле СчетФактура выберите соответствующий внутренний документ Счет-фактура полученный (или создайте его по кнопке «Создать на основании»).
  4. Нажмите кнопку «Найти» (ПоставщикНайти) на вкладке товаров для автоматического сопоставления номенклатуры поставщика с вашей базой.

Шаг 3. Проведение по виртуальному складу

Укажите Склад (ваш виртуальный склад) и нажмите кнопку «Провести». Это отразит приход товара на вашем виртуальном складе, что позволит в дальнейшем выписывать исходящие ЭСФ и СНТ на этот товар.


Урок 3. Создание корректировочного ЭСФ

Когда: изменилась цена или количество товара (например, предоставлена скидка или возвращен излишек), и нужно скорректировать НДС.

  1. Найдите исходный зарегистрированный в ИС ЭСФ (исходящий) документ ЭСФ.
  2. Нажмите «Создать на основании» → «Электронный счет-фактура».
  3. В созданном документе программа автоматически установит: - Вид = «Корректировочный»; - СвязанныйЭСФ = ссылка на исходный документ; - Перенесутся все исходные реквизиты.
  4. Обязательно заполните текстовое поле Причина (например, «Увеличение цены на 5%»).
  5. Отредактируйте строки в табличной части Товары, указав измененное количество или цены.
  6. Проверьте и отправьте корректировочный ЭСФ в ИС ЭСФ с подписанием ЭЦП.
📷 СКРИН 04
СКРИН 04 — Создание корректировочного ЭСФ с заполнением реквизитов связи и причины.

Урок 4. Отклонение и отзыв ЭСФ


Урок 5. Загрузка из XML и обновление статусов


🛠 Часть 2. Для программиста

Технический разбор структуры метаданных, программного API модуля, бизнес-логики проведения и зависимостей.

Главное про объект в одном абзаце

Документ ЭСФ является чисто налоговым и виртуально-складским объектом. У него отсутствует логика бухгалтерского плана счетов — бухгалтерские проводки Дт/Кт не формируются. Однако, в отличие от СчетФактураВыданный, проведение документа ЭСФ активно формирует движения по регистрам накопления Виртуального склада: ТоварыНаВиртуальныхСкладах и ТоварыВиртуальногоСкладаВРезерве. Вся тяжелая логика обмена с ИС ЭСФ (формирование XML, подпись, HTTP-запросы) делегирована в общие модули ОбработкаОбменЭСФ, ЭСФСервер, ЭСФКлиентСервер.


Формы документа

Имя формы Синоним Назначение
ФормаВыбора — Форма выбора ЭСФ из списка (упрощённая, для полей ввода с подбором)
ФормаСписка — Промежуточная форма выбора направления ЭСФ (входящие/исходящие) перед открытием основного списка
ФормаСпискаВходящих «Электронные счета-фактуры (полученные)» Основная форма списка входящих ЭСФ — фильтры, синхронизация с ИС ЭСФ, обновление статусов, отклонение
ФормаСпискаИсходящих «Электронные счета-фактуры (выданные)» Основная форма списка исходящих ЭСФ — отправка, проверка, выгрузка, отзыв
ФормаДокумента — Ключевая форма редактирования ЭСФ — все реквизиты и табличные части, сценарии заполнения, валидация, подписание

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

Реквизиты шапки (полный справочник)

Все реквизиты документа сгруппированы по функциональному назначению.

Группа: Идентификация и ЭДО

Имя Тип Обязательность Назначение
Идентификатор xs:string DontCheck Уникальный идентификатор документа в ИС ЭСФ; присваивается системой при регистрации
РегистрационныйНомер xs:string DontCheck Внешний регистрационный номер ИС ЭСФ (формат XXXXXXXXXXXX-XXXX)
Направление EnumRef.НаправленияЭСФ ShowError Входящий / Исходящий. Определяет видимость полей, логику заполнения и валидации
Статус EnumRef.СтатусыЭСФ DontCheck Статус документа на портале (Новый, Отправлен, Принят, Отклонён, Отозван, Аннулирован)
Состояние EnumRef.СостоянияЭСФ DontCheck Состояние обработки документа в информационной системе (Новый, Обработан и т.д.)
ПользовательскийСтатус EnumRef.ПользовательскиеСтатусыЭСФ DontCheck Пользовательский статус для внутреннего учёта организации (классификация пользователем)
УполномоченныйСотрудник xs:string DontCheck ФИО сотрудника, уполномоченного подписывать ЭСФ
Автор — DontCheck Ссылка на пользователя, создавшего документ
ФайлЭСФ ValueStorage DontCheck Хранилище исходного XML-файла документа (бинарные данные)
ВерсияБланкаЭСФ xs:decimal DontCheck Версия формата бланка ИС ЭСФ (например, 2.0, 3.0) — определяет набор полей XML

Группа: Основные реквизиты

Имя Тип Обязательность Назначение
ДатаОборота xs:dateTime ShowError Дата совершения оборота по НДС (отгрузка/получение); не путать с датой документа
Вид EnumRef.ВидыЭСФ ShowError Основной, Корректировочный, Дополнительный, Исправленный
Причина xs:string DontCheck Причина создания корректировочного/дополнительного ЭСФ (обязательна для корр. видов)
Контрагент — DontCheck Основной контрагент (покупатель для исходящих / поставщик для входящих)
Организация — DontCheck Организация, от лица которой выписан/получен ЭСФ
СтруктурноеПодразделение — DontCheck Структурное подразделение организации
СуммаДокумента xs:decimal DontCheck Итоговая сумма с налогами (автоматически пересчитывается из ТЧ «Товары»)
Комментарий xs:string DontCheck Произвольный комментарий пользователя
ДополнительныеСведения xs:string DontCheck Произвольная текстовая информация к ЭСФ
СчетФактура DocumentRef.* DontCheck Связанный внутренний документ 1С (СФ выданный или полученный)

Группа: Связанный ЭСФ (корректировки)

Имя Тип Обязательность Назначение
СвязанныйЭСФ DocumentRef.ЭСФ DontCheck Ссылка на исходный ЭСФ (обязателен для корректировочных/дополнительных видов)
СвязанныйЭСФДата xs:dateTime DontCheck Дата связанного ЭСФ (дублируется для отображения без дополнительных запросов)
СвязанныйЭСФНомер xs:string DontCheck Номер связанного ЭСФ
СвязанныйЭСФРегистрационныйНомер xs:string DontCheck Регистрационный номер связанного ЭСФ в ИС ЭСФ

Группа: Грузоотправитель

Имя Тип Обязательность Назначение
Грузоотправитель — DontCheck Ссылка на справочник контрагентов (грузоотправитель)
ГрузоотправительИдентификатор xs:string DontCheck ИИН/БИН грузоотправителя
ГрузоотправительНаименование xs:string DontCheck Полное наименование грузоотправителя
АдресОтправки xs:string DontCheck Адрес фактической отгрузки товара

Группа: Грузополучатель

Имя Тип Обязательность Назначение
Грузополучатель — DontCheck Ссылка на справочник контрагентов (грузополучатель)
ГрузополучательИдентификатор xs:string DontCheck ИИН/БИН грузополучателя
ГрузополучательНаименование xs:string DontCheck Полное наименование грузополучателя
АдресДоставки xs:string DontCheck Адрес фактической доставки товара
ГрузополучательКодСтраны xs:string DontCheck Код страны грузополучателя для экспортных операций
ПунктНазначения xs:string DontCheck Пункт назначения груза

Группа: Договор поставки

Имя Тип Обязательность Назначение
ДоговорПоставки — DontCheck Ссылка на справочник договоров
ДоговорПоставкиНомер xs:string DontCheck Номер договора поставки
ДоговорПоставкиДата xs:dateTime DontCheck Дата договора поставки
ДоговорПоставкиУсловияОплаты xs:string DontCheck Условия оплаты по договору
ДоговорПоставкиСпособОтправления xs:string DontCheck Способ отправления товара
ДоговорПоставкиУсловияПоставки xs:string DontCheck Условия поставки по договору

Группа: Документ, подтверждающий поставку

Имя Тип Обязательность Назначение
ДокументПодтверждающийПоставкуНомер xs:string DontCheck Номер документа поставки (накладная, акт)
ДокументПодтверждающийПоставкуДата xs:dateTime DontCheck Дата документа поставки
ДокументПодтверждающийПоставкуАВРНомер xs:string DontCheck Номер документа поставки для АВР (акт выполненных работ)
ДокументПодтверждающийПоставкуАВРДата xs:dateTime DontCheck Дата документа поставки для АВР

Группа: Доверенность на поставку

Имя Тип Обязательность Назначение
ДоверенностьНаПоставкуНомер xs:string DontCheck Номер доверенности на поставку
ДоверенностьНаПоставкуДата xs:dateTime DontCheck Дата доверенности на поставку

Группа: Госучреждение

Имя Тип Обязательность Назначение
ГосучреждениеИИК xs:string DontCheck ИИК государственного учреждения (для бюджетных операций)
ГосучреждениеКодТоваров xs:string DontCheck Код товаров, работ, услуг для госучреждений
ГосучреждениеНазначениеПлатежа xs:string DontCheck Назначение платежа для госучреждений
ГосучреждениеБИК xs:string DontCheck БИК банка госучреждения

Группа: Валюта

Имя Тип Обязательность Назначение
ВалютаКод xs:string ShowError Буквенный код валюты (ISO 4217, 3 символа: KZT, USD, RUB и т.д.)
Валюта — DontCheck Ссылка на справочник валют (заполняется автоматически по коду)
КурсВалюты xs:decimal DontCheck Курс валюты на дату оборота (для пересчёта в тенге)

Группа: ЭЦП и подпись

Имя Тип Обязательность Назначение
ТипПодписи EnumRef.ТипыПодписиЭСФ DontCheck Тип ЭЦП (Обычная, Усиленная и т.д.)
ЭЦП xs:string DontCheck Строка электронной цифровой подписи (Base64)

Группа: Поверенные поставщика

Имя Тип Обязательность Назначение
ПоверенныйПоставщикаБИН xs:string DontCheck БИН поверенного поставщика
ПоверенныйПоставщикаНаименование xs:string DontCheck Наименование поверенного поставщика
ПоверенныйПоставщикаАдресМестонахождения xs:string DontCheck Адрес местонахождения поверенного поставщика
ДоговорПорученияПоставщикаНомер xs:string DontCheck Номер договора поручения поставщика
ДоговорПорученияПоставщикаДата xs:dateTime DontCheck Дата договора поручения поставщика

Группа: Поверенные покупателя

Имя Тип Обязательность Назначение
ПоверенныйПокупателяБИН xs:string DontCheck БИН поверенного покупателя
ПоверенныйПокупателяНаименование xs:string DontCheck Наименование поверенного покупателя
ПоверенныйПокупателяАдресМестонахождения xs:string DontCheck Адрес местонахождения поверенного покупателя
ДоговорПорученияПокупателяНомер xs:string DontCheck Номер договора поручения покупателя
ДоговорПорученияПокупателяДата xs:dateTime DontCheck Дата договора поручения покупателя

Группа: Виртуальный склад и прочее

Имя Тип Обязательность Назначение
Склад CatalogRef.ВиртуальныеСклады ShowError Виртуальный склад организации (обязателен для проведения документа)
ОтражаетсяВВС xs:boolean DontCheck Признак отражения на виртуальном складе (управляет формированием движений)
МестоРеализацииНеРК xs:boolean DontCheck Признак реализации за пределами РК (без НДС РК)
СНТ — DontCheck Ссылка на документ «Сопроводительная накладная на товары»
УникальныйНомерВалютногоКонтроля xs:string DontCheck Учетный номер валютного контроля для экспортных операций
ДатаВыпискиНаБумажномНосителе xs:dateTime DontCheck Дата выписки бумажной версии (при наличии)
ПричинаВыпискиНаБумажномНосителе EnumRef.ПричиныВыпискиСФНаБумаге DontCheck Причина выписки ЭСФ на бумаге (техническая невозможность и т.д.)
СпособОтправленияПоКлассификатору xs:string DontCheck Код способа отправления из классификатора ИС ЭСФ

Табличные части (полный справочник)

ТЧ «Поставщики» (26 колонок)

Назначение: содержит информацию о поставщиках товаров/услуг. Для входящих ЭСФ заполняется из ИС ЭСФ; для исходящих — автоматически из реквизитов организации. Поддерживает несколько поставщиков для посреднических операций (комиссия, совместная деятельность).

Имя колонки Тип Назначение
Поставщик — Ссылка на элемент справочника «Контрагенты»
ПоставщикИдентификатор xs:string ИИН или БИН поставщика (12 цифр)
ПоставщикНаименование xs:string Полное наименование поставщика (из учредительных документов)
Адрес xs:string Адрес места нахождения поставщика
СерияСвидетельстваПоНДС xs:string Серия свидетельства плательщика НДС
НомерСвидетельстваПоНДС xs:string Номер свидетельства плательщика НДС
Комитент xs:boolean Признак: поставщик является комитентом
Комиссионер xs:boolean Признак: поставщик является комиссионером
Экспедитор xs:boolean Признак: поставщик является экспедитором
Лизингодатель xs:boolean Признак: поставщик является лизингодателем
УчастникСовместнойДеятельности xs:boolean Признак: участник совместной деятельности
ЭкспортерИлиУчастникСРП xs:boolean Признак: экспортёр или участник СРП (соглашение о разделе продукции)
УчастникСРП xs:boolean Признак: участник СРП (новая версия формата)
Экспортер xs:boolean Признак: экспортёр (новая версия)
МеждународныйПеревозчик xs:boolean Признак: международный перевозчик
Доверитель xs:boolean Признак: поставщик является доверителем
ДокументПодтверждающийПоставкуНомер xs:string Номер документа поставки (акт, накладная)
ДокументПодтверждающийПоставкуДата xs:dateTime Дата документа поставки
ДополнительныеСведения xs:string Дополнительная информация о поставщике
КБе xs:string Код бюджетной классификации (для госучреждений)
ИИК xs:string Индивидуальный идентификационный код банковского счёта
БИК xs:string Банковский идентификационный код
НаименованиеБанка xs:string Наименование банка поставщика
ДоляУчастия xs:decimal Коэффициент доли участия в совместной деятельности (0…1)
БИНФилиала xs:string БИН филиала/структурной единицы поставщика
БИНРеорганизованногоЛица xs:string БИН реорганизованного юридического лица (при правопреемстве)
ЯвляетсяСтруктурнымПодразделениемНерезидента xs:boolean Признак: структурное подразделение юридического лица-нерезидента
Адвокат xs:boolean Признак: поставщик — адвокат
СудебныйИсполнитель xs:boolean Признак: судебный исполнитель
Медиатор xs:boolean Признак: медиатор
Нотариус xs:boolean Признак: нотариус

ТЧ «Получатели» (24 колонки)

Назначение: содержит информацию о получателях товаров/услуг. Для исходящих ЭСФ заполняется из данных контрагента; для входящих — автоматически из ИС ЭСФ. Поддерживает нескольких получателей для комплексных операций.

Имя колонки Тип Назначение
Получатель — Ссылка на справочник «Контрагенты»
ПолучательИдентификатор xs:string ИИН/БИН получателя
ПолучательНаименование xs:string Полное наименование получателя
Адрес xs:string Адрес места нахождения получателя
СерияСвидетельстваПоНДС xs:string Серия свидетельства плательщика НДС
НомерСвидетельстваПоНДС xs:string Номер свидетельства плательщика НДС
ДополнительныеСведения xs:string Дополнительная информация о получателе
Комитент xs:boolean Признак: получатель является комитентом
Комиссионер xs:boolean Признак: получатель является комиссионером
Лизингодатель xs:boolean Признак: получатель является лизингополучателем
УчастникСовместнойДеятельности xs:boolean Признак: участник совместной деятельности
ГосударственноеУчреждение xs:boolean Признак: получатель — государственное учреждение
Нерезидент xs:boolean Признак: нерезидент или розничная реализация (старая версия формата)
НерезидентВерсия2 xs:boolean Признак: нерезидент (новая версия формата, разделён от розницы)
РозничнаяРеализация xs:boolean Признак: розничная реализация (выделен из Нерезидент в новой версии)
ФизическоеЛицо xs:boolean Признак: получатель — физическое лицо
ДоляУчастия xs:decimal Коэффициент доли участия
КодСтраны xs:string Код страны получателя (для экспорта)
УчастникСРП xs:boolean Признак: участник СРП
Доверитель xs:boolean Признак: доверитель
БИНРеорганизованногоЛица xs:string БИН реорганизованного лица
БИНФилиала xs:string БИН структурной единицы
Адвокат xs:boolean Признак: адвокат
СудебныйИсполнитель xs:boolean Признак: судебный исполнитель
Медиатор xs:boolean Признак: медиатор
Нотариус xs:boolean Признак: нотариус

ТЧ «Товары» (30 колонок)

Назначение: основная табличная часть — детализация товаров/работ/услуг с указанием количества, цен, ставок НДС и акцизов, происхождения товара и данных для прослеживаемости.

Имя колонки Тип Назначение
Товар — Ссылка на справочник «Номенклатура»
ТоварНаименование xs:string Наименование товара, работ, услуг (текстовое)
КодТНВЭД xs:string Код товара по ТН ВЭД (для экспорта/импорта)
ЕдиницаИзмерения — Ссылка на справочник «Единицы измерения»
ЕдиницаИзмеренияНаименование xs:string Наименование единицы измерения (штук, литров, кг и т.д.)
ЕдиницаИзмеренияКод xs:string Код единицы измерения по классификатору ИС ЭСФ
Количество xs:decimal Количество (объем) товара в единицах измерения
Цена xs:decimal Цена за единицу без налогов (НДС и акцизов)
СуммаБезНалогов xs:decimal Стоимость без налогов (Количество × Цена)
СтавкаАкциза — Ссылка на справочник ставок акцизов
СтавкаАкцизаЧисло xs:decimal Числовое значение ставки акциза (%, тенге/ед.)
СуммаАкциза xs:decimal Сумма акциза по позиции
ОборотПоРеализации xs:decimal Оборот по реализации (СуммаБезНалогов + СуммаАкциза) — база для НДС
СтавкаНДС — Ссылка на справочник ставок НДС
СтавкаНДСЧисло xs:decimal Числовое значение ставки НДС (обычно 12%)
БезНДС xs:boolean Признак: операция без НДС (освобождённая от НДС)
СуммаНДС xs:decimal Сумма НДС по позиции
Сумма xs:decimal Стоимость с налогами (ОборотПоРеализации + СуммаНДС)
ПризнакПроисхождения xs:string Признак происхождения товара (импорт, производство РК и т.д., значения 1–6)
ИсточникПроисхождения CatalogRef.ИсточникиПроисхождения Ссылка на справочник источников происхождения
ИдентификаторТовара xs:string Идентификатор товара в ИС ЭСФ (для прослеживаемости)
НомерЗаявленияВРамкахТС xs:string Номер заявления в рамках Таможенного союза или Декларации на товары
НомерГТД — Ссылка на справочник «ГТД» (грузовая таможенная декларация)
ДополнительныеДанные xs:string Дополнительная информация по товару
ТоварНаименованиеВРамкахТС xs:string Наименование товара в соответствии с Декларацией на товары или заявлением о ввозе
НомерПозицииВДекларацииИлиЗаявлении xs:string Номер товарной позиции из заявления о ввозе товаров
ЕдиницаИзмеренияХраненияОстатков — Единица измерения для складского учёта (может отличаться от ЕИ в ЭСФ)
КоэффициентПересчета xs:decimal Коэффициент пересчёта между единицей измерения ЭСФ и учётной единицей
ДополнительныйИдентификатор xs:decimal Дополнительный числовой идентификатор товара (ID)
ПризнакУчетаНаВиртуальномСкладе xs:boolean Признак: товар учитывается на виртуальном складе
НомерИзСНТ xs:string Номер позиции из сопроводительной накладной на товары (СНТ)
КоличественнаяЕдИзм — Ссылка на количественную единицу измерения (для маркировки)
КоличественнаяЕдИзмКод xs:string Код количественной единицы измерения
КоличествоВКоличественнойЕдИзм xs:decimal Количество в количественной единице измерения (для маркировки)
GTIN xs:string Глобальный номер товарной позиции (штрих-код GTIN-13/GTIN-14)

ТЧ «ТоварыПоПоставщикам» (13 колонок)

Назначение: распределение товаров из ТЧ «Товары» по поставщикам для сложных операций с несколькими поставщиками (комиссия, совместная деятельность). Каждая строка связывает товар (по номеру) с поставщиком (по ИИН/БИН).

Имя колонки Тип Назначение
Идентификатор xs:string ИИН/БИН поставщика (связь с ТЧ «Поставщики» по ПоставщикИдентификатор)
НомерТовара xs:decimal Номер строки из ТЧ «Товары»
Количество xs:decimal Количество товара от данного поставщика
СуммаБезНалогов xs:decimal Стоимость без налогов
СуммаАкциза xs:decimal Сумма акциза
ОборотПоРеализации xs:decimal Оборот по реализации
СуммаНДС xs:decimal Сумма НДС
Сумма xs:decimal Стоимость с налогами
ДополнительныеДанные xs:string Дополнительная информация
НомерИзСНТ xs:string Номер позиции из СНТ
КоличественнаяЕдИзм xs:string Код количественной единицы измерения
КоличествоВКоличественнойЕдИзм xs:decimal Количество в количественной единице
GTIN xs:string Код товара GTIN

ТЧ «ТоварыПоПолучателям» (13 колонок)

Назначение: распределение товаров из ТЧ «Товары» по получателям для операций с несколькими получателями. Структура идентична «ТоварыПоПоставщикам», но привязка идёт к получателю.

Имя колонки Тип Назначение
Идентификатор xs:string ИИН/БИН получателя (связь с ТЧ «Получатели» по ПолучательИдентификатор)
НомерТовара xs:decimal Номер строки из ТЧ «Товары»
Количество xs:decimal Количество товара для данного получателя
СуммаБезНалогов xs:decimal Стоимость без налогов
СуммаАкциза xs:decimal Сумма акциза
ОборотПоРеализации xs:decimal Оборот по реализации
СуммаНДС xs:decimal Сумма НДС
Сумма xs:decimal Стоимость с налогами
ДополнительныеДанные xs:string Дополнительная информация
НомерИзСНТ xs:string Номер позиции из СНТ
КоличественнаяЕдИзм xs:string Код количественной единицы измерения
КоличествоВКоличественнойЕдИзм xs:decimal Количество в количественной единице
GTIN xs:string Код товара GTIN

ТЧ «Ошибки» (2 колонки)

Назначение: служебная табличная часть для хранения ошибок валидации ЭСФ при обмене с ИС ЭСФ или внутренних проверках.

Имя колонки Тип Назначение
Текст xs:string Текст сообщения об ошибке
Поле xs:string Имя поля / адрес ячейки, в которой обнаружена ошибка

Жизненный цикл — обработчики ObjectModule

ObjectModule.bsl оркестрирует стандартные события 1С, перенаправляя вызовы в специализированные общие модули:

ОбработкаЗаполнения

Инициализирует новый документ. Устанавливает направление по умолчанию, заполняет организацию, автора и валюту. При создании на основании счета-фактуры вызывает общий метод заполнения данных из СФ в структуру ЭСФ.

ПередЗаписью

  1. Считает СуммаДокумента как итог по табличной части товаров.
  2. Проверяет режим загрузки обмена (ОбменДанными.Загрузка). Если истина — проверки пропускаются.
  3. Перед проведением выполняет валидацию заполнения виртуальных складов.
  4. Вызывает ЭСФСервер.ПередЗаписьюЭСФ(ЭтотОбъект).

ОбработкаПроверкиЗаполнения

Формирует массив МассивНепроверяемыхРеквизитов в зависимости от направления и вида документа. Вызывает ЭСФСервер.ПроверитьЗаполнениеЭСФ(ЭтотОбъект, Отказ, ПроверяемыеРеквизиты, МассивНепроверяемыхРеквизитов). - Если Вид = Корректировочный — реквизит СвязанныйЭСФ и строка Причина принудительно проверяются. - Если Направление = Входящий — очищаются из обязательных проверки исходящих полей.

ПриКопировании

Очищает уникальные идентификаторы, ЭЦП, статус сбрасывается в значение по умолчанию («Новый»), ТЧ Ошибки очищается:

Идентификатор = Неопределено;
РегистрационныйНомер = Неопределено;
Статус = ПредоставленноеЗначение("Перечисление.СтатусыЭСФ.Новый");
ЭЦП = Неопределено;
Ошибки.Очистить();

ОбработкаПроведения

Формирует движения по виртуальным складам на основе табличной части Товары при включенном флаге ОтражаетсяВВС:

// Движения по виртуальным складам
Если ОтражаетсяВВС Тогда
    ДвиженияВиртуальногоСклада = ВиртуальныеСкладыСервер.ПодготовитьДвиженияТоваровЭСФ(ЭтотОбъект);
    ВиртуальныеСкладыСервер.ЗаписатьДвиженияТоваров(Движения, ДвиженияВиртуальногоСклада);
КонецЕсли;

Движения по регистрам

При проведении документа ЭСФ с флагом ОтражаетсяВВС формируются следующие движения:

  1. Регистр накопления ТоварыНаВиртуальныхСкладах:
    • Приход (для входящего ЭСФ): Увеличивает остатки товаров на выбранном виртуальном складе с указанием источника происхождения.
    • Расход (для исходящего ЭСФ): Списывает количество товаров с виртуального склада.
  2. Регистр накопления ТоварыВиртуальногоСкладаВРезерве:
    • Управляет резервированием товаров на виртуальном складе в процессе отправки или корректировки ЭСФ.

Важно: Бухгалтерские проводки (движения по плану счетов) документ ЭСФ не формирует. За бухгалтерский учёт отвечают связанные документы: СчетФактураВыданный, СчетФактураПолученный, РеализацияТМЗИУслуг.


Расширенные сценарии (для разработчика)

Сценарий 3.5. Отзыв исходящего ЭСФ

Когда применяется: обнаружена ошибка в отправленном ЭСФ до того, как покупатель его принял.

Шаги пользователя: 1. Открыть список исходящих ЭСФ. 2. Найти отправленный ЭСФ со статусом «Отправлен» (не «Принят»!). 3. Открыть документ. 4. Нажать кнопку «Отозвать» (команда ФормаОтозвать). 5. В диалоге указать Причину отзыва (обязательно). 6. Подтвердить отзыв. 7. Система отправляет запрос на отзыв в ИС ЭСФ. 8. Статус меняется на «Отозван». 9. После отзыва можно создать исправленный ЭСФ.

Проверки: - Система проверяет статус ЭСФ в ИС ЭСФ (можно отозвать только до принятия покупателем). - Контролируется наличие причины отзыва.

Что произойдёт: - Отозванный ЭСФ становится недействительным в ИС ЭСФ. - Движения по регистрам остаются (при необходимости документ нужно распровести вручную). - Можно создать новый ЭСФ с исправленными данными.

Сценарий 3.6. Загрузка ЭСФ из XML-файла

Когда применяется: ЭСФ получен не через ИС ЭСФ, а в виде XML-файла (например, по электронной почте, через внешний обмен).

Шаги пользователя: 1. Открыть список входящих или исходящих ЭСФ (в зависимости от направления). 2. Нажать кнопку «Загрузить из XML (ЭСФ)» (команда Импортировать). 3. В диалоге выбора файла указать путь к XML-файлу ЭСФ. 4. Система парсит XML и создаёт новый документ ЭСФ. 5. Открывается форма созданного документа с заполненными данными из XML. 6. Проверить данные: - Контрагентов (автоматически сопоставляются по ИИН/БИН); - Товары (сопоставляются по наименованию и кодам); - Суммы и ставки НДС. 7. При необходимости вручную сопоставить несопоставленные элементы. 8. Записать документ. 9. Если ЭСФ входящий — провести для формирования движений.

Проверки: - Система проверяет корректность формата XML (соответствие схеме ИС ЭСФ). - Валидирует обязательные реквизиты. - Проверяет электронную подпись (если присутствует в XML).

Что произойдёт: - Создаётся документ ЭСФ со статусом «Новый». - Реквизит ФайлЭСФ сохраняет исходный XML. - При последующей синхронизации система может связать документ с записью в ИС ЭСФ (по идентификатору).

Сценарий 3.7. Обновление статусов ЭСФ

Когда применяется: регулярная синхронизация для получения актуальных статусов отправленных/полученных ЭСФ из ИС ЭСФ.

Шаги пользователя: 1. Открыть список исходящих или входящих ЭСФ. 2. Выделить один или несколько документов (или не выделять — обновятся все). 3. Нажать кнопку «Обновить ЭСФ» (команда Обновить / СписокКнопкаОбновить). 4. Система подключается к ИС ЭСФ и запрашивает актуальные статусы. 5. Обновляются реквизиты: - Статус (Отправлен, Принят, Отклонён, Аннулирован и т.д.); - РегистрационныйНомер (если ЭСФ зарегистрирован); - Состояние (текущее состояние обработки). 6. В табличной части Ошибки появляются сообщения об ошибках (если есть). 7. Система показывает уведомление о количестве обновлённых документов.

Проверки: - Система проверяет наличие подключения к ИС ЭСФ. - Контролируется наличие сертификата ЭЦП для аутентификации.

Что произойдёт: - Актуализируются статусы документов. - Пользователь видит актуальное состояние ЭСФ. - На основании статусов можно формировать отчёты и контролировать обороты.


Per-field reference (детальное описание ключевых реквизитов)

Направление (EnumRef.НаправленияЭСФ)

Описание: определяет направление документа — «Исходящий» (выданный, от продавца) или «Входящий» (полученный, от покупателя). Это самый критичный реквизит, от которого зависит: - Видимость и обязательность других полей (для исходящих обязательны данные получателя, для входящих — поставщика); - Логика заполнения табличных частей «Поставщики» и «Получатели»; - Алгоритм формирования движений по регистрам; - Доступные команды формы (кнопка «Отправить» только для исходящих, «Принять» — для входящих).

Обязательность: Да (ShowError) — без заполнения документ не запишется.

Валидация: обработчик ОбработкаПроверкиЗаполнения проверяет, что направление заполнено и имеет корректное значение из перечисления.

Типичные значения: - «Исходящий» — при создании ЭСФ на реализацию; - «Входящий» — при получении ЭСФ от поставщика.


ДатаОборота (xs:dateTime)

Описание: дата совершения оборота (отгрузки товара, оказания услуг). Это налоговая дата, по которой определяется период отражения НДС в учёте. Не путать с датой документа (дата создания ЭСФ).

Обязательность: Да (ShowError).

Влияние на другие поля: при изменении даты оборота может автоматически пересчитываться курс валюты (если валюта не тенге). От даты оборота зависит период, в котором ЭСФ попадёт в отчётность по НДС.

Валидация: проверяется, что дата оборота не больше текущей даты и не старше установленного лимита (обычно не более 12 месяцев для корректировочных ЭСФ). Также контролируется, что дата не ранее даты создания организации.

Типичные значения: обычно совпадает с датой отгрузочного документа (накладная, акт).


Вид (EnumRef.ВидыЭСФ)

Описание: вид счёта-фактуры, определяющий тип операции.

Обязательность: Да (ShowError).

Влияние на другие поля: при выборе «Корректировочный» становятся обязательными поля СвязанныйЭСФ и Причина. При выборе «Дополнительный» также требуется связь с исходным документом. Для вида «Основной» эти поля не обязательны.

Валидация: при виде «Корректировочный» или «Дополнительный» система проверяет наличие и статус связанного ЭСФ.

Типичные значения: - «Основной» — обычный ЭСФ при первичной реализации; - «Корректировочный» — при изменении стоимости/количества; - «Дополнительный» — при доначислении НДС или других случаях; - «Исправленный» — при исправлении ошибок в реквизитах.


Склад (CatalogRef.ВиртуальныеСклады)

Описание: виртуальный склад для учёта товаров по ЭСФ. Виртуальные склады используются для обособленного учёта товаров, по которым выписаны/получены ЭСФ, от общего складского учёта.

Обязательность: Да (ShowError) — обязателен для проведения документа.

Влияние на другие поля: при изменении склада пересчитываются остатки товаров (если включена проверка остатков). От склада зависят движения по регистрам накопления.

Валидация: проверяется, что склад не помечен на удаление, относится к текущей организации и имеет тип «Виртуальный».

Типичные значения: для каждой организации создаётся один или несколько виртуальных складов (например, «ВС Основной», «ВС Экспорт»).


ВалютаКод (xs:string)

Описание: код валюты по классификатору (например, «KZT» для тенге, «USD» для доллара, «RUB» для рубля).

Обязательность: Да (ShowError).

Влияние на другие поля: при изменении валюты автоматически заполняется поле Валюта (ссылка на справочник) и КурсВалюты (курс на дату оборота). Все суммы в табличной части «Товары» пересчитываются в указанную валюту.

Валидация: проверяется, что код валюты соответствует справочнику валют и классификатору ИС ЭСФ (3-символьный код ISO 4217).

Типичные значения: «KZT» (в большинстве случаев для внутренних операций в РК).


СвязанныйЭСФ (DocumentRef.ЭСФ)

Описание: ссылка на исходный ЭСФ при создании корректировочного или дополнительного документа.

Обязательность: Нет (DontCheck), но фактически обязателен, если Вид = «Корректировочный» или «Дополнительный».

Влияние на другие поля: при заполнении автоматически подтягиваются: СвязанныйЭСФДата, СвязанныйЭСФНомер, СвязанныйЭСФРегистрационныйНомер. Также из связанного ЭСФ копируются данные поставщика/получателя и товары.

Валидация: система проверяет, что связанный ЭСФ имеет статус «Зарегистрирован» в ИС ЭСФ и не помечен на удаление. Также контролируется совпадение направлений (нельзя связать исходящий с входящим).


Контрагент

Описание: основной контрагент по документу (для исходящих — покупатель, для входящих — поставщик). Используется для быстрой фильтрации в списках и отчётах.

Обязательность: Нет (DontCheck), но фактически рекомендуется заполнять.

Влияние на другие поля: при выборе контрагента автоматически заполняются его реквизиты в табличных частях «Поставщики» или «Получатели» (ИИН/БИН, наименование, адрес, свидетельство НДС). Также подтягивается договор по умолчанию.

Валидация: контрагент должен быть из справочника «Контрагенты», не помечен на удаление.


СчетФактура

Описание: ссылка на связанный внутренний документ «Счёт-фактура». Используется для синхронизации данных между ЭСФ и внутренним учётом.

Обязательность: Нет.

Влияние на другие поля: при заполнении связи доступны команды: - ФормаСчетФактураОткрыть — открыть связанный документ; - ФормаСчетФактураОбновить — обновить данные ЭСФ из счёта-фактуры; - ФормаСчетФактураОтсоединить — разорвать связь; - ФормаПерезаполнитьПоСчетуФактуре — полностью перезаполнить ЭСФ из указанного СФ.

Валидация: проверяется, что счёт-фактура существует, не помечен на удаление и относится к той же организации.

Типичные значения: ссылка на документ «Счёт-фактура выданный» (для исходящих) или «Счёт-фактура полученный» (для входящих).


Организация

Описание: организация, от лица которой выписан/получен ЭСФ.

Обязательность: Нет формально, но фактически обязательна (заполняется автоматически при создании).

Влияние на другие поля: при изменении организации пересчитываются реквизиты поставщика (для исходящих) или получателя (для входящих), выбирается склад по умолчанию, обновляются данные сертификата ЭЦП.


Валидации (сводно)

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

Зависимости (общие модули)

Модуль Назначение
ОбработкаОбменЭСФ Центральный процессор обмена с порталом ИС ЭСФ (формирование XML, HTTP-запросы, парсинг ответов)
ЭСФСервер Серверная логика: валидация, получение токенов, подпись XML, обработка статусов
ЭСФКлиент Клиентская логика: выбор сертификата, диалоги подтверждения, интерактивные проверки
ЭСФКлиентСервер Общая клиент-серверная логика (форматирование ошибок, вспомогательные функции)
ЭСФКлиентСерверПереопределяемый Кастомные обработчики проверки заполнения и форматирования ошибок (точка расширения для доработок)
ВиртуальныеСкладыСервер Проведение по регистрам виртуального склада, контроль остатков ТМЗ на ВС

📋 Заметки для партнёра / разработчика

  1. Нет бухгалтерских проводок. Документ ЭСФ не формирует движений по регистру бухгалтерии. Если вам нужно отразить начисление/зачёт НДС — используйте связанные документы СчетФактураВыданный / СчетФактураПолученный.

  2. Виртуальный склад — обязателен. Без корректно заполненного реквизита Склад проведение невозможно. При доработках всегда проверяйте, что склад доступен для выбранной организации.

  3. XML-формат версионируется. Реквизит ВерсияБланкаЭСФ определяет, какой набор полей попадает в XML. При обновлении формата ИС ЭСФ необходимо проверять совместимость кода формирования XML в модуле ОбработкаОбменЭСФ.

  4. Точки расширения. Модуль ЭСФКлиентСерверПереопределяемый — основная точка для добавления пользовательских проверок без изменения типовых модулей. Используйте расширения конфигурации для подписки на события.

  5. ТоварыПоПоставщикам / ТоварыПоПолучателям заполняются только при сложных операциях (несколько поставщиков/получателей). В типовом сценарии «один поставщик — один получатель» эти ТЧ остаются пустыми.

  6. ПриКопировании — критично. При копировании документа обязательно очищаются: Идентификатор, РегистрационныйНомер, ЭЦП, Статус (сбрасывается в «Новый»), ТЧ Ошибки. Если вы добавляете новые уникальные реквизиты через расширение — не забудьте очистить их в обработчике ПриКопировании.

  7. Обмен данными. При программной записи через ОбменДанными.Загрузка = Истина все проверки в ПередЗаписью пропускаются. Используйте это для массовой загрузки из внешних систем, но помните о рисках записи некорректных данных.

  8. Статусная модель. Жизненный цикл ЭСФ в ИС ЭСФ: Новый → Отправлен → Принят / Отклонён / Отозван → Аннулирован. Переходы между статусами контролируются порталом, а не 1С. При доработках не пытайтесь менять статус напрямую — используйте команды форм (ФормаОтправить, ФормаОтозвать, ФормаОтклонить).


🔗 Связанные разделы