СБИС Сапёр — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
(Новая страница: «=Общие сведения= ==Назначение документа== Документ представляет собой техническое описа…»)
 
(Пакет /SBIS/CORE_740)
 
(не показано 114 промежуточных версий 2 участников)
Строка 1: Строка 1:
 
=Общие сведения=
 
=Общие сведения=
==Назначение документа==
+
[[Файл:sap_send_packet.png|400px|thumb|right|Список пакетов документов]]
 +
[[Файл:sap_inbox.png|400px|thumb|right|Список полученных пакетов документов]]
 +
[[Файл:sap_packet_preview.png|400px|thumb|right|Окно просмотра пакета]]
  
Документ представляет собой техническое описание порядка установки, настройки и расширения стандартного функционала SBIS for SAP.  
+
СБИС САПЁР - это модуль интеграции SAP с системой обмена юридически значимыми электронными документами СБИС.
  
==Область применения документа==
+
Используя СБИС САПЁР, можно:
Настоящий документ предназначен для описания технических аспектов внедрения продукта SBIS for SAP. Документ может использоваться для постановки задач техническим специалистам по внедрению и расширению функциональности Системы.
+
* отправлять из SAP любые пакеты любых электронных документов в формате XML.
 +
* отслеживать состояние ранее отправленных документов
 +
* просматривать и обрабатывать входящие электронные документы
 +
* создавать документы SAP на основании входящих электронных документов
  
==Общее назначение системы==
+
=Отправка документов=
 +
СБИС САПЁР может формировать и отправлять электронные документы несколькими способами:
 +
==Отправка через интерфейс SAP==
 +
В составе СБИС САПЁР есть ABAP программа \SBIS\SAPPER, с помощью которой пользователь в интерфейсе SAP может работать с электронными документами.
  
Система предназначена для автоматизации процессов обмена электронными юридически значимыми документами.
+
'''Сценарий работы пользователя''' (в оптимальном варианте после запуска два клика мышкой):
 +
# вызываем программу
 +
# выбираем тип пакета документов
 +
# отмечаем пакеты документов которые хотим отправить
 +
# нажимаем кнопку отправить
  
==Глоссарий==
+
'''Возможные настройки''':
 +
# варианты пакетов документов и их состав
 +
# внешний вид (визуализация) документов
 +
# способ получения данных: программа печати / XML из ЭДО от SAP СНГ / BAPI
 +
# способ отправки: SDK, СБИС Коннект, API, архитектура решения допускает отправку через любого оператора
  
Настоящий раздел содержит полный список сокращений и определений, используемых в документе.
+
'''Как это работает''':
  
Таблица 2 Глоссарий
+
Все разделы меню Сапера, настраиваются без изменения ABAP кода. Пункты меню раздела Продажа, описывают варианты пакетов отправляемых документов. Каждый пункт этого раздела описывает состав конкретного типа пакетов документов.
  
Технические документы Файлы, предусмотренные регламентом документооборота, содержащие описание процесса отправки
+
При выборе пользователем какого-то пункта меню раздела Продажа Сапер получает из настроек модуля текст запроса для построения списка документов и выполняет его. Текст запроса написан таким образом, чтобы собрать соответствующие пакеты документов. В результате запроса, пользователь увидит на экране список документов сгруппированных в пакеты (например, ТОРГ-12 и фактура).  
* '''Формализованный документ''' - Структурированный документ (XML-формат)
 
* '''Неформализованный документ''' - Неструктурированный документ (произвольный файл, например, в формате PDF)
 
* '''ЭДО''' - Электронный документооборот
 
* Документ Документ, полученный от контрагента или направляемый ему, отражающий факты проведения финансовых операций с контрагентом, выполнения каких-либо работ или оказания услуг, поставки каких либо * ТМЦ (например, Счёт-фактура, Накладная Торг-12, Акт приёма/сдачи работ и т.п.)
 
* ЭП Электронная подпись - реквизит электронного документа, предназначенный для защиты данного электронного документа от подделки, полученный в результате криптографического преобразования информации с использованием закрытого ключа электронной цифровой подписи и позволяющий идентифицировать владельца сертификата ключа подписи, а также установить отсутствие искажения информации в электронном документе
 
Техническая ЭП ЭП, которая применяется для подписания технических документов (технологических уведомлений) в процессе обмена через ОЭД.
 
* ИМ, IM Интеграционный модуль (Integration Module) - компонент Системы, отвечающий за обмен сообщениями между SAP-системой Заказчика и ОЭД
 
* БЕ Код балансовой единицы в системе SAP
 
* ГФ Группа функций, объект системы SAP
 
* ФМ Функциональный модуль, объект системы SAP
 
* БО Бизнес-объект SAP
 
* СЭ Селекционный экран, экран выбора данных
 
  
=Общая характеристика продукта=
+
При открытии пользователем карточки пакета документов (двойной клик в списке) или при нажатии кнопки отправить - Сапер для каждого документа пакета вызывает программу печати, которая обычно используется для его печати, в режиме формирования электронного документа. Далее, на основании рассчитанных программами печати данных и при помощи таблиц маппинга он формирует XML файлы требуемых форматов. Полностью сформировав пакет документов он подключается к COM объекту СБИС и при помощи него подписывает и отправляет документы (возможно несколько вариантов, с подписанием и без).
==Архитектура системы==
 
  
В настоящем разделе приведена схема взаимодействия основных компонентов, дано краткое описание решения. На схеме отражены ключевые программные компоненты и логические подсистемы  решения.
+
Данный способ работает на любом SAP, с любыми типами документов и отчетов (не имеет никаких зависимостей от функционала, реализованного SAP для журнала электронных счетов фактур из российского Add-on)
 
Рисунок 1 Схема логической и программной архитектуры
 
  
===SBIS for SAP===
+
==Отправка через интерфейс СБИС==
Программный компонент, предназначен для интеграции учётной системы SAP ERP с СБИС. Условно SBIS for SAP  
+
Если Вы пользуетесь согласованиями в СБИС (например для входящих документов), то Вам будет удобнее загружать документы в SAP из интерфейса СБИС. Тоже самое касается и отправки документов. Для этого находясь в СБИС достаточно нажать на кнопку выгрузить в SAP (или загрузить из SAP), после чего все будет ровно так же как если бы Вы отправляли документы из SAP).
  
===SBIS Plugin===
+
'''Как это работает''':
Объект для обеспечения функционала личного кабинет СБИС (предназначен для генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7, вывода информационных уведомлений о поступивших документах / заданиях, операций по ручной загрузке и выгрузке документов). Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством SAP NET Connector 3, входит в состав компонентов ядра продукта.
+
 
 +
Браузер по WebSocket подключается к СБИС Плагин установленный на компьютере пользователя. СБИС Плагин конвертирует запрос в форматы соответствующих методов RFC и вызывает их.
 +
 
 +
==Отправка через интерфейс стандартного модуля ЭДО==
 +
В составе СБИС САПЁР есть пакет EJOURNAL который реализует работу ( в т.ч. BADI) со стандартными журналами электронных документов SAP.
 +
 
 +
Дополнительно к этому он предоставляет программу, которая позволяет в три клика отправлять пакеты документов сформированные из записей стандартных журналов. Сделано специально для приверженцев стандартного функционала.
 +
 
 +
Функционал данного способа ограничен возможностями стандартного модуля и всеми его [[Варианты интеграции с SAP |недостатками]].
 +
 
 +
== FAQ ==
 +
'''Вопрос:''' У нас сотрудник не должен видеть все документы определенного типа, возможен ли показ документов только его зоны ответственности?
 +
 
 +
'''Ответ:''' Да возможно, список документов перед отправкой строится при помощи простого запроса указанного в таблице настроек, его можно изменить с учетом Вашей специфики.
 +
 
 +
=Загрузка документов=
 +
==Загрузка через интерфейс SAP==
 +
В интерфейсе СБИС САПЁР есть разделы Полученные, в этом разделе показываются все документы которые пользователь видит в личном кабинете в разделе Входящие. На основании входящего электронного документа можно создать SAP документ. Как правило на основании накладной создается Заказ на закупку в ММ, а на основании акта выполненных работ или счет-фактуры создается Входящий счет в ММ.
 +
 
 +
'''Сценарий работы пользователя''':
 +
# вызываем программу
 +
# пользователь видим список доступных ему входящих документов (ограничения настраиваются в личном кабинете СБИС)
 +
# любой документ пользователь может посмотреть, выполнить над ним доступное действие (по умолчанию это принять / отклонить)
 +
# В карточке документа на документе нажимает правую кнопку мыши и видит список вариантов загрузки.
 +
# Выбирает интересующий вариант. Видит окно параметров загрузки, ввод информации отсутствующей в XML, например завод, и таблицу сопоставления кодов номенклатуры.
 +
# Нажимает кнопку загрузить - видит заполненную карточку документа SAP
 +
 
 +
'''Варианты настройки''':
 +
# для каждого типа электронного документа можно настроить несколько вариантов его загрузки в SAP, например ТОРГ-12 можно загрузить как заявку и как накладную.
 +
# два способа загрузки BAPI и пакетный ввод (для измененных форм)
 +
 
 +
'''Как это работает''':
 +
При выборе способа загрузки, Сапер согласно настройкам сериализует XML в структуру SAP и заполняет окно ввода дополнительных параметров. Для каждого товара / услуги ищет по таблице соответствия кодов номенклатуры соответствующий материал SAP.
 +
 
 +
После нажатия кнопки загрузить в окне ввода дополнительных параметров загрузки, Сапер сохраняет введенные данные по соответствию кодов номенклатуры. Далее в соответствии с таблицей настроек формирует структуры для BAPI указанной в настройках и вызывает её. В случае пакетного ввода - формирует последовательность и исполняет её. По окончании открывает карточку созданного документа.
 +
 
 +
=Архитектура системы=
 +
[[Файл:AddonSbisForSAPcheme1.png|400px|thumb|right|Схема логической и программной архитектуры]]
 +
В настоящем разделе приведена схема взаимодействия основных компонентов. На схеме отражены ключевые программные компоненты и логические подсистемы решения.
 +
 
 +
Модуль состоит из нескольких ABAP пакетов и поставляется в виде нескольких транспортных запросов.
 +
 
 +
 
 +
==SBIS SAPPER==
 +
 
 +
Программный компонент, предназначен для интеграции учётной системы SAP ERP с СБИС. Имеет модульную архитектуру, позволяющую легко встраиваться в имеющиеся бизнес-процессы. Поставляется в ввиде нескольких транспортных запросов. Каждый транспортный запрос содержит одноименный ABAP пакет:
 +
 
 +
Список ABAP пакетов в порядке их импорта:
 +
 
 +
 
 +
=== Пакет /SBIS/CORE ===
 +
 
 +
Содержит общие объекты, используемые другими специализированными пакетами.
 +
#Таблицы
 +
##/SBIS/MATERIALS - таблица сопоставления номенклатуры с номенклатурой клиентов.
 +
##/SBIS/SETTINGS - настройки Сапера.
 +
##/SBIS/STATUS - справочник статусов документов.
 +
##/SBIS/STATUS_DOC - статусы документов.
 +
##/SBIS/U_SETTINGS - настройки Сапера для пользователя.
 +
##/SBIS/XSLT - справочник и двоичные данные XSLT.
 +
#Классы
 +
##/SBIS/CL_ASYNC_PROCESSING - содержит методы для многопоточной обработки.
 +
##/SBIS/CL_CORE - содержит вспомогательные служебные методы и методы-оболочки обработки данных.
 +
##/SBIS/CL_CREATE_SAP_DOCUMENTS - содержит методы создания SAP-документов и сопоставления номенклатуры.
 +
##/SBIS/CL_EXCHANGE_FILE - содержит методы обмена документами через каталог.
 +
##/SBIS/CL_EXCHANGE_SDK - содержит методы обмена документами через СБИС SDK.
 +
##/SBIS/CL_MAPPING - маппинг полей при движении документов между системами SAP и СБИС.
 +
##/SBIS/CL_SAP_DATA - содержит методы получения данных из системы SAP.
 +
##/SBIS/CX_CORE - класс обработки исключений.
 +
#Интерфейсы
 +
##/SBIS/IF_EXCHANGE - интерфейс для технической реализации обмена документами с системой СБИС.
 +
##/SBIS/IF_SAP_DATA - интерфейс для получения данных из системы SAP.
 +
#Программы
 +
##/SBIS/MIGO_DIALOG - программа-оболочка для транзакции MIGO.
 +
##/SBIS/TEST_GET_ATTACHMENT - тестовая программа получения вложения СБИС.
 +
##/SBIS/TEST_GET_LIST_PACKET - тестовая программа получения списка пакетов документов СБИС.
 +
##/SBIS/TEST_GET_PACKET - тестовая программа получения пакета СБИС.
 +
##/SBIS/TEST_SDK  - программа для тестирования работы СБИС SDK.
 +
##/SBIS/TEST_SEND_PACKET - тестовая программа отправки пакета СБИС.
 +
##/SBIS/UPDATE_SETTINGS - программа загрузки настроек Сапера.
 +
##/SBIS/UPDATE_STATUS - программа загрузки справочника статусов документов.
 +
##/SBIS/UPDATE_XSLT - программа загрузки XSLT в справочник XSLT.
 +
#Группы функций
 +
##/SBIS/GF_ASYNC_PROCESSING - содержит функциональные модули (ФМ) для многопоточной обработки.
 +
##/SBIS/GF_AUTH  - содержит ФМ и экраны для авторизации через СБИС SDK.
 +
##/SBIS/GF_CREATE_SAP_DOC - содержит ФМ создания SAP-документов и сопоставления номенклатуры.
 +
##/SBIS/GF_PRINT_PROG - содержит ФМ для запуска программ печати.
 +
##/SBIS/GF_RFC - содержит RFC для работы через браузер. Работа с настройками Сапера и документами.
 +
##/SBIS/GF_SBIS_SHLP2 - средства поиска
 +
##/SBIS/TAB_STATUS - автоматически сгенерированный ФМ для ведения данных таблицы /SBIS/STATUS.
 +
#Транзакции
 +
##/SBIS/MIGO_DIALOG - оболочка для транзакции MIGO.
 +
#XSLT преобразования
 +
##/SBIS/DOC301 - преобразование документа в XML формата 3.01.
 +
##/SBIS/DOC301_2 - преобразование документа в XML формата 3.01.
 +
##/SBIS/DOC301_XML_TO_ABAP - получение данных из XML формата 3.01.
 +
##/SBIS/KONVERT_NATIVE - получение XML пакета СБИС.
 +
 
 +
=== Пакет /SBIS/CORE_700 ===
  
Для работы требуется операционная система Windows XP SP3 и выше, а также NET Framework 2.0 или 4.0. Не поддерживается работа с NET Framework 4.0 Client profile.
+
Содержит объекты, специфичные для версии базиса 7.00.
 +
#Классы
 +
##/SBIS/CL_SAP_DATA_700 - содержит методы получения данных из системы SAP.
 +
##/SBIS/CL_SAP_DATA_700_LIKP - содержит методы получения данных из системы SAP.
 +
##/SBIS/CL_SAP_DATA_700_VBRK - содержит методы получения данных из системы SAP.
  
===SBIS SDK===
+
=== Пакет /SBIS/CORE_740 ===
Объект предназначен для обмена данными с API sbis.ru, а также генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7 . Объект устанавливается на рабочих местах пользователей.  Интеграция с SAP системой выполнена посредством технологии OLE2, входит в состав компонентов ядра продукта.
 
  
==Стандартная поставка==
+
Содержит объекты, специфичные для версии базиса выше 7.40 SP05 (SAPKB74005).
В стандарте продукта SBIS for SAP  поставляется следующий набор пакетов:
+
#Классы
* /SBIS/CORE – родительский пакет, включающий все пакеты ядра системы.
+
##/SBIS/CL_SAP_DATA_740 - содержит методы получения данных из системы SAP.
** /SBIS/ – набор всех ключевых функций продукта;
+
##/SBIS/CL_SAP_EJOURNAL2 - содержит методы получения данных из системы SAP.
** /SBIS/_SAP_<XXX>  - разработки, специфичные для версии системы SAP, где <XXX> - номер версии компонентов;
 
** /SBIS/GUI  - пакет, включающий в себя элементы пользовательского интерфейса;
 
Совет При внедрении продукта рекомендуется создание корневого пакета разработок ZSBIS, в который должны быть включены пакеты:
 
• ZSBIS_<XXXXX> - специфичные для Заказчика разработки, где <XXXXX> - обозначение Заказчика.
 
  
==Правила ведения разработки на проекте==
+
=== Пакет /SBIS/GUI ===
Настоящий раздел содержит общие рекомендации к ведению разработки на проектах внедрения.
 
===Именование объектов словаря===
 
Настоящий раздел описывает концепцию наименований объектов словаря на стороне SAP системы. 
 
  
Таблица 3 Именование объектов словаря
+
Набор общих экранов и функционала, предназначенных для взаимодействия с пользователем.
Объект репозитария Длина
+
#Классы
имени Маска
+
##/SBIS/CL_TREE - набор методов для построения и работы со списком пакетов документов.
Домены 30 /SBIS/DM_[<ff>][_<XXXXXXXX>]
+
##/SBIS/CL_TREE_ACCORDION - набор методов для построения рабочего меню.
Элементы данных 30 /SBIS/ED_[<ff>][_<XXXXXXXX>]
+
##/SBIS/CL_TREE_API2_PACKET - построение и работа со списком исходящих пакетов документов.
Структуры 30 /SBIS/S_[<ff>][_<XXXXXXXX>]
+
##/SBIS/CL_TREE_INBOX - построение и работа со списком полученных пакетов документов.
Типы таблиц 30 /SBIS/T_[<ff>][_<XXXXXXXX>]
+
##/SBIS/CL_TREE_OUTBOX - построение и работа со списком отправленных пакетов документов.
Таблицы БД 16 /SBIS/[<ff>][<XXXXXXXX>]
+
##/SBIS/CL_TREE_RESPONSE - построение и работа со списком уведомлений.
/SBIS/[<ff>][<XXXXXXXX>]T  - для текстовых таблиц
+
##/SBIS/CL_VIEW_INBOX_PACKET - набор методов для работы с полученным пакетом документов.
Ракурсы 16 /SBIS/V_[<ff>][<XXXXXXXX>]
+
##/SBIS/CL_VIEW_OUTBOX_PACKET - набор методов для работы с отправленным пакетом документов.
Search-Help 30 /SBIS/SH_[<ff>][_<XXXXXXXX>]
+
##/SBIS/CL_VIEW_RESPONSE_PACKET - набор методов для работы с уведомлением.
Объект блокировок 16 /SBIS/[<ff>][<XXXXXXXX>]
+
##/SBIS/CL_VIEW_SAP_PACKET - набор методов для работы с исходящим пакетом документов.
Группа функций 26 /SBIS/GF_[<ff>][_<XXXXXXXX>]
+
#Интерфейсы
Функциональные Модули 30 /SBIS/FM_ [<ff>][_<XXXXXXXX>]
+
##/SBIS/IF_TREE_API2_PACKET - интерфейс для работы со списком пакетов.
/SBIS/RFC_ [<ff>][_<XXXXXXXX>]
+
##/SBIS/IF_VIEW_PACKET - интерфейс для работы с пакетом документов
Программы, include 40 /SBIS/[<ff>][_<XXXXXXXX>]
+
#Программы
Пулы модулей 40 /SBIS/[<ff>][_<XXXXXXXX>]
+
##/SBIS/SAPPER - программа для электронного обмена документами с системой СБИС.
Классы 30 /SBIS/CL_[<ff>][_<XXXXXXXX>]
+
#Группы функций
Интерфейсы 30 /SBIS/IF_[<ff>][_<XXXXXXXX>]
+
##/SBIS/GF_FILTER - набор экранов и функций для работы фильтра по документам.
Транзакции 20 /SBIS/[<ff>][<XXXXXXXX>]
+
##/SBIS/GF_WINDOW - набор экранов и функций для вывода сообщений.
Smartforms/SAPScript 30 /SBIS/[<ff>][_<XXXXXXXX>]
+
#Транзакции
Классы сообщений 20 /SBIS/[<ff>][<XXXXXXXX>]
+
##/SBIS/SAPPER - транзакция для электронного обмена документами с системой СБИС.
Классы разработок 30 /SBIS/[<ff>][_<XXXXXXXX>]
 
Реализация BAdi (новый/старый) 30/20 /SBIS/[<имя определения BAdi>]
 
Проекты SAP-расширений 8 /SBIS/[<XXXXXXXX>]
 
SET/GET-параметры 20 /SBIS/[<ff>][<XXXXXXXX>]
 
Append – структуры в стандартных таблицах 30 /SBIS/A_[<ff>][_<XXXXXXXX>]
 
Поля в append-структурах стандартных таблиц 15 Z[<XXXXXXXX>]
 
Меню областей 30 /SBIS/[<ff>][_<XXXXXXXX>]
 
Объект полномочий 30 /SBIS/[<ff>][_<XXXXXXXX>]
 
  
Для именования остальных объектов репозитария используется  маска формирования имени:
 
<ZZ>SBIS_[<ff>]_[<XXXXXXXX>] , где:
 
• <ZZ> - буква Z (или две буквы Z, например, для полей в append - структурах стандартных таблиц) в соответствии с соглашением о пространстве имен для клиента;
 
• <ff> - дополнительный квалификатор функциональности, опускается, в случае если объект принадлежит пакету ZCOMMON;
 
• <XXXXXXXX> - произвольный набор символов, возможно, но не обязательно, как-то отражающий физический или производственный смысл объекта на английском языке. Возможно использование цифр для отражения следующей логики: 1 - создание, 2 - редактирование, 3 – удаление;
 
Объекты, не попадающие под требование, должны именоваться исходя из здравого смысла.
 
  
===Именование переменных кода===
+
=== Пакет /SBIS/EJOURNAL ===
Настоящий раздел описывает систему именования объектов и переменных программ продукта на стороне SAP.
 
Таблица 4 Именование объектов и переменных программ
 
Объект Префикс
 
Class cl_
 
Parameter p_
 
Pushbutton pb_
 
Radio Button rb_
 
Select Option so_
 
Table type tt_
 
Type ty_
 
Global Constant gc_
 
Global Field Symbol gfs_
 
Global Structure gs_
 
Global Variable gv_
 
Global Internal Table gt_
 
Global Range gt_rng_
 
Global Reference gr_
 
Local Constant lc_
 
Local Field Symbol lfs_
 
Local Structure ls_
 
Local Variable lv_
 
Local Internal Table lt_
 
Local Range lt_rng_
 
Local Reference lr_
 
Parameter IMPORTING – Variable iv_
 
Parameter IMPORTING –Structure is_
 
Parameter IMPORTING – Internal Table it_
 
Parameter CHANGING – Variable cv_
 
Parameter CHANGING – Structure cs_
 
Parameter CHANGING - Internal Table ct_
 
Parameter EXPORTING – Variable ev_
 
Parameter EXPORTING – Structure es_
 
Parameter EXPORTING - Internal Table et_
 
  
==Языковая поддержка==
+
Предназначен для работы с журналами электронных документов из российского Add-On.
Текущая версия системы должна поддерживать (работать без дополнительной настройки) следующие языки:
+
#Таблицы
• Русский.
+
##/SBIS/STATUS_EJ - таблица статусов документов .
=Пользовательский интерфейс и кастомизация=
+
#Классы
==Интерфейсы==
+
##/SBIS/CL_J3RF_DIGINV_BADI_2 - реализация BADI для ЭЖ.
===ГФ /SBIS/RFC – Набор RFC функций===
+
##/SBIS/CL_J3RF_DIGINV_PROCESSOR - дополнительные методы для класса CL_J3RF_DIGINV_PROCESSOR.
====Общее назначение====
+
#Программы
 +
##/SBIS/FILL_ID_DEBI - Заполнение УИД клиента в настройках ЭЖ.
 +
##/SBIS/FILL_ID_KRED - Заполнение УИД кредитора в настройках ЭЖ.
 +
#XSLT преобразования
 +
##/SBIS/J_3RF_DI_DOCTYPE_01 - получение типа документа.
 +
##/SBIS/J_3RF_ROSEU_UOU - обработка уведомления об уточнении.
  
Настоящая группа функций обеспечивает работу с SAP из интерфейса личного кабинета СБИС. Соединение осуществляется через SBIS Plugin установленный на рабочем месте пользователя..
+
=== Пакет /SBIS/ARCHIVE_EJOURNAL ===
====ФМ /SBIS/RFC_GET_LIST_DOC – Получение списка документов.====
 
Функциональный модуль предназначен для получения списка пакетов документов для отправки.
 
В таблице ниже представлен локальный интерфейс модуля.
 
Параметр Описание
 
IMPORTING
 
IV_FOLDER Код раздела настроек содержащих параметры необходимые для получения списка документов.
 
IS_FILTER Структура содержащая параметры для ограничения выборки списка документов (период, контрагент, балансовая единица и т.п.)
 
TABLES
 
ET_LIST_DOC Список пакетов документов
 
EXCEPTIONS
 
 
 
====ФМ /SBIS/RFC_GET_DOC – Данные отправки====
 
Функциональный модуль предназначен для получения данных необходимых для формирования пакета документов (описание пакета и его вложений).
 
  
Получает из таблицы настроек набор SQL запросов необходимых для построения списка пакетов документов.
+
Предназначен для работы с журналами электронных документов из российского Add-On.
В таблице ниже представлен локальный интерфейс модуля.
+
#Классы
Параметр Описание
+
##/SBIS/CL_ARCHIVE_EJOURNAL - сохранение данных в ЭЖ.
IMPORTING
 
IV_FOLDER Код раздела настроек содержащих параметры необходимые для получения данных документа.
 
IS_DOC_ID Уникальный идентификатор документа
 
EXPORTING
 
ES_DOC Данные заголовка пакета документов
 
ET_ATTACHMENT Данные для формирования электронных документов (вложений в пакет).
 
====ФМ /SBIS/RFC_GET_LIST_PARAM – Получения списка настроек====
 
Функциональный модуль предназначен для получения списка параметров, необходимых другим ФМ для работы. Личный кабинет СБИС предоставляет удобный интерфейс для администрирования параметров.
 
В таблице ниже представлен локальный интерфейс модуля.
 
Параметр Описание
 
IMPORTING
 
IV_FOLDER Параметр для ограничения списка возвращаемых настроек.
 
IV_SUBFOLDER Параметр для ограничения списка возвращаемых настроек.
 
TABLE
 
ET_MAPPING Таблица с настройками
 
  
====ФМ /SBIS/RFC_GET_PARAM – Получения списка настроек====
+
=== Пакет ZSBIS ===
Функциональный модуль предназначен для получения конкретного параметра из настроечных таблиц.
 
В таблице ниже представлен локальный интерфейс модуля.
 
Параметр Описание
 
IMPORTING
 
IV_FOLDER Параметр для ограничения списка возвращаемых настроек.
 
IV_SUBFOLDER Параметр для ограничения списка возвращаемых настроек.
 
IV_PARAM_NAME Имя параметра для отбора.
 
EXPORTING
 
ES_VALUE Структура со значением параметра
 
  
====ФМ /SBIS/RFC_DEL_LIST_PARAM – Удаляем список настроек====
+
Вспомогательный пакет.
Функциональный модуль предназначен для удаления настроек, используется при администрировании настроек.
+
#Транзакции
В таблице ниже представлен локальный интерфейс модуля.
+
##ZSBIS - транзакция для быстрого доступа в СБИС Сапер.
Параметр Описание
 
IMPORTING
 
IV_FOLDER Параметр для ограничения списка удаляемых параметров.
 
IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров.
 
  
====ФМ /SBIS/RFC_DEL_PARAM – Удаляем параметр====
+
==SBIS Plugin==
Функциональный модуль предназначен для удаления конкретного параметра, используется при администрировании настроек.
+
Объект для обеспечения функционала личного кабинет СБИС (предназначен для генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7, вывода информационных уведомлений о поступивших документах / заданиях, операций по ручной загрузке и выгрузке документов). Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством SAP NET Connector 3, входит в состав компонентов ядра продукта.
В таблице ниже представлен локальный интерфейс модуля.
 
Параметр Описание
 
IMPORTING
 
IV_FOLDER Параметр для ограничения списка удаляемых параметров.
 
IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров.
 
IV_PARAM_NAME Имя удаляемого параметра.
 
  
====ФМ /SBIS/RFC_ADD_LIST_PARAM – Удаляем список настроек====
+
Для работы требуется операционная система Windows XP SP3 и выше, а также NET Framework 2.0 или 4.0. Не поддерживается работа с NET Framework 4.0 Client profile.
Функциональный модуль предназначен для добавления настроек, используется при администрировании настроек.
 
В таблице ниже представлен локальный интерфейс модуля.
 
Параметр Описание
 
IMPORTING
 
IV_FOLDER Параметр для ограничения списка удаляемых параметров.
 
IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров.
 
  
====ФМ /SBIS/RFC_ADD_PARAM – Удаляем параметр====
+
==SBIS SDK==
Функциональный модуль предназначен для добавления конкретного параметра, используется при администрировании настроек.
+
Объект предназначен для обмена данными с [https://help.sbis.ru/help/integration/api/ API СБИС], а также генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7 . Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством технологии OLE2. [https://help.sbis.ru/help/integration/sdk/ Подробнее о СБИС SDK].
В таблице ниже представлен локальный интерфейс модуля.
 
Параметр Описание
 
IMPORTING
 
IV_FOLDER Параметр для ограничения списка удаляемых параметров.
 
IV_SUBFOLDER Параметр для ограничения списка удаляемых параметров.
 
IV_PARAM_NAME Имя удаляемого параметра.
 
  
 +
==SBIS Connect==
 +
Windows приложение для интеграции СБИС с информационными системами пользователей через каталог. [https://help.sbis.ru/help/integration/catalog/ Подробнее о СБИС Коннект]
  
+
[[Категория:SAP]]
=Алгоритм выгрузки документов из SAP в СБИС для последующей отправки=
+
[[Категория:SAPPER]]
 
=Алгоритм загрузки документов в SAP из СБИС=
 

Текущая версия на 14:30, 24 января 2017

Общие сведения

Список пакетов документов
Список полученных пакетов документов
Окно просмотра пакета

СБИС САПЁР - это модуль интеграции SAP с системой обмена юридически значимыми электронными документами СБИС.

Используя СБИС САПЁР, можно:

  • отправлять из SAP любые пакеты любых электронных документов в формате XML.
  • отслеживать состояние ранее отправленных документов
  • просматривать и обрабатывать входящие электронные документы
  • создавать документы SAP на основании входящих электронных документов

Отправка документов

СБИС САПЁР может формировать и отправлять электронные документы несколькими способами:

Отправка через интерфейс SAP

В составе СБИС САПЁР есть ABAP программа \SBIS\SAPPER, с помощью которой пользователь в интерфейсе SAP может работать с электронными документами.

Сценарий работы пользователя (в оптимальном варианте после запуска два клика мышкой):

  1. вызываем программу
  2. выбираем тип пакета документов
  3. отмечаем пакеты документов которые хотим отправить
  4. нажимаем кнопку отправить

Возможные настройки:

  1. варианты пакетов документов и их состав
  2. внешний вид (визуализация) документов
  3. способ получения данных: программа печати / XML из ЭДО от SAP СНГ / BAPI
  4. способ отправки: SDK, СБИС Коннект, API, архитектура решения допускает отправку через любого оператора

Как это работает:

Все разделы меню Сапера, настраиваются без изменения ABAP кода. Пункты меню раздела Продажа, описывают варианты пакетов отправляемых документов. Каждый пункт этого раздела описывает состав конкретного типа пакетов документов.

При выборе пользователем какого-то пункта меню раздела Продажа Сапер получает из настроек модуля текст запроса для построения списка документов и выполняет его. Текст запроса написан таким образом, чтобы собрать соответствующие пакеты документов. В результате запроса, пользователь увидит на экране список документов сгруппированных в пакеты (например, ТОРГ-12 и фактура).

При открытии пользователем карточки пакета документов (двойной клик в списке) или при нажатии кнопки отправить - Сапер для каждого документа пакета вызывает программу печати, которая обычно используется для его печати, в режиме формирования электронного документа. Далее, на основании рассчитанных программами печати данных и при помощи таблиц маппинга он формирует XML файлы требуемых форматов. Полностью сформировав пакет документов он подключается к COM объекту СБИС и при помощи него подписывает и отправляет документы (возможно несколько вариантов, с подписанием и без).

Данный способ работает на любом SAP, с любыми типами документов и отчетов (не имеет никаких зависимостей от функционала, реализованного SAP для журнала электронных счетов фактур из российского Add-on)

Отправка через интерфейс СБИС

Если Вы пользуетесь согласованиями в СБИС (например для входящих документов), то Вам будет удобнее загружать документы в SAP из интерфейса СБИС. Тоже самое касается и отправки документов. Для этого находясь в СБИС достаточно нажать на кнопку выгрузить в SAP (или загрузить из SAP), после чего все будет ровно так же как если бы Вы отправляли документы из SAP).

Как это работает:

Браузер по WebSocket подключается к СБИС Плагин установленный на компьютере пользователя. СБИС Плагин конвертирует запрос в форматы соответствующих методов RFC и вызывает их.

Отправка через интерфейс стандартного модуля ЭДО

В составе СБИС САПЁР есть пакет EJOURNAL который реализует работу ( в т.ч. BADI) со стандартными журналами электронных документов SAP.

Дополнительно к этому он предоставляет программу, которая позволяет в три клика отправлять пакеты документов сформированные из записей стандартных журналов. Сделано специально для приверженцев стандартного функционала.

Функционал данного способа ограничен возможностями стандартного модуля и всеми его недостатками.

FAQ

Вопрос: У нас сотрудник не должен видеть все документы определенного типа, возможен ли показ документов только его зоны ответственности?

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

Загрузка документов

Загрузка через интерфейс SAP

В интерфейсе СБИС САПЁР есть разделы Полученные, в этом разделе показываются все документы которые пользователь видит в личном кабинете в разделе Входящие. На основании входящего электронного документа можно создать SAP документ. Как правило на основании накладной создается Заказ на закупку в ММ, а на основании акта выполненных работ или счет-фактуры создается Входящий счет в ММ.

Сценарий работы пользователя:

  1. вызываем программу
  2. пользователь видим список доступных ему входящих документов (ограничения настраиваются в личном кабинете СБИС)
  3. любой документ пользователь может посмотреть, выполнить над ним доступное действие (по умолчанию это принять / отклонить)
  4. В карточке документа на документе нажимает правую кнопку мыши и видит список вариантов загрузки.
  5. Выбирает интересующий вариант. Видит окно параметров загрузки, ввод информации отсутствующей в XML, например завод, и таблицу сопоставления кодов номенклатуры.
  6. Нажимает кнопку загрузить - видит заполненную карточку документа SAP

Варианты настройки:

  1. для каждого типа электронного документа можно настроить несколько вариантов его загрузки в SAP, например ТОРГ-12 можно загрузить как заявку и как накладную.
  2. два способа загрузки BAPI и пакетный ввод (для измененных форм)

Как это работает: При выборе способа загрузки, Сапер согласно настройкам сериализует XML в структуру SAP и заполняет окно ввода дополнительных параметров. Для каждого товара / услуги ищет по таблице соответствия кодов номенклатуры соответствующий материал SAP.

После нажатия кнопки загрузить в окне ввода дополнительных параметров загрузки, Сапер сохраняет введенные данные по соответствию кодов номенклатуры. Далее в соответствии с таблицей настроек формирует структуры для BAPI указанной в настройках и вызывает её. В случае пакетного ввода - формирует последовательность и исполняет её. По окончании открывает карточку созданного документа.

Архитектура системы

Схема логической и программной архитектуры

В настоящем разделе приведена схема взаимодействия основных компонентов. На схеме отражены ключевые программные компоненты и логические подсистемы решения.

Модуль состоит из нескольких ABAP пакетов и поставляется в виде нескольких транспортных запросов.


SBIS SAPPER

Программный компонент, предназначен для интеграции учётной системы SAP ERP с СБИС. Имеет модульную архитектуру, позволяющую легко встраиваться в имеющиеся бизнес-процессы. Поставляется в ввиде нескольких транспортных запросов. Каждый транспортный запрос содержит одноименный ABAP пакет:

Список ABAP пакетов в порядке их импорта:


Пакет /SBIS/CORE

Содержит общие объекты, используемые другими специализированными пакетами.

  1. Таблицы
    1. /SBIS/MATERIALS - таблица сопоставления номенклатуры с номенклатурой клиентов.
    2. /SBIS/SETTINGS - настройки Сапера.
    3. /SBIS/STATUS - справочник статусов документов.
    4. /SBIS/STATUS_DOC - статусы документов.
    5. /SBIS/U_SETTINGS - настройки Сапера для пользователя.
    6. /SBIS/XSLT - справочник и двоичные данные XSLT.
  2. Классы
    1. /SBIS/CL_ASYNC_PROCESSING - содержит методы для многопоточной обработки.
    2. /SBIS/CL_CORE - содержит вспомогательные служебные методы и методы-оболочки обработки данных.
    3. /SBIS/CL_CREATE_SAP_DOCUMENTS - содержит методы создания SAP-документов и сопоставления номенклатуры.
    4. /SBIS/CL_EXCHANGE_FILE - содержит методы обмена документами через каталог.
    5. /SBIS/CL_EXCHANGE_SDK - содержит методы обмена документами через СБИС SDK.
    6. /SBIS/CL_MAPPING - маппинг полей при движении документов между системами SAP и СБИС.
    7. /SBIS/CL_SAP_DATA - содержит методы получения данных из системы SAP.
    8. /SBIS/CX_CORE - класс обработки исключений.
  3. Интерфейсы
    1. /SBIS/IF_EXCHANGE - интерфейс для технической реализации обмена документами с системой СБИС.
    2. /SBIS/IF_SAP_DATA - интерфейс для получения данных из системы SAP.
  4. Программы
    1. /SBIS/MIGO_DIALOG - программа-оболочка для транзакции MIGO.
    2. /SBIS/TEST_GET_ATTACHMENT - тестовая программа получения вложения СБИС.
    3. /SBIS/TEST_GET_LIST_PACKET - тестовая программа получения списка пакетов документов СБИС.
    4. /SBIS/TEST_GET_PACKET - тестовая программа получения пакета СБИС.
    5. /SBIS/TEST_SDK - программа для тестирования работы СБИС SDK.
    6. /SBIS/TEST_SEND_PACKET - тестовая программа отправки пакета СБИС.
    7. /SBIS/UPDATE_SETTINGS - программа загрузки настроек Сапера.
    8. /SBIS/UPDATE_STATUS - программа загрузки справочника статусов документов.
    9. /SBIS/UPDATE_XSLT - программа загрузки XSLT в справочник XSLT.
  5. Группы функций
    1. /SBIS/GF_ASYNC_PROCESSING - содержит функциональные модули (ФМ) для многопоточной обработки.
    2. /SBIS/GF_AUTH - содержит ФМ и экраны для авторизации через СБИС SDK.
    3. /SBIS/GF_CREATE_SAP_DOC - содержит ФМ создания SAP-документов и сопоставления номенклатуры.
    4. /SBIS/GF_PRINT_PROG - содержит ФМ для запуска программ печати.
    5. /SBIS/GF_RFC - содержит RFC для работы через браузер. Работа с настройками Сапера и документами.
    6. /SBIS/GF_SBIS_SHLP2 - средства поиска
    7. /SBIS/TAB_STATUS - автоматически сгенерированный ФМ для ведения данных таблицы /SBIS/STATUS.
  6. Транзакции
    1. /SBIS/MIGO_DIALOG - оболочка для транзакции MIGO.
  7. XSLT преобразования
    1. /SBIS/DOC301 - преобразование документа в XML формата 3.01.
    2. /SBIS/DOC301_2 - преобразование документа в XML формата 3.01.
    3. /SBIS/DOC301_XML_TO_ABAP - получение данных из XML формата 3.01.
    4. /SBIS/KONVERT_NATIVE - получение XML пакета СБИС.

Пакет /SBIS/CORE_700

Содержит объекты, специфичные для версии базиса 7.00.

  1. Классы
    1. /SBIS/CL_SAP_DATA_700 - содержит методы получения данных из системы SAP.
    2. /SBIS/CL_SAP_DATA_700_LIKP - содержит методы получения данных из системы SAP.
    3. /SBIS/CL_SAP_DATA_700_VBRK - содержит методы получения данных из системы SAP.

Пакет /SBIS/CORE_740

Содержит объекты, специфичные для версии базиса выше 7.40 SP05 (SAPKB74005).

  1. Классы
    1. /SBIS/CL_SAP_DATA_740 - содержит методы получения данных из системы SAP.
    2. /SBIS/CL_SAP_EJOURNAL2 - содержит методы получения данных из системы SAP.

Пакет /SBIS/GUI

Набор общих экранов и функционала, предназначенных для взаимодействия с пользователем.

  1. Классы
    1. /SBIS/CL_TREE - набор методов для построения и работы со списком пакетов документов.
    2. /SBIS/CL_TREE_ACCORDION - набор методов для построения рабочего меню.
    3. /SBIS/CL_TREE_API2_PACKET - построение и работа со списком исходящих пакетов документов.
    4. /SBIS/CL_TREE_INBOX - построение и работа со списком полученных пакетов документов.
    5. /SBIS/CL_TREE_OUTBOX - построение и работа со списком отправленных пакетов документов.
    6. /SBIS/CL_TREE_RESPONSE - построение и работа со списком уведомлений.
    7. /SBIS/CL_VIEW_INBOX_PACKET - набор методов для работы с полученным пакетом документов.
    8. /SBIS/CL_VIEW_OUTBOX_PACKET - набор методов для работы с отправленным пакетом документов.
    9. /SBIS/CL_VIEW_RESPONSE_PACKET - набор методов для работы с уведомлением.
    10. /SBIS/CL_VIEW_SAP_PACKET - набор методов для работы с исходящим пакетом документов.
  2. Интерфейсы
    1. /SBIS/IF_TREE_API2_PACKET - интерфейс для работы со списком пакетов.
    2. /SBIS/IF_VIEW_PACKET - интерфейс для работы с пакетом документов
  3. Программы
    1. /SBIS/SAPPER - программа для электронного обмена документами с системой СБИС.
  4. Группы функций
    1. /SBIS/GF_FILTER - набор экранов и функций для работы фильтра по документам.
    2. /SBIS/GF_WINDOW - набор экранов и функций для вывода сообщений.
  5. Транзакции
    1. /SBIS/SAPPER - транзакция для электронного обмена документами с системой СБИС.


Пакет /SBIS/EJOURNAL

Предназначен для работы с журналами электронных документов из российского Add-On.

  1. Таблицы
    1. /SBIS/STATUS_EJ - таблица статусов документов .
  2. Классы
    1. /SBIS/CL_J3RF_DIGINV_BADI_2 - реализация BADI для ЭЖ.
    2. /SBIS/CL_J3RF_DIGINV_PROCESSOR - дополнительные методы для класса CL_J3RF_DIGINV_PROCESSOR.
  3. Программы
    1. /SBIS/FILL_ID_DEBI - Заполнение УИД клиента в настройках ЭЖ.
    2. /SBIS/FILL_ID_KRED - Заполнение УИД кредитора в настройках ЭЖ.
  4. XSLT преобразования
    1. /SBIS/J_3RF_DI_DOCTYPE_01 - получение типа документа.
    2. /SBIS/J_3RF_ROSEU_UOU - обработка уведомления об уточнении.

Пакет /SBIS/ARCHIVE_EJOURNAL

Предназначен для работы с журналами электронных документов из российского Add-On.

  1. Классы
    1. /SBIS/CL_ARCHIVE_EJOURNAL - сохранение данных в ЭЖ.

Пакет ZSBIS

Вспомогательный пакет.

  1. Транзакции
    1. ZSBIS - транзакция для быстрого доступа в СБИС Сапер.

SBIS Plugin

Объект для обеспечения функционала личного кабинет СБИС (предназначен для генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7, вывода информационных уведомлений о поступивших документах / заданиях, операций по ручной загрузке и выгрузке документов). Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством SAP NET Connector 3, входит в состав компонентов ядра продукта.

Для работы требуется операционная система Windows XP SP3 и выше, а также NET Framework 2.0 или 4.0. Не поддерживается работа с NET Framework 4.0 Client profile.

SBIS SDK

Объект предназначен для обмена данными с API СБИС, а также генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7 . Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством технологии OLE2. Подробнее о СБИС SDK.

SBIS Connect

Windows приложение для интеграции СБИС с информационными системами пользователей через каталог. Подробнее о СБИС Коннект