СБИС Сапёр
Общие сведения
СБИС САПЁР - это модуль интеграции SAP с системой обмена юридически значимыми электронными документами СБИС.
Используя СБИС САПЁР, можно:
- отправлять из SAP любые пакеты любых электронных документов в формате XML.
- отслеживать состояние ранее отправленных документов
- просматривать и обрабатывать входящие электронные документы
- создавать документы SAP на основании данных XML документов.
Отправка документов
СБИС САПЁР может формировать и отправлять электронные документы несколькими способами:
Отправка через интерфейс SAP
В составе СБИС САПЁР есть ABAP программа \SBIS\SAPPER, с помощью которой пользователь в интерфейсе SAP может работать с электронными документами.
Сценарий работы пользователя (в оптимальном варианте после запуска два клика мышкой):
- вызываем программу
- выбираем тип пакета документов
- отмечаем пакеты документов которые хотим отправить
- нажимаем кнопку отправить
Возможные настройки:
- варианты пакетов документов и их состав
- внешний вид (визуализация) документов
- способ получения данных: программа печати / XML из ЭДО от SAP СНГ / BAPI
- способ отправки: SDK, СБИС Коннект, API, архитектура решения допускает отправку через любого оператора
Как это работает:
Когда пользователь запускает программу отправки (/SBIS/SAPPER), модуль в зависимости от типа пакета смотрит в таблице настроек текст запроса для построения списка документов и выполняет его. Результат пользователь видит на экране.
После того как пользователь отметил пакеты документов которые он хочет отправить, /SBIS/SAPPER смотрит в таблице настроек, какая программа печати используется для печати данного документа и вызывает её. Вместо вывода на принтер, программа печати все рассчитанные значения сохраняет в xml файл универсального формата. Когда /SBIS/SAPPER получила xml файлы всех документов пакета, передает их на отправку.
Отправка, в зависимости от настроек может осуществляться при помощи SBIS SDK (через COM объект) или СБИС Коннект (через каталог).
В обоих случаях файлы при помощи XSLT конвертируются в актуальные форматы ФНС, после чего подписываются и отправляются.
Для подписания может применяться как серверная так и локальная электронная подпись.
Использование универсального формата xml позволяет делать электронные документы любых типов из любых документов SAP, а также не делать в SAP никаких изменений при смене формата ФНС (а за два года их было уже 4 ).
Использование программы печати позволяет получить электронный документ с учетом всех особенности клиента, подобный способ используется и в стандартном модуле ЭДО от SAP CIS, за той лишь разницей, что конвертация в xml является не жесткой, а настраиваемой через таблицу настроек.
В простейшем случае доработка сводится к добавлению к в программу печати (или её копию) вызова метода СБИС Сапёр который завершает программу печати после формирования электронного документа.
Пример вызова СБИС Сапёр для формирования электронного документа. Данный код необходимо добавить непосредственно перед вызовом формуляра.
DATA lv_not_print TYPE c VALUE 'X'.
DATA cl_mapping TYPE REF TO /sbis/cl_mapping.
CREATE OBJECT cl_mapping.
CALL METHOD cl_mapping->calc_doc
IMPORTING
ev_not_print = lv_not_print.
IF lv_not_print = 'X'.
EXIT.
ENDIF.
С интеграционным модулем поставляются примеры стандартных программ печати в которые добавлен вызов СБИС Сапёр.
В ряде случаев этого может быть не достаточно.
Генерация электронного документа использует в качестве данных значения рассчитанные программой печати. Иногда название контрагента, его ИНН и КПП или банковские реквизиты выводятся в печатной форме одной строкой и как правило в программе печати они хранятся в одной переменной, а для формирования электронного документа они нужны по раздельности. Поэтому для каждой программы печати проводится анализ, каких данных в ней не хватает, после чего в текст программы вносятся соответствующие изменения.
Отправка через интерфейс СБИС
Если Вам больше нравится работать из интерфейса СБИС (это нормально). Вы можете находясь в СБИС нажать на кнопку загрузить из SAP, после чего все будет ровно так же как если бы Вы отправляли документы из SAP, только это будет чуть более красиво и возможно чуть-чуть быстрее.
Как это работает:
На компьютер пользователя устанавливается SBIS Plugin имеющий в своем составе стандартный SAP NET Connector 3, который через RFC обменивается данными с SAP.
В ряде случаев возможен обмен данными с SAP без установки каких либо модулей, однако это вариант будет более медленным.
Отправка через интерфейс стандартного модуля ЭДО (не рекомендуется)
В составе СБИС САПЁР есть пакет EJOURNAL который реализует работу ( в т.ч. BADI) со стандартными журналами электронных документов SAP.
Дополнительно к этому он предоставляет программу, которая позволяет в три клика отправлять пакеты документов сформированные из записей стандартных журналов. Сделано специально для приверженцев стандартного функционала.
Функционал данного способа ограничен возможностями стандартного модуля и всеми его недостатками.
Как это работает: В СБИС САПЁР реализованы все BADI стандартного модуля электронных документов SAP CIS и немного больше.
FAQ
Вопрос: У нас сотрудник не должен видеть все документы определенного типа, возможен ли показ документов только его зоны ответственности?
Ответ: Да возможно, список документов перед отправкой строится при помощи простого запроса указанного в таблице настроек, его можно изменить с учетом Вашей специфики.
Загрузка документов
Загрузка через интерфейс SAP
В интерфейсе СБИС САПЁР есть разделы Полученные, в этом разделе показываются все документы которые пользователь видит в личном кабинете в разделе Входящие. На основании входящего электронного документа можно создать SAP документ. Как правило на основании накладной создается Заказ на закупку в ММ, а на основании акта выполненных работ или счет-фактуры создается Входящий счет в ММ.
Сценарий работы пользователя:
- вызываем программу
- пользователь видим список доступных ему входящих документов (ограничения настраиваются в личном кабинете СБИС)
- любой документ пользователь может посмотреть, выполнить над ним доступное действие (по умолчанию это принять / отклонить)
- загрузить в SAP (возможно для этого потребуется сопоставить номенклатуру)
Как это работает:
При переходе в реестр Полученные, пользователь через SDK авторизуется в личном кабинете СБИС, и происходит запрос списка входящих документов. Далее для каждого входящего документа проверяется загружался ли он в SAP и сравниваются суммы документов, и эта информация добавляется в список. Результат пользователь видит на экране.
При нажатии кнопки загрузить в SAP, пользователя при наличии нескольких вариантов загрузки XML файла спросят куда именно он хочет загрузить документ, после чего XML файл конвертируется в XML универсального формата, который при помощи таблицы настроек сериализуется в структуру SAP которая передается соответствующему BAPI. В момент загрузки по желанию заказчика в таблицы SAP может быть передана информация о подписантах, оригиналы XML документов, PDF представление документа со штампом ЭДО.
Архитектура системы
В настоящем разделе приведена схема взаимодействия основных компонентов. На схеме отражены ключевые программные компоненты и логические подсистемы решения.
Модуль состоит из нескольких ABAP пакетов и поставляется в виде нескольких транспортных запросов.
SBIS SAPPER
Программный компонент, предназначен для интеграции учётной системы SAP ERP с СБИС. ИМ построен на нескольких интерфейсах позволяющих легко встраивать модуль в имеющиеся бизнес-процессы:
- SBIS GUI - набор экранов выполненных в интерфейсе SAP для взаимодействия с пользователем.
- Data interface - набор классов реализующих интерфейс получения списка, выгрузки и загрузки документов из разных источников данных, таковыми могут быть программы печати, BAPI, журналы.
- Exchange interface - набор классов реализующих интерфейс обмена данными с СБИС, по умолчанию это СБИС SDK, в ряде случаем может быть использован обмен через каталог.
- User settings - основа модуля это таблица настроек отвечающая за параметры обмена и маппинг полей. За счет неё решение получает свою гибкость.
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 приложение для интеграции СБИС с информационными системами пользователей через каталог. Подробнее о СБИС Коннект