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

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

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

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

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

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

totalintegerOptional

400

json with error msg

application/json

get

/counterparty/{counterparty_guid}/recons

HTTPcURLJavaScriptPython

GET /api/v1/counterparty/{counterparty_guid}/recons?counterparty_role=creditor HTTP/1.1
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
}

Параметр 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
}

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

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

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

totalintegerOptional

400

json with error msg

application/json

get

/counterparty/{counterparty_guid}/recons/participants

HTTPcURLJavaScriptPython

GET /api/v1/counterparty/{counterparty_guid}/recons/participants?counterparty_role=creditor HTTP/1.1
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
}

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

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