Додавання, Редагування та Видалення платежів у Finmap через API

ㅤЧас читання матеріалу – 8 хв
ㅤFinmap
ㅤ

Зміст статті

Додавання платежів через API ➕

ㅤ
Через API є можливість додати наступні платежі:

Витрати
Доходи
Перекази

ㅤ
ㅤ
Для того, щоб додати платіж через API необхідно:

ㅤ

1. Перейти в API документацію https://api.finmap.online/

2. Авторизуватися за допомогою ключа API

3. Обрати тип платежу, який потрібно додати, до цих типів входять:

operations/income
operations/expense
operations/transfer

ㅤ

4. Натискаємо на параметр POST

5. Вказати необхідні дані до платежу

6. Натискаємо виконати запит

ㅤ
ㅤ✅ В результаті в сервісі Finmap буде додано новий платіж
ㅤ

Параметри, які можуть міститись в операції:
ㅤ

“date” – Дата проведення платежу
“amount” – Сума платежу
“comment” – Коментар
“amountInCompanyCurrency” – Сума в валюті компанії (цей параметр корисний, якщо ви проводите операцію на рахунок, валюта якого відрізняється від валюти компанії)
“exchangeRate” – Валютний курс
“transactionSum – Сума платежу
“transactionCurrency” – Валюта проведення платежу
“transactionCurrencyRate” – Валютний курс
“dateOfPayment” – Дата нарахування платежу
“startDate” – Початок періоду нарахування платежу
“endDate” – Кінець періоду нарахування платежу
“accountToId” – ID рахунку
“categoryId” – ID категорії
“counterpartyId” – ID контрагенту
“projectId”– ID проєкту
“tagIds” – ID тегу (можна додавати одразу декілька ID тегів)
“externalId”: – ID операції (власноруч вказуєте id, щоб потім могли по цьому id редагувати, або видалити платіж)

ㅤㅤ
ㅤ
ㅤ❗ Для додавання платежу не обов’язково використовувати всі параметри.

ㅤ❗❗ Важливо: Наш сервіс працює в часовому поясі UTC 0, якщо вам потрібно вказати інший часовий пояс, тоді на допомогу прийде параметр offset.
Зверніть увагу, що параметр date необхідно вказувати в UNIX(мілісекунди) форматі.
Приклад “date”: 1717158515050
ㅤ

ㅤ
ㅤ

Редагування платежів через API ⚙️

ㅤ
Через API є можливість редагувати наступні платежі:

Витрати
Доходи
Перекази

ㅤ
Для того, щоб редагувати платіж через API необхідно:
ㅤㅤ

operations/income
operations/expense
operations/transfer

ㅤ

4. Натискаємо на параметр PATCH

5. Оберіть по якому типу будете редагувати платіж по operationID або externalID

ㅤ

6. Вкажіть необхідне ID

7. Вкажіть зміни які хочете зробити

8. Виконайте запит

ㅤ

✅ В результаті дані в операції будуть змінені. Ви можете змінювати не всі параметри, а лише ті, що вам потрібно, наприклад можна змінити лише дату (найчастіше зміну дати використовують, коли потрібно підтвердити майбутній платіж)
ㅤ
ㅤ