Содержание
Работа с Сущностями 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 часов) и предоставит квалифицированный ответ.