SBIS SAPPER overview — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
(Разговоров Михаил переименовал страницу SBIS SAPPER в СБИС Сапёр)
 
Строка 1: Строка 1:
#перенаправление [[СБИС Сапёр]]
+
=Overview=
 +
SBIS SAPPER - is SAP integration module exchange system of legally relevant electronic documents of SBIS.
 +
 
 +
Используя SBIS SAPPER, можно:
 +
* отправлять из SAP любые пакеты любых электронных документов в формате xml несколькими способами
 +
* принимать в SAP любые xml документы (создавать документ SAP по данным из XML) несколькими способами
 +
* организовать локальный архив электронных документов в SAP либо на отдельном локальном сервисе
 +
* использовать возможности SBIS в SAP:
 +
** внутренний документооборот - согласование документов перед загрузкой / отправкой
 +
** сопоставление номенклатуры поставщика
 +
** ЕГАИС - работа в соответствии с алкогольным законодательством
 +
 
 +
=Отправка документов=
 +
SBIS SAPPER может формировать и отправлять электронные документы несколькими способами:
 +
==Отправка через интерфейс SAP==
 +
В составе SBIS SAPPER есть специальная программа (/SBIS/SEND), с помощью которой пользователь в интерфейсе SAP может отправлять любые электронные документы.
 +
Сценарий работы пользователя (в оптимальном варианте после запуска два клика мышкой):
 +
# вызываем программу
 +
# выбираем тип пакета документов (этот пункт возможно исключить)
 +
# отмечаем галочками пакеты документов которые хотим отправить
 +
# нажимаем кнопку отправить
 +
 
 +
===Как это работает:===
 +
SBIS SAPPER проектировался так, чтобы пользователь делал в нем (программном коде) минимум изменений. Вся адаптация под клиента делается путем редактирования таблицы настроек.
 +
 
 +
Когда пользователь запускает программу отправки (/SBIS/SEND), модуль в зависимости от типа пакета смотрит в таблице настроек текст запроса для построения списка документов и выполняет его. Результат пользователь видит на экране.
 +
 
 +
После того как пользователь отметил пакеты документов которые он хочет отправить, /SBIS/SEND смотрит в таблице настроек, какая программа печати используется для печати данного документа и вызывает её, только вместо вывода на принтер, она все рассчитанные программой печати значения сохраняет в xml файл универсального формата. Когда /SBIS/SEND получила xml файлы всех документов пакета, она конвертирует на стороне оператора универсальные xml файлы в актуальные форматы ФНС, подписывает и отправляет их.
 +
 
 +
Использование универсального формата xml позволяет делать электронные документы любых типов из любых документов SAP, а также не делать в SAP никаких изменений при смене формата ФНС ( за два года их было уже 4 ).
 +
 
 +
Использование программы печати позволяет получить электронный документ с учетом всех особенности клиента, подобный способ используется и в  стандартном модуле ЭДО от SAP CIS, за той лишь разницей, что конвертация в xml является не жесткой, а настраиваемой через таблицу настроек.
 +
 
 +
В простейшем случае доработка сводится к добавлению к в программу печати (или её копию) вызова метода SBIS SAPPER который завершает программу печати после формирования электронного документа.
 +
 
 +
Пример вызова SBIS SAPPER для формирования электронного документа. Данный код необходимо добавить непосредственно перед вызовом формуляра.
 +
 
 +
<source lang=ABAP>
 +
  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.
 +
</source>
 +
 
 +
С интеграционным модулем поставляются примеры стандартных программ печати в которые добавлен вызов SBIS SAPPER.
 +
 
 +
В ряде случаев этого может быть не достаточно.
 +
 
 +
Генерация электронного документа использует в качестве данных значения рассчитанные программой печати. Иногда название контрагента, его ИНН и КПП выводятся в печатной форме одной строкой и как правило в программе печати они хранятся в одной переменной, а для формирования электронного документа они нужны по раздельности. Поэтому для каждой программы печати проводится анализ, каких данных в ней не хватает, после чего в текст программы вносятся соответствующие изменения.
 +
 
 +
Для подписания и отправки опционально может быть использован либо SBIS SDK (прямая отправка) или SBIS Коннект (обмен через каталог).
 +
 
 +
==Отправка через интерфейс SBIS==
 +
Если Вам больше нравится работать из интерфейса SBIS (это нормально). Вы можете находясь в SBIS нажать на кнопку загрузить из SAP, после чего все будет ровно так же как если бы Вы отправляли документы из SAP, только это будет чуть более красиво и возможно чуть-чуть быстрее.
 +
 
 +
===Как это работает:===
 +
Для удобной работы в кабинете SBIS на компьютере пользователя должен быть установлен SBIS Plugin, который отвечает за комфортную работу пользователя: выдачу всплывающих уведомлений, подписание документов, работу со сканерами и другими устройствами, а также взаимодействие с информационными системами прямо из интерфейса личного кабинета SBIS.
 +
 
 +
Так вот, когда пользователь нажимает кнопку "Загрузить из SAP", браузер через SBIS Plugin запрашивает в SAP список документов определенного типа.
 +
 
 +
SBIS Plugin имеет в своем составе стандартный SAP Net connector 3, с помощью которого, через RFC интерфейс он получает информацию таким же способом что и /SBIS/SEND.
 +
 
 +
Подобное решение не может быть использовано для доступа к SAP из интернет, доступ возможен только из браузера пользователя по его инициативе и ограничен правами в SAP.
 +
 
 +
==Отправка через интерфейс стандартного модуля ЭДО (не рекомендуется)==
 +
В составе SBIS SAPPER есть пакет EJOURNAL который реализует работу ( в т.ч. BADI) со стандартными журналами электронных документов SAP.
 +
 
 +
Дополнительно к этому он предоставляет программу, которая позволяет в три клика отправлять пакеты документов сформированные из записей стандартных журналов. Сделано специально для приверженцев стандартного функционала.
 +
 
 +
Функционал данного способа ограничен возможностями стандартного модуля и всеми его [[Интеграция с SAP |недостатками]].
 +
 
 +
Как это работает:
 +
В SBIS SAPPER реализованы все BADI стандартного модуля электронных документов SAP CIS и немного больше.
 +
 
 +
== FAQ ==
 +
'''Вопрос:''' У нас сотрудник не должен видеть все документы определенного типа, возможен ли показ документов только его зоны ответственности?
 +
 
 +
'''Ответ:''' Да возможно, список документов перед отправкой строится при помощи простого запроса указанного в таблице настроек, его можно изменить с учетом Вашей специфики.
 +
 
 +
 
 +
=Загрузка документов=
 +
==Загрузка через интерфейс SAP==
 +
В составе SBIS SAPPER есть специальная программа (/SBIS/INBOX), с помощью которой пользователь в интерфейсе SAP может просматривать, обрабатывать и загружать входящие документы.
 +
 
 +
Сценарий работы пользователя:
 +
# вызываем программу
 +
# программа автоматически генерирует извещение о получении документов доступных этому пользователю (при условии наличия ЭЦП без этого не возможен их просмотр)
 +
# пользователь видим список доступных ему входящих документов (ограничения настраиваются в личном кабинете SBIS)
 +
# любой документ пользователь может посмотреть, выполнить над ним доступное действие (по умолчанию это принять / отклонить)
 +
# загрузить в SAP (возможно для этого потребуется сопоставить номенклатуру)
 +
 
 +
===Как это работает:===
 +
Когда пользователь запускает программу отправки (/SBIS/INBOX), она через SDK авторизуется в личном кабинете SBIS, запрашивает список входящих документов (аналогичный можно видеть в разделе Входящие личного кабинета). Далее для каждого входящего документа проверяется загружался ли он в SAP и сравниваются суммы документов, и эта информация добавляется в список. Результат пользователь видит на экране.
 +
 
 +
При нажатии кнопки загрузить в SAP, пользователя при наличии нескольких вариантов загрузки XML файла спросят куда именно он хочет загрузить файл, после чего XML файл конвертируется в XML универсального формата, который при помощи таблицы настроек сериализуется в структуру SAP которая передается соответствующему BAPI. В момент загрузки по желанию заказчика в таблицы SAP может быть передана информация о подписантах, оригиналы XML документов, PDF представление документа со штампом ЭДО.
 +
 
 +
 
 +
=Архитектура системы=
 +
[[Файл:AddonSbisForSAPcheme1.png|400px|thumb|right|Схема логической и программной архитектуры]]
 +
В настоящем разделе приведена схема взаимодействия основных компонентов. На схеме отражены ключевые программные компоненты и логические подсистемы решения.
 +
 
 +
==SBIS SAPPER==
 +
Программный компонент, предназначен для интеграции учётной системы SAP ERP с SBIS. ИМ имеет несколько пользовательских интерфейсов:
 +
* SBIS GUI - набор экранов выполненных в интерфейсе SAP для взаимодействия с пользователем.
 +
* Data interface - набор классов реализующих интерфейс получения списка, выгрузки и загрузки документов из разных источников данных, таковыми могут быть программы печати, BAPI, журналы.
 +
* Exchange interface - набор классов реализующих интерфейс обмена данными с SBIS, по умолчанию это SBIS SDK, в ряде случаем может быть использован обмен через каталог.
 +
* User settings - основа модуля это таблица настроек отвечающая за параметры обмена, маппинг полей. За счет неё решение получает свою гибкость.
 +
 
 +
==SBIS Plugin==
 +
Объект для обеспечения функционала личного кабинет SBIS (предназначен для генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7, вывода информационных уведомлений о поступивших документах / заданиях, операций по ручной загрузке и выгрузке документов). Объект устанавливается на рабочих местах пользователей.  Интеграция с SAP системой выполнена посредством SAP NET Connector 3, входит в состав компонентов ядра продукта.
 +
 
 +
Для работы требуется операционная система Windows XP SP3 и выше, а также NET Framework 2.0 или 4.0. Не поддерживается работа с NET Framework 4.0 Client profile.
 +
 
 +
==SBIS SDK==
 +
Объект предназначен для обмена данными с [https://help.sbis.ru/help/integration/api/ API SBIS], а также генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7 . Объект устанавливается на рабочих местах пользователей.  Интеграция с SAP системой выполнена посредством технологии OLE2. [https://help.sbis.ru/help/integration/sdk/ Подробнее о SBIS SDK].
 +
 
 +
==SBIS Connect==
 +
Windows приложение для интеграции SBIS с информационными системами пользователей через каталог. [https://help.sbis.ru/help/integration/catalog/ Подробнее о SBIS Коннект]
 +
 
 +
[[Категория:SAP]]
 +
[[Категория:SAPPER]]

Версия 12:52, 25 февраля 2016

Overview

SBIS SAPPER - is SAP integration module exchange system of legally relevant electronic documents of SBIS.

Используя SBIS SAPPER, можно:

  • отправлять из SAP любые пакеты любых электронных документов в формате xml несколькими способами
  • принимать в SAP любые xml документы (создавать документ SAP по данным из XML) несколькими способами
  • организовать локальный архив электронных документов в SAP либо на отдельном локальном сервисе
  • использовать возможности SBIS в SAP:
    • внутренний документооборот - согласование документов перед загрузкой / отправкой
    • сопоставление номенклатуры поставщика
    • ЕГАИС - работа в соответствии с алкогольным законодательством

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

SBIS SAPPER может формировать и отправлять электронные документы несколькими способами:

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

В составе SBIS SAPPER есть специальная программа (/SBIS/SEND), с помощью которой пользователь в интерфейсе SAP может отправлять любые электронные документы. Сценарий работы пользователя (в оптимальном варианте после запуска два клика мышкой):

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

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

SBIS SAPPER проектировался так, чтобы пользователь делал в нем (программном коде) минимум изменений. Вся адаптация под клиента делается путем редактирования таблицы настроек.

Когда пользователь запускает программу отправки (/SBIS/SEND), модуль в зависимости от типа пакета смотрит в таблице настроек текст запроса для построения списка документов и выполняет его. Результат пользователь видит на экране.

После того как пользователь отметил пакеты документов которые он хочет отправить, /SBIS/SEND смотрит в таблице настроек, какая программа печати используется для печати данного документа и вызывает её, только вместо вывода на принтер, она все рассчитанные программой печати значения сохраняет в xml файл универсального формата. Когда /SBIS/SEND получила xml файлы всех документов пакета, она конвертирует на стороне оператора универсальные xml файлы в актуальные форматы ФНС, подписывает и отправляет их.

Использование универсального формата xml позволяет делать электронные документы любых типов из любых документов SAP, а также не делать в SAP никаких изменений при смене формата ФНС ( за два года их было уже 4 ).

Использование программы печати позволяет получить электронный документ с учетом всех особенности клиента, подобный способ используется и в стандартном модуле ЭДО от SAP CIS, за той лишь разницей, что конвертация в xml является не жесткой, а настраиваемой через таблицу настроек.

В простейшем случае доработка сводится к добавлению к в программу печати (или её копию) вызова метода SBIS SAPPER который завершает программу печати после формирования электронного документа.

Пример вызова SBIS SAPPER для формирования электронного документа. Данный код необходимо добавить непосредственно перед вызовом формуляра.

  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.

С интеграционным модулем поставляются примеры стандартных программ печати в которые добавлен вызов SBIS SAPPER.

В ряде случаев этого может быть не достаточно.

Генерация электронного документа использует в качестве данных значения рассчитанные программой печати. Иногда название контрагента, его ИНН и КПП выводятся в печатной форме одной строкой и как правило в программе печати они хранятся в одной переменной, а для формирования электронного документа они нужны по раздельности. Поэтому для каждой программы печати проводится анализ, каких данных в ней не хватает, после чего в текст программы вносятся соответствующие изменения.

Для подписания и отправки опционально может быть использован либо SBIS SDK (прямая отправка) или SBIS Коннект (обмен через каталог).

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

Если Вам больше нравится работать из интерфейса SBIS (это нормально). Вы можете находясь в SBIS нажать на кнопку загрузить из SAP, после чего все будет ровно так же как если бы Вы отправляли документы из SAP, только это будет чуть более красиво и возможно чуть-чуть быстрее.

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

Для удобной работы в кабинете SBIS на компьютере пользователя должен быть установлен SBIS Plugin, который отвечает за комфортную работу пользователя: выдачу всплывающих уведомлений, подписание документов, работу со сканерами и другими устройствами, а также взаимодействие с информационными системами прямо из интерфейса личного кабинета SBIS.

Так вот, когда пользователь нажимает кнопку "Загрузить из SAP", браузер через SBIS Plugin запрашивает в SAP список документов определенного типа.

SBIS Plugin имеет в своем составе стандартный SAP Net connector 3, с помощью которого, через RFC интерфейс он получает информацию таким же способом что и /SBIS/SEND.

Подобное решение не может быть использовано для доступа к SAP из интернет, доступ возможен только из браузера пользователя по его инициативе и ограничен правами в SAP.

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

В составе SBIS SAPPER есть пакет EJOURNAL который реализует работу ( в т.ч. BADI) со стандартными журналами электронных документов SAP.

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

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

Как это работает: В SBIS SAPPER реализованы все BADI стандартного модуля электронных документов SAP CIS и немного больше.

FAQ

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

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


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

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

В составе SBIS SAPPER есть специальная программа (/SBIS/INBOX), с помощью которой пользователь в интерфейсе SAP может просматривать, обрабатывать и загружать входящие документы.

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

  1. вызываем программу
  2. программа автоматически генерирует извещение о получении документов доступных этому пользователю (при условии наличия ЭЦП без этого не возможен их просмотр)
  3. пользователь видим список доступных ему входящих документов (ограничения настраиваются в личном кабинете SBIS)
  4. любой документ пользователь может посмотреть, выполнить над ним доступное действие (по умолчанию это принять / отклонить)
  5. загрузить в SAP (возможно для этого потребуется сопоставить номенклатуру)

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

Когда пользователь запускает программу отправки (/SBIS/INBOX), она через SDK авторизуется в личном кабинете SBIS, запрашивает список входящих документов (аналогичный можно видеть в разделе Входящие личного кабинета). Далее для каждого входящего документа проверяется загружался ли он в SAP и сравниваются суммы документов, и эта информация добавляется в список. Результат пользователь видит на экране.

При нажатии кнопки загрузить в SAP, пользователя при наличии нескольких вариантов загрузки XML файла спросят куда именно он хочет загрузить файл, после чего XML файл конвертируется в XML универсального формата, который при помощи таблицы настроек сериализуется в структуру SAP которая передается соответствующему BAPI. В момент загрузки по желанию заказчика в таблицы SAP может быть передана информация о подписантах, оригиналы XML документов, PDF представление документа со штампом ЭДО.


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

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

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

SBIS SAPPER

Программный компонент, предназначен для интеграции учётной системы SAP ERP с SBIS. ИМ имеет несколько пользовательских интерфейсов:

  • SBIS GUI - набор экранов выполненных в интерфейсе SAP для взаимодействия с пользователем.
  • Data interface - набор классов реализующих интерфейс получения списка, выгрузки и загрузки документов из разных источников данных, таковыми могут быть программы печати, BAPI, журналы.
  • Exchange interface - набор классов реализующих интерфейс обмена данными с SBIS, по умолчанию это SBIS SDK, в ряде случаем может быть использован обмен через каталог.
  • User settings - основа модуля это таблица настроек отвечающая за параметры обмена, маппинг полей. За счет неё решение получает свою гибкость.

SBIS Plugin

Объект для обеспечения функционала личного кабинет SBIS (предназначен для генерации стандартизованной электронной цифровой подписи, которая базируется на формате 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 SBIS, а также генерации стандартизованной электронной цифровой подписи, которая базируется на формате PKCS#7 . Объект устанавливается на рабочих местах пользователей. Интеграция с SAP системой выполнена посредством технологии OLE2. Подробнее о SBIS SDK.

SBIS Connect

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