Перейти на сайт

API ПланФакта.

Как работать с API ПланФакта?

У ПланФакта есть открытое API, документацию к которому вы можете найти по ссылке: https://apidoc.planfact.io/

 

API позволяет работать со следующими объектами ПланФакта:

  • Юрлица

  • Счета (наличные, безналичные)

  • Операции

  • Контрагенты

  • Проекты

  • Бюджеты

  • Показатели

  • Настройки бизнеса

Для работы с API вам понадобится Токен API (ApiKey). Вы можете найти его в ПланФакте в своей учетной записи.

 

В разделе Настройки → Мой профиль


Если вы не нашли Токен API (ApiKey) в своей учетной записи, обратитесь к Владельцу аккаунта с просьбой предоставить вам доступ к API.


Управление доступом к API

Доступом к API для присоединенных пользователей управляет владелец аккаунта.

 

При работе с API установленные для присоединенного пользователя права и настройки доступа сохраняются.

 

Чтобы предоставить доступ к API зайдите в раздел Пользователи, выберите нужный email и в меню нажмите Редактировать.

 В блоке «Настройки доступа» отметьте галочкой "Разрешить доступ к API" и сохраните настройки:


Выбранный пользователь в своем аккаунте в разделе Настройки → Мой профиль увидит поле Токен API (ApiKey).

 


Разрешайте доступ к API только доверенным лицам и не передавайте никому свой Токен API (ApiKey). Помните, что ключ к API дает доступ к данным вашей учетной записи. 

 Если ключ скомпрометирован, обратитесь в службу поддержки за присвоением нового.

 

Авторизация

Для авторизации ApiKey передается как параметр заголовка.

 curl -X GET --header 'Accept: application/json' --header 'X-ApiKey: TEST_API_KEY' 'https://api.planfact.io/api/v1/operations?paging.limit=100'

 

Остатки по счетам

Получить остатки по счетам можно с помощью метода GET /api/v1/bizinfos/accountshistory, который возвращает историю изменений по счетам за все время.

 Просуммируйте все данные по счету до сегодняшней даты включительно. Обратите внимание, что при суммировании данных за текущих день, следует использовать только фактическую сумму (операции с подтвержденной датой оплаты).


Создание операции

Для создания операции используйте POST-запрос, в теле которого в формате JSON необходимо передать ее параметры.

 Обязательными параметрами являются:

  • operationDate

  • accountId

  • value

  • comment

  • items
    – value
    – calculationDate (дата начисления)
    – isCalculationCommitted (Подтверждение даты начисления)




Для тестирования запросов и ответов без консоли можно использовать https://reqbin.com/curl, отправляя cURL-запросы через веб-интерфейс

 


ПРИМЕРЫ НА PHP

https://github.com/planfact/planfact-api-php-example



Для оперативного решения технических вопросов с API можно обращаться в поддержку на сайте сервиса ПланФакт или в официальной группе в Telegram – https://t.me/planfact_api

 


👆 На этом пока всё