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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(SBIS)
 
(не показаны 24 промежуточные версии 3 участников)
Строка 1: Строка 1:
Общие настройки содержат следующие ключевые значения:
+
[[Категория:SAPPER]]
#EXCHANGE_CLASS параметр, указывающий используемый тип обмена между SAP и СБИС
+
[[Категория:SAP]]
#ASYNC_GROUP_SERVER – значение группы серверов для асинхронного обмена данными
+
 
#DOC_TYPE – соответствие типа загружаемого документа – документу SAP  
+
=SBIS=
#NDS_CODE_INCOMING - соответствие ставки НДС значению ставки в SAP
+
*Раздел настроек SBIS содержит общие настройки SAPPER:
#CONVERT_XSLT_NAME_TO_FIO_TYPE – список наименований юридических лиц, используемый с ФИО
+
 
#SBIS_ROBOT – настройки автоматической отправки и получения статусов
+
Структура:
#ACCORDION – настройки аккордеона, состоит из набора доступных папок и документов в списке. Обычно содержит как минимум реестр “Полученных”, ”Отправленных”, “Ответы контрагентов”, отражающие аналогичные реестры в личном кабинете. “Продажи” содержит список выгружаемых пакетов документов.  
+
 
Еще раз перечислим настройки аккордеона:
+
*EXCHANGE_CLASS - имя класса реализующего интерфейс обмена с SBIS
#NAME – имя реестра
+
*ASYNC_GROUP_SERVER – значение группы серверов для асинхронного обмена данными
#CONTENT_CLASS – класс построения дерева (списка) документов
+
*DOC_TYPE – Настройки средств просмотра созданных документов SAP
#EXCHANGE_SEND_CLASS – класс обмена данными
+
*NDS_CODE - Соответствие ставок НДС ФНС, значению ставки НДС SAP
#VIEW_CLASS – класс отображения пакета документов
+
*CONVERT_XSLT_NAME_TO_FIO_TYPE – Параметры представления названия субъекта предпринимательской деятельности физ лиц (ЧП, ПБЮЛ и тп)
#PAGE_SIZE – размер страницы при загрузке документов
+
*SBIS_ROBOT – настройки автоматической отправки и получения статусов
#FILTER_FM_NAME – фильтр, отображаемый на экране
+
*ACCORDION – настройки меню SAPPER - аккордеона
#ASYNC_PROCESSING – "X" выполнять асинхронно, иначе синхронно
+
*EXCEL - массив настройки для выгрузок в EXCEL.
#Дополнительно может быть добавлена проверка на авторизации: <source lang=json>
+
*PARTNER_SETTINGS - массив настройки для контрагента.
  "Имя": "CHECK_AUTHORITY",
 
  "Значение": [
 
    {
 
      "Имя": "BUKRS_ORG",
 
      "Значение": [
 
        {
 
          "Имя": "ПолучениеДанныхМетод",
 
          "Значение": "GET_AUTH_BUKRS"
 
        },
 
        {
 
          "Имя": "ПроверкаМетод",
 
          "Значение": "CHECK_AUTH_BUKRS"
 
        },
 
        {
 
          "Имя": "ПараметрыПроверки",
 
          "Значение": [
 
            {
 
              "Имя": "ACTVT",
 
              "Значение": "03",
 
              "Тип": "Операция"
 
            },
 
            {
 
              "Имя": "PSART",
 
              "Значение": "01",
 
              "Тип": "Сектор"
 
            }
 
          ],
 
          "Формат": "F_BKPF_BUK - комментарий"
 
        }
 
      ]
 
    }
 
  ]
 
}
 
</source>
 
  
В итоге файл SBIS.json выглядит следующим образом:
 
 
<div style="border: 1px dashed;">
 
<div style="border: 1px dashed;">
'''пример SBIS'''
+
Пример структуры раздела настроек SBIS
 
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 
<br>
 
<br>
Строка 59: Строка 24:
 
{
 
{
 
   "EXCHANGE_CLASS": {
 
   "EXCHANGE_CLASS": {
     "Значение": "/SBIS/CL_EXCHANGE_SDK" //класс обмена, на данный момент (14.03.2018) доступны варианты /SBIS/CL_EXCHANGE_SDK, /SBIS/CL_EXCHANGE_FILE
+
     "Значение": "/SBIS/CL_EXCHANGE_SDK" //имя класса обмена, доступны варианты /SBIS/CL_EXCHANGE_EXTSDK, /SBIS/CL_EXCHANGE_SDK, /SBIS/CL_EXCHANGE_FILE
 
   },
 
   },
 
   "FILTER_FM_NAME": {
 
   "FILTER_FM_NAME": {
     "Значение": "/SBIS/FM_FILTER_SCREEN_301", //значение фильтра по умолчанию
+
     "Значение": "/SBIS/FM_FILTER_SCREEN_301", // имя FM реализующего экран фильтра по умолчанию
 
     "Подтип": "Parameter"
 
     "Подтип": "Parameter"
 
   },
 
   },
 
   "ASYNC_GROUP_SERVER": {
 
   "ASYNC_GROUP_SERVER": {
     "Значение": ""
+
     "Значение": "" // название группы серверов для асинхронного запуска
 
   },
 
   },
 
   "DOC_TYPE": {
 
   "DOC_TYPE": {
     "Значение": [
+
     "Значение": []
      {
 
        "Имя": "IC", //тип документа
 
        "Тип": "Заказ",
 
        "Значение": [
 
          {
 
            "Имя": "VIEW_DOCUMENT",
 
            "Тип": "ME23N", //транзакция просмотра
 
            "Значение": [
 
              {
 
                //заполняемые поля на экране
 
                "Имя": "BELNR",
 
                "Значение": "BES"
 
              }
 
            ]
 
          }
 
        ]
 
      }
 
    ]
 
 
   },
 
   },
 
   "NDS_CODE_INCOMING": {
 
   "NDS_CODE_INCOMING": {
     "Значение": [
+
     "Значение": []
      {
 
        "Имя": "18", // ставка НДС
 
        "Тип": "INBOUND",
 
        "Значение": "PC" //ставка НДС в SAP
 
      },
 
      {
 
        "Имя": "18%",
 
        "Тип": "INBOUND",
 
        "Значение": "PC"
 
      },
 
      {
 
        "Имя": "18/118",
 
        "Тип": "INBOUND",
 
        "Значение": "PC"
 
      }
 
    ]
 
 
   },
 
   },
 
   "CONVERT_XSLT_NAME_TO_FIO_TYPE": {
 
   "CONVERT_XSLT_NAME_TO_FIO_TYPE": {
     "Значение": [
+
     "Значение": []
      {
 
        "Имя": "TERMS",
 
        "Тип": "String",
 
        "Значение": "ип,чп,индивидуальный предприниматель,адвокат,нотариус,предприниматель без образования юридического лица,пбоюл,предприниматель"
 
      }
 
    ]
 
 
   },
 
   },
 
   "SBIS_ROBOT": {
 
   "SBIS_ROBOT": {
     "Значение": [
+
     "Значение": []
      {
 
        "Имя": "/SBIS/PR_UPDATE_DOC_STATUS", //программа обновления статусов
 
        "Значение": ""
 
      },
 
      {
 
        "Имя": "/SBIS/PR_SEND_ALL_SDK", //программа отправки документов
 
        "Значение": "SALES"
 
      }
 
    ]
 
 
   },
 
   },
 
   "ACCORDION": {
 
   "ACCORDION": {
 
     "Тип": "List",
 
     "Тип": "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",
 
            "Значение": []  //список реестров
 
          }
 
        ]
 
      }
 
    ]
 
 
   }
 
   }
 
}
 
}
Строка 276: Строка 53:
 
</div>
 
</div>
 
</div>
 
</div>
 +
 +
==DOC_TYPE==
 +
 +
Настройки средств просмотра созданных документов SAP. Содержит массив настроек, каждая запись которого определяет как (с помощью какой транзакции) показывать документ SAP.
 +
 +
Используется для открытия документа SAP из SAPPER. В момент открытия данные открываемого документа лежат в структуре S_API2_PACKET.
 +
 +
Структура записи:
 +
* [Код типа документа SAP и его название]
 +
** VIEW_DOCUMENT - имя транзакции для просмотра
 +
*** [настройки заполнения селекционного экрана транзакции, [имя поля] = [источник данных в API2_PACKET]]
  
 
<div style="border: 1px dashed;">
 
<div style="border: 1px dashed;">
'''пример SBIS.json с добавленным реестром "Реализация Товаров"'''
+
Пример DOC_TYPE для заказа показываемого транзакцией ME23N. В ME23N необходимо в параметр BES передать номер показываемого документа. Номер показываемого документа лежит в поле BELNR структуры S_API2_PACKET
 
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 
<br>
 
<br>
 
<source lang=JSON>
 
<source lang=JSON>
 
{
 
{
  "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": {
 
   "DOC_TYPE": {
 
     "Значение": [
 
     "Значение": [
 
       {
 
       {
 
         "Имя": "IC", //тип документа
 
         "Имя": "IC", //тип документа
         "Тип": "Заказ",
+
         "Тип": "Заказ", // представление типа документа в SAPPER
 
         "Значение": [
 
         "Значение": [
 
           {
 
           {
Строка 304: Строка 82:
 
             "Значение": [
 
             "Значение": [
 
               {
 
               {
                 //заполняемые поля на экране
+
                  
                 "Имя": "BELNR",
+
                 "Имя": "BES", - поле селекционного экрана транзакции ME23N
                 "Значение": "BES"
+
                 "Значение": "BELNR" - поле S_API2_PACKET
 
               }
 
               }
 
             ]
 
             ]
Строка 313: Строка 91:
 
       }
 
       }
 
     ]
 
     ]
   },
+
   }
   "NDS_CODE_INCOMING": {
+
</source></div></div>
 +
 
 +
Используемые коды документов SAP:
 +
 
 +
* IC (ME23N)- Заказ
 +
* IJ (/SBIS/MIGO_DIALOG) - Накладная
 +
* IM (MIR4) - Счет-фактура
 +
 
 +
==NDS_CODE==
 +
   
 +
Соответствие ставок НДС ФНС, значению ставки НДС SAP. Содержит массив значений следующего вида:
 +
* [Ставка НДС ФНС]
 +
* [Направление обмена] - INBOUND\OUTBOUND (входящий\исходящий НДС), в данный момент используется только INBOUND
 +
* [Значение ставки НДС SAP]
 +
 
 +
<div style="border: 1px dashed;">
 +
Пример NDS_CODE для ставки НДС 18%
 +
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 +
<br>
 +
<source lang=JSON>
 +
{
 +
   "NDS_CODE": {
 
     "Значение": [
 
     "Значение": [
 
       {
 
       {
         "Имя": "18", // ставка НДС
+
         "Имя": "18", //вариант обозначения ставки НДС
         "Тип": "INBOUND",
+
         "Тип": "INBOUND", //направление обмена INBOUND\OUTBOUND
         "Значение": "PC" //ставка НДС в SAP
+
         "Значение": "PC" //код ставки НДС в SAP
 
       },
 
       },
 
       {
 
       {
 
         "Имя": "18%",
 
         "Имя": "18%",
        "Тип": "INBOUND",
 
        "Значение": "PC"
 
      },
 
      {
 
        "Имя": "18/118",
 
 
         "Тип": "INBOUND",
 
         "Тип": "INBOUND",
 
         "Значение": "PC"
 
         "Значение": "PC"
 
       }
 
       }
     ]
+
     ]
  },
+
}
  "CONVERT_XSLT_NAME_TO_FIO_TYPE": {
+
</source></div></div>
 +
 
 +
==CONVERT_XSLT_NAME_TO_FIO_TYPE==
 +
 
 +
Параметры представления названия субъекта предпринимательской деятельности физ лиц (ЧП, ПБЮЛ и тп). Используется для корректного отображения ФИО субъекта деятельности, если в ФИО хранится название предпринимательской деятельности, к примеру, "ИП Иванов Иван Иванович". Для преобразования используется метод класса /SBIS/CL_CORE->CONVERT_XSLT_NAME_TO_FIO
 +
 
 +
Структура параметра:
 +
* [имя определения]
 +
* [тип определения]
 +
* [значение]
 +
 
 +
<div style="border: 1px dashed;">
 +
Пример CONVERT_XSLT_NAME_TO_FIO_TYPE со списком возможных значений
 +
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 +
<br>
 +
<source lang=JSON>
 +
{
 +
"CONVERT_XSLT_NAME_TO_FIO_TYPE": {
 
     "Значение": [
 
     "Значение": [
 
       {
 
       {
Строка 341: Строка 152:
 
       }
 
       }
 
     ]
 
     ]
   },
+
   }
 +
}
 +
</source>
 +
</div>
 +
</div>
 +
 
 +
==SBIS_ROBOT==
 +
Раздел настройки для автоматической отправки и получения статусов, содержит массив значений следующей структуры:
 +
* [имя вызываемой программы]
 +
* [вариант]
 +
 
 +
<div style="border: 1px dashed;">
 +
Пример SBIS_ROBOT для настройки автоматической отправки документов с фильтром по варианту SALES
 +
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 +
<br>
 +
<source lang=JSON>
 +
{
 
   "SBIS_ROBOT": {
 
   "SBIS_ROBOT": {
 
     "Значение": [
 
     "Значение": [
 
       {
 
       {
        "Имя": "/SBIS/PR_UPDATE_DOC_STATUS", //программа обновления статусов
+
         "Имя": "/SBIS/PR_SEND_ALL_SDK",
        "Значение": ""
 
      },
 
      {
 
         "Имя": "/SBIS/PR_SEND_ALL_SDK", //программа отправки документов
 
 
         "Значение": "SALES"
 
         "Значение": "SALES"
 
       }
 
       }
 
     ]
 
     ]
   },
+
   }
  "ACCORDION": {
+
}
 +
</source></div></div>
 +
 
 +
Подробнее о функционале по [http://wiki.razgovorov.ru/index.php/%D0%A1%D0%91%D0%98%D0%A1_%D0%A1%D0%B0%D0%BF%D1%91%D1%80_-_%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#.D0.A1.D0.91.D0.98.D0.A1_.D1.80.D0.BE.D0.B1.D0.BE.D1.82.2C_.D0.B0.D0.B2.D1.82.D0.BE.D0.BC.D0.B0.D1.82.D0.B8.D0.B7.D0.B0.D1.86.D0.B8.D1.8F_.D0.BE.D1.82.D0.BF.D1.80.D0.B0.D0.B2.D0.BA.D0.B8_.D0.B4.D0.BE.D0.BA.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D0.BE.D0.B2_.D0.B8_.D0.BE.D0.B1.D0.BD.D0.BE.D0.B2.D0.BB.D0.B5.D0.BD.D0.B8.D1.8F_.D1.81.D1.82.D0.B0.D1.82.D1.83.D1.81.D0.BE.D0.B2 ссылке].
 +
 
 +
==ACCORDION==
 +
 
 +
Меню (аккордеон) в SBIS SAPPER динамический.
 +
[[Файл:Accordion.png|right|Аккордеон]]
 +
Содержимое меню является двухуровневым иерархическим списком.
 +
 
 +
Раздел (папка) аккордеона должен содержать параметры:
 +
* NAME - название пункта
 +
* ITEMS (тип list) - список вложенных пунктов (код, параметры)
 +
 
 +
Пункт аккордеона должен содержать параметры:
 +
* NAME - название пункта
 +
* CONTENT_CLASS - имя класса отвечающего за построение дерева списка в SAPPER
 +
* EXCHANGE_SEND_CLASS - имя класса отвечающего за способ обмена документами с СБИС
 +
* VIEW_CLASS - имя класса отвечающего за просмотр пакета
 +
* PAGE_SIZE - количество пакетов на странице
 +
* FILTER_FM_NAME - имя FM для установки фильтра в списке
 +
* ASYNC_PROCESSING - "X" выполнять асинхронно, иначе синхронно
 +
 
 +
Для аккордеона могут быть использованы следующие предустановленные пункты - Полученные, Отправленные, Ответы контрагентов - показывающие соответствующие разделы СБИС.
 +
 
 +
<div style="border: 1px dashed;">
 +
Пример аккордеона с папками Полученные, Отправленные, Ответы контрагентов, Продажи с пунктом Реализация Товаров
 +
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 +
<br>
 +
<source lang=JSON>
 +
{
 +
"ACCORDION": {
 
     "Тип": "List",
 
     "Тип": "List",
 
     "Значение": [
 
     "Значение": [
Строка 362: Строка 217:
 
           {
 
           {
 
             "Имя": "NAME",
 
             "Имя": "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",
 
             "Имя": "CONTENT_CLASS",
             "Значение": "/SBIS/CL_TREE_TASKS_LIST"
+
             "Значение": "/SBIS/CL_TREE_INBOX"
 
           },
 
           },
 
           {
 
           {
Строка 404: Строка 229:
 
           {
 
           {
 
             "Имя": "VIEW_CLASS",
 
             "Имя": "VIEW_CLASS",
             "Значение": ""
+
             "Значение": "/SBIS/CL_VIEW_INBOX_PACKET"
 
           },
 
           },
 
           {
 
           {
Строка 414: Строка 239:
 
             "Значение": "/SBIS/FM_FILTER_SCREEN_301",
 
             "Значение": "/SBIS/FM_FILTER_SCREEN_301",
 
             "Подтип": "Parameter"
 
             "Подтип": "Parameter"
           },
+
           }        
          {
 
            "Имя": "FOLDER",
 
            "Значение": "НаМне"
 
          }
 
 
         ]
 
         ]
 
       },
 
       },
Строка 493: Строка 314:
 
             "Значение": [
 
             "Значение": [
 
               {
 
               {
              "Имя": "LO_РеализацияТоваров",
+
                "Имя": "LO_РеализацияТоваров",
              "Значение": [
+
                "Значение": [
                {
+
                  {
                  "Имя": "NAME",
+
                    "Имя": "NAME",
                  "Значение": "Реализация товаров"
+
                    "Значение": "Реализация товаров"
                },
+
                  },
                {
+
                  {
                  "Имя": "CONTENT_CLASS",
+
                    "Имя": "CONTENT_CLASS",
                  "Значение": "/SBIS/CL_TREE_API2_PACKET"
+
                    "Значение": "/SBIS/CL_TREE_API2_PACKET"
                },
+
                  },
                {
+
                  {
                  "Имя": "VIEW_CLASS",
+
                    "Имя": "VIEW_CLASS",
                  "Значение": "/SBIS/CL_VIEW_SAP_PACKET"
+
                    "Значение": "/SBIS/CL_VIEW_SAP_PACKET"
                },
+
                  },
                {
+
                  {
                  "Имя": "PAGE_SIZE",
+
                    "Имя": "PAGE_SIZE",
                  "Значение": "20"
+
                    "Значение": "20"
                },
+
                  },
                {
+
                  {
                  "Имя": "FILTER_FM_NAME",
+
                    "Имя": "FILTER_FM_NAME",
                  "Значение": "/SBIS/FM_FILTER_SCREEN_302",
+
                    "Значение": "/SBIS/FM_FILTER_SCREEN_302",
                  "Подтип": "Range"
+
                    "Подтип": "Range"
                },
+
                  },
                {
+
                  {
                  "Имя": "CHECK_AUTHORITY",
+
                    "Имя": "ASYNC_PROCESSING",
                  "Значение": [
+
                     "Значение": ""
                     {
+
                   }
                      "Имя": "BUKRS_ORG",
+
                 ]
                      "Значение": [
+
               }
                        {
 
                          "Имя": "ПолучениеДанныхМетод",
 
                          "Значение": "GET_AUTH_BUKRS"
 
                        },
 
                        {
 
                          "Имя": "ПроверкаМетод",
 
                          "Значение": "CHECK_AUTH_BUKRS"
 
                        },
 
                        {
 
                          "Имя": "ПараметрыПроверки",
 
                          "Значение": [
 
                            {
 
                              "Имя": "ACTVT",
 
                              "Значение": "03",
 
                              "Тип": "Операция"
 
                            },
 
                            {
 
                              "Имя": "PSART",
 
                              "Значение": "01",
 
                              "Тип": "Сектор"
 
                            }
 
                          ],
 
                          "Формат": "F_BKPF_BUK - комментарий"
 
                        }
 
                      ]
 
                    }
 
                   ]
 
                },
 
                 {
 
                  "Имя": "ASYNC_PROCESSING",
 
                  "Значение": ""
 
                }
 
               ]
 
            }
 
 
             ]
 
             ]
 
           }
 
           }
Строка 562: Строка 349:
 
     ]
 
     ]
 
   }
 
   }
}
 
 
</source>
 
</source>
 
</div>
 
</div>
 
</div>
 
</div>
 
+
==EXCEL==
 
+
Массив настройки для выгрузок в EXCEL. Структура:
 
+
* MAPPING_REPORT - Массив настроек для выгрузки в excel в разделах "Полученные", "Сопоставленные", в окне сопоставления. Структура:
 
+
** FIELDS  - набор полей которые выгружаются в excel. Структура:
 
+
*** [Имя] - Имя поля
 
+
*** [Значение] - Описание поля
 
+
<div style="border: 1px dashed;">
[[Категория:SAPPER]]
+
Пример настроек
[[Категория:SAP]]
+
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 +
<br>
 +
<source lang=JSON>
 +
{
 +
  "EXCEL": {
 +
  "Значение": [
 +
{
 +
"Имя": "MAPPING_REPORT",
 +
"Тип": "List",
 +
"Значение": [
 +
{
 +
"Имя": "FIELDS",
 +
"Тип": "List",
 +
"Значение": [
 +
{
 +
"Имя": "DOC_NAME_SBIS",
 +
"Значение": "Имя документа СБИС"
 +
},
 +
{
 +
"Имя": "DOC_NAME_SAP",
 +
"Значение": "Имя документа SAP"
 +
},
 +
{
 +
"Имя": "DATE_SAP",
 +
"Значение": "Дата документа СБИС"
 +
},
 +
{
 +
"Имя": "DATE_SBIS",
 +
"Значение": "Дата документа СБИС"
 +
},
 +
{
 +
"Имя": "NUMBER_SBIS",
 +
"Значение": "Номер документа СБИС"
 +
},
 +
{
 +
"Имя": "NUMBER_SAP",
 +
"Значение": "Номер документа SAP"
 +
},
 +
{
 +
"Имя": "SYSTEM_NUMBER_SAP",
 +
"Значение": "Системный номер документа SAP"
 +
},
 +
{
 +
"Имя": "SUM_SBIS",
 +
"Значение": "Сумма документа СБИС"
 +
},
 +
{
 +
"Имя": "SUM_SAP",
 +
"Значение": "Сумма документа SAP"
 +
},
 +
{
 +
"Имя": "DELTA_SUM",
 +
"Значение": "Дельта"
 +
},
 +
{
 +
"Имя": "PARTNER_SBIS",
 +
"Значение": "Контрагент по документу СБИС"
 +
},
 +
{
 +
"Имя": "PARTNER_ID_SBIS",
 +
"Значение": "Идентификатор контрагента по документу СБИС"
 +
},
 +
{
 +
"Имя": "PARTNER_INN_SBIS",
 +
"Значение": "ИНН"
 +
},
 +
{
 +
"Имя": "PARTNER_KPP_SBIS",
 +
"Значение": "КПП"
 +
},
 +
{
 +
"Имя": "PARTNER_SAP",
 +
"Значение": "Контрагент по документу SAP"
 +
},
 +
{
 +
"Имя": "PARTNER_ID_SAP",
 +
"Значение": "Идентификатор контрагента по документу SAP"
 +
},
 +
{
 +
"Имя": "PARTNER_INN_SAP",
 +
"Значение": "ИНН"
 +
},
 +
{
 +
"Имя": "PARTNER_KPP_SAP",
 +
"Значение": "КПП"
 +
},
 +
{
 +
"Имя": "ORG_SBIS",
 +
"Значение": "Наша организация по документу СБИС"
 +
},
 +
{
 +
"Имя": "ORG_ID_SBIS",
 +
"Значение": "Идентификатор нашей организации по документу СБИС"
 +
},
 +
{
 +
"Имя": "ORG_INN_SBIS",
 +
"Значение": "ИНН"
 +
},
 +
{
 +
"Имя": "ORG_KPP_SBIS",
 +
"Значение": "КПП"
 +
},
 +
{
 +
"Имя": "ORG_SAP",
 +
"Значение": "Наша организация по документу SAP"
 +
},
 +
{
 +
"Имя": "ORG_ID_SAP",
 +
"Значение": "Идентификатор нашей организации по документу SAP"
 +
},
 +
{
 +
"Имя": "ORG_INN_SAP",
 +
"Значение": "ИНН"
 +
},
 +
{
 +
"Имя": "ORG_KPP_SAP",
 +
"Значение": "КПП"
 +
},
 +
{
 +
"Имя": "RESPONSIBLE_SBIS",
 +
"Значение": "Ответственный по документу СБИС"
 +
},
 +
{
 +
"Имя": "RESPONSIBLE_ID_SBIS",
 +
"Значение": "Идентификатор ответственного по документу СБИС"
 +
},
 +
{
 +
"Имя": "RESPONSIBLE_SAP",
 +
"Значение": "Ответственный по документу SAP"
 +
},
 +
{
 +
"Имя": "RESPONSIBLE_ID_SAP",
 +
"Значение": "Идентификатор ответственного по документу SAP"
 +
}
 +
]
 +
}
 +
]
 +
}
 +
]
 +
  }
 +
}
 +
</source></div></div>
 +
==PARTNER_SETTINGS==
 +
Массив настройки для контрагента:
 +
Структура:
 +
* DEFINE - тип выбора контрагента для сопоставления. Используемые значения:
 +
** DOCUMENT  - берем контрагента из документа(пакета)
 +
** ATTACHMENT - берем контрагента из вложения
 +
** AGENT      - определяем контрагента по логике: если ИНН партнера документа и вложения отличаются, то берем из документа, иначе из вложения
 +
<div style="border: 1px dashed;">
 +
Пример настроек
 +
<div class="mw-collapsible mw-collapsed" style="overflow: hidden;">
 +
<br>
 +
<source lang=JSON>
 +
{
 +
  "PARTNER_SETTINGS": {
 +
    "Значение": [
 +
{
 +
"Имя": "DEFINE",
 +
"Значение": "DOCUMENT"
 +
}
 +
    ]
 +
  }
 +
}
 +
</source></div></div>

Текущая версия на 09:12, 30 июня 2022


SBIS

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

Структура:

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

Пример структуры раздела настроек SBIS


{
  "EXCHANGE_CLASS": {
    "Значение": "/SBIS/CL_EXCHANGE_SDK" //имя класса обмена, доступны варианты /SBIS/CL_EXCHANGE_EXTSDK, /SBIS/CL_EXCHANGE_SDK, /SBIS/CL_EXCHANGE_FILE
  },
  "FILTER_FM_NAME": {
    "Значение": "/SBIS/FM_FILTER_SCREEN_301", // имя FM реализующего экран фильтра по умолчанию
    "Подтип": "Parameter"
  },
  "ASYNC_GROUP_SERVER": {
    "Значение": "" // название группы серверов для асинхронного запуска
  },
  "DOC_TYPE": {
    "Значение": []
  },
  "NDS_CODE_INCOMING": {
    "Значение": []
  },
  "CONVERT_XSLT_NAME_TO_FIO_TYPE": {
    "Значение": []
  },
  "SBIS_ROBOT": {
    "Значение": []
  },
  "ACCORDION": {
    "Тип": "List",
    "Значение": []
  }
}

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", //транзакция просмотра
            "Значение": [
              {
                
                "Имя": "BES", - поле селекционного экрана транзакции ME23N
                "Значение": "BELNR" - поле S_API2_PACKET 
              }
            ]
          }
        ]
      }
    ]
  }

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

  • IC (ME23N)- Заказ
  • IJ (/SBIS/MIGO_DIALOG) - Накладная
  • IM (MIR4) - Счет-фактура

NDS_CODE

Соответствие ставок НДС ФНС, значению ставки НДС SAP. Содержит массив значений следующего вида:

  • [Ставка НДС ФНС]
  • [Направление обмена] - INBOUND\OUTBOUND (входящий\исходящий НДС), в данный момент используется только INBOUND
  • [Значение ставки НДС SAP]

Пример NDS_CODE для ставки НДС 18%


{
  "NDS_CODE": {
    "Значение": [
      {
        "Имя": "18", //вариант обозначения ставки НДС
        "Тип": "INBOUND", //направление обмена INBOUND\OUTBOUND
        "Значение": "PC" //код ставки НДС в SAP
      },
      {
        "Имя": "18%",
        "Тип": "INBOUND",
        "Значение": "PC"
      }
    ]  
}

CONVERT_XSLT_NAME_TO_FIO_TYPE

Параметры представления названия субъекта предпринимательской деятельности физ лиц (ЧП, ПБЮЛ и тп). Используется для корректного отображения ФИО субъекта деятельности, если в ФИО хранится название предпринимательской деятельности, к примеру, "ИП Иванов Иван Иванович". Для преобразования используется метод класса /SBIS/CL_CORE->CONVERT_XSLT_NAME_TO_FIO

Структура параметра:

  • [имя определения]
  • [тип определения]
  • [значение]

Пример CONVERT_XSLT_NAME_TO_FIO_TYPE со списком возможных значений


{
"CONVERT_XSLT_NAME_TO_FIO_TYPE": {
    "Значение": [
      {
        "Имя": "TERMS",
        "Тип": "String",
        "Значение": "ип,чп,индивидуальный предприниматель,адвокат,нотариус,предприниматель без образования юридического лица,пбоюл,предприниматель"
      }
    ]
  }
}

SBIS_ROBOT

Раздел настройки для автоматической отправки и получения статусов, содержит массив значений следующей структуры:

  • [имя вызываемой программы]
  • [вариант]

Пример SBIS_ROBOT для настройки автоматической отправки документов с фильтром по варианту SALES


{
  "SBIS_ROBOT": {
    "Значение": [
      {
        "Имя": "/SBIS/PR_SEND_ALL_SDK",
        "Значение": "SALES"
      }
    ]
  }
}

Подробнее о функционале по ссылке.

ACCORDION

Меню (аккордеон) в SBIS SAPPER динамический.

Аккордеон

Содержимое меню является двухуровневым иерархическим списком.

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

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

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

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

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

Пример аккордеона с папками Полученные, Отправленные, Ответы контрагентов, Продажи с пунктом Реализация Товаров


{
"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_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"
                  },
                  {
                    "Имя": "ASYNC_PROCESSING",
                    "Значение": ""
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }

EXCEL

Массив настройки для выгрузок в EXCEL. Структура:

  • MAPPING_REPORT - Массив настроек для выгрузки в excel в разделах "Полученные", "Сопоставленные", в окне сопоставления. Структура:
    • FIELDS - набор полей которые выгружаются в excel. Структура:
      • [Имя] - Имя поля
      • [Значение] - Описание поля

Пример настроек


{
  "EXCEL": {
  "Значение": [
		{
			"Имя": "MAPPING_REPORT",
			"Тип": "List",
			"Значение": [
				{
					"Имя": "FIELDS",
					"Тип": "List",
					"Значение": [
						{
							"Имя": "DOC_NAME_SBIS",
							"Значение": "Имя документа СБИС"
						},
						{
							"Имя": "DOC_NAME_SAP",
							"Значение": "Имя документа SAP"
						},
						{
							"Имя": "DATE_SAP",
							"Значение": "Дата документа СБИС"
						},
						{
							"Имя": "DATE_SBIS",
							"Значение": "Дата документа СБИС"
						},
						{
							"Имя": "NUMBER_SBIS",
							"Значение": "Номер документа СБИС"
						},
						{
							"Имя": "NUMBER_SAP",
							"Значение": "Номер документа SAP"
						},
						{
							"Имя": "SYSTEM_NUMBER_SAP",
							"Значение": "Системный номер документа SAP"
						},
						{
							"Имя": "SUM_SBIS",
							"Значение": "Сумма документа СБИС"
						},
						{
							"Имя": "SUM_SAP",
							"Значение": "Сумма документа SAP"
						},
						{
							"Имя": "DELTA_SUM",
							"Значение": "Дельта"
						},
						{
							"Имя": "PARTNER_SBIS",
							"Значение": "Контрагент по документу СБИС"
						},
						{
							"Имя": "PARTNER_ID_SBIS",
							"Значение": "Идентификатор контрагента по документу СБИС"
						},
						{
							"Имя": "PARTNER_INN_SBIS",
							"Значение": "ИНН"
						},
						{
							"Имя": "PARTNER_KPP_SBIS",
							"Значение": "КПП"
						},
						{
							"Имя": "PARTNER_SAP",
							"Значение": "Контрагент по документу SAP"
						},
						{
							"Имя": "PARTNER_ID_SAP",
							"Значение": "Идентификатор контрагента по документу SAP"
						},
						{
							"Имя": "PARTNER_INN_SAP",
							"Значение": "ИНН"
						},
						{
							"Имя": "PARTNER_KPP_SAP",
							"Значение": "КПП"
						},
						{
							"Имя": "ORG_SBIS",
							"Значение": "Наша организация по документу СБИС"
						},
						{
							"Имя": "ORG_ID_SBIS",
							"Значение": "Идентификатор нашей организации по документу СБИС"
						},
						{
							"Имя": "ORG_INN_SBIS",
							"Значение": "ИНН"
						},
						{
							"Имя": "ORG_KPP_SBIS",
							"Значение": "КПП"
						},
						{
							"Имя": "ORG_SAP",
							"Значение": "Наша организация по документу SAP"
						},
						{
							"Имя": "ORG_ID_SAP",
							"Значение": "Идентификатор нашей организации по документу SAP"
						},
						{
							"Имя": "ORG_INN_SAP",
							"Значение": "ИНН"
						},
						{
							"Имя": "ORG_KPP_SAP",
							"Значение": "КПП"
						},
						{
							"Имя": "RESPONSIBLE_SBIS",
							"Значение": "Ответственный по документу СБИС"
						},
						{
							"Имя": "RESPONSIBLE_ID_SBIS",
							"Значение": "Идентификатор ответственного по документу СБИС"
						},
						{
							"Имя": "RESPONSIBLE_SAP",
							"Значение": "Ответственный по документу SAP"
						},
						{
							"Имя": "RESPONSIBLE_ID_SAP",
							"Значение": "Идентификатор ответственного по документу SAP"
						}
					]
				}
			]
		}
	]
  }
}

PARTNER_SETTINGS

Массив настройки для контрагента: Структура:

  • DEFINE - тип выбора контрагента для сопоставления. Используемые значения:
    • DOCUMENT - берем контрагента из документа(пакета)
    • ATTACHMENT - берем контрагента из вложения
    • AGENT - определяем контрагента по логике: если ИНН партнера документа и вложения отличаются, то берем из документа, иначе из вложения

Пример настроек


{
  "PARTNER_SETTINGS": {
    "Значение": [
	{
		"Имя": "DEFINE",
		"Значение": "DOCUMENT"
	}
    ]
  }
}