SAPPER SETTINGS - Общие — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
Строка 1: Строка 1:
Общие настройки содержат следующие ключевые значения:
+
=SBIS=
#EXCHANGE_CLASS параметр, указывающий используемый тип обмена между SAP и СБИС
+
*Раздел настроек SBIS содержит общие настройки SAPPER:
 +
 
 +
Структура:
 +
 
 +
#EXCHANGE_CLASS - имя класса реализующего интерфейс обмена с SBIS
 +
#ASYNC_GROUP_SERVER – значение группы серверов для асинхронного обмена данными
 +
#DOC_TYPE – Настройки средств просмотра созданных документов SAP
 +
#NDS_CODE_INCOMING - Соответствие ставок НДС ФНС, значению ставки НДС SAP
 +
#CONVERT_XSLT_NAME_TO_FIO_TYPE – Параметры представления названия субъекта предпринимательской деятельности физ лиц (ЧП, ПБЮЛ и тп)
 +
#SBIS_ROBOT – настройки автоматической отправки и получения статусов
 +
#ACCORDION – настройки меню SAPPER - аккордеона.личном
 +
 
 +
Пример:
 +
 
 +
 
 +
==DOC_TYPE==
 +
 
 +
Настройки средств просмотра созданных документов SAP. Содержит массив настроек, каждая запись которого определяет как (с помощью какой транзакции) показывать документ SAP.
 +
 
 +
Используется для открытия документа SAP из SAPPER. В момент открытия данные открываемого документа лежат в структуре S_API2_PACKET.
 +
 
 +
Структура записи:
 +
* [Код типа документа SAP и его название]
 +
** VIEW_DOCUMENT" - имя транзакции для просмотра
 +
*** [маппинг API2_PACKET в поля селекционного экрана транзакции]
 +
 
 +
<div style="border: 1px dashed;">
 +
Пример DOC_TYPE для заказа показываемого транзакцией ME23N. В ME23N необходимо в параметр BES передать номер показываемого документа. Номер показываемого документа лежит в поле BELNR структуры S_API2_PACKET
 +
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 +
<br>
 +
<source lang=JSON>
 +
{
 +
  "DOC_TYPE": {
 +
    "Значение": [
 +
      {
 +
        "Имя": "IC", //тип документа
 +
        "Тип": "Заказ", // представление типа документа в SAPPER
 +
        "Значение": [
 +
          {
 +
            "Имя": "VIEW_DOCUMENT",
 +
            "Тип": "ME23N", //транзакция просмотра
 +
            "Значение": [
 +
              {
 +
               
 +
                "Имя": "BELNR", - поле S_API2_PACKET
 +
                "Значение": "BES" - поле селекционного экрана транзакции ME23N
 +
              }
 +
            ]
 +
          }
 +
        ]
 +
      }
 +
    ]
 +
  }
 +
</source></div></div>
 +
 
 +
Используемые коды документов SAP:
 +
 
 +
* IS (ME23N)- Заказ
 +
         
 +
 
 +
==ACCORDION==
 +
 
 +
Меню (Аккордеон) в SBIS SAPPER динамический. (скрин аккордеона выделен). Содержимое меню является двухуровневым иерархическим списком описанным в данном разделе настроек.
 +
 
 +
Раздел (папка) аккордеона должен содержать параметры:
 +
* NAME - название пункта
 +
* ITEMS (тип list) - список вложенных пунктов (код, параметры)
 +
 
 +
Пункт аккордеона должен содержать параметры:
 +
* NAME - название пункта
 +
* CONTENT_CLASS - имя класса отвечающего за построение дерева списка в SAPPER
 +
* EXCHANGE_CLASS - имя класса отвечающего за способ обмена документами с СБИС
 +
* VIEW_CLASS - имя класса отвечающего за просмотр пакета
 +
* PAGE_SIZE - количество пакетов на странице
 +
* FILTER_FM_NAME - имя FM для установки фильтра в списке
 +
 
 +
Для аккордеона могут быть использованы следующие предустановленные пункты - Полученные, Отправленных, Ответы контрагентов - показывающие соответствующие разделы СБИС
 +
 
 +
Пример (для скрина выше):
 +
 
 +
 
 +
 
 +
#EXCHANGE_CLASS - параметр, указывающий используемый тип обмена между SAP и СБИС
 
#ASYNC_GROUP_SERVER – значение группы серверов для асинхронного обмена данными
 
#ASYNC_GROUP_SERVER – значение группы серверов для асинхронного обмена данными
 
#DOC_TYPE – соответствие типа загружаемого документа – документу SAP  
 
#DOC_TYPE – соответствие типа загружаемого документа – документу SAP  

Версия 09:13, 15 марта 2018

SBIS

  • Раздел настроек SBIS содержит общие настройки SAPPER:

Структура:

  1. EXCHANGE_CLASS - имя класса реализующего интерфейс обмена с SBIS
  2. ASYNC_GROUP_SERVER – значение группы серверов для асинхронного обмена данными
  3. DOC_TYPE – Настройки средств просмотра созданных документов SAP
  4. NDS_CODE_INCOMING - Соответствие ставок НДС ФНС, значению ставки НДС SAP
  5. CONVERT_XSLT_NAME_TO_FIO_TYPE – Параметры представления названия субъекта предпринимательской деятельности физ лиц (ЧП, ПБЮЛ и тп)
  6. SBIS_ROBOT – настройки автоматической отправки и получения статусов
  7. ACCORDION – настройки меню SAPPER - аккордеона.личном

Пример:


DOC_TYPE

Настройки средств просмотра созданных документов SAP. Содержит массив настроек, каждая запись которого определяет как (с помощью какой транзакции) показывать документ SAP.

Используется для открытия документа SAP из SAPPER. В момент открытия данные открываемого документа лежат в структуре S_API2_PACKET.

Структура записи:

  • [Код типа документа SAP и его название]
    • VIEW_DOCUMENT" - имя транзакции для просмотра
      • [маппинг API2_PACKET в поля селекционного экрана транзакции]

Пример DOC_TYPE для заказа показываемого транзакцией ME23N. В ME23N необходимо в параметр BES передать номер показываемого документа. Номер показываемого документа лежит в поле BELNR структуры S_API2_PACKET


{
  "DOC_TYPE": {
    "Значение": [
      {
        "Имя": "IC", //тип документа
        "Тип": "Заказ", // представление типа документа в SAPPER
        "Значение": [
          {
            "Имя": "VIEW_DOCUMENT",
            "Тип": "ME23N", //транзакция просмотра
            "Значение": [
              {
                
                "Имя": "BELNR", - поле S_API2_PACKET
                "Значение": "BES" - поле селекционного экрана транзакции ME23N
              }
            ]
          }
        ]
      }
    ]
  }

Используемые коды документов SAP:

  • IS (ME23N)- Заказ


ACCORDION

Меню (Аккордеон) в SBIS SAPPER динамический. (скрин аккордеона выделен). Содержимое меню является двухуровневым иерархическим списком описанным в данном разделе настроек.

Раздел (папка) аккордеона должен содержать параметры:

  • NAME - название пункта
  • ITEMS (тип list) - список вложенных пунктов (код, параметры)

Пункт аккордеона должен содержать параметры:

  • NAME - название пункта
  • CONTENT_CLASS - имя класса отвечающего за построение дерева списка в SAPPER
  • EXCHANGE_CLASS - имя класса отвечающего за способ обмена документами с СБИС
  • VIEW_CLASS - имя класса отвечающего за просмотр пакета
  • PAGE_SIZE - количество пакетов на странице
  • FILTER_FM_NAME - имя FM для установки фильтра в списке

Для аккордеона могут быть использованы следующие предустановленные пункты - Полученные, Отправленных, Ответы контрагентов - показывающие соответствующие разделы СБИС

Пример (для скрина выше):


  1. EXCHANGE_CLASS - параметр, указывающий используемый тип обмена между SAP и СБИС
  2. ASYNC_GROUP_SERVER – значение группы серверов для асинхронного обмена данными
  3. DOC_TYPE – соответствие типа загружаемого документа – документу SAP
  4. NDS_CODE_INCOMING - соответствие ставки НДС значению ставки в SAP
  5. CONVERT_XSLT_NAME_TO_FIO_TYPE – список наименований юридических лиц, используемый с ФИО
  6. SBIS_ROBOT – настройки автоматической отправки и получения статусов
  7. ACCORDION – настройки аккордеона, состоит из набора доступных папок и документов в списке. Обычно содержит как минимум реестр “Полученных”, ”Отправленных”, “Ответы контрагентов”, отражающие аналогичные реестры в личном кабинете. “Продажи” содержит список выгружаемых пакетов документов.

Еще раз перечислим настройки аккордеона:

  1. NAME – имя реестра
  2. CONTENT_CLASS – класс построения дерева (списка) документов
  3. EXCHANGE_SEND_CLASS – класс обмена данными
  4. VIEW_CLASS – класс отображения пакета документов
  5. PAGE_SIZE – размер страницы при загрузке документов
  6. FILTER_FM_NAME – фильтр, отображаемый на экране
  7. ASYNC_PROCESSING – "X" выполнять асинхронно, иначе синхронно
  8. Дополнительно может быть добавлена проверка на авторизации:
      "Имя": "CHECK_AUTHORITY",
      "Значение": [
        {
          "Имя": "BUKRS_ORG",
          "Значение": [
            {
              "Имя": "ПолучениеДанныхМетод",
              "Значение": "GET_AUTH_BUKRS"
            },
            {
              "Имя": "ПроверкаМетод",
              "Значение": "CHECK_AUTH_BUKRS"
            },
            {
              "Имя": "ПараметрыПроверки",
              "Значение": [
                {
                  "Имя": "ACTVT",
                  "Значение": "03",
                  "Тип": "Операция"
                },
                {
                  "Имя": "PSART",
                  "Значение": "01",
                  "Тип": "Сектор"
                }
              ],
              "Формат": "F_BKPF_BUK - комментарий"
            }
          ]
        }
      ]
    }

В итоге файл SBIS.json выглядит следующим образом:

пример SBIS


{
  "EXCHANGE_CLASS": {
    "Значение": "/SBIS/CL_EXCHANGE_SDK" //класс обмена, на данный момент (14.03.2018) доступны варианты /SBIS/CL_EXCHANGE_SDK, /SBIS/CL_EXCHANGE_FILE
  },
  "FILTER_FM_NAME": {
    "Значение": "/SBIS/FM_FILTER_SCREEN_301", //значение фильтра по умолчанию
    "Подтип": "Parameter"
  },
  "ASYNC_GROUP_SERVER": {
    "Значение": ""
  },
  "DOC_TYPE": {
    "Значение": [
      {
        "Имя": "IC", //тип документа
        "Тип": "Заказ",
        "Значение": [
          {
            "Имя": "VIEW_DOCUMENT",
            "Тип": "ME23N", //транзакция просмотра
            "Значение": [
              {
                //заполняемые поля на экране
                "Имя": "BELNR",
                "Значение": "BES"
              }
            ]
          }
        ]
      }
    ]
  },
  "NDS_CODE_INCOMING": {
    "Значение": [
      {
        "Имя": "18", // ставка НДС
        "Тип": "INBOUND",
        "Значение": "PC" //ставка НДС в SAP
      },
      {
        "Имя": "18%",
        "Тип": "INBOUND",
        "Значение": "PC"
      },
      {
        "Имя": "18/118",
        "Тип": "INBOUND",
        "Значение": "PC"
      }
    ]
  },
  "CONVERT_XSLT_NAME_TO_FIO_TYPE": {
    "Значение": [
      {
        "Имя": "TERMS",
        "Тип": "String",
        "Значение": "ип,чп,индивидуальный предприниматель,адвокат,нотариус,предприниматель без образования юридического лица,пбоюл,предприниматель"
      }
    ]
  },
  "SBIS_ROBOT": {
    "Значение": [
      {
        "Имя": "/SBIS/PR_UPDATE_DOC_STATUS", //программа обновления статусов
        "Значение": ""
      },
      {
        "Имя": "/SBIS/PR_SEND_ALL_SDK", //программа отправки документов
        "Значение": "SALES"
      }
    ]
  },
  "ACCORDION": {
    "Тип": "List",
    "Значение": [
      {
        "Имя": "Полученные",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Полученные"  //имя реестра
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_INBOX" //класс построения дерева
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": "" //класс обмена
          }, 
          {
            "Имя": "VIEW_CLASS",
            "Значение": "/SBIS/CL_VIEW_INBOX_PACKET" //класс просмотра пакета документов
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20" //размер страницы (значение для навигации)
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301", //фильтр на экране
            "Подтип": "Parameter"
          }
        ]
      },
      {
        "Имя": "Задачи",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Задачи"
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_TASKS_LIST"
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": ""
          },
          {
            "Имя": "VIEW_CLASS",
            "Значение": ""
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20"
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301",
            "Подтип": "Parameter"
          },
          {
            "Имя": "FOLDER",
            "Значение": "НаМне"
          }
        ]
      },
      {
        "Имя": "Отправленные",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Отправленные"
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_OUTBOX"
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": ""
          },
          {
            "Имя": "VIEW_CLASS",
            "Значение": "/SBIS/CL_VIEW_OUTBOX_PACKET"
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20"
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301",
            "Подтип": "Parameter"
          }
        ]
      },
      {
        "Имя": "Ответы контрагентов",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Ответы контрагентов"
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_RESPONSE"
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": ""
          },
          {
            "Имя": "VIEW_CLASS",
            "Значение": "/SBIS/CL_VIEW_RESPONSE_PACKET"
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20"
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301",
            "Подтип": "Parameter"
          }
        ]
      },
      {
        "Имя": "Продажа",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Продажа"
          },
          {
            "Имя": "ITEMS",
            "Тип": "List",
            "Значение": []  //список реестров
          }
        ]
      }
    ]
  }
}

Структура реестра приведена ниже:

 
                                {
                                    "Имя": "LO_РеализацияТоваров",
                                    "Значение": [
                                        {
                                            "Имя": "NAME",
                                            "Значение": "Реализация товаров" //наименование реестра
                                        },
                                        {
                                            "Имя": "CONTENT_CLASS",
                                            "Значение": "/SBIS/CL_TREE_API2_PACKET" //класс отображения дерева
                                        },
                                        {
                                            "Имя": "EXCHANGE_SEND_CLASS",
                                            "Значение": ""
                                        },
                                        {
                                            "Имя": "VIEW_CLASS",
                                            "Значение": "/SBIS/CL_VIEW_SAP_PACKET" //класс отображения пакета (предпросмотр)
                                        },
                                        {
                                            "Имя": "PAGE_SIZE",
                                            "Значение": "20"
                                        },
                                        {
                                            "Имя": "FILTER_FM_NAME",
                                            "Значение": "/SBIS/FM_FILTER_SCREEN_302", //фильтр доступный на экране
                                            "Подтип": "Range"
                                        }
                                    ]
                                }


пример SBIS с добавленным реестром "Реализация Товаров"


{
  "EXCHANGE_CLASS": {
    "Значение": "/SBIS/CL_EXCHANGE_SDK" //класс обмена, на данный момент (14.03.2018) доступны варианты /SBIS/CL_EXCHANGE_SDK, /SBIS/CL_EXCHANGE_FILE
  },
  "FILTER_FM_NAME": {
    "Значение": "/SBIS/FM_FILTER_SCREEN_301", //значение фильтра по умолчанию
    "Подтип": "Parameter"
  },
  "ASYNC_GROUP_SERVER": {
    "Значение": ""
  },
  "DOC_TYPE": {
    "Значение": [
      {
        "Имя": "IC", //тип документа
        "Тип": "Заказ",
        "Значение": [
          {
            "Имя": "VIEW_DOCUMENT",
            "Тип": "ME23N", //транзакция просмотра
            "Значение": [
              {
                //заполняемые поля на экране
                "Имя": "BELNR",
                "Значение": "BES"
              }
            ]
          }
        ]
      }
    ]
  },
  "NDS_CODE_INCOMING": {
    "Значение": [
      {
        "Имя": "18", // ставка НДС
        "Тип": "INBOUND",
        "Значение": "PC" //ставка НДС в SAP
      },
      {
        "Имя": "18%",
        "Тип": "INBOUND",
        "Значение": "PC"
      },
      {
        "Имя": "18/118",
        "Тип": "INBOUND",
        "Значение": "PC"
      }
    ]
  },
  "CONVERT_XSLT_NAME_TO_FIO_TYPE": {
    "Значение": [
      {
        "Имя": "TERMS",
        "Тип": "String",
        "Значение": "ип,чп,индивидуальный предприниматель,адвокат,нотариус,предприниматель без образования юридического лица,пбоюл,предприниматель"
      }
    ]
  },
  "SBIS_ROBOT": {
    "Значение": [
      {
        "Имя": "/SBIS/PR_UPDATE_DOC_STATUS", //программа обновления статусов
        "Значение": ""
      },
      {
        "Имя": "/SBIS/PR_SEND_ALL_SDK", //программа отправки документов
        "Значение": "SALES"
      }
    ]
  },
  "ACCORDION": {
    "Тип": "List",
    "Значение": [
      {
        "Имя": "Полученные",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Полученные"  //имя реестра
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_INBOX" //класс построения дерева
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": "" //класс обмена
          },
          {
            "Имя": "VIEW_CLASS",
            "Значение": "/SBIS/CL_VIEW_INBOX_PACKET" //класс просмотра пакета документов
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20" //размер страницы (значение для навигации)
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301", //фильтр на экране
            "Подтип": "Parameter"
          }
        ]
      },
      {
        "Имя": "Задачи",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Задачи"
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_TASKS_LIST"
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": ""
          },
          {
            "Имя": "VIEW_CLASS",
            "Значение": ""
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20"
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301",
            "Подтип": "Parameter"
          },
          {
            "Имя": "FOLDER",
            "Значение": "НаМне"
          }
        ]
      },
      {
        "Имя": "Отправленные",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Отправленные"
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_OUTBOX"
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": ""
          },
          {
            "Имя": "VIEW_CLASS",
            "Значение": "/SBIS/CL_VIEW_OUTBOX_PACKET"
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20"
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301",
            "Подтип": "Parameter"
          }
        ]
      },
      {
        "Имя": "Ответы контрагентов",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Ответы контрагентов"
          },
          {
            "Имя": "CONTENT_CLASS",
            "Значение": "/SBIS/CL_TREE_RESPONSE"
          },
          {
            "Имя": "EXCHANGE_SEND_CLASS",
            "Значение": ""
          },
          {
            "Имя": "VIEW_CLASS",
            "Значение": "/SBIS/CL_VIEW_RESPONSE_PACKET"
          },
          {
            "Имя": "PAGE_SIZE",
            "Значение": "20"
          },
          {
            "Имя": "FILTER_FM_NAME",
            "Значение": "/SBIS/FM_FILTER_SCREEN_301",
            "Подтип": "Parameter"
          }
        ]
      },
      {
        "Имя": "Продажа",
        "Значение": [
          {
            "Имя": "NAME",
            "Значение": "Продажа"
          },
          {
            "Имя": "ITEMS",
            "Тип": "List",
            "Значение": [
              {
              "Имя": "LO_РеализацияТоваров",
              "Значение": [
                {
                  "Имя": "NAME",
                  "Значение": "Реализация товаров"
                },
                {
                  "Имя": "CONTENT_CLASS",
                  "Значение": "/SBIS/CL_TREE_API2_PACKET"
                },
                {
                  "Имя": "VIEW_CLASS",
                  "Значение": "/SBIS/CL_VIEW_SAP_PACKET"
                },
                {
                  "Имя": "PAGE_SIZE",
                  "Значение": "20"
                },
                {
                  "Имя": "FILTER_FM_NAME",
                  "Значение": "/SBIS/FM_FILTER_SCREEN_302",
                  "Подтип": "Range"
                },
                {
                  "Имя": "CHECK_AUTHORITY",
                  "Значение": [
                    {
                      "Имя": "BUKRS_ORG",
                      "Значение": [
                        {
                          "Имя": "ПолучениеДанныхМетод",
                          "Значение": "GET_AUTH_BUKRS"
                        },
                        {
                          "Имя": "ПроверкаМетод",
                          "Значение": "CHECK_AUTH_BUKRS"
                        },
                        {
                          "Имя": "ПараметрыПроверки",
                          "Значение": [
                            {
                              "Имя": "ACTVT",
                              "Значение": "03",
                              "Тип": "Операция"
                            },
                            {
                              "Имя": "PSART",
                              "Значение": "01",
                              "Тип": "Сектор"
                            }
                          ],
                          "Формат": "F_BKPF_BUK - комментарий"
                        }
                      ]
                    }
                  ]
                },
                {
                  "Имя": "ASYNC_PROCESSING",
                  "Значение": ""
                }
              ]
            }
            ]
          }
        ]
      }
    ]
  }
}