Робота з Сутностями Finmap через API: Додавання, Редагування чи Видалення контрагентів, категорій, проєктів і тегів


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


ㅤAPI Finmap надає можливість автоматизованого управління ключовими сутностями вашого фінансового обліку, такими як контрагенти, категорії, проекти та теги. Завдяки інтеграції з API, ви зможете ефективно додавати нові елементи, отримувати дані про існуючі сутності, редагувати їх або видаляти без необхідності ручного втручання.

ㅤУ цій статті ми розглянемо, як саме працювати з сутностями Finmap через API, а також покажемо приклади запитів для додавання, отримання, редагування та видалення даних.

Створення нової сутності за допомогою API ✔️


Створити можна наступні сутності:

  • tags
  • projects 
  • categories/income 
  • categories/expense 
  • customers 
  • investors
  • creditors 
  • debitors 
  • suppliers 
  • employees 
  • owners 



Для того, щоб створити нову сутність вам потрібно:


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

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

3. Обрати яку сутність хочете створити


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

5. Вказуємо назву сутності

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


✅ В результаті в сервісі Finmap буде додана нова сутність

Отримання даних про вже існуючі сутності за допомогою API 🔍


ㅤОтримати інформацію можна про наступні сутності:

  • tags
  • projects 
  • categories/income 
  • categories/expense 
  • customers 
  • investors
  • creditors 
  • debitors 
  • suppliers 
  • employees 
  • owners 
  • accounts


Для того, щоб отримати інформацію про сутність вам потрібно:


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

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

3. Обрати про яку сутність потрібно отримати інформацію
(наприклад, теги)



4. Обираємо tags

5. Натискаємо на параметр GET

6. Виконуємо запит


✅ В результаті ви отримаєте список всіх тегів, та їх ID


Редагування сутностей за допомогою API ⚙️


ㅤРедагуванню підлягають наступні сутності:

  • tags 
  • projects 
  • categories/income 
  • categories/expense 
  • customers 
  • investors
  • creditors 
  • debitors 
  • suppliers 
  • employees 
  • owners 



Для того, щоб відредагувати сутність вам потрібно:



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

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

3. Обрати про яку сутність потрібно отримати інформацію
(наприклад, теги)




4. Натиснути на параметр PATCH

5. Вкажіть ID сутності

6. Вкажіть оновлену назву сутності

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


✅ В результаті у вас зміниться назва сутності в Finmap

Видалення сутності за допомогою API ✂️

ㅤВидаленню підлягають наступні сутності:

  • tags 
  • projects 
  • categories/income 
  • categories/expense 
  • customers 
  • investors
  • creditors 
  • debitors 
  • suppliers 
  • employees 
  • owners 



Для того, щоб видалити сутність вам потрібно:


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

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

3. Обрати необхідну сутність



4. Натиснути на параметр DELETE

5. Вкажіть ID сутності

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

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