Настройка внешней обработки СБИС для 1С 8.х
Внешняя обработка обмена электронными документами для 1С позволяет выгружать файлы документов реализации и актов сверки взаиморасчетов для последующей отправки их контрагентам, а также загружать файлы, присланные контрагентами. Все потребительские настройки выведены в интерфейс обработки, здесь рассматриваются вопросы адаптации внешней обработки под нестандартные конфигурации или особые пожелания клиентов.
Почему возникает необходимость настройки?
Конфигурации 1С зачастую изменяются пользователями, в результате таблицы, поля, предусмотренные в типовой конфигурации, могут называться по-другому, или вообще отсутствовать.
Что можно настраивать во внешней обработке?
| Что можно настраивать | Уровень знаний |
|---|---|
| Отправка документов | |
| Добавление не поддерживаемого реестра документов в раздел Продажа | Средний |
| Содержание реестров документов в раздела Продажа | Средний |
| Список документов 1С которые необходимы для формирования одного пакета документов | Средний |
| Параметры фильтрации списка документов для каждого реестра | Продвинутый |
| Какие электронные документы будут сформированы из документа 1С | Средний |
| Изменить источники данных для реквизитов электронных документов | Начальный |
| Добавить новые реквизиты в стандартные электронные документы | Начальный |
| Описать условия заполнения реквизитов электронных документов | Продвинутый |
| Описать условия формирования пакета документов | Продвинутый |
| Добавить к пакету документов не формализованный xls или pdf документ сформированный из макета документа 1С | Средний |
| Загрузка документов | |
| Определить какие электронные документы можно загружать в 1С | Средний |
| Определить какие документы 1С можно создать из электронного документа | Средний |
| Определить какие реквизиты документа 1С будут заполнены | Начальный |
| Описать условия заполнения реквизитов документа 1С | Продвинутый |
Состав обработки
Обработка состоит из одного файла:
- для толстого клиента Sbis1C.epf
- для управляемых форм Sbis1C_UF.epf
Файл обработки при запуске распаковывает на диск:
- ActiveX компонент который отвечает за взаимодействие с СБИС через https
- Конфигурационные XML файлы описывающие источники данных необходимые для работы обработки.
Обработка может быть дополнена пользовательской обработкой ВнешниеФункции_Клиент.epf.
Основные принципы настройки
- Код самой обработки ни при каких условиях не изменяется.
- Конфигурационные файлы выгружаемые обработкой ни при каких условиях не изменяются.
- Вся настройка производится в пользовательских конфигурационных файлах путем переопределения параметров, либо добавления новых.
- При необходимости написать функцию для получения какого либо значения или изменения алгоритма выгрузки создается пользовательская обработка «ВнешниеФункции_Клиент.epf» в которой переопределяются имеющихся функции или создаются новые. Обработка «ВнешниеФункции_Клиент.epf» должна лежать или в каталоге настроек или в 1С в справочнике «Дополнительные внешние обработки»/«Внешние обработки».
Общая логика формирования электронного документа
Универсальность внешней обработки обеспечивается не только отдельными файлами настроек для каждой конфигурации и каждого документа, но и общей структурой и логикой выгрузки всех документов. Если более детально посмотреть файл настроек, то можно заметить что описанные в нем поля хоть и содержат необходимые значения для формирования документа, но не очень похожи на форматы ФНС. Более того, структура инишек для разных документов одинакова. Как же получается, что обработка имея один и тот же набор полей, на выходе формирует разные типы электронных документов?
Дело в том, что обработка сначала формирует документ в промежуточный xml файл формата 3.01. На основе этого формата, например, реальзованы документы «Счет», «Акт сверки взаиморасчето», «Реестр сертификатов, деклараций» и некоторые другие.
Полученный xml файл формата 3.01 обработка конвертирует с помощью xslt преобразования в формат ФНС. И он уже отправляется контрагенту. Xslt файл подбирается исходя из типа, подтипа и версии формата указанного в файле настроек. Если этих полей нет или по ним оработка не смогла найти xslt файл в каталоге настроек, то документ отправляется «как есть» без преобразования. По такой логике с помощью стандартных настроек отправляются документы «Счет» и «Акт сверки взаиморасчетов». После того как документ отправлен в кабинет, система определяет что это за формат и с помощью xslt файла визуализации показывает его как html.
Таким образом при отправке документа получается следующая цепочка:
- С помощью настроек обработка формирует xml формата 3.01
- С помощью xslt преобразовывает документ из 3.01 в формат ФНС
- Отправляет его
- В СБИС документ с помощью xslt визуализации показывает xml как html страницу
В случае загрузки в 1С происходит обратная конвертация:
- С помощью xslt «из формата ФНС в 3.01» обработка формирует xml универсальной структуры (3.01)
- С помощью файлов настроек определяет откуда из 3.01 взять поле и куда в 1С его положить
Такой принцип работы позволяет сохранить универсальность при изменении форматов ФНС. Ведь для поддержки нового формата достаточно будет заменить xslt файл «из 3.01 в формат ФНС» без изменения файлов настроек.
Для отладки и возможности просмотра файлов формата 3.01 в обработке (начиная с 36 версии) на вкладке «Настройки» добавлена опция «Режим отладки», которая позволяет указать каталог куда будут сохраняться файлы формата 3.01
Первый запуск обработки
- Запустить 1С. Добавить обработку в список дополнительных внешних обработок. Для этого заходим в меню Сервис/Дополнительные отчеты и обработки/Дополнительные внешние обработки. В открывшемся окне нажимаем добавить и выбираем файл обработки.
- Запустить обработку.
- При запуске обработка сама выгрузит файлы настроек в каталог C:\Sbis1C. Для клиент-серверной 1С, запущенной в управляемом режиме, этот каталог будет располагаться на сервере. При необходимости каталог настроек можно изменить на вкладке Настройки/Файлы настроек в обработке.
Если конфигурация клиента нестандартная в Служебных сообщениях появится список ошибок – говорящих о том, что в базе данных нет каких-то полей или они заданы неверно.
Файлы настроек (инишки)
У 1С есть множество разнообразных конфигураций, которые могут заметно отличаться друг от друга по способу хранения данных. Для того, чтобы не делать отдельную обработку под каждую конфигурацию, или не делать кучу условий внутри одной обработки, мы используем файлы настроек, которые говорят обработке, где в текущей конфигурации хранится необходимое значение.
Файлы настроек, это xml файлы определенного формата. По старой традиции мы их называем инишками (в внешней обработке первой версии, это были ini файлы).
Для каждой конфигурации делается отдельный набор инишек. Для наиболее популярных конфигураций готовые наборы инишек (стандартные) уже включены в обработку.
Если обработка при запуске определила, что у Вас одна из поддерживаемых версий 1С, то она автоматически установит нужный набор инишек.
Стандартные инишки автоматически обновляются вместе с обработкой, именно поэтому их нельзя редактировать. Для внесения исправлений в стандартные инишки реализован механизм заплаток — Пользовательских файлов настроек (пользовательских инишек).Пользовательские инишки отличаются от стандартных расширением файла ( у стандартного расширение .sbis3.xml, у пользовательского .xml). При каждом запуске обработки формируется сводный файл настроек, в котором параметры из пользовательской инишки заменяют аналогичные параметры стандартной.
Как было сказано ранее, для каждой конфигурации делается отдельный набор файлов настроек. Данный набор состоит из:
Файл настроек конфигурации
В данном файле описаны общие параметры, необходимые для работы обработки
Имя файла
Название файла формируется по шаблону «ВО82[Код конфигурации]_Конфигурация.sbis3.xml» Например, для Бухгалтерии 2.0 это будет ВО2БУХ2_Конфигурация.sbis3.xml
Коды типовых конфигураций поддерживаемых обработкой:
- БУХ1 — Бухгалтерия предприятия 1.6
- БУХ2 — Бухгалтерия предприятия 2.0
- БУХ3 — Бухгалтерия предприятия 3.0
- УТ10 — Управление торговлей 10.х
- УТ11 — Управление торговлей 11.х
- УПП — Управление производственным предприятием 1
- КА — Комплексная автоматизация
- БГУ — Бухгалтерия госучреждений 1
Структура файла
Содержит плоским списком параметры конфигурации, которые необходимы для работы обработки:
Описание основных параметров:
Форма работы со статусами Понять, в каком состоянии находится документ (доставлен ли он до контрагента, утвержден или отклонен), можно по статусу электронного документа. По умолчанию статус и идентификатор электронного документа, соответствующего документу 1С, записываются в регистр сведений (ЗначенияСвойствОбъектов или ДополнительныеСведения в зависимости от конфигурации). При этом в файле настроек конфигурации указана форма работы со статусами ‘Статусы_Регистры’.
Если в конфигурации нет таких регистров или другого места для хранения статусов, в файле настроек необходимо указать ‘Статусы_ДБФ’ — в этом случае статусы будут храниться в dbf-файле в каталоге настроек обработки.
Форма работы с номенклатурой контрагентов Перед загрузкой полученных документов необходимо сопоставить номенклатуру контрагента со своей. Результат этого сопоставления сохраняется, чтобы в следующий раз, когда от контрагента придет документ с такой же номенклатурой, сопоставление происходило автоматически. По умолчанию сопоставление записывается в dbf-файлы в подкаталоге НоменклатураПоставщиков каталога настроек обработки. При этом в файле настроек конфигурации указана форма работы с номенклатурой контрагентов ‘СопоставлениеНоменклатуры_ДБФ’.
Во многих конфигурациях 1С есть специальные справочники или регистры сведений для хранения сопоставления номенклатуры. Запись
означает, что сопоставление номенклатуры будет храниться в регистре сведений (обычно этот регистр называется «НоменклатураКонтрагентов»). Минус такого варианта в том, что в большинстве конфигураций данный регистр не позволяет сопоставить нескольким видам номенклатуры контрагента одну и ту же карточку своей номенклатуры.
означает, что сопоставление номенклатуры будет храниться в справочнике (обычно справочник называется «НоменклатураПоставщиков»).
Примечание. При загрузке исходящих документов (в случае, если документы были сформированы и отправлены из другой учетной системы), если необходимо сопоставить номенклатуру другой учетной системы с номенклатурой в текущей базе 1С и сопоставление хранится в регистрах или справочниках, то в справочнике Контрагенты должен быть заведен контрагент с реквизитами нашей организации (ИНН/КПП), так как для исходящего документа владельцем номенклатуры контрагента является наша организация.
При суммовом учете в сопоставлении номенклатуры нет необходимости. В этом случае любой номенклатуре контрагента сопоставляется одна и та же карточка номенклатуры в нашей системе. В этом случае необходимо указать форму работы с номенклатурой ‘СопоставлениеНоменклатуры_СуммовойУчет’. Для определения, какая именно карточка номенклатуры будет сопоставлена со всей номенклатурой контрагента, необходимо добавить параметр «СуммовойУчетКодНоменклатуры», в котором указать в одинарных кавычках код номенклатуры:
Строка подключения к dbf-файлам Дополнительно в файле настроек конфигурации может быть указан параметр «СтрокаПодключенияДБФ». Он необходим в том случае, если на компьютере не установлен драйвер работы с dbf-файлами, используемый обработкой по умолчанию (Microsoft dBASE Driver) и при этом сопоставление номенклатуры либо статусы хранятся в dbf. Например:
К этой строке в конце обработкой будет дописан путь к каталогу, где лежит нужный dbf-файл с номенклатурой поставщика либо со статусами.
Файлы настроек реестров Продажа / Покупка
Разделы Продажа/Покупка внешней обработки содержат подразделы, в которых отображаются списки документов 1С, например, «Реализация товаров и услуг», «Акт об оказании производственных услуг», «Заказ поставщику» и другие. Из этих разделов документы 1С можно отправить контрагентам в электронном виде. Список пунктов меню раздела Продажа — динамический. Он зависит от количества инишек находящихся в каталоге настроек.
Состав подразделов в Продаже/Покупке определяется файлами настроек.
Имя файла
Название файла формируется по шаблону «ВО82[Код конфигурации]_[Имя документа].sbis3.xml». Например, для Реализации товаров и услуг в Бухгалтерии 2.0 это будет ВО82БУХ2_РеализацияТоваровУслуг.sbis3.xml
Структура файла
- Общие параметры данного реестра документов
- Запрос для построения списка документов
- Параметры шапки документа
- Массив табличных частей (мТаблДок)
- Параметры табличной части документа
Подраздел в Продаже или Покупке появляется в том случае, если в соответствующем файле настроек присутствует параметр «ЗапросСпискаДокументов», содержащий текст запроса документов из базы 1С. С помощью запроса можно выбрать не только документы определенного типа, но и связанные с ними документы таким образом, чтобы связанные документы отправлялись контрагенту одним комплектом. Например, в комплекте с реализацией товаров и услуг можно отправить счет-фактуру и счет на оплату.
В какой именно раздел будет добавлен тот или иной реестр документов, определяется параметром файла настроек «ДокументРаздел»:
Некоторые документы, например, «Акт сверки», могут присутствовать в обоих разделах:
Имя подраздела, которое отображается в интерфейсе обработки, определяется параметром «Реестр1С_Название»:
По умолчанию при выгрузке каждого документа используется файл настроек, соответствующий имени этого документа, то есть для Реализации товаров и услуг используется файл ВО82БУХ2_РеализацияТоваровУслуг.sbis3.xml, для Счета-фактуры выданного — ВО82БУХ2_СчетФактураВыданный.sbis3.xml и т.д.
Иногда документы одного и того же типа нужно выгружать по-разному в зависимости от определенного условия. Например, логика выгрузки авансовых счетов-фактур отличается от обычных, хотя все они являются одним и тем же документом 1С — «Счет фактура выданный». В этом случае создается отдельный файл настроек со своим запросом и своими параметрами выгружаемых файлов. В запросе указывается условие, что в данный подраздел попадают только счета-фактуры с видом «На аванс». Имя файла настроек будет отличаться от имени документа 1С, т.к. стандартное имя уже занято файлом для выгрузки обычных счетов-фактур. Например, для Бухгалтерии 2.0 это будет ВО82БУХ2_СчетФактураНаАванс.sbis3.xml. Чтобы авансовый счет-фактура выгружался с помощью данного файла настроек, а не стандартного ВО82БУХ2_СчетФактураВыданный.sbis3.xml, необходимо указать название используемого файла в поле запроса «ФайлНастроекДокумента».
В файле настроек может присутствовать один или несколько узлов «мФайл» — это означает, что на основании документа 1С может быть сформирован один или несколько электронных документов. Например, для реализации товаров и услуг в файле настроек обычно присутствует два узла «мФайл» — для формирования акта и накладной.
Но это не означает, что на основании реализации всегда будет выгружаться два электронных документа. Все зависит от заполнения табличных частей.
Внутри каждого узла «мФайл» может быть описана одна или несколько табличных частей. Например, для акта описывается две табличные части:
Если хотя бы одна из этих табличных частей будет заполнена, то сформируется электронный документ Акт.
Для накладной обычно описывается одна табличная часть — «Товары». Если она будет заполнена, то сформируется электронный документ Накладная.
Если будут заполнены и товары, и услуги, то сформируются оба документа.
В файлах настроек есть группа особых параметров, имя которых начинается на «Файл_» или «Документ_». Эти параметры автоматически записываются в выгружаемый файл как атрибуты соответствующего узла («Файл» или «Документ»). Параметры, имя которых начинается на «ТаблДок_» автоматически записываются в выгружаемый файл в строки табличной части.
Рассмотрим один блок мФайл целиком на примере накладной:
Дополнительные возможности выгрузки
Форма формирования файла
Во внешней обработке есть группа форм, которые используются непосредственно при формировании выгружаемого файла — это формы вида «Файл_[Формат файла]_[Версия формата файла]». Например, для формирования файла счета-фактуры используется форма «Файл_СчФктр_3_01».
Формат файла и версия формата определяется в файле настроек в параметрах «Файл_Формат» и «Файл_ВерсияФормата». Например:
Так как большинство файлов формируются по одному и тому же алгоритму, для их формирования используется форма «Файл_Шаблон». Эта форма используется для всех файлов, для которых в обработке нет формы вида «Файл_[Формат файла]_[Версия формата файла]».
Основное отличие формирования счета-фактуры от других документов заключается в том, что в 1С в документе Счет-фактура выданный нет табличной части, содержащей номенклатуру, а есть только ссылки на документы-основания. При формировании файла счета-фактуры табличная часть заполняется из документов-оснований. Для всех остальных документов табличные части заполняются непосредственно из самого документа (из табличных частей «Товары», «Услуги» и т.п.) Но, например, для авансового счета-фактуры табличная часть должна заполняться из табличной части «Авансы» самого счета-фактуры, поэтому его формирование ничем не отличается от большинства других документов. Поэтому для его формирования необходимо использовать форму «Файл_Шаблон», а не «Файл_СчФктр_3_01». Для этого в файле настроек указан специальный параметр «ФормаФормирования»:
Встречаются конфигурации 1С, где табличные части с номенклатурой («Товары», «Услуги») хранятся в самом счете-фактуре. Для таких конфигураций в файле настроек для выгрузки счета-фактуры так же необходимо указывать форму формирования «Файл_Шаблон».
Проверка заполнения кодов номенклатуры контрагента
Данный функционал необходим, если при выгрузке в документе обязательно должен быть указан код номенклатуры контрагента. Например, если покупатель договорился со своими поставщиками, что отправляет им заказы с кодами номенклатуры поставщиков. В этом случае поставщику не требуется производить сопоставление номенклатуры, и он сразу понимает, какой товар заказан.
Чтобы перед отправкой проводилась проверка, все ли коды поставщиков заполнены, необходимо в файл настроек добавить параметр «НоменклатураКодКонтрагента». В значении параметра указывается имя атрибута файла, в который записывается код номенклатуры контрагента, например, для заказа:
При наличии этого параметра, если не все коды будут заполнены, то при отправке файла выдастся ошибка. А в форме просмотра документа на вкладке сопоставления номенклатуры можно ввести недостающие коды.
Выгрузка одной табличной части в разные документы по условию
Обычно для различных видов номенклатуры в документе 1С предусмотрены различные табличные части (Товары или Услуги). Но встречаются случаи, когда в документе есть только одна табличная часть, например, Товары, при этом в нее заносятся и товары, и услуги. Для печати таких документов в 1С обычно предусмотрены несколько печатных форм, причем в печатную форму накладной попадает не вся табличная часть Товары, а только номенклатура с типом Товар, а в печатную форму акта попадает только номенклатура с типом Услуга. Соответственно и при отправке данного документа в электронном виде должно быть сформировано два файла — накладная и акт, каждый с определенным типом номенклатуры.
Рассмотрим на примере, какие настройки необходимо сделать для такой выгрузки.
- В стандартном файле настроек для документа с одной табличной частью Товары предусмотрена выгрузка только товарной накладной (то есть в файле настроек присутствует один блок мФайл с именем «ЭДОНакл», например, в Управлении торговлей, 11). Поэтому в первую очередь в пользовательском файле настроек для данного типа документа 1С добавляем еще один блок мФайл для выгрузки акта (проще всего скопировать этот блок с накладной и изменить реквизиты Файл_Формат и Файл_Имя). В результате, если мы откроем на просмотр документ в разделе Продажа, то увидим, что на основании документа 1С сформировались накладная и акт, но и в обоих документах в табличные части попали и товары, и услуги. Чтобы распределить номенклатуру по документам правильно, необходимо в файл настроек добавить признак, от которого зависит принадлежность номенклатуры накладной или акту. В нашем случае добавляется реквизит:
Данный реквизит добавляется в табличную часть акта и накладной в пользовательском файле настроек.
- Затем в обработке ВнешниеФункции_Клиент.epf (если такой еще нет, то создаем ее и кладем в каталог настроек обработки) создаем формы по форматам выгружаемых файлов: Файл_ЭДОНакл_3_01 и Файл_АктВР_3_01. В каждой форме пишем функцию сбисПослеФормированияСтроки, которая возвращает Истину в случае, если данная строка табличной части должна попасть в данный файл, и Ложь, если не должна. В нашем случае для накладной функция будет выглядеть следующим образом:
Первое условие (Если Контекст.Свойство(«СФ»)) срабатывает, когда идет выгрузка счета-фактуры, так как его табличная часть заполняется из документов оснований. В счет-фактуру должны попасть и товары, и услуги, поэтому в данном случае всегда возвращается Истина.
Далее проверяется тип номенклатуры: для накладной возвращается Истина, если это товар, а для акта, если это работа или услуга.
Аналогичным образом можно распределять строки табличной части по разным файлам и по любым другим условиям. Для этого нужно только добавить необходимые параметры в файл настроек и прописать соответствующие условия во внешних функциях.
Данный механизм можно применить и для формирования Акта приема-передачи неисключительных прав. Для этого в пользовательском файле настроек добавляется блок мФайл для выгрузки акта приема-передачи. Во внешних функциях создается форма Файл_АктПП_3_01 с функцией сбисПослеФормированияСтроки. Данная функция должна возвращать Истину только для номенклатуры, относящейся к неисключительным правам. Так как обычно такая номенклатура заведена в 1С как товар, то необходимо исключить ее из накладной, а для этого нужно прописать дополнительное условие в форме Файл_ЭДОНакл_3_01 в функции сбисПослеФормированияСтроки.
Прикрепление внешнего файла к пакету
Кроме электронных документов, сформированных на основе документов 1С, в комплект можно добавить и внешние файлы, например, договор или соглашение, сформированные в Microsoft Word, сканы приложений к документам отгрузки и вообще любой другой файл. Состав пакета документов определяется в запросе списка документов, поэтому и ссылку на внешний файл необходимо добавить в текст запроса. Например, чтобы добавить к пакету документов реализации файл, который лежит в каталоге «C:\Документы» и называется «Соглашение с [Наименование контрагента]» в запрос добавляем блок:
Данный текст добавляется в конце запроса перед блоком «УПОРЯДОЧИТЬ ПО».
Как видно из примера, полный путь к файлу кладется в поле Приложение, при этом поля СуммаПриложения, ДатаПриложения и НомерПриложения заполняются нулевыми значениями.
Если необходимо добавить несколько файлов, то добавляется несколько аналогичных блоков. Все изменения делаются в пользовательском файле настроек, куда выносится параметр «ЗапросСпискаДокументов».
На момент отправки внешние файлы должны лежать по указанному пути, иначе комплект документов полностью не будет сформирован.
Формирование пакета электронных документов
В большинстве случаев отправитель и получатель электронных документов совпадают с поставщиком и покупателем (грузоотправителем/грузополучателем), указанными в самом документе. Поэтому в стандартной настройке данные для формирования пакета электронных документов берутся с первого вложения пакета (с накладной, акта или другого документа).
Встречаются ситуации, когда документ нужно отправить за другую организацию, например, когда продажа осуществляется через агента. Для случаев, когда отправитель или получатель электронных документов не совпадает со сторонами, указанными в самом документе, предусмотрена следующая настройка.
В файл настроек выгрузки (как всегда в пользовательский) добавляется новый блок мФайл с именем «Конверт»:
В данном примере показана возможность указания кодов филиалов для участников документооборота. При необходимости коды филиалов можно завести в регистре сведений ЗначенияСвойствОбъектов/ДополнительныеСведения с названием «КодФилиала» аналогично заведению GLN. Если коды филиалов не требуются, просто не создаем эти параметры в файле настроек.
Файлы настроек загрузки
В разделе внешней обработки Полученные отображаются электронные документы, полученные от контрагентов. Какие из этих документов можно загрузить в 1С, определяется файлами настроек для загрузки.
Имя файла
Название файла формируется по шаблону «ВО82[Код конфигурации]_[КодФормата]_[ВерсияФормата].sbis3.xml». Например, для счет-фактуры загружаемой в Бухгалтерию 2.0 это будет ВО82БУХ2_СчФктр_3_01.sbis3.xml
Структура файла
- Общие параметры для файлов этого типа
- Массив документов 1С, которые возможно создать при загрузке файла этого типа (мДокумент)
- Параметры шапки создаваемого документа
- Параметры табличной части документа
В файле настроек может присутствовать один или несколько узлов «мДокумент» — это означает, что полученный электронный документ может быть загружен в 1С как один из перечисленных типов документов 1С. Например, для электронной накладной в файле настроек обычно присутствует два узла «мДокумент» — для формирования поступления товаров и услуг или возврата товаров поставщику.
При загрузке документов из реестра (не открывая карточку документа) всегда будет создаваться документ, указанный первым в файле настроек. При открытии карточки просмотра можно выбрать, какой документ 1С будет создан при загрузке.
Есть исключение, когда на основании одного электронного документа могут быть созданы сразу два документа 1С — это электронный счет-фактура. Если счет-фактура приходит в комплекте с актом или накладной, то на основании каждого электронного документа создается один документ 1С и эти документы связываются между собой (в основание счета-фактуры ставится основание — поступление товаров и услуг). Если счет-фактура приходит один, то при его загрузке сначала ищется подходящий документ-основание и если он не найден, то на основании электронного счета-фактуры могут быть созданы сразу два документа 1С — счет-фактура и его основание — поступление товаров и услуг.
Рассмотрим назначение блоков файла настроек на примере накладной:
Описание параметров в файлах настроек
Прямое обращение к данным из базы
Есть два ключевых слова, которые означают, что в данный параметр файла настроек нужно поместить ссылку на текущий выгружаемый объект 1С (документ или элемент справочника):
- Документ
- ЗаписьСправочника
Например, следующая запись означает, что при выгрузке определенного документа 1С в параметре «Документ» будет ссылка на этот документ.
В стандартных файлах настроек не используется выгрузка элементов справочника, но в пользовательском файле это вполне можно настроить. Например, если мы хотим отправлять в электронном виде договоры контрагентов (хранящиеся в справочнике «Договоры контрагентов»), то запись в файле настроек будет выглядеть так:
В этом случае в параметре «Документ» будет ссылка на выгружаемый договор.
Обращение к данным через ранее определенный параметр
Ранее определенный параметр пишется в квадратных скобках. После скобки ставится точка и далее название реквизита (табличной части, значение перечисления). Например:
Чтобы понять, какое значение попадет в данный параметр, нужно проследить всю цепочку параметров. Смотрим определение параметра «Сторона»:
Далее смотрим определение параметра «Документ»:
Про параметр «Документ» мы уже знаем, что это прямое обращение к выгружаемому документу. Таким образом, мы понимаем, что в параметре «Сторона_ИНН» будет ИНН организации из выгружаемого документа.
Присвоение параметру строкового значения
В ряде случаев не требуется брать значение из 1С, т.к. оно заранее известно — например тип документа является константой, в этих случаях это значение можно явно присвоить параметру.
Строковая константа заключается в одинарные кавычки
Выбор документов (запрос к базе)
С помощью запроса выбираются документы из базы 1С. Выбранные документы отображаются в определенном подразделе разделов Продажа или Покупка. Запросом определяется состав документов, отправляемых контрагенту одним комплектом.
Результатом выполнения запроса является таблица, с определенным набором полей:
- Документ — основной документ комплекта
- ДокументПроведен — признак проведения документа, используется при отображении пиктограммы документа в реестре
- ДокументПометкаУдаления — признак удаления документа, используется при отображении пиктограммы документа в реестре
- ДатаДокумента — дата документа, отображается в реестре документов
- НомерДокумента — номер документа, отображается в реестре документов
- Контрагент — название контрагента, отображается в реестре документов
- Организация — название организации, отображается в реестре документов
- Комментарий — комментарий документа, отображается в реестре документов
- Склад — склад документа, отображается в реестре документов
- СуммаДокумента — сумма документа, отображается в реестре документов
- Приложение — документ, связанный с основным документом комплекта
- СуммаПриложения — сумма связанного документа
- ДатаПриложения — дата связанного документа
- НомерПриложения — номер связанного документа
- СтатусЭД — статус электронного документа (заполнен, если документ уже отправлен в электронном виде), отображается пиктограммой в реестре документов
Дополнительно могут быть заполнены поля:
- ФайлНастроекДокумента — название файла настроек, который будет использован при выгрузке основного документа комплекта (без префиксов и расширения, например, «СчетФактураНаАванс»)
- ФайлНастроекПриложения — название файла настроек, который будет использован при выгрузке документа-приложения (без префиксов и расширения)
При обработке результата запроса записи группируются по основному документу, таким образом мы получаем запись с одним основным документом и несколькими приложениями — все это при отправке контрагенту попадет в один комплект документов. Наглядно это можно увидеть, открыв карточку документа из реестров в разделах Продажа или Покупка.
Запрос содержит стандартный набор параметров:
- ДатНач — начальная дата, с которой запрашиваются документы
- ДатКон — конечная дата, по которую запрашиваются документы
- Контрагент — контрагент, по которому отбираются документы
- ЗначениеКонтрагентЗаполнено — признак заполненности фильтра по контрагенту
- ТекущаяОрганизация — организация, по которой отбираются документы
- ЗначениеТекущаяОрганизацияЗаполнено — признак заполненности фильтра по организации
- ТекущийДокумент — определенный документ (заполняется при использовании внешней обработки, как внешней печатной формы определенного документа)
- ЗначениеТекущийДокументЗаполнено — признак заполненности параметра ТекущийДокумент
Значения параметров берутся из фильтра, установленного в интерфейсе обработки.
Могут быть установлены дополнительные параметры при использовании пользовательских фильтров (см. раздел про пользовательские фильтры)
Текст запроса прописывается в параметр <ЗапросСпискаДокументов>, например:
Текст запроса формируется по правилам 1С. Назначения блоков:
- «ИЗ» — таблица, из которой выбираются данные
- «ВЫБРАТЬ» — выбираемые поля
- «ГДЕ» — условие выбора
- «КАК» — присвоение логического имени для более простой адресации
- «УПОРЯДОЧИТЬ ПО» — правила сортировки
В приведенном примере в один комплект попадают 3 документа — Реализация товаров и услуг, Счет на оплату покупателю и Счет-фактура выданный.
Обращение к данным через формулу
Для несложных вычислений не обязательно писать функцию во внешней обработке, можно использовать формулы.
Формула имеет следующий вид: ^[операция](параметр1,параметр2. ).
В качестве параметров могут быть указаны строковые значения или ранее определенные параметры файла настроек.
Реализованы следующие варианты формул:
- Сложение строк или чисел: +
В примере параметр НазваниеЗаказа определяется с помощью формулы. Знак + означает операцию сложения. В скобках указывается произвольное количество параметров. Все параметры должны быть одинакового типа (строка или число).
- Операции сравнения: >, <, =, !=
Для операций сравнения всегда указывается 4 параметра. К первым двум параметрам применяется сама операция (в примере проверяется, что номер договора равен «111»). Если условие выполняется, то возвращается значение третьего параметра, иначе — значение четвертого параметра. То есть, если номер договора будет равен «111», то в реквизит Параметр_Значение попадет строка «Договор 111», а иначе пустая строка.
- Проверка заполнения: =, !=
В случае, если для операций = и != указано три параметра, то выполняется проверка заполненности (незаполненности для !=) первого параметра. Если условие выполняется (параметр заполнен), то возвращается значение второго параметра, иначе — значение третьего параметра. В примере если у документа заполнен комментарий, то вернется текст комментария, а иначе текст «Комментарий не заполнен».
- Составные условия: И, ИЛИ
Для данных операций указывается произвольное количество параметров, из которых предпоследний — это значение, возвращаемое в случае выполнения условия, а последний — в случае невыполнения. Все параметры кроме двух последних, должны иметь тип Булево. Для операции «И» для выполнения условия необходимо, чтобы все параметры принимали значение Истина — в этом случае вернется предпоследний параметр, иначе — последний. Для операции «ИЛИ» достаточно, чтобы один из параметров принимал значение Истина — в этом случае вернется предпоследний параметр, иначе — последний.
В примере Отправитель_Роль примет значение «ОтправительПакета» в случае, если у организации установлен флаг «Обособленное подразделение» и заполнена головная организация, иначе Отправитель_Роль примет значение «Отправитель».
- Получение подстроки: Сред
Первый параметр — исходная строка. Второй параметр — номер символа с которого берем подстроку. Третий параметр — количество выбираемых символов. Если параметр не указан, то выбираются символы до конца строки.
Обращение к данным через функцию
Если выше перечисленных способов не достаточно чтобы рассчитать значение параметра, вы можете написать свою функцию для его расчета.
Для сохранения возможности автообновления основной обработки, все новые функции реализованные для конкретного клиента размещаются в отдельной внешней обработке — которая должна называться «ВнешниеФункции_Клиент.epf» и находиться в или в каталоге настроек или в 1С в справочнике «Дополнительные внешние обработки»/«Внешние обработки». Функции для расчета параметров должны быть помещены в форму «РаботаСДокументами1С» этой внешней обработки.
Для того, чтобы параметр рассчитывался при помощи функции, необходимо указать её название в фигурных скобках. Указанная функция будет искаться сначала в основной обработке, затем в обработке «ВнешниеФункции_Клиент.epf».
Функции для расчета параметров имеют единственный параметр Контекст — это структура, содержащая все ранее вычисленные параметры данного файла настроек.
Результат выполнения функции записывается в указанный параметр.
Атрибуты в файлах настроек
Атрибут «Имя» используется для именования множественных узлов. Например, <мСторона Имя=»Грузоотправитель»>.
Атрибут «Формат» используется для приведения значения параметра к определенному формату. Например, запись
Атрибут «Тип» в обязательном порядке задается для параметров, содержащих табличную часть документа, например,
Так же он обязательно задается вместе с атрибутом формат для даты, которую необходимо выгрузить в файл в определенном формате. Например,
Атрибуты вида «Отбор_. » используются при необходимости выбрать запись справочника, регистра сведений или строку табличной части, отвечающую определенным условиям. Например, нам нужно получить адрес организации из регистра сведений КонтактнаяИнформация. У данного регистра есть измерения «Объект», «Тип» и «Вид». Для установки отбора по данным измерениям мы задаем атрибуты «Отбор_Объект», «Отбор_Тип» и «Отбор_Вид»:
Значения атрибутов задаются так же, как значения самих параметров, то есть в данном случае — это ссылки на ранее определенные параметры. Для справочников и табличных частей отбор задается аналогично, только не по измерениям, а по реквизитам, по которым необходимо произвести поиск.
Атрибут «Кэш» используется для кэширования значений параметров, одинаковых для нескольких документов в одном пакете. Например, в одном пакете выгружается накладная, счет-фактура и счет. В каждом документе присутствуют данные по одному и тому же контрагенту (адрес, телефон, факс). Чтобы не искать заново эту информацию в базе 1С для каждого документа, данные кладутся в кэш, что существенно ускоряет выгрузку. Есть одно особенное значение атрибута «Кэш» — это «Организация». Т.к. в базе 1С часто присутствует всего одна организация (иногда несколько, но в любом случае не так много, как контрагентов) имеет смысл кэшировать информацию по организации не в рамках одного пакета, а в целом в рамках запуска внешней обработки.
Атрибуты в файлах настроек для загрузки документов
Атрибут «Данные» — в значении атрибута указывается путь, откуда должно быть взято значение из загружаемого файла. Например, запись
означает, что реквизит «НомерВходящегоДокумента» в создаваемом при загрузке документе 1С будет заполнен из атрибута «Номер» узла «Документ» полученного файла.
Атрибут «Вычислить» используется, если при загрузке документа определенный реквизит нужно заполнить не значением из файла, а вычислить с помощью функции либо заполнить определенным значение перечислений, либо строковой константой. Например, запись
означает, что в создаваемом документе 1С реквизит «ВидОперации» будет заполнен значением «ПокупкаКомиссия» перечисления «ВидыОперацийПоступлениеТоваровУслуг».
означает, что реквизит «ДоговорКонтрагента» в создаваемом документе 1С будет заполнен с помощью функции ЗаполнитьДоговор(). Функция описана в модуле формы «РаботаСДокументами1С» внешней обработки. Как и любую функцию, вызываемую из файла настроек, ее можно переопределить в аналогичной форме обработки «ВнешниеФункции_Клиент.epf»
В атрибуте «Вычислить» так же можно использовать функции из общих модулей конфигурации. Название модуля и функции при этом разделяются точкой:
В случае вызова функции из общих модулей необходимо указать параметры функции.
Атрибут «ВычислитьНаСервере» используется в управляемом приложении. Нужен для вызова функции из общего модуля, работающего только на сервере. Например, для бухгалтерии 3.0 получаем курс валюты:
Исправление ошибок в настройках
Если при запуске обработки выдается протокол проверки файлов настроек, значит необходимо внести изменения в настройки.
Для файла настроек, в котором обнаружены ошибки, обработка автоматически создает пользовательский файл настроек, в котором присутствуют только те параметры, в которых обнаружены ошибки. Пользовательский файл настроек называется так же, как и основной, только без расширения sbis3. Например, для файла «ВО82БУХ2_РеализацияТоваровУслуг.sbis3.xml» пользовательский файл будет называться «ВО82БУХ2_РеализацияТоваровУслуг.xml». Любые изменения производятся только в пользовательском файле, так как стандартные файлы настроек обновляются при обновлении обработки.
Если ошибок несколько, то начинаем исправлять их по-одной. Возможно, при исправлении значения одного параметра, другие ошибки пропадут сами, т.к. параметры связаны между собой. После исправления ошибки закрываем протокол проверки, нажимаем кнопку «Проверить настройки» в обработке и смотрим, остались ли еще ошибки. И так далее, пока не будут исправлены все ошибки.
В конфигурации реквизит назван по-другому
Диагностика
В протоколе проверки выдается ошибка:
Не найден реквизит «Договор». Значение параметра: [Документ].Договор Полный путь параметра: Документ.РеализацияТоваровУслуг.Договор Таблица доступных реквизитов: РеализацияТоваровУслуг
Т.о., мы понимаем, что в БД у документа РеализацияТоваровУслуг нет реквизита Договор.
Решение
В протоколе проверки ищем таблицу РеализацияТоваровУслуг (в тексте ошибки указано название таблицы доступных реквизитов). В таблице ищем реквизит по смыслу похожий на «Договор».
Видим, что есть реквизит «ДоговорКонтрагента». В пользовательском файле настроек вместо параметра [Документ].Договор пишем [Документ].ДоговорКонтрагента.
При наличии доступа в конфигуратор названия реквизитов можно посмотреть там, вместо того, чтобы искать нужную таблицу в протоколе проверки.
В конфигурации реквизит хранится в другом месте
Диагностика
В протоколе проверки выдается ошибка:
Не найден реквизит «НомерГТД». Значение параметра: [ТаблДок].НомерГТД Полный путь параметра: Документ.РеализацияТоваровУслуг.ТабличнаяЧасть.Товары.НомерГТД Таблица доступных реквизитов: Товары
Т.о., мы понимаем, что в БД у документа РеализацияТоваровУслуг в табличной части Товары нет реквизита НомерГТД.
Решение
В протоколе проверки ищем таблицу Товары. В таблице ищем реквизит по смыслу похожий на «НомерГТД» — ничего похожего на НомерГТД не видим. Получается, что либо номера ГТД не ведутся вообще, либо хранятся в каком-то другом месте. Логичнее всего, что если его нет в табличной части документа, возможно он есть в карточке номенклатуры. Такую же логику можно применить к единицам измерения: в некоторых конфигурациях они указываются в табличной части документа, а в некоторых — только в карточке номенклатуры.
В протоколе проверки находим таблицу доступных реквизитов номенклатуры (в таблице Товары есть ее название — обычно это «Номенклатура»). Видим, что в номенклатуре есть реквизит НомерГТД, а значит в пользовательском файле настроек мы заменяем значение параметра [ТаблДок].НомерГТД на [Номенклатура].НомерГТД (параметр [Номенклатура] у нас уже определен в стандартном файле настроек)
Аналогичные поиски реквизитов можно выполнять и в конфигураторе (при наличии доступа в него). В открывшемся окне в табличной части Товары документа РеализацияТоваровУслуг ничего похожего на НомерГТД не видим
Спрашиваем у клиента, где они заполняют номера ГТД. В нашем примере номер ГТД хранился не в документе реализации, а в справочнике Номенклатуры.
Более сложный, но самый правильный вариант узнать, где хранится нужный реквизит — это посмотреть модуль печатной формы документа в 1С, чтобы понять, откуда данные выводятся на печать.
Документы хранятся в нестандартном реестре
Диагностика
В протоколе проверки выдается ошибка:
«Неправильный текст запроса. (<(14, 2)>: Таблица не найдена «»Документ.КорректировкаРеализации»» <<?>>Документ.КорректировкаРеализации КАК КорректировкаРеализации)»
Т.о., мы понимаем, что в БД нет документа КорректировкаРеализации.
Решение
Самый простой вариант, если в данной конфигурации вообще не ведутся документы такого типа. В этом случае просто удаляем и стандартный и пользовательский файлы настроек.
Второй вариант — документы данного типа ведутся, но называются по-другому, например «КорректировкаРеализацииТоваров». В этом случае создаем новый пользовательский файл настроек по имени документа и полностью заполняем его. За основу можно взять стандартный файл корректировки реализации и внести в него необходимые изменения.
Настройка
Бывают случаи, когда ошибок в файлах настроек нет, но клиент хочет чтобы при выгрузке или при загрузке документов определенные реквизиты рассчитывались нестандартным способом.
Изменение выгрузки документа
Изменение выгрузки существующего реквизита
Например, мы хотим, чтобы при выгрузке накладной сумма НДС бралась не из реквизита СуммаНДС табличной части Товары документа Реализация товаров и услуг, а рассчитывалась с помощью функции.
Для этого создаем пользовательский файл настроек. В пользовательском файле не должно быть лишних параметров — только тот, который мы хотим изменить, но должна соблюдаться структура вложенности узлов xml. То есть в нашем случае пользовательский файл будет выглядеть следующим образом:
где сбисВычислитьСуммуНДС() — функция, которую мы должны определить в модуле формы «РаботаСДокументами1С» обработки «ВнешниеФункции_Клиент.epf»
Добавление параметра в выгружаемый файл
При необходимости выгрузить какую-то дополнительную информацию по документу, мы добавляем в пользовательский файл настроек параметры. Например, хотим добавить информацию о производителе товара. Информация о нем хранится в номенклатуре. Соответственно параметры добавляем в табличную часть. Пользовательский файл настроек будет выглядеть следующим образом:
В данном случае мы добавили три параметра в табличную часть документа НаимПроизв, ИННПроиз, КПППроизв — наименовании, ИНН, КПП производителя. Данная информация будет присутствовать в выгружаемом файле. При необходимости ее можно вывести в печатную форму документа — для этого необходимо сделать пользовательскую визуализацию документа.
Аналогичным способом можно добавить параметры и в шапку документа.
Используемые параметры
В параметры можно выгрузить абсолютно любую информацию, а также задать для них любые имена. НО! Для систематизации данных, чтобы однотипная информация всегда выгружалась в параметр с определенным именем, составлен список параметров, которые рекомендуется использовать:
Имя параметра Описание параметра Комментарий Параметры шапки документа GLNПокуп GLN покупателя Глобальный идентификационный номер GLN (Global Location Number) представляет собой 13-разрядный цифровой код (номер), предназначенный для идентификации предприятий, функциональных подразделений, физических местоположений. Данные параметры необходимо заполнять при обмене EDI GLNПост GLN поставщика GLNГрузОтпр GLN грузоотправителя GLNГрузПолуч GLN грузополучателя ДоверДата Дата доверенности Сведения о доверенности ДоверНомер Номер доверенности ДоверКем Кем выдана доверенность ДоверКому Кому выдана доверенность Договор Название договора Используются для документов, у которых в формате отсутствует информация о договоре ДоговорДата Дата договора ДоговорНомер Номер договора ЗаказДата Дата заказа Сведения о заказе. Указываются в накладной, созданной на основании данного заказа. ЗаказНомер Номер заказа Заказчик Наименование заказчика Используются в акте выполненных работ, так как по формату ФНС не предусмотрена информация о заказчике. При наличии выводятся в печатную форму. ЗаказчикИНН ИНН заказчика ЗаказчикКПП КПП заказчика ЗаказчикАдрес Адрес заказчика ИнфШапка Информация, выводимая перед шапкой документа Используются для вывода любой дополнительной информации в печатной форме документа. См. раздел Визуализация дополнительной информации ИнфПередТабл Информация, выводимая перед табличной частью документа ИнфПослеТабл Информация, выводимая после табличной части документа ИнфПодвал Информация, выводимая после подвала документа КодПокуп Код филиала покупателя Код филиала участника. Используется при наличии нескольких филиалов с одинаковыми ИНН/КПП для однозначного определения участника документооборота. КодПост Код филиала поставщика КодГрузОтпр Код филиала грузоотправителя КодГрузПолуч Код филиала грузополучателя КолМестВсего Количество мест всего Используется в документах, где форматом не предусмотрено указание количества мест КСчетПокуп Корреспондентский счет покупателя Используются в накладной, так как по формату данные реквизиты не предусмотрены. При наличии выводятся в печатную форму. КСчетПост Корреспондентский счет поставщика КСчетГрузОтпр Корреспондентский счет грузоотправителя КСчетГрузПолуч Корреспондентский счет грузополучателя НаимПокуп Наименование покупателя Используются для физических лиц, так как по формату предусмотрено только ФИО, а в печатной форме нужно полное наименование. При наличии выводятся в печатную форму. НаимПост Наименование поставщика НаимГрузОтпр Наименование грузоотправителя НаимГрузПолуч Наименование грузополучателя ОбщийВес Общий вес товаров Используется в документах, где данный реквизит не предусмотрен форматом ОснованиеДата Дата документа-основания Сведения о документе-основании. Используется в счете-фактуре для указания реквизитов накладной/акта. В случае отправки счета-фактуры отдельным пакетом при загрузке на стороне получателя производится поиск документа основания по данным реквизитам. ОснованиеНомер Номер документа-основания ПРД Сведения о платежно-расчетных документах Используется если данные хранятся одной произвольной строкой и нет возможности записать отдельно дату и номер, как предусмотрено форматом счета-фактуры. РСчетПокуп Расчетный счет покупателя Используются в документах, где по формату не предусмотрены банковские реквизиты. РСчетПост Расчетный счет поставщика РСчетГрузОтпр Расчетный счет грузоотправителя РСчетГрузПолуч Расчетный счет грузополучателя Срок Срок поставки товара Используется в документах, где данный реквизит не предусмотрен форматом СФДата Дата счета-фактуры Сведения о счете-фактуре, для которого текущий документ является основанием. СФНомер Номер счета-фактуры ТТНДата Дата товарно-транспортной накладной Сведения о товарно-транспортной накладной ТТННомер Номер товарно-транспортной накладной Параметры табличной части документа GTIN GTIN товара Глобальный номер товара (Global Trade Item Number; GTIN) предназначен для уникальной идентификации продукта в торговле. Данный параметр необходимо заполнять при обмене EDI. Брутто Масса брутто Используется в документах, где форматом не предусмотрено указание массы брутто, либо при необходимости указать большее количество знаков после запятой, чем предусмотрено форматом. КолМест Количество мест (упаковок) Используется в документах, где форматом не предусмотрено указание количества мест, либо при необходимости указать большее количество знаков после запятой, чем предусмотрено форматом. Кол_во Количество Используется при необходимости указать большее количество знаков после запятой, чем предусмотрено форматом. При наличии данного параметра он выводится в печатную форму вместо стандартного атрибута Кол_во. НаимПроизв Наименование производителя Сведения об алкогольной продукции ИННПроизв ИНН производителя КПППроизв КПП производителя КодВидаАлкПрод Код вида алкогольной продукции по классификатору Нетто Масса нетто Используется в документах, где форматом не предусмотрено указание массы нетто, либо при необходимости указать большее количество знаков после запятой, чем предусмотрено форматом. Площадь Площадь объекта Цена Цена Используется при необходимости указать большее количество знаков после запятой, чем предусмотрено форматом, либо при необходимости указать цену, включающую НДС. При наличии данного параметра он выводится в печатную форму вместо стандартного атрибута Цена. Визуализация дополнительной информации
Довольно часто печатная форма документа у клиента незначительно отличается от стандартной, например, выводится строчка с какой-то дополнительной информацией перед табличной частью. Чтобы для каждого такого клиента не делать отдельную визуализацию, существует особая группа параметров, которые автоматически попадают в печатную форму документа:
- ИнфШапка — значение параметра отображается в шапке документа
- ИнфПередТабл — значение параметра отображается перед табличной частью документа
- ИнфПослеТабл — значение параметра отображается после табличной части документа
- ИнфПодвал — значение параметра отображается в подвале документа
Например, клиент хочет в счет-фактуре перед табличной частью видеть название договора. В этом случае в пользовательский файл настроек добавляется параметр «ИнфПередТабл»:
При необходимости к добавляемой строке можно применить форматирование (с помощью html-кода). Например, название договора должно выводиться жирным шрифтом. В этом случае параметр придется определить через внешнюю функцию:
Описание и настройка обработки СБИС для 1С 8.3
Обработка СБИС для 1С позволяет работать с документами напрямую из программы 1С. Общая схема работы выглядит следующим образом: документы, отправленные контрагентами, приходят на портал СБИС, обработка их считывает и показывает пользователю в рабочем месте. Пользователь может работать с документами из обработки, утвердить, отклонить, загрузить в 1С и т.д. Соответственно, документы можно отправлять контрагентам напрямую из 1С. При отправке документа обработка формирует XML-файл определенного формата, который содержит всю информацию необходимую для последующего формирования документа на портале СБИС. Также если необходимо сделать вложения каких-то документов, то они добавляются к XML-файлу и отправляются одним пакетом. Соответственно, при загрузке документа, пришедшего от контрагента, обработка считывает XML и формирует соответствующий документ 1С и позволяет выгрузить документ из 1С.
Сама обработка скачивается с портала СБИС и запускается в 1С как внешняя обработка. Далее необходимо указать свой логин и пароль на портале СБИС. При обработке все документы попадают в соответствующие разделы: входящие документы от контрагентов попадают в раздел «Полученные», документы продажи – в раздел «Продажа» и т.д. Состав документов, попадающих в тот или иной подраздел, можно гибко настраивать. Об этом расскажем далее.
Соответственно, каждый документ можно открыть, просмотреть и при необходимости загрузить, утвердить, отклонить, отправить и т.д.
1. Как использовать и найти файлы настроек.
У компании «1С» существует множество конфигураций, плюс часто они дорабатываются под конкретные задачи и бизнес-процессы компании. Для того чтобы не делать множество обработок под каждую конфигурацию, в обработке можно найти файлы настроек в формате XML, которые указывают обработке, где что хранится в конкретной конфигурации. Для типовых, наиболее распространенных конфигураций, наборы этих файлов уже включены в обработку. При первом запуске обработка сама определяет конфигурацию, и если у вас одна из поддерживаемых версий, формирует папку с настройками для данной версии. Папку можно поменять в обработке в меню настройки. Если папка будет путая, обработка автоматически заполнит ее файлами для текущей конфигурации. Ниже показано, как это выглядит. Справа список всех файлов настроек для текущей конфигурации, а слева размещенные в папке. Зная, с какими документами мы обмениваемся через СБИС и название файлов настроек, отвечающих за них, мы можем добавить только необходимые файлы. Таким образом, в обработке у нас будут отображаться только необходимые нам типы документов. Это позволит не перегружать лишними данными рабочее место.
Из названий файлов уже понятно, за какой тип документа они отвечают.
Название файла выгрузки 1С формируется по шаблону:
для ЕРП 2.4, настройка 1С выгрузки документов Реализации товаров и услуг будет иметь вид: «ВО82ERP2-4_РеализацияТоваровУслуг.sbis3»
Название файла загрузки формируется по шаблону:
для ЕРП 2.4, настройка загрузки документов «ПриобретениеУслуг иПрочихАктивов» будет иметь вид: «ВО82ERP2-4_АктВР_3_01.sbis3».
Существует 3 типа файлов настроек:
· Настройки 1С конфигурации: (ВО82ERP2-4_Конфигурация.sbis3). Он всего лишь один и содержит общие настройки для работы обработки.
· Файлы настроек реестров Продажа/Покупка:
(ВО82ERP2-4_РеализацияТоваровУслуг.sbis3). Они отвечают за отправку требуемых типов документов из 1С в СБИС и формируют списки документов в соответствующих разделах обработки.
· Файлы настроек загрузки: (ВО82ERP2-4_АктВР_3_01.sbis3) Они отвечают за загрузку документов из СБИС в 1С.
2. Как загрузить из 1С в СБИС?
Далее нужно понять, как загрузить из 1С в СБИС. Разделы обработки Продажа/Покупка содержат в себе подразделы, в которых отображаются списки документов 1С, например, «Реализация товаров и услуг», «Заказ поставщику» и т.д. Из этих подразделов документы можно отправлять контрагентам. Список пунктов подразделов зависит от количества файлов настроек в каталоге. Подраздел появляется в том случае, если файл настроек содержит параметр <ЗапросСпискаДокументов>, содержащий запрос документов из базы.
Файлы настроек данного типа имеют следующую структуру:
· Общие параметры раздела
· Запрос для списка документов
· Массив с параметрами выгружаемых файлов (мФайл)
· Параметры шапки документа
· Массив табличных частей (мТаблДок)
· Параметры табличной части документа
В общем виде она выглядит так (часть параметров я удалил для удобства рассмотрения структуры):
Тег <ЗапросСпискаДокументов> содержит запрос и определяет документы которые будут отображаться в разделе. В нашем случае -«Продажа».
Узел <мФайл> содержит в себе данные, необходимые для формирования и заполнения файла.
Теги <Файл_Формат>Параметры необходимы для определения формата электронного документа. Автоматически попадают в выгружаемый файл.
Теги<мСторона> содержат реквизиты участников сделки: ИНН, КПП и другие коды, контактную информацию, банковские реквизиты.
Узел <мТаблДок>. В нем описываются реквизиты табличной части документа.
Все теги я описывать не буду — их назначения понятно из «имен». Отмечу лишь, что при необходимости можно записать в файл любую дополнительную информацию, не предусмотренную форматом электронного документа. Для этого используется узел <мПараметр>. В листинге выше так описан параметр с именем «ДоговорНомер».
Важно: для внесения изменения в файлы настроек разработан специальный механизм замены данных в файле настроек. Так как стандартные файлы настроек автоматически обновляются вместе с обработкой, для внесения изменений используются пользовательские файлы настроек программы, которые отличаются от стандартных расширением (стандартный файл расширение .sbis3.xml, пользовательский xml). При запуске обработки формируется сводный файл, где одноименные параметры стандартного файла заменяются параметрами пользовательского файла. Главное соблюсти структуру XML-файла.
Предположим, нам нужно поменять Название номенклатуры в табличной части документа «СчетНаОплатуКлиенту». Мы создаем свой файл на основе стандартной настройки ВО82ERP2-4_СчетНаОплатуКлиенту.sbis3, только меняем название файла на ВО82ERP2-4_СчетНаОплатуКлиенту. В файле сохраняя структуру исходного файла пишем:
При такой настройке название номенклатуры в табличной части будет получаться из нашего пользовательского файла и для всех позиций проставляться «Наш товар».
3. Описание параметров в файлах настроек программы.
В файлах настроек доступно описание необходимых параметров несколькими способами:
· Прямое обращение к данным: <Документ>Документ.РеализацияТоваровУслуг</Документ>
Здесь ключевое слово Документ означает, что в параметр будет помещена ссылка на выгружаемый документ.
· Обращение через ранее определенный параметр:
· Присвоение строкового значения:
· Обращение к данным через функцию.
Если нам необходимо получать параметр по какому-то сложному алгоритму, то предусмотрена возможность описать его в модуле внешней обработки. Обработка должна называться «ВнешниеФункции_Клиент.epf» и располагаться в папке с настройками. В обработке создается форма с названием «РаботаСДокументами1С». В модуле этой формы и располагается необходимая нам функция. Функция имеет один параметр Контекст, где в виде структур находятся все вычисленные ранее параметры файла настроек.
С помощью запроса к базе:
4. Настройка файлов Загрузки документов при выгрузке из СБИС в 1С.
Все документы, полученные от контрагентов, отображаются в разделе обработки «Полученные». Какие документы можно загрузить файл в 1С 8.3, определяется файлами настроек для загрузки документов.
Файлы настроек данного типа имеют следующую структуру
· Общие параметры для этого типа
· Массив документов 1С, которые можно создать при загрузке файла этого типа (мДокумент)
· Параметры шапки создаваемого документа
· Параметры табличной части документа
В общем виде она выглядит так (часть параметров я удалил для удобства рассмотрения структуры):
Узел <мДокумент> определяет, какой тип документа будет загружен. Таких узлов может быть несколько. Например, из полученной Счет-фактуры можно создать несколько документов: «СчетФактураПолученный» и связаный «ПриобретениеТоваровУслуг».
Внутри узла описываются данные, которые необходимо проставить в загруженном документе. Подход здесь точно такой же, как и при настройке выгрузки документов. Остановимся подробней только на ключевом моменте файлов загрузки – это атрибутах «Данные» и «Выгрузить».
Данные атрибуты указывают, откуда нужно взять значение для заполнения соответствующего реквизита созданного документа 1С.
Через атрибут «Данные» указывается путь напрямую из файла загрузки. Например, запись:
Означает, что реквизит «Организация», создаваемого документа 1С, будет заполнен из атрибута «Получатель» узла «Документ» полученного файла.
Атрибут «Вычислить» используется, если реквизит нужно заполнить не значением из файла, а вычислить через функцию, присвоить строковое значение или значение перечислений и т.д.
Эти записи означают, что реквизит Валюта будет заполнен из реквизита «Валюта» параметра «Соглашение», а реквизит «Договор» будет определен через функцию «ЗаполнитьДоговорУТ11()».
В данной статье были рассмотрены основные понятия и принципы работы с файлами настроек обработки СБИС, загрузка и выгрузка из 1С в СБИС. В следующей статье разберем практический пример адаптации настроек под конкретную задачу.
Как настроить интеграцию СБИС и 1С
Встроенные возможности СБИС позволяют организовать документооборот прямо в браузере, не настраивая дополнительно 1С, при условии что у вас версия 8.2 и выше, в том числе веб-клиент.
Достаточно один раз наладить взаимодействие систем.
Вызовите мастер настройки:
- На главной странице СБИС нажмите , наведите курсор на «Загрузить» и выберите « Из 1С».
- для ПК-версии выберите один из предложенных вариантов;
- для веб-клиента скопируйте URL из адресной строки браузера.
Как загрузить справочники из 1С в СБИС
* Для загрузки справочника алкоголя этот способ не подойдет. Необходимо выполнить запрос остатков.
Чтобы импортировать справочник сотрудников:
1. Зайдите в раздел «Сотрудники».
2. Нажмите и выберите .
3. Кликните и отметьте необходимых сотрудников.
4. Нажмите «Загрузить».
5. Теперь в СБИС есть такие же справочники, как в 1С.
Сервис мгновенного обмена электронными документами внутри компании и с контрагентами. Интегрируется в любую учетную систему, экономит время, избавляет от бумажных документов, повышает информационную безопасность.
Как загрузить документ из 1С
1.«Документы» → «Исходящие» → выберите требуемый тип, например, «Реализация» → Нажмите → выберите базу и тип документа.
2. Стандартно документы выбираются за последний месяц. Используя фильтр, отметьте галочками те, что нужны вам.
3. Кликните «Загрузить».
Как выгрузить документ в 1С
1. Войдите в один из реестров:
— Документы → Входящие
— Бизнес → Закупки
— Документы → Исходящие → Реализации— Бизнес → Продажи/CRM → Реализации2. Нажмите
3. В панели массовых операций отметьте флагом документы и кликните «» → выберите вашу базу .
Когда выгрузка завершится, сформируется отчет. Код номенклатурной позиции не должен превышать 11 символов (ограничение 1С).
4. Проверьте загруженный файл в 1С. Если элементы не связались с нужной номенклатурой автоматически, укажите ее вручную.
Также предлагаем посмотреть подробную видеоинструкцию:Если у вас остались вопросы или нужна помощь с подключением сервисов, заполните заявку на обратный звонок или позвоните по номеру (831) 2-333-666. Мы рады помочь.