Зміст
Робота з Сутностями Finmap через API: Додавання, Редагування чи Видалення контрагентів, категорій, проєктів і тегів
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 буде успішно видалена
Якщо залишились питання
Якщо у вас виникнуть питання щодо документації API або є приклад технічного запиту, який ви хочете вирішити, будь ласка, напишіть нам на пошту support-team@finmap.online.
В листі потрібно описати наступне: “Запит …, не працює (з’являється така відповідь) коли ви надсилаєте параметри …”. Наш технічний фахівець розгляне ваш запит (опрацювання запитів відбувається в межах 24 годин) і надасть кваліфіковану відповідь.