Выгрузка данных по оплаченным бронированиям из Bnovo в таблицу базы данных PostgreSQL и дашборд Yandex DataLens

1. Пример заказчика: проблема и решение

В нашу компанию обратился заказчик, который является владельцем сети отелей.

Ему нужна была помощь с настройкой интеграции для учета всех платежей по бронированиям и подробного анализа финансовых данных.

Для бронирования заказчик использует платформу Bnovo.

В Bnovo есть встроенный финансовый отчет, но он не предоставляет такой визуализации, которая была нужна заказчику, что затрудняет ему видеть ясную картину финансового положения компании.

Для решения этой задачи мы предложили следующий подход:

Во-первых, будем выгружать информацию о платежах и расходах из Bnovo в базу данных PostgreSQL.

Создание чистой статистики на вашем дашборде Yandex DataLens, если пользователи предпочитают удалять сущности в Битрикс24: подробности в статье.

Во-вторых, используем эти данные для создания дашборда в Yandex DataLens.

Создание сквозной аналитики на базе данных PostgreSQL/ MySQL из Битрикс24 и Roistat и визуализация на дашбордах Yandex DataLens: читайте по ссылке.

Как все настроить с помощью платформы Пинкит, расскажем дальше.

2. Выгрузка данных по поступлениям и расходам из Bnovo в PostgreSQL

В Пинкит ранее не было триггера "Поступления и расходы" для сервиса Bnovo, который необходим для активации наших интеграций.

Поэтому перед тем как приступить к настройке отчета, мы добавили данное событие с помощью Пинкитбилдер.

Шаг первый: Откуда

Выбираем источником данных Bnovo и событие “Поступления и расходы”. Подключение к приложению - доступы к Bnovo.

Шаг второй: Инструменты

— Способ оплаты

Используем сопоставление данных по полю source.type_id. Получаем типы оплат.

— Статья денежных средств

Используем API-запрос методом GET с указанием URL /finance/items.

— Преобразовать данные в нужный формат

Нам понадобится декодировать JSON в поле step2.0.

— Определить статью денежных средств

Используем фильтр элементов массива в поле step3. Условие - ЧислоРавно, Сравниваемое значение - source.item_id.

— Статус печати чека

Используем сопоставление данных по полю source.fiscal_status. Получаем статусы печати чека.

— Получить юридических лиц отеля

Используем API-запрос методом GET с указанием URL /finance/details.

— Определить юридическое лицо

Используем фильтр элементов массива в поле step7.suppliers. Название поля внутри элемента массива - finance_supplier_id. Условие - ЧислоРавно, Сравниваемое значение - source.supplier_id.

— Определить юридическое лицо, на которого поступил платеж

Используем фильтр элементов массива в поле step7.suppliers. Название поля внутри элемента массива - id. Условие - ЧислоРавно, Сравниваемое значение - source.external_supplier_id.

Шаг третий: Куда

Добавляем строку в PostgreSQL. Выбираем заранее созданную таблицу.

Шаг четвертый: Сопоставление данных

Выполняем сопоставление полей в Bnovo с колонками в таблице PostgreSQL.

Для этого потребуется настроить множество пользовательских соответствий для таких полей, как Имя, Дата платежа, Дата создания брони и другие:

Шаг пятый: Запуск

Запускаем интеграцию.

Резюмируем

На основе данных, выгружаемых интеграцией Пинкит из Bnovo в базу PostgreSQL, будет сформирован дашборд по поступлениям и расходам в следующем формате:

Инструкцию по подключению СУБД к сервису Yandex DataLens можно найти тут.

Если у вас есть вопросы, пишите нам в Телеграм или WhatsApp.

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

Также вы можете самостоятельно протестировать Пинкит, для этого зарегистрируйтесь в личном кабинете по ссылке: https://lk.pinkit.io/register.

Алексей Окара,
продакт-менеджер Пинкит