Документ «Электронный счет-фактура (ЭСФ)»
ЭСФ — ключевой электронный налоговый документ Республики Казахстан. Он обеспечивает отправку сведений о реализации в ИС ЭСФ (исходящие) и получение сведений от поставщиков (входящие). В отличие от обычного счета-фактуры, ЭСФ делает движения по виртуальным складам (регистры накопления ТоварыНаВиртуальныхСкладах и ТоварыВиртуальногоСкладаВРезерве), но бухгалтерских проводок (Дт/Кт) не формирует.
🎯 Что это и зачем
В Казахстане электронные счета-фактуры (ЭСФ) обязательны для большинства налогоплательщиков. Документ ЭСФ в 1С: - Формирует XML-структуру и передает ее в государственную систему ИС ЭСФ; - Позволяет получать входящие документы от поставщиков по API; - Хранит официальный регистрационный номер ИС ЭСФ и статус документа; - Реализует учет товаров на виртуальных складах (прослеживаемость импорта, производства и реализации).
Кто работает: бухгалтеры, ежедневно. Документ создается на основании внутренних счетов-фактур или загружается при синхронизации с порталом.
🧭 Где найти в программе
Документ доступен в разделе «ЭСФ/ЭАВР» → пункт «Электронные счета-фактуры».
В зависимости от роли и настроек, вы можете открыть:
- Список полученных (входящих) ЭСФ — форма ФормаСпискаВходящих;
- Список выданных (исходящих) ЭСФ — форма ФормаСпискаИсходящих.
👤 Часть 1. Для пользователя
Пошаговые инструкции по полному циклу обмена: создание, отправка, сопоставление товаров, корректировка и отклонение документов.
Урок 1. Создание и отправка исходящего ЭСФ
Когда: вы реализовали ТМЗ/услугу контрагенту и должны выписать ЭСФ в регламентированный срок.
Шаг 1. Создаем ЭСФ на основании
Лучший способ — открыть внутренний документ Счет-фактура выданный и нажать кнопку «Создать на основании» → «Электронный счет-фактура (исходящий)».
Программа автоматически заполнит:
- Направление = «Исходящий»;
- Организация и Контрагент;
- Табличную часть Товары (номенклатура, коды ТН ВЭД, признаки происхождения, количество и суммы);
- Склад — виртуальный склад вашей организации.
Шаг 2. Проверяем реквизиты
В открывшейся ФормаДокумента убедитесь, что заполнены:
- Дата оборота — дата совершения оборота по реализации (критично для периода НДС);
- ВалютаКод — трехзначный код валюты (по умолчанию KZT);
- Склад — выбран ваш Виртуальный склад;
- Договор поставки (номер и дата).
Шаг 3. Валидация перед отправкой
Нажмите кнопку «Проверить» на командной панели. Если в данных есть логические ошибки (неверный ИИН/БИН, незаполненный признак происхождения товара, не сходится сумма), они отобразятся в табличной части «Ошибки».
Шаг 4. Подписание и отправка
- Нажмите «Записать».
- Нажмите кнопку «Отправить».
- Система откроет окно для выбора сертификата ЭЦП (подпись подсистемы ИС ЭСФ). Выберите ключ и введите пароль.
После успешной отправки ИС ЭСФ присвоит документу Регистрационный номер (формата XXXXXXXXXXXX-XXXX), а статус изменится на «Отправлен» или «Принят».
Урок 2. Получение и регистрация входящего ЭСФ
Когда: поставщик выписал ЭСФ на ваше имя, и вам нужно принять НДС к зачету и отразить товар на виртуальном складе.
Шаг 1. Синхронизация с порталом
Откройте список полученных ЭСФ и нажмите кнопку «Получить электронные счета-фактуры из ИС ЭСФ» (команда Синхронизировать).
Программа свяжется с сервером ИС ЭСФ по вашему токену/паролю и загрузит все новые документы. В списке появятся записи со статусом «Получен».
Шаг 2. Сопоставление с учетной базой
- Откройте новый входящий ЭСФ.
- Проверьте данные поставщика и перечень товаров/услуг.
- Свяжите ЭСФ со счетом-фактурой поставщика. В поле СчетФактура выберите соответствующий внутренний документ
Счет-фактура полученный(или создайте его по кнопке «Создать на основании»). - Нажмите кнопку «Найти» (
ПоставщикНайти) на вкладке товаров для автоматического сопоставления номенклатуры поставщика с вашей базой.
Шаг 3. Проведение по виртуальному складу
Укажите Склад (ваш виртуальный склад) и нажмите кнопку «Провести». Это отразит приход товара на вашем виртуальном складе, что позволит в дальнейшем выписывать исходящие ЭСФ и СНТ на этот товар.
Урок 3. Создание корректировочного ЭСФ
Когда: изменилась цена или количество товара (например, предоставлена скидка или возвращен излишек), и нужно скорректировать НДС.
- Найдите исходный зарегистрированный в ИС ЭСФ (исходящий) документ ЭСФ.
- Нажмите «Создать на основании» → «Электронный счет-фактура».
- В созданном документе программа автоматически установит: - Вид = «Корректировочный»; - СвязанныйЭСФ = ссылка на исходный документ; - Перенесутся все исходные реквизиты.
- Обязательно заполните текстовое поле Причина (например, «Увеличение цены на 5%»).
- Отредактируйте строки в табличной части Товары, указав измененное количество или цены.
- Проверьте и отправьте корректировочный ЭСФ в ИС ЭСФ с подписанием ЭЦП.
Урок 4. Отклонение и отзыв ЭСФ
- Отклонить (для входящих): Если поставщик выставил вам ошибочный ЭСФ, вы не должны его проводить. Выделите документ в списке полученных, нажмите «Отклонить», укажите в диалоге текстовую Причину отклонения и подпишите ЭЦП. Статус изменится на «Отклонен».
- Отозвать (для исходящих): Если вы нашли ошибку в отправленном ЭСФ, вы можете отозвать его, пока покупатель его не принял/не подтвердил. В форме исходящего документа нажмите «Отозвать», укажите причину отзыва и отправьте запрос. Статус изменится на «Отозван».
Урок 5. Загрузка из XML и обновление статусов
- Импорт XML: Если вам прислали ЭСФ в виде файла, нажмите в списке кнопку «Загрузить из XML (ЭСФ)» (
Импортировать), укажите файл. Документ запишется со статусом «Новый» и сохранит исходную 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С, перенаправляя вызовы в специализированные общие модули:
ОбработкаЗаполнения
Инициализирует новый документ. Устанавливает направление по умолчанию, заполняет организацию, автора и валюту. При создании на основании счета-фактуры вызывает общий метод заполнения данных из СФ в структуру ЭСФ.
ПередЗаписью
- Считает
СуммаДокументакак итог по табличной части товаров. - Проверяет режим загрузки обмена (
ОбменДанными.Загрузка). Если истина — проверки пропускаются. - Перед проведением выполняет валидацию заполнения виртуальных складов.
- Вызывает
ЭСФСервер.ПередЗаписьюЭСФ(ЭтотОбъект).
ОбработкаПроверкиЗаполнения
Формирует массив МассивНепроверяемыхРеквизитов в зависимости от направления и вида документа. Вызывает ЭСФСервер.ПроверитьЗаполнениеЭСФ(ЭтотОбъект, Отказ, ПроверяемыеРеквизиты, МассивНепроверяемыхРеквизитов).
- Если Вид = Корректировочный — реквизит СвязанныйЭСФ и строка Причина принудительно проверяются.
- Если Направление = Входящий — очищаются из обязательных проверки исходящих полей.
ПриКопировании
Очищает уникальные идентификаторы, ЭЦП, статус сбрасывается в значение по умолчанию («Новый»), ТЧ Ошибки очищается:
Идентификатор = Неопределено;
РегистрационныйНомер = Неопределено;
Статус = ПредоставленноеЗначение("Перечисление.СтатусыЭСФ.Новый");
ЭЦП = Неопределено;
Ошибки.Очистить();
ОбработкаПроведения
Формирует движения по виртуальным складам на основе табличной части Товары при включенном флаге ОтражаетсяВВС:
// Движения по виртуальным складам
Если ОтражаетсяВВС Тогда
ДвиженияВиртуальногоСклада = ВиртуальныеСкладыСервер.ПодготовитьДвиженияТоваровЭСФ(ЭтотОбъект);
ВиртуальныеСкладыСервер.ЗаписатьДвиженияТоваров(Движения, ДвиженияВиртуальногоСклада);
КонецЕсли;
Движения по регистрам
При проведении документа ЭСФ с флагом ОтражаетсяВВС формируются следующие движения:
- Регистр накопления
ТоварыНаВиртуальныхСкладах:- Приход (для входящего ЭСФ): Увеличивает остатки товаров на выбранном виртуальном складе с указанием источника происхождения.
- Расход (для исходящего ЭСФ): Списывает количество товаров с виртуального склада.
- Регистр накопления
ТоварыВиртуальногоСкладаВРезерве:- Управляет резервированием товаров на виртуальном складе в процессе отправки или корректировки ЭСФ.
Важно: Бухгалтерские проводки (движения по плану счетов) документ ЭСФ не формирует. За бухгалтерский учёт отвечают связанные документы:
СчетФактураВыданный,СчетФактураПолученный,РеализацияТМЗИУслуг.
Расширенные сценарии (для разработчика)
Сценарий 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 до 6). - Суммовой контроль: Сумма НДС по строке должна соответствовать формуле:
ОборотПоРеализации × СтавкаНДС(с погрешностью округления до 1 тиына). - Корректировочные ЭСФ: При
Вид = КорректировочныйобязательныСвязанныйЭСФ(со статусом «Зарегистрирован» в ИС ЭСФ) и текстоваяПричина. - ИИН/БИН: Проверяется корректность длины и контрольной цифры для всех идентификаторов поставщиков и получателей.
- Запрет отзыва принятого: Отозвать можно только ЭСФ со статусом «Отправлен» (до принятия покупателем).
- Запрет проведения отклонённого: Отклонённый входящий ЭСФ не должен проводиться.
Зависимости (общие модули)
| Модуль | Назначение |
|---|---|
ОбработкаОбменЭСФ |
Центральный процессор обмена с порталом ИС ЭСФ (формирование XML, HTTP-запросы, парсинг ответов) |
ЭСФСервер |
Серверная логика: валидация, получение токенов, подпись XML, обработка статусов |
ЭСФКлиент |
Клиентская логика: выбор сертификата, диалоги подтверждения, интерактивные проверки |
ЭСФКлиентСервер |
Общая клиент-серверная логика (форматирование ошибок, вспомогательные функции) |
ЭСФКлиентСерверПереопределяемый |
Кастомные обработчики проверки заполнения и форматирования ошибок (точка расширения для доработок) |
ВиртуальныеСкладыСервер |
Проведение по регистрам виртуального склада, контроль остатков ТМЗ на ВС |
📋 Заметки для партнёра / разработчика
-
Нет бухгалтерских проводок. Документ
ЭСФне формирует движений по регистру бухгалтерии. Если вам нужно отразить начисление/зачёт НДС — используйте связанные документыСчетФактураВыданный/СчетФактураПолученный. -
Виртуальный склад — обязателен. Без корректно заполненного реквизита
Складпроведение невозможно. При доработках всегда проверяйте, что склад доступен для выбранной организации. -
XML-формат версионируется. Реквизит
ВерсияБланкаЭСФопределяет, какой набор полей попадает в XML. При обновлении формата ИС ЭСФ необходимо проверять совместимость кода формирования XML в модулеОбработкаОбменЭСФ. -
Точки расширения. Модуль
ЭСФКлиентСерверПереопределяемый— основная точка для добавления пользовательских проверок без изменения типовых модулей. Используйте расширения конфигурации для подписки на события. -
ТоварыПоПоставщикам / ТоварыПоПолучателям заполняются только при сложных операциях (несколько поставщиков/получателей). В типовом сценарии «один поставщик — один получатель» эти ТЧ остаются пустыми.
-
ПриКопировании — критично. При копировании документа обязательно очищаются:
Идентификатор,РегистрационныйНомер,ЭЦП,Статус(сбрасывается в «Новый»), ТЧОшибки. Если вы добавляете новые уникальные реквизиты через расширение — не забудьте очистить их в обработчикеПриКопировании. -
Обмен данными. При программной записи через
ОбменДанными.Загрузка = Истинавсе проверки вПередЗаписьюпропускаются. Используйте это для массовой загрузки из внешних систем, но помните о рисках записи некорректных данных. -
Статусная модель. Жизненный цикл ЭСФ в ИС ЭСФ:
Новый→Отправлен→Принят/Отклонён/Отозван→Аннулирован. Переходы между статусами контролируются порталом, а не 1С. При доработках не пытайтесь менять статус напрямую — используйте команды форм (ФормаОтправить,ФормаОтозвать,ФормаОтклонить).
🔗 Связанные разделы
- realizaciya-tmz-i-uslug — Документ-основание для реализации товаров и услуг.
- schet-faktura-vydannyy — Ссылка на внутренний документ счет-фактура выданный.
- schet-faktura-poluchennyy — Ссылка на внутренний документ счет-фактура полученный.
- eavr — Электронные акты выполненных работ.