.. meta::
   :description: /services/v2/rpt-engine API endpoint Payneteasy: загружает расширенные отчёты через движок отчётов с гибкими фильтрами и группировками.

.. _services_v2_rpt-engine:

/services/v2/rpt-engine
##############################################

.. role:: ex

.. role:: code

Введение
^^^^^^^^^^^^^^^^^^^^^^^^

| Пользовательский отчёт по транзакциям предоставляет возможность получить настраиваемую информацию о транзакциях с их статусами для проверки и дальнейшего анализа.
|
| Пользовательский отчёт по транзакциям инициируется посредством запроса :code:`HTTPS POST` с использованием указанных ниже :ref:`URL<services_transaction-report_url>` и :ref:`параметров<services_v2_rpt-engine_parameters>`. Для аутентификации используйте :ref:`HMAC-SHA1<HMAC-SHA1>`. Параметры отчёта передаются через JSON.

.. _services_v2_rpt-engine_url:

API URL
^^^^^^^^^^^^^^^^^^^^

.. note::
    | Путь API URL не должен быть задан фиксированным значением, т.к. он может быть изменён позднее.

.. list-table::
  :widths: 50, 50
  :header-rows: 1
  :class: longtable

  * - Интеграционная среда
    - Производственная среда
  * - :ex:`https://sandbox.payneteasy.ru/paynet-ui/services/v2/rpt-engine`
    - :ex:`https://gate.payneteasy.ru/paynet-ui/services/v2/rpt-engine`


.. _services_v2_rpt-engine_parameters:

Параметры запроса
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

| Каждый пользовательский отчёт имеет разные параметры тела JSON. Шаблоны JSON и поддерживаемые форматы требуемых пользовательских отчётов могут быть предоставлены менеджерами поддержки по запросу.

Описание: Request body example:

.. highlight:: text

::

    {
        "reportIdentifier": "exampleReport",
        "reportEncode": "UTF-8",
        "reportName": "example",
        "reportCsvDelimiter": ",",
        "reportFormat": "CSV",
        "configurationReportParameters": [],
        "inputReportParameters": [
            {
                "type": "INPUT_TEXT",
                "name": "example",
                "value": "example"
            }
        ],
        "outputReportParameters": [],
        "filters": {
            "gates": [],
            "companies": [],
            "projects": [],
            "endpoints": [],
            "merchants": [],
            "processors": [],
            "managers": [],
            "resellers": [],
            "currencies": []
        }
    }


Параметры ответа
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

| Каждый пользовательский отчёт имеет разные параметры тела ответа. Обычно он предоставляется в формате CSV или PDF.
|

.. note::
   Сформированный отчет имеет правильно сформированный формат (well-formed) CSV. В соответствии с поля |rfc_link|, содержащие переносы строк (CRLF, CR, LF), двойные кавычки и запятые заключаются в двойные кавычки.

.. |rfc_link| raw:: html

   <a href="https://datatracker.ietf.org/doc/html/rfc4180" rel="nofollow noopener noreferrer">RFC 4180</a>

Пример запроса
^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. highlight:: text

::

    POST /paynet-ui/services/v2/rpt-engine HTTP/1.1
    Host: gate.doc2.com
    User-Agent: curl/7.88.1
    Accept: */*
    Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="login",oauth_timestamp="1690553049",oauth_nonce="2lrRWDbfOoq",oauth_signature_method="HMAC-SHA1",oauth_signature="ZAi2xFUlh35DAzDYKnSbyUUGGIA%3D"
    Content-Type: application/json
    Content-Length: 417
    Connection: close

    {"reportIdentifier":"exampleReport","reportEncode":"UTF-8","reportName":"example","reportCsvDelimiter":",","reportFormat":"CSV","configurationReportParameters":[],"inputReportParameters":[{"type":"INPUT_TEXT","name":"example","value":"example"}],"outputReportParameters":[],"filters":{"gates":[],"companies":[],"projects":[],"endpoints":[],"merchants":[],"processors":[],"managers":[],"resellers":[],"currencies":[]}}

Пример успешного ответа
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. highlight:: text

::

    "Merchant_Name","Transaction_id","Merchant_OID","Created_date","Amount","Currency","Transaction_type","Order_description","Date_of_report"
    "TestMerchant3","6891747","902B4FF5","2023-07-27 16:37:21","90.000","USD","Sale","Order #293927","28.07.2023"

Пример неуспешного ответа
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. highlight:: text

::

    HTTP/1.1 200
    Server: server
    Date: Mon, 31 Jul 2023 09:49:07 GMT
    Content-Type: text/plain
    Content-Length: 46
    Connection: close
    Strict-Transport-Security: max-age=31536000

    You are not authorised to perform such request

Коллекция Postman
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. raw:: html
    :file: ../_static/Postman/Postman_rpt-engine.html

Конструктор запросов
^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. raw:: html
    :file: ../_static/examples/crpt_engine_debug.html