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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(SBIS_ROBOT)
(SBIS)
Строка 350: Строка 350:
 
</div>
 
</div>
 
</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>

Версия 08:47, 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 - аккордеона

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