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 - аккордеона
• 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"
	}
    ]
  }
}