Integration Guide for Banks
[UKR] Посібник з інтеграції для банку
[UKR] Посібник з інтеграції для банку
  • General
    • 💰Загальний опис
      • Перекази між цифровізованими сутностями
        • Варіант 1. Швидке створення/видалення ідентифікаторів
        • Варіант 2. Стандартне створення/видалення ідентифікаторів (опціонально)
      • Історія версій
      • Журнал змін API
      • Глосарій
    • 🌐Загальні вимоги
    • 👉Базовий варіант впровадження
    • 📅План інтеграції
      • План інтеграції (Бізнес)
      • План інтеграції (Технічна команда)
      • Мультипідпис
    • ❗Повідомлення про помилки
  • 🛠️API МЕТОДИ
    • Автентифікація
      • Авторизація через JWT
      • Служба Аутентифікації Банку
      • JWT формат
    • Працівники
      • Призначити роль працівнику
      • Управління ролями
    • Клієнти
      • Сегмент
    • Цифровізовані сутності
    • Ідентифікатори
    • Трансфер (перерозподілення ідентифікаторів)
      • Мультипідпис для трансферів
      • Зворотні виклики
      • Категорія
    • Ліміти
    • Реконсиляція
    • [необов’язково] Відділення
      • Відділення (доступ)
      • Як додати працівника до віддлення (філії)
      • Фільтр по відділенню
      • Трансфери (Відділення)
Powered by GitBook
On this page
  1. API МЕТОДИ

Реконсиляція

PreviousЛімітиNext[необов’язково] Відділення

Last updated 1 year ago

У внутрішніх трансферах узгодження означає систематичний процес співставлення та порівняння операцій між різними Контрагентами або фінансовими установами для забезпечення точності та послідовності зареєстрованих даних. Цей процес включає виявлення розбіжностей, помилок або відсутньої інформації в записах транзакцій, а потім проведедння коригувальних дій для узгодження записів і рахунків, що в кінцевому підсумку забезпечує плавний потік коштів і підтримує фінансову цілісність між учасниками.

Статусна модель

Отримати узгоджувальну таблицю

Можете побачити всі звірки по потрібному Контрагенту, також можна фільтрувати таблицю за допомогою параметрів.

Параметр counterparty_role приймає такі значення:

  • боржник

  • кредитор

Response example

Example of response with filter counterparty = creditor, status = calculated, order = created_at:

{
    "recons": [
        {
            "guid": "ab5767d9-1db8-445c-b48a-d1633ba85cda",
            "created_at": "2023-08-08T12:09:39.089306Z",
            "updated_at": "2023-08-08T12:09:42.986984Z",
            "start_date": "2023-08-08T00:00:00Z",
            "end_date": "2023-08-09T00:00:00Z",
            "overdue_days": 0,
            "status": "calculated",
            "creditor": {
                "guid": "7a0c6eef-b8f9-4049-affc-9c995a1bf993",
                "name": "Chok 1",
                "is_blocked": false,
                "participant_type": "",
                "central_reserve": 0,
                "balance_before": 0,
                "balance_after": 0
            },
            "debtor": {
                "guid": "01aec264-658c-4246-8afd-486f8878c3ee",
                "name": "",
                "is_blocked": false,
                "participant_type": "",
                "central_reserve": 0,
                "balance_before": 0,
                "balance_after": 0
            },
            "asset": {
                "asset_guid": "7170180d-11f3-4f92-942b-34a9ad4394d3",
                "asset_code": "UAH",
                "issuer": "GBWUVXEBXYAJITVDD6PEZAY4SBBEAOQFVPFJC4PKTWBNIZXSTSAH7LML"
            },
            "calculations": {
                "total_in": 10,
                "total_out": 40,
                "saldo": -30,
                "amount_reserve_account": 0,
                "reserve_acc_currency": ""
            }
        }
    ],
    "total": 1
}

Отримання Учасників-Контрагентів

Для отримання учасників використовується наступний метод:

Оновлення статусу узгодження

Виконуючи звірку, перш за все, необхідно отримати таблицю звірок для Контрагента зі статусом фільтра = розраховано, щоб побачити звірки, які необхідно підтвердити. Якщо звіока підтверджується, використовується наступний метод з parameterstatus = підтверджено. Статус узгодження змінюється.

🛠️

Get counterparty's participants

get

Get counterparty's participants

Path parameters
counterparty_guidstringRequired

Counterparty GUID of bank

Query parameters
counterparty_rolestring · enumRequired

Counterparty role

Possible values:
start_dateintegerOptional

Start date

end_dateintegerOptional

End date

asset_guidstringOptional

asset's guid

limitintegerOptional

Limit

offsetintegerOptional

Offset

orderstring · enumOptional

list order (string)

Possible values:
Responses
200
OK
application/json
400
json with error msg
application/json
get
GET /api/v1/counterparty/{counterparty_guid}/recons/participants?counterparty_role=creditor HTTP/1.1
Host: your_host
Accept: */*
{
  "participants": [
    {
      "balance_after": 1,
      "balance_before": 1,
      "central_reserve": 1,
      "guid": "text",
      "is_blocked": true,
      "name": "text",
      "saldo": 1,
      "total_in": 1,
      "total_out": 1
    }
  ],
  "total": 1
}
  • Статусна модель
  • Отримати узгоджувальну таблицю
  • GETGet recons's table for bank.
  • Отримання Учасників-Контрагентів
  • GETGet counterparty's participants
  • Оновлення статусу узгодження

Get recons's table for bank.

get

Get recons's table for bank.

Path parameters
counterparty_guidstringRequired

Counterparty GUID

Query parameters
counterparty_rolestring · enumRequired

Counterparty's role in recon

Possible values:
participant_counterparty_guidstringOptional

Participant's counterparty guid. If counterparty_role is one_of, then this param is ignored

guidstring[]Optional

recon's GUIDs

start_dateintegerOptional

Start date

end_dateintegerOptional

End date

asset_guidstringOptional

asset's guid

limitintegerOptional

Limit

offsetintegerOptional

Offset

orderstring · enumOptional

list order (string)

Possible values:
Responses
200
OK
application/json
400
json with error msg
application/json
get
GET /api/v1/counterparty/{counterparty_guid}/recons?counterparty_role=creditor HTTP/1.1
Host: your_host
Accept: */*
{
  "recons": [
    {
      "asset": {
        "asset_code": "text",
        "asset_guid": "text",
        "issuer": "text"
      },
      "calculations": {
        "amount_reserve_account": 1,
        "reserve_acc_currency": "text",
        "saldo": 1,
        "total_in": 1,
        "total_out": 1
      },
      "created_at": "text",
      "creditor": {
        "balance_after": 1,
        "balance_before": 1,
        "central_reserve": 1,
        "guid": "text",
        "is_blocked": true,
        "name": "text",
        "saldo": 1,
        "total_in": 1,
        "total_out": 1
      },
      "debtor": {
        "balance_after": 1,
        "balance_before": 1,
        "central_reserve": 1,
        "guid": "text",
        "is_blocked": true,
        "name": "text",
        "saldo": 1,
        "total_in": 1,
        "total_out": 1
      },
      "end_date": "text",
      "guid": "text",
      "overdue_days": 1,
      "start_date": "text",
      "status": "awaiting_payment",
      "updated_at": "text"
    }
  ],
  "total": 1
}