Cодержание:
1. Как использовать и найти файлы настроек
2. Как загрузить из 1С в СБИС?
3. Описание параметров в файлах настроек программы.
4. Настройка файлов Загрузки документов при выгрузке из СБИС в 1С.
Обработка СБИС для 1С позволяет работать с документами напрямую из программы 1С. Общая схема работы выглядит следующим образом: документы, отправленные контрагентами, приходят на портал СБИС, обработка их считывает и показывает пользователю в рабочем месте. Пользователь может работать с документами из обработки, утвердить, отклонить, загрузить в 1С и т.д. Соответственно, документы можно отправлять контрагентам напрямую из 1С. При отправке документа обработка формирует XML-файл определенного формата, который содержит всю информацию необходимую для последующего формирования документа на портале СБИС. Также если необходимо сделать вложения каких-то документов, то они добавляются к XML-файлу и отправляются одним пакетом. Соответственно, при загрузке документа, пришедшего от контрагента, обработка считывает XML и формирует соответствующий документ 1С и позволяет выгрузить документ из 1С.
Сама обработка скачивается с портала СБИС и запускается в 1С как внешняя обработка. Далее необходимо указать свой логин и пароль на портале СБИС. При обработке все документы попадают в соответствующие разделы: входящие документы от контрагентов попадают в раздел «Полученные», документы продажи – в раздел «Продажа» и т.д. Состав документов, попадающих в тот или иной подраздел, можно гибко настраивать. Об этом расскажем далее.
Соответственно, каждый документ можно открыть, просмотреть и при необходимости загрузить, утвердить, отклонить, отправить и т.д.
1. Как использовать и найти файлы настроек.
У компании «1С» существует множество конфигураций, плюс часто они дорабатываются под конкретные задачи и бизнес-процессы компании. Для того чтобы не делать множество обработок под каждую конфигурацию, в обработке можно найти файлы настроек в формате XML, которые указывают обработке, где что хранится в конкретной конфигурации. Для типовых, наиболее распространенных конфигураций, наборы этих файлов уже включены в обработку. При первом запуске обработка сама определяет конфигурацию, и если у вас одна из поддерживаемых версий, формирует папку с настройками для данной версии. Папку можно поменять в обработке в меню настройки. Если папка будет путая, обработка автоматически заполнит ее файлами для текущей конфигурации. Ниже показано, как это выглядит. Справа список всех файлов настроек для текущей конфигурации, а слева размещенные в папке. Зная, с какими документами мы обмениваемся через СБИС и название файлов настроек, отвечающих за них, мы можем добавить только необходимые файлы. Таким образом, в обработке у нас будут отображаться только необходимые нам типы документов. Это позволит не перегружать лишними данными рабочее место.
Из названий файлов уже понятно, за какой тип документа они отвечают.
Название файла выгрузки 1С формируется по шаблону:
«ВО82[Код конфигурации]_Название.sbis3.xml»,
для ЕРП 2.4, настройка 1С выгрузки документов Реализации товаров и услуг будет иметь вид: «ВО82ERP2-4_РеализацияТоваровУслуг.sbis3»
Название файла загрузки формируется по шаблону:
«ВО82[Код конфигурации]_[КодФормата]_[ВерсияФормата].sbis3.xml»
для ЕРП 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С в СБИС. В следующей статье разберем практический пример адаптации настроек под конкретную задачу.
Специалист компании ООО «Кодерлайн»
Сергей Озеров.