Добавление

Добавление движения

POST https://do.freshoffice.ru/finance/insert

Создаёт приход (direction_id: 1) или расход (direction_id: 2) по счёту. Переводы между счетами через публичный API не поддерживаются.

Request Body

Name Type Description
transaction* JSON 
{
  "status": "success",
  "error": "",
  "code": null,
  "rows": 0,
  "pages": 0,
  "page": 0,
  "value": "70012"
}

JSON

Все доступные параметры нового объекта
  • direction_id - * Направление: 1 — приход, 2 — расход
  • account_id - * Код счёта
  • sum - * Сумма в базовой валюте
  • category_id - Код статьи доходов/расходов
  • type_id - Код формы оплаты
  • company_id - Код контрагента
  • deal_id - Код сделки
  • date - Дата/время движения, например 2026-08-26 15:00. По умолчанию — сейчас
  • note - Примечание
  • user_id - Код ответственного. По умолчанию — владелец токена
  • sum_currency - Сумма в валюте (по умолчанию равна sum)
  • rate - Курс (по умолчанию 1)
  • agent_id - Код агента
  • project_id - Код проекта
  • external_code - Внешний код (1С)
  • tags - Теги через запятую

{
   "direction_id": 1,
   "account_id": 3,
   "sum": 150000,
   "category_id": 7,
   "company_id": 368132,
   "date": "2026-08-26",
   "note": "Оплата по счету 145 от Продстар"
}

Примечание

Обязательные параметры
direction_id (1 — приход, 2 — расход)
account_id (Код счёта)
sum (Сумма, не может быть нулевой)

Пример

curl --location --request POST 'https://do.freshoffice.ru/finance/insert' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "direction_id": 1,
    "account_id": 3,
    "sum": 150000,
    "company_id": 368132,
    "note": "Оплата по счету 145 от Продстар"
  }
  '

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://do.freshoffice.ru/finance/insert',
  'headers': {
    'Authorization': 'Bearer XXXX-XXXXXXX-XXXXXXX',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "direction_id": 1,
    "account_id": 3,
    "sum": 150000,
    "company_id": 368132,
    "note": "Оплата по счету 145 от Продстар"
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Справочники

Пользователи

Ответ

{
  "status": "success",
  "error": "",
  "code": null,
  "rows": 0,
  "pages": 0,
  "page": 0,
  "value": "70012"
}
// value - ID идентификатор нового движения
Предыдущая
Список
Следующая
Обновление