Редактирование измерений чистой выручки с помощью налогового API (Tax API)

Премиум

Для:

маркетологов

Последнее обновление: 09/10/2025 19:00

О чистой выручке и измерениях налогов

Истинный доход – это уровень бизнес-логики, созданный для обслуживания решения AppsFlyer ROI360 по учету доходов от покупок в приложении и подписок. Он автоматически рассчитывает стоимость чистого дохода для каждой входящей транзакции в режиме реального времени и включает ее в отчеты.

По умолчанию налог указывается в отчете по любой транзакции, измеряемой ROI360, с использованием конфигурации налоговых ставок по умолчанию.

Конфигурация может быть отредактирована с помощью специального налогового API (Tax API).

Подробнее о чистой выручке

Редактировать налоговые ставки с помощью налогового API

Прежде чем начать: обязательно завершите шаги 1–2 настройки измерения доходов от покупок в приложении и подписок ROI360.

Как отредактировать конфигурацию налогов с помощью налогового API

Предоставьте своему разработчику:
- Токен API V2 для использования в качестве ключа авторизации.
- Параметры и значения, содержащие информацию о том, какие налоги необходимо рассчитать, как указано в таблице ниже.
Сообщите своему разработчику, что ему необходимо следовать инструкции по налоговому API для создания правил расчета налоговых ставок. Примечание: API допускает наличие JSON-файла в теле запроса post. В этом JSON-файле отображаются все поддерживаемые страны и их налоговые ставки по умолчанию. Разработчик может редактировать его или использовать в API без изменений.

Параметры и значения для использования в API

Параметр	Обязательный	Примечания
tax_name	Да	Название, указанное в счете-фактуре клиента, описывающее конкретный тип налога. Пример: Налог с продаж, НДС, федеральный налог на товары и услуги
tax_rate	Да	Значение должно быть больше 0. Число, содержащее до четырех десятичных знаков, отображающее налог, который нужно взыскать, в процентах . Пример: 7,25
tax_exclusive	Нет	Логический параметр: true (истина) или false (ложь). False означает, что налог включен в общую выручку. True означает, что налог взимается дополнительно к общей заявленной выручке. Например, в США или Канаде цена указана без учета налога с продаж. По умолчанию установлено значение false.
country	Нет	Двухбуквенный код страны по стандарту ISO, для которой применяется налог. Пример: CA Примечание. Для Великобритании используется код «UK», а не «GB».
subdivision	Нет	В некоторых странах может быть дополнительно указан штат/муниципальное образование. Обрабатывается в соответствии с кодами муниципальных образований по ISO 3166-2. Должен включать код страны и код муниципального образования. Пример: US-CA
postal_code	Нет	Строка из букв и/или цифр Пример: L4J8E3
deduction_order	Нет	Перечисление, 0, 1, или 2: 0 означает, что сначала из валового дохода вычитается комиссия магазина, а из оставшейся суммы вычитается налог. 1 означает, что сначала из валового дохода вычитается налог, а из оставшейся суммы вычитается комиссия магазина. 2 означает, что из валового дохода вычитается и налог, и комиссия магазина.