SAPPER SETTINGS - Общие

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 - аккордеона

Пример структуры раздела настроек 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",
                    "Значение": ""
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  }

PARTNER_SETTINGS

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

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

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

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