Как настроить Яндекс Директ в 1С: интеграция и учёт расходов

Под «настройкой Директа в 1С» обычно понимают две разные задачи. Первая — автоматическая загрузка статистики и расходов Яндекс Директа в учётную систему, чтобы бухгалтерия видела затраты на рекламу без ручного ввода. Вторая — передача данных из 1С в Директ: например, выгрузка товарного каталога для смарт-баннеров и динамических объявлений или отправка офлайн-конверсий для корректной работы стратегий.

В типовых конфигурациях 1С (Бухгалтерия предприятия, Управление нашей фирмой, Комплексная автоматизация) нет полноценного встроенного модуля работы с Директом. Интеграция реализуется через API Яндекс Директа: либо готовой внешней обработкой, либо обменом файлами, либо связкой через промежуточные сервисы. Ниже разобраны все рабочие сценарии — от простого учёта расходов до выгрузки фида и конверсий.

Перед началом работы убедитесь, что у вас есть доступ к рекламному кабинету Директа с правами на получение токена API, а в 1С — права на добавление внешних обработок и настройку регламентных заданий. Без этого интеграцию настроить не получится.

Что именно нужно настроить: определяем сценарий

Прежде чем что-то подключать, определите, какая задача стоит перед вами, потому что техническая реализация у сценариев разная. Учёт расходов на рекламу — самая частая потребность: бухгалтеру нужны акты и суммы затрат по Директу в 1С для закрытия месяца. Здесь достаточно загрузки документов от Яндекса или регулярной выгрузки статистики через API отчётов.

Второй сценарий — выгрузка товарного каталога из 1С в Директ для динамических объявлений и смарт-баннеров. Нужен фид в формате YML или CSV, который формируется из номенклатуры с актуальными ценами и остатками. Третий сценарий — передача офлайн-конверсий: 1С отправляет в Директ данные об оплаченных заказах, чтобы автостратегии оптимизировались не на заявки, а на реальную выручку.

Подготовка: токен API и доступы

Любая автоматическая интеграция начинается с получения токена доступа к API Директа. Войдите в Яндекс под логином, которому принадлежит рекламный кабинет (или которому выдан представительский доступ), и перейдите на страницу регистрации приложения в Яндекс OAuth. При создании приложения укажите доступ к API Директа — без этого права запросы будут отклоняться.

После регистрации приложения получите токен: система перенаправит вас на страницу с подтверждением доступа и покажет строку токена. Сохраните её в надёжном месте — токен фактически даёт доступ к управлению рекламным кабинетом. Для работы с API на чтение статистики обычно требуется, чтобы у приложения был подтверждён доступ; на этапе тестирования действуют ограничения по количеству запросов и баллов API.

В 1С подготовьте место для хранения настроек: константу или регистр сведений с токеном, логином кабинета и параметрами расписания. Хранить токен в открытом виде в коде обработки — плохая практика: при обмене конфигурацией или выгрузке базы он может утечь.

Учёт расходов на Директ в 1С Бухгалтерии

Самый простой способ отразить расходы на рекламу — загрузить закрывающие документы из кабинета Директа. Яндекс ежемесячно формирует акт и счёт-фактуру (или УПД), которые доступны в разделе документов рекламного кабинета. В 1С Бухгалтерии эти документы можно загрузить через сервис обмена электронными документами (1С-ЭДО), если у вас подключён оператор, через которого Яндекс передаёт документы, либо ввести вручную по файлу.

Ручное отражение делается документом «Поступление (акты, накладные, УПД)» с видом операции «Услуги». Укажите контрагента Яндекс, договор, сумму из акта и счёт затрат — обычно 44 «Расходы на продажу» или 26 с аналитикой «Реклама». НДС выделяется по данным УПД. Если вы работаете на УСН, расходы на рекламу учитываются после фактической оплаты.

Для автоматизации без ЭДО используются внешние обработки, которые по API отчётов Директа ежедневно или еженедельно забирают суммы фактических списаний и формируют в 1С документы или записи для управленческого учёта. В управленческих конфигурациях (УНФ) расходы на рекламу часто отражают документом «Расход со счёта» или «Прочие расходы» с соответствующей статьёй.

1. 1
   Скачайте акт и УПД из раздела документов в кабинете Директа
2. 2
   Создайте документ «Поступление (акты, накладные, УПД)» с операцией «Услуги»
3. 3
   Укажите контрагента Яндекс, договор и сумму из акта
4. 4
   Выберите счёт затрат 44 или 26 с аналитикой «Реклама», выделите НДС по УПД
5. 5
   Проверьте попадание суммы в отчёт по затратам и в книгу покупок

Автоматическая загрузка статистики через API

Если нужна не только бухгалтерская сумма, но и детальная статистика (кампании, ключевые фразы, клики, конверсии), настраивается обмен через Reports API Директа. Механика такая: 1С отправляет POST-запрос с токеном в заголовке и телом-описанием отчёта (период, поля, фильтры), сервер ставит отчёт в очередь, и через несколько секунд его можно скачать в формате TSV.

В 1С запрос формируется средствами HTTPСоединение и HTTPЗапрос. Важные нюансы: отчёт формируется асинхронно, поэтому обработка должна повторять запрос до получения готового файла (коды 201 и 202 означают, что отчёт ещё готовится); расход баллов API зависит от объёма данных, поэтому не запрашивайте детализацию по дням за год одним запросом — дробите по периодам.

Полученные данные загружаются в регистр сведений или документ аналитики, после чего строятся отчёты: расход по кампаниям в разрезе дней, сопоставление с продажами из 1С, расчёт стоимости привлечения заказа. Именно связка «расходы Директа + продажи 1С» даёт главную ценность интеграции — фактическую окупаемость рекламы.

Соединение = Новый HTTPСоединение("api.direct.yandex.com", 443,,,,, Новый ЗащищенноеСоединениеOpenSSL);
Запрос = Новый HTTPЗапрос("/json/v5/reports");
Запрос.Заголовки.Вставить("Authorization", "Bearer " + Токен);
Запрос.Заголовки.Вставить("Client-Login", ЛогинКабинета);
Запрос.УстановитьТелоИзСтроки(ТелоОтчета);
Ответ = Соединение.ОтправитьДляОбработки(Запрос);

Выгрузка товарного фида из 1С в Директ

Для смарт-баннеров и динамических объявлений Директу нужен фид — файл с товарами, ценами и ссылками. Из 1С фид формируется в формате YML (XML-документ установленной структуры) или CSV. В типовых конфигурациях с торговлей (УТ, КА, УНФ) есть механизмы выгрузки каталога, которые можно адаптировать под YML; в остальных случаях пишется выгрузка запросом по номенклатуре с ценами и остатками.

Обязательные поля фида: идентификатор товара, название, цена, ссылка на страницу товара, ссылка на изображение. Для корректной работы динамических объявлений цены и наличие в фиде должны совпадать с сайтом — при расхождении объявления отклоняются модерацией или показываются с неактуальными данными.

Файл выкладывается на сайт по постоянному URL, который указывается в настройках кампании Директа. Обновление фида настраивается регламентным заданием в 1С — обычно раз в сутки или чаще, если цены и остатки меняются в течение дня. Проверьте, что файл доступен без авторизации и его размер не превышает ограничений Директа.

Передача офлайн-конверсий из 1С

Офлайн-конверсии решают ключевую проблему рекламной аналитики: Директ видит заявку с сайта, но не знает, превратилась ли она в оплаченный заказ. Когда 1С отправляет данные о реальных продажах, автостратегии начинают оптимизироваться под выручку, а не под лиды, что обычно заметно улучшает качество трафика.

Для передачи нужно связать заказ в 1С с рекламным визитом. При оформлении заказа на сайте сохраняйте в заказе идентификатор клика (yclid из ссылки) или ClientID счётчика Метрики. Затем по расписанию 1С формирует пакет конверсий: идентификатор визита, дата, сумма, цель — и отправляет его через конверсионный центр Яндекса или API Метрики.

Передавайте конверсии с корректной датой события и не дублируйте отправки: повторная передача той же конверсии может исказить статистику. Учитывайте, что атрибуция работает в пределах окна, установленного в Метрике, — заказы, оплаченные спустя долгое время после клика, могут не связаться с визитом.

Проверка результата и контроль работы обмена

После настройки каждого сценария проверьте результат на тестовом периоде. Для учёта расходов: сумма, загруженная за месяц, должна сойтись с актом из кабинета Директа до копейки. Для фида: в кабинете Директа не должно быть ошибок обработки фида, а в объявлениях — актуальные цены. Для конверсий: в отчётах Метрики появляются офлайн-конверсии, и их количество сопоставимо с числом оплаченных заказов из рекламы.

Настройте контроль сбоев: если регламентное задание загрузки завершилось с ошибкой, ответственный должен получить уведомление. Типичные причины сбоев — истёкший или отозванный токен, превышение лимитов API, изменение структуры данных в 1С после обновления конфигурации. Ведите журнал обмена с датами, объёмами и ошибками — это сильно упрощает диагностику.

FAQ