Расходы

Расходы — это то, что вы платите за трафик: бюджет в FB, TikTok, Google, пуш-сети. Без расходов в отчётах будет доход, но не будет прибыли и ROI. Раздел «Расходы» (/dashboard/costs) хранит ручные записи. Есть и вторая модель — авто-цена за клик, см. ниже.

1. Добавить расход — одна запись: ссылка, период, сумма, валюта, разрез.
2. Массовый ввод — вставка из Excel или Google Sheets, одна строка на день.
3. Таблица — записи с периодом, ссылкой, разрезом и источником (Вручную или API).

Ручная запись

Поле	Что вводить
Ссылка	Конкретная ссылка или «Без привязки к ссылке (по всему воркспейсу)».
Дата	Начало периода. Чекбокс «Расход относится к нескольким дням» открывает «Дату окончания».
Ключ разреза	Например sub_id_2. Нужен, если расход привязан к объявлению или креативу.
Значение разреза	Например ad_12345. Должно совпадать с значением sub_id в клике.
Сумма	Число, до двух знаков после запятой.
Валюта	Трёхбуквенный код, по умолчанию USD.
Заметка	Произвольный текст, до 1000 знаков.

Массовый ввод

Скопируйте таблицу из Excel или Google Sheets и вставьте в диалог «Массовый ввод расходов». Колонки строго в таком порядке:

#	Колонка	Формат
1	Date	YYYY-MM-DD
2	Link	код ссылки, можно пусто
3	Breakdown key	например sub_id_2
4	Breakdown value	например ad_12345
5	Amount	число
6	Currency	трёхбуквенный код, по умолчанию USD
7	Notes	текст

Каждая строка — один день. Ошибки подсвечиваются: неверная дата, код валюты не из трёх букв, код ссылки не найден.

1. Заголовки колонок — порядок важен, вставка идёт по позициям.
2. Строки — по одной на день. Кнопки «Добавить строку» и «Сохранить все» под таблицей.

Повторная отправка обновляет, а не дублирует

«Сохранить все» работает как upsert. Запись идентифицируется набором: ссылка, ключ и значение разреза, период и источник. Если такая запись уже есть, обновляются сумма, валюта и заметка. Если в одной пачке встречается один и тот же набор дважды, побеждает последняя строка. Поэтому таблицу можно отправить повторно после исправления суммы.

Две модели расхода

Модель	Где задаётся	Как считается
Ручные записи	Этот раздел	Сумма записи, распределённая по дням периода.
Авто-цена клика	«Приём кликов» (/dashboard/settings/click-settings)	Нет, фикс за клик (CPC), за 1000 кликов (CPM) или значение из параметра URL. Записывается в момент клика.

Модели не складываются. Если по группе отчёта есть ручная сумма, используется она. Авто-цена применяется только к группам без ручного расхода.

Подробно о том, в какие отчёты попадают ручные записи и как делится сумма по дням, — в разделе Отчёты.

Расход за период, а не за день

Если вы заливали бюджет на неделю, введите одну запись на неделю с датой окончания. Отчёт по дням разложит сумму равномерно. Не вводите одну и ту же сумму отдельными записями на каждый день и на неделю сразу, иначе она удвоится.

Валюта

Записи в другой валюте переводятся в базовую по курсу дня записи. Если курса нет, отчёт покажет предупреждение о смешанных валютах. Курсы — в курсах валют.

Права

• Участник с «Скрыть финансы» список расходов не видит совсем.
• Участник с «Только свои сущности» видит только записи, которые создал сам, и записи по разрешённым ссылкам. Записи без привязки к ссылке ему не видны.

См. доступ байеров.

API

Метод	Путь	Scope
GET	/api/v1/costs?from=&to=&linkId=	costs:read
POST	/api/v1/costs	costs:write
PUT	/api/v1/costs/bulk	costs:write, тело { "records": [...] }, до 500 записей; upsert по набору идентификации, см. выше
PATCH	/api/v1/costs/:id	costs:write
DELETE	/api/v1/costs/:id	costs:write

Поля создания: linkId, breakdownKey, breakdownValue, periodStart, periodEnd, amount, currency, source, notes.

POST /api/v1/costs и PATCH /api/v1/costs/:id с набором, который уже есть у другой записи, возвращают 409 Conflict. Для обновления существующей записи используйте PUT /costs/bulk.