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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(SBIS)
(SBIS)
 
(не показаны 4 промежуточные версии 2 участников)
Строка 14: Строка 14:
 
*SBIS_ROBOT – настройки автоматической отправки и получения статусов
 
*SBIS_ROBOT – настройки автоматической отправки и получения статусов
 
*ACCORDION – настройки меню SAPPER - аккордеона
 
*ACCORDION – настройки меню SAPPER - аккордеона
 +
*EXCEL - массив настройки для выгрузок в EXCEL.
 +
*PARTNER_SETTINGS - массив настройки для контрагента.
  
 
<div style="border: 1px dashed;">
 
<div style="border: 1px dashed;">
Строка 159: Строка 161:
 
Раздел настройки для автоматической отправки и получения статусов, содержит массив значений следующей структуры:
 
Раздел настройки для автоматической отправки и получения статусов, содержит массив значений следующей структуры:
 
* [имя вызываемой программы]
 
* [имя вызываемой программы]
* [вариант] - возможно указание конкретного варианта, списка вариантов разделенного запятой и выбор всех вариантов значение "*"
+
* [вариант]
  
 
<div style="border: 1px dashed;">
 
<div style="border: 1px dashed;">
Строка 177: Строка 179:
 
}
 
}
 
</source></div></div>
 
</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==
 
==ACCORDION==
Строка 348: Строка 352:
 
</div>
 
</div>
 
</div>
 
</div>
 +
==EXCEL==
 +
Массив настройки для выгрузок в EXCEL. Структура:
 +
* MAPPING_REPORT - Массив настроек для выгрузки в excel в разделах "Полученные", "Сопоставленные", в окне сопоставления. Структура:
 +
** FIELDS  - набор полей которые выгружаются в excel. Структура:
 +
*** [Имя] - Имя поля
 +
*** [Значение] - Описание поля
 +
<div style="border: 1px dashed;">
 +
Пример настроек
 +
<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"
	}
    ]
  }
}