Посилання на Swagger
https://api.spending.gov.ua/api/swagger-ui.html#/Transactions
Список доступних енд-поінтів
Метод | Енд-поінт | Опис |
---|---|---|
Get | https://api.spending.gov.ua/api/v2/api/transactions/ping | Перевірка доступності сервісу |
Get | https://api.spending.gov.ua/api/v2/api/transactions/lastload | Отримати дату останнього завантаження |
Get | https://api.spending.gov.ua/api/v2/api/transactions/?{params} | Отримати Реєстр трансакцій |
Структура трансакції
Поле | Тип даних | Опис | Приклад | JSON відповідь | |
---|---|---|---|---|---|
1 | id | Ціле число | унікальний ідентифікатор трансакції в Системі | 256103375 | { |
2 | doc_vob | Текст | код розрахункового документа | "1" | |
3 | doc_vob_name | Текст | назва коду розрахункового документа | "платіжне доручення" | |
4 | doc_number | Текст | номер розрахункового документа, до 35 знаків | "8139/903" | |
5 | doc_date | Текст | дата складання розрахункового документа у форматі РРРР-ММ-ДД | "2023-05-10" | |
6 | doc_v_date | Текст | дата валютування документа у форматі РРРР-ММ-ДД | "2023-05-10" | |
7 | trans_date | Текст | дата оплати у форматі РРРР-ММ-ДД | "2023-05-10" | |
8 | amount | Число з плаваючою крапкою | сума оплати в гривнях з копійками, роздільник крапка | 19415413165.34 | |
9 | amount_cop | Ціле число | сума оплати в копійках | 1941541316534 | |
10 | currency | Текст | літеральний код валюти (довідник) | "UAH" | |
11 | payer_edrpou | Текст | код ЄДРПОУ платника, 8 знаків | "37567646" | |
12 | payer_name | Текст | найменування платника, до 140 знаків | "Виділення асигнувань по ЗФ" | |
13 | payer_account | Текст | рахунок платника (IBAN), до 29 знаків | "UA618201720000042314000000000" | |
14 | payer_mfo | Текст | код банку платника (опціонально), 6 знаків | "820172" | |
15 | payer_bank | Текст | найменування банку платника (опціонально), до 140 знаків | "Державна казначейська служба України" | |
16 | payer_edrpou_fact | Текст | код ЄДРПОУ фактичного платника, 8 знаків | "37567646" | |
17 | payer_name_fact | Текст | найменування фактичного платника, до 140 знаків | "Державна казначейська служба України" | |
18 | recipt_edrpou | Текст | код ЄДРПОУ отримувача, 8 або 10 знаків | для юридичної особи: "00013480" для фізичної особи: "хххххххххх" | |
19 | recipt_name | Текст | найменування отримувача, до 140 знаків | "Мінфін" | |
20 | recipt_account | Текст | рахунок отримувача (IBAN), до 29 знаків | "UA608201720343340023000000141" | |
21 | recipt_mfo | Текст | код банку отримувача (опціонально), 6 знаків | "820172" | |
22 | recipt_bank | Текст | найменування банку отримувача (опціонально), до 140 знаків | "Державна казначейська служба України" | |
23 | recipt_edrpou_fact | Текст | код ЄДРПОУ фактичного отримувача, 8 або 10 знаків | для юридичної особи: "00013480" для фізичної особи: "хххххххххх" | |
24 | recipt_name_fact | Текст | найменування фактичного отримувача, до 140 знаків | "Мінфін" | |
25 | payment_details | Текст | призначення платежу, до 420 знаків | "Спл.дох.по ОВДП.Розп.МФУ вчд 27.04.xxxx Nxxxx" | |
26 | doc_add_attr | Текст | додатковий реквізит, до 80 знаків (опціонально) | null | |
27 | region_id | Ціле число | код регіону (довідник) | 28 | |
28 | payment_type | Текст | тип платіжної системи | "nsep" | |
29 | payment_data | Текст | додаткові дані для типу платіжної системи (опціонально) | null | |
30 | source_id | Ціле число | унікальний ідентифікатор джерела даних в Системі | 2 | |
31 | source_name | Текст | найменування джерела даних, до 140 знаків | "ДКСУ" | |
32 | kekv | Ціле число | код економічної класифікації видатків, 4 знаки (довідник) | 2410 | |
33 | kpk | Текст | код програмної класифікації видатків та кредитування, до 7 знаків (довідник ДБ, довідник МБ) | "3511350" | |
34 | contractId | Текст | унікальний ідентифікатор договору про закупівлю в системі Prozorro, 32 знаки | "64e949275b3749d5b6b82917b01249eb" | |
35 | contractNumber | Текст | унікальний ідентифікатор закупівлі в системі Prozorro, 22 знаки | "UA-2020-09-10-005249-b" | |
36 | budgetCode | Текст | код бюджету, 10 знаків (довідник) | "9900000000" | |
37 | system_key | Текст | Внутрішній номер документа | "149246190" | |
38 | system_key_ff | Текст | Ідентифікатор бюджетного фінансового зобов’язання | "77914981" |
Параметри запиту на отримання Реєстру трансакцій за 1 день
https://api.spending.gov.ua/api/v2/api/transactions/?{params}
отримати файлом у форматі .CSV
curl -X GET "https://api.spending.gov.ua/api/v2/api/transactions/?startdate=2023-06-10&enddate=2023-06-10" -H "accept: application/octet-stream"
Параметр | Тип даних | Обов’язковість | Опис | Приклад |
---|---|---|---|---|
startdate | Текст | Так | дата оплати у форматі РРРР-ММ-ДД, має дорівнювати endate | https://api.spending.gov.ua/api/v2/api/transactions/?startdate=2023-06-10&enddate=2023-06-10 |
enddate | Текст | Так | дата оплати у форматі РРРР-ММ-ДД, має дорівнювати startdate |
Параметри запиту на отримання Реєстру трансакцій за період
https://api.spending.gov.ua/api/v2/api/transactions/?{params}
отримати файлом у форматі .CSV
curl -X GET "https://api.spending.gov.ua/api/v2/api/transactions/?{params}" -H "accept: application/octet-stream"
Параметр | Тип даних | Обов’язковість | Опис | Приклад |
---|---|---|---|---|
startdate | Текст | Так | дата оплати у форматі РРРР-ММ-ДД, період не більше 92 днів | https://api.spending.gov.ua/api/v2/api/transactions/? https://api.spending.gov.ua/api/v2/api/transactions/? https://api.spending.gov.ua/api/v2/api/transactions/? https://api.spending.gov.ua/api/v2/api/transactions/? |
enddate | Текст | Так | дата оплати у форматі РРРР-ММ-ДД, період не більше 92 днів | |
payers_edrpous | Текст | Так, якщо startdate != enddate та recipt_edrpous == NULL | код ЄДРПОУ платника, 8 знаків, масив значень | |
recipt_edrpous | Текст | Так, якщо startdate != enddate та payers_edrpous == NULL | код ЄДРПОУ отримувача, 8 знаків, масив значень | |
sumFrom | Число з плаваючою крапкою | Ні | сума оплати Від в гривнях з копійками, роздільник крапка | |
sumTo | Число з плаваючою крапкою | Ні | сума оплати До в гривнях з копійками, роздільник крапка | |
regions | Ціле число | Ні | код регіону (довідник), масив елементів |