WORKSECTION

Витрати

Отримання витрат часу та фінансів по завданнях через API: get_costs

Приклад get_costs запиту

?action=get_costs
Повертає часові та фінансові витрати по вказаних або всіх завданнях

Необов'язкові параметри:
  • id_project — ID проєкту (витрати по завданнях певного проєкту)
  • id_task — ID завдання (витрати по певному завданню)
  • datestart і dateend — діапазон дат для пошуку даних у форматі DD.MM.YYYY (дати рахуються включно)
  • is_timer — тип часових витрат, можливі значення:
    1 — внесено з таймеру
    0 — внесено вручну
  • filter — додатковий параметр пошуку (список операторів для роботи з даними, які використовуються в filter, див. search_tasks)

можливі дані для використання в filter (для методу get_costs):
  • id=TASK_ID — витрати по певному завданню (тип Integer)
  • project=PROJECT_ID — витрати по завданнях певного проєкту (тип Integer)
  • comment — коментар користувача до витрат (тип String)
  • dateadd — дата внесення витрат у форматі 'DD.MM.YYYY' (тип String)
Повертаються наступні дані:
  • id — ID рядкe витрат
  • comment — коментар користувача до витрат
  • time — значення часових витрат
  • money — значення фінансових витрат
  • date — дата внесення витрат
  • is_timer — тип часових витрат
    • true — отримані з таймеру
    false — внесені вручну
    • user_from — користувач, за яким закріплено рядок витрат
    • task — завдання, куди внесені витрати (значення параметрів аналогічні описаним в методі get_task)
    • total — сумарні значення часових та фінансовими витрат по усіх рядках витрат, отриманих у відповіді

Приклад JSON відповіді
При успішному виконанні запиту, відповідь буде містити статус ok і наступні дані:

{
    "status": "ok",
    "data": [
        {
            "id": "COSTS_ID_1",
            "comment": "COSTS_COMMENT",
            "time": "10:00",
            "money": "100.00",
            "date": "YYYY—MM—DD",
            "is_timer": false,
            "user_from": {
                "id": "USER_ID",
                "email": "USER_EMAIL",
                "name": "USER_NAME"
            },
            "task": {
                "id": "TASK_ID",
                "name": "TASK_NAME",
                "page": "/project/PROJECT_ID/TASK_ID/",
                "status": "active",
                "priority": "0..10",
                "user_from": {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                "user_to": {
                    "id": "USER_ID",
                    "email": "USER_EMAIL",
                    "name": "USER_NAME"
                },
                "project": {
                    "id": "PROJECT_ID",
                    "name": "PROJECT_NAME",
                    "page": "/project/PROJECT_ID/"
                }, 
                "date_added": "YYYY—MM—DD HH:II",
                "date_start": "YYYY—MM—DD",
                "date_end": "YYYY—MM—DD",
                "time_end": "HH:II",
                "max_time": 20,
                "max_money": 500,
                "tags": {
                    "TAG_ID": "TAG_NAME_1",
                    "TAG_ID": "TAG_NAME_2",
                }
            },
   
        },
        {
            "id": "COSTS_ID_2",
            "comment": "COMMENT_COSTS",
            ... ... ...
        }
    ],
    "total": {
        "time": "HH:II",
        "money": "10.01"
    }
}
Ця стаття була вам корисною? Так, дякую! Ні

Отримання загальних витрат часу і фінансів по завданнях через API: get_costs_total

Приклад get_costs_total запиту

?action=get_costs_total
Повертає загальні часові та фінансові витрати по вказаних або всіх завданнях

Необов'язкові параметри:
  • id_project — ID проєкту (витрати по завданнях певного проєкту)
  • id_task — ID завдання (витрати по певному завданню)
  • datestart і dateend — діапазон дат для пошуку даних у форматі DD.MM.YYYY (дати рахуються включно)
  • is_timer — тип часових витрат, можливі значення:
      • 1 — внесено з таймеру
      0 — внесено вручну
Приклад JSON відповіді
При успішному виконанні запиту, відповідь буде містити статус ok і наступні дані:

{
    "status": "ok",
    "total": {
        "time": "HH:II",
        "money": "0.00",
    }
}
Ця стаття була вам корисною? Так, дякую! Ні

Додавання часових і фінансових витрат до завдання через API: add_costs

Приклад add_costs запиту

?action=add_costs&id_task=TASK_ID&time=TIME
Додає витрати до вказаного завдання

Обов'язкові параметри:
  • id_task — ID завдання

Умовні параметри:
*обов'язковий мінімум один: time або money
  • time — часові витрати в одному з форматів 0.15 / 0,15 / 0:09
  • money — фінансові витрати у валюті акаунту (якщо необхідно вказати без прив'язки до погодинної ставки)

Необов'язкові параметри:
  • email_user_from — email користувача, за яким будуть закріплені витрати (автоматично вказується при використанні токена доступу)
    обов'язковий при використанні адмінського токену
  • is_rate=1 — фінансові витрати розраховуються виходячи з погодинної ставки (параметр money ігнорується)
  • comment — коментар до витрат
  • date — дата внесення витрат у форматі DD.MM.YYYY
Приклад JSON відповіді
При успішному виконанні запиту, відповідь буде містити статус ok і id рядка витрат:

{
    "status": "ok",
    "id": "COSTS_ID"
}
Ця стаття була вам корисною? Так, дякую! Ні

Оновлення часових і фінансових витрат завдання через API: update_costs

Приклад update_costs запиту

?action=update_costs&id=ID_COSTS&time=2
Редагує витрати завдання

Обов'язкові параметри:
  • id_costs — ID рядку витрат (можна отримати через метод get_costs)

Необов'язкові параметри:
  • time — витрати часу в одному з форматів 0.15 / 0,15 / 0:09
  • money — фінансові витрати у валюті акаунту (якщо необхідно вказати без прив'язки до погодинної ставки)
  • is_rate=1 — фінансові витрати вираховуються виходячи з погодинної ставки, якщо вказано нове значення time (параметр money ігнорується)
  • comment — коментар до витрат
  • date — дата внесення витрат у форматі DD.MM.YYYY

Недоступні для редагування параметри:
  • email_user_from — email користувача, за яким закріплені внесені витрати
Приклад JSON відповіді
При успішному виконанні запиту, відповідь буде містити статус ok 

{
    "status": "ok"
}
Ця стаття була вам корисною? Так, дякую! Ні

Видалення часових і фінансових витрат завдання через API: delete_costs

Приклад delete_costs запиту

?action=delete_costs&id=COSTS_ID
Видаляє вказаний рядок витрат завдання

Обов'язкові параметри:
  • id_costs — ID рядку витрат (можна отримати через метод get_costs)
Приклад JSON відповіді
При успішному виконанні запиту, відповідь буде містити статус ok

{
    "status": "ok"
}

Ця стаття була вам корисною? Так, дякую! Ні
esc
или
Роздрукувати