Export Mappers

Export Mappers определяют, как системные данные форматируются и структурируются перед отправкой во внешние платформы. Они необходимы для создания корректно сопоставленных файлов (например, invoices, payment logs, events), соответствующих требованиям сторонних систем, таких как ERP, банки или BI tools.

Темы в этом документе:

Export Mappers в Tridens Monetization используются для структурирования outbound data (например, payment records, invoice data или event logs) в формат, требуемый внешними системами — такими как банки, ERP, billing partners или BI tools.

С помощью export mappers вы определяете, как системные данные преобразуются и форматируются перед экспортом, обеспечивая совместимость со сторонними получателями.


Where to Find Export Mappers

Перейдите в:
Business Configuration > Export

Create Import Mapper - Payment Рисунок 1: Export Mappers default page


Export Mapper Types

Экран Export Mappers содержит три отдельные вкладки, каждая из которых представляет специфический тип экспорта. Как и Import Mappers, все они используют одинаковый формат конфигурации.

Available Tabs:

  • Payment Mappers
  • Invoice Mappers
  • Event Mappers

На каждой вкладке есть опция Add для настройки нового export mapper.


Adding a New Export Mapper

Нажмите Add в любой из вкладок, чтобы открыть форму Create Export Mapper. Поля ниже общие для всех трех типов mapper.

Create Import Mapper - Payment Рисунок 2: Create Export Mapper page

Required Fields

Таблица 1: Required Fields

FieldDescription
NameЯсное, уникальное имя для mapper (например, ERP_Invoice_Export)
CodeInternal system code identifier (например, ERP_01)
DescriptionOptional. Заметки или контекст о том, что покрывает этот экспорт
PrefixOptional. Используется для уникальной маркировки записей или форматирования имен файлов экспорта
Import ModeХотя это поле в первую очередь для importers, оно может отображаться, если mapper используется для двусторонней синхронизации
DelimiterУказывает разделитель экспортируемого файла (например, comma ,, tab \t, semicolon ;)

После загрузки файла вы также можете определить правила сопоставления column-to-field в зависимости от конфигурации системы.


Tabs Overview

1. Payment Mappers

Используется для экспорта outbound payment data (например, processed transactions, settlements) в требуемом формате банка или партнера.

2. Invoice Mappers

Структурирует billing и invoice data для экспорта в ERP systems или внешние accounting tools, такие как SAP или QuickBooks.

3. Event Mappers

Экспортирует logged usage events, threshold breaches или business rule events во внешние системы или аудиторам.


Best Practices

Info “Tip” - Сопоставляйте структуру экспорта со спецификацией полей целевой системы (например, CSV column names). - Используйте поле Prefix для версионирования или добавления временных меток к export files. - Проверяйте delimiter с помощью file viewer или script, который потребляет экспорт. - Всегда тестируйте export mapping в непроизводственной среде.


Summary

Export Mappers помогают доставлять структурированные, совместимые и точные outbound data во внешние системы.
Убедитесь, что вы:

  • даете каждому mapper понятное имя
  • загружаете representative file structure
  • сопоставляете export fields с system data

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