Pool_Management Settings: TIN/USREOU pools monitored by triggers
URL https://secure.ubki.ua/m2/
Test URL https://test.ubki.ua/m2/
List of monitoring pools
GET /pool
Request for receiving a list of all generated pools for the organization (if the name is empty), and searching by the pool name. The request must be submitted in the GET method body. Request https://secure.ubki.ua/m2/pool?{name} Parameters Parameter Name Format name Name of the pool to search for integer Response Parameter Name Format PoolBriefDto poolID Pool number integer poolName Pool name string
maxLength: 150
minLength: 3 createDate Pool generation date string($date-time) poolState Pool status string [ created, active, inactive, finished, invalid ] workPeriod Operation frequency string [ daily, weekly, monthly ] workTime Operation period, months integer workCount Number of runs integer doneTotalCount Number of activations integer workEndDate Operation end date string($date) [YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31) editDate Date of revision string($date-time)
[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31), HH - hour (00 - 23), MM - minute (00 - 59), SS - second (00-59) editUser UserId of the editing user integer firstStartDate First launch date string($date) [YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31) lastStartDate Last launch date string($date) [YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31) lastInnCount Number of TINs integer lastDoneCount Number of activations during the last run integer lastWorkState Current work status integer [ new, closed, done, wip, failed ]
Pool generation
POST/pool
Pool generation request ("poolState": "created") The request must be submitted in the POST method body. Request https://secure.ubki.ua/m2/pool No parameters
Request body {
"poolName": "Pool_test ",
"workPeriod": "daily",
"workEndDate": "2022-02-01",
"inns": [
"33546706"
],
"triggers": [
1
]
} Response body
{
"poolID": 12,
"poolName": "Pool_test ",
"createDate": "2022-02-01 10:58:16",
"poolState": "created",
"workPeriod": "daily",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": null,
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706"
],
"triggers": [
1
]
} Parameter Name Format PoolDto poolID Pool number integer poolName Pool name string
maxLength: 150
minLength: 3 createDate Pool generation date string($date-time)
[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31), HH - hour (00 - 23), MM - minute (00 - 59), SS - second (00-59) poolState Pool status string [ created, active, inactive, finished, invalid ] workPeriod Operation frequency string
[ daily, weekly, monthly ] workTime Operation period, months integer workCount Number of runs integer doneTotalCount Number of activations integer workEndDate Operation end date string($date) [YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31) editDate Date of revision string($date-time)
[YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31), HH - hour (00 - 23), MM - minute (00 - 59), SS - second (00-59) editUser UserId of the editing user integer firstStartDate First launch date string($date) [YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31) lastStartDate Last launch date string($date) [YYYY-MM-DD], YYYY – year (1920–2099), MM – month (01–12), DD – day (01–31) lastInnCount Number of TINs integer lastDoneCount Number of activations during the last run integer lastWorkState Current work status string [ new, closed, done, wip, failed ] inns List of TINs monitored by the pool string triggers List of triggers monitored by the pool integer
Pool parameters
Pool parameters reception request.
The request must be submitted in the GET method body. Request https://secure.ubki.ua/m2/pool/{poolID} Parameters Parameter Name Format poolID Pool number integer Response body
{
"poolID": 12,
"poolName": "Pool_test ",
"createDate": "2022-02-01 10:58:16",
"poolState": "created",
"workPeriod": "daily",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": null,
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706"
],
"triggers": [
1
]
} Response description
Edit pool
POST /pool/{poolId}
Pool editing request (change: name, operation frequency, operation period, list of TINs/USREOUs, triggers) without stopping the pool.
The request must be submitted in the POST method body. Request https://secure.ubki.ua/m2/{poolID}
Parameters Parameter Name Format poolID Pool number integer
Request body
New pool data (request contains the data to be changed)
{
"poolName": "Pool_test",
"workPeriod": "weekly",
"workEndDate": "2022-02-01",
"inns": [
"33546706",
"40075815"
],
"triggers": [
2
]
}
Response body {
"poolID": 12,
"poolName": "Pool_test",
"createDate": "2022-02-01 10:58:16",
"poolState": "created",
"workPeriod": "weekly",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": "2022-02-01 12:12:31",
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706",
"40075815"
],
"triggers": [
2
]
} Response description
Pool editing: adding TINs/USREOUs
Request to add the TIN/USREOU to the pool, without stopping it. The request must be submitted in the POST method body.
Request https://secure.ubki.ua/m2/pool/{poolID}/add_inns
Parameters Parameter Name Format poolID Pool number integer Request body New pool inns ( request contains the data to be added)
{
"inns": [
"25522107","41078439","40456297"
]
} Response body {
"poolID": 12,
"poolName": "Pool_test",
"createDate": "2022-02-01 10:58:16",
"poolState": "created",
"workPeriod": "weekly",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": "2022-02-01 12:12:31",
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706",
"40075815",
"25522107",
"41078439",
"40456297"
],
"triggers": [
2
]
} Response description
Pool editing: deleting TINs/USREOUs
Request to delete the TIN/USREOU from the pool, without stopping it. The request must be submitted in the POST method body. Request https://secure.ubki.ua/m2/pool/{poolID}/rm_inns
Parameters Parameter Name Format poolID Pool number integer Request body Remove pool inns ( request contains the data to be deleted)
{
"inns": [
"41078439","40456297"
]
} Response body {
"poolID": 12,
"poolName": "Pool_test",
"createDate": "2022-02-01 10:58:16",
"poolState": "created",
"workPeriod": "weekly",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": "2022-02-01 12:12:31",
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706",
"40075815",
"25522107"
],
"triggers": [
2
]
} Response description
Pool activation
Pool activation request ("poolState": "active") The request must be submitted in the POST method body. Request https://secure.ubki.ua/m2/pool/{poolID}/activate
Parameters Parameter Name Format poolID Pool number integer Response body {
"poolID": 12,
"poolName": "Pool_test",
"createDate": "2022-02-01 10:58:16",
"poolState": "active",
"workPeriod": "weekly",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": "2022-02-01 12:30:21",
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706",
"40075815",
"25522107"
],
"triggers": [
2
]
} Response description
Disabling the pool
Pool deactivation request ("poolState": "inactive") The request must be submitted in the POST method body. Request https://secure.ubki.ua/m2/pool/{poolID}/deactivate Parameters Parameter Name Format poolID Pool number integer Response body
{
"poolID": 12,
"poolName": "Pool_test",
"createDate": "2022-02-01 10:58:16",
"poolState": "inactive",
"workPeriod": "weekly",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": "2022-02-01 13:47:05",
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706",
"40075815",
"25522107"
],
"triggers": [
2
]
} Response description
Copying the pool
Request to create a copy of the pool with the same parameters. The request must be submitted in the POST method body. Request https://secure.ubki.ua/m2/pool/{poolID}/duplicate Parameters Parameter Name Format poolID Pool number integer Response body
{
"poolID": 13,
"poolName": "Pool_test",
"createDate": "2022-02-01 13:49:14",
"poolState": "created",
"workPeriod": "weekly",
"workTime": 0,
"workCount": 0,
"doneTotalCount": 0,
"workEndDate": "2022-02-01",
"editDate": null,
"editUser": null,
"firstStartDate": "2022-02-01",
"lastStartDate": null,
"lastInnCount": 0,
"lastDoneCount": 0,
"lastWorkState": "new",
"inns": [
"33546706",
"40075815",
"25522107"
],
"triggers": [
2
]
} Response description
Pool deletion
Request to delete the pool (possible if there is no activations in the pool) The request must be submitted in the POST method body. Request https://secure.ubki.ua/m2/pool/{poolID}/delete Parameters Parameter Name Format poolID Pool number integer