Mapeadores de Importação
Categoria:
Tópicos neste documento:
- Onde encontrar os Mappers
- Tipos de Import Mapper
- Adicionar um novo Import Mapper
- Exemplo de caso de utilização
- Visão geral dos separadores disponíveis
- Melhores Práticas
Os Import Mappers no Tridens Monetization permitem-lhe transformar e alinhar dados externos (CSV, ficheiros planos, etc.) em formatos compatíveis com o sistema. Quer se trate da importação de dados de pagamento, eventos ou transações bancárias, os import mappers garantem que o sistema interpreta e ingere corretamente os dados estruturados de plataformas externas.
Onde encontrar os Mappers
Navegue para:Business Configuration > Import
Figura 1: Página por defeito dos Import Mappers
Tipos de Import Mapper
No topo do ecrã Import Mappers, encontrará quatro separadores — cada um representando um domínio de dados diferente. Todos os separadores partilham a mesma estrutura de configuração:
- Payment Mappers
- Direct Debit Mappers
- Event Mappers
- Bank Mappers
Cada separador permite-lhe adicionar um novo mapper (Add a new mapper) utilizando um formulário como o que é mostrado na captura de ecrã.
Adicionar um novo Import Mapper
Clique no botão Add em qualquer um dos quatro separadores para abrir o formulário Create Mapper. Os campos que deve preencher são idênticos em todos os tipos de mapper.
Campos obrigatórios
Tabela 1: Campos obrigatórios
| Campo | Descrição |
|---|---|
| Name | Um nome único e descritivo para o mapper (ex: Bankart Payment Mapper) |
| Code | Um identificador de sistema utilizado internamente (ex: BANKART_01) |
| Description | Opcional. Adicione notas sobre o objetivo ou a origem deste mapper |
| Prefix | Opcional. Utilizado para anexar valores únicos durante o mapeamento |
| Import Mode | Define a estrutura do ficheiro de entrada. Opções: Single ou Multi |
| Delimiter | Delimitador do ficheiro, normalmente vírgula ,, tabulação \t ou ponto e vírgula ; |
| File | Carregue o ficheiro de modelo de mapeamento (normalmente formato CSV ou TXT) |
Figura 2: Página de criação de Import Mapper
Exemplo de caso de utilização
Está a importar um ficheiro CSV de um fornecedor de pagamentos (ex: Stripe) que inclui colunas para o ID da transação, ID do cliente, montante e estado.
Irá criar um Payment Mapper para alinhar essas colunas com os campos esperados no Tridens.
Visão geral dos separadores disponíveis
Cada separador em Import Mappers aceita os mesmos campos:
1. Payment Mappers
Utilizado para importar dados de transações brutos de sistemas de pagamento externos.
2. Direct Debit Mappers
Mapeia dados de ordens de débito ou mandatos de bancos ou PSPs.
3. Event Mappers
Importa eventos (ex: eventos de utilização, gatilhos) que afetam a lógica de tarifação ou cobrança.
4. Bank Mappers
Utilizado para integrar extratos bancários importados ou ficheiros de reconciliação.
Melhores Práticas
Info “Dica” - Utilize convenções de nomenclatura consistentes para códigos e prefixos. - Teste sempre o seu ficheiro de mapeamento num ambiente de sandbox antes da utilização em produção. - Escolha o delimitador correto com base na sua fonte de dados (CSV, TSV, etc.). - Mantenha cópias de segurança dos modelos de mapeamento e ficheiros de teste.
