Mapeadores de Exportação
Categoria:
Tópicos neste documento:
- Onde encontrar os Export Mappers
- Tipos de Export Mapper
- Adicionar um novo Export Mapper
- Visão geral dos separadores
- Melhores Práticas
- Resumo
Os Export Mappers no Tridens Monetization são utilizados para estruturar dados de saída (como registos de pagamento, dados de faturas ou registos de eventos) num formato exigido por sistemas externos — como bancos, ERPs, parceiros de faturação ou ferramentas de BI.
Com os export mappers, define como os dados do sistema são transformados e formatados antes de serem exportados, garantindo a compatibilidade com os consumidores terceiros.
Onde encontrar os Export Mappers
Navegue para:Business Configuration > Export
Figura 1: Página por defeito dos Export Mappers
Tipos de Export Mapper
O ecrã Export Mappers contém três separadores distintos, cada um representando um tipo de exportação específico do domínio. Tal como os Import Mappers, todos utilizam o mesmo formato de configuração.
Separadores disponíveis:
- Payment Mappers
- Invoice Mappers
- Event Mappers
Cada separador inclui uma opção Add para configurar um novo export mapper.
Adicionar um novo Export Mapper
Clique no botão Add em qualquer um dos separadores para iniciar o formulário Create Export Mapper. Os campos abaixo são comuns aos três tipos de mapper.
Figura 2: Página de criação de Export Mapper
Campos obrigatórios
Tabela 1: Campos obrigatórios
| Campo | Descrição |
|---|---|
| Name | Um nome claro e único para o mapper (ex: ERP_Invoice_Export) |
| Code | Identificador de código interno do sistema (ex: ERP_01) |
| Description | Opcional. Notas ou contexto sobre o que esta exportação abrange |
| Prefix | Opcional. Utilizado para etiquetar registos de forma única ou formatar nomes de ficheiros de exportação |
| Import Mode | Embora seja principalmente para importadores, este campo pode aparecer se o mapper for utilizado para sincronização bidirecional |
| Delimiter | Especifica o separador para o ficheiro exportado (ex: vírgula ,, tabulação \t, ponto e vírgula ;) |
Também pode definir regras de mapeamento de coluna para campo após carregar o ficheiro, dependendo da configuração do sistema.
Visão geral dos separadores
1. Payment Mappers
Utilizado para exportar dados de pagamentos de saída (ex: transações processadas, liquidações) no formato exigido pelo banco ou parceiro.
2. Invoice Mappers
Estrutura dados de faturação e faturas para exportação para sistemas ERP ou ferramentas de contabilidade externas como SAP ou QuickBooks.
3. Event Mappers
Exporta eventos de utilização registados, violações de limites ou eventos de regras de negócio para sistemas externos ou auditores.
Melhores Práticas
Info “Dica” - Faça corresponder a estrutura de exportação às especificações de campos do sistema de destino (ex: nomes de colunas CSV). - Utilize o campo Prefix para versionar ou colocar um selo temporal nas suas exportações. - Valide o delimitador com o visualizador de ficheiros ou script que consome a exportação. - Teste sempre o mapeamento de exportação num ambiente que não seja de produção primeiro.
Resumo
Os Export Mappers ajudam-no a fornecer dados de saída estruturados, compatíveis e precisos para sistemas externos.
Certifique-se de:
- Nomear cada mapper de forma clara
- Carregar uma estrutura de ficheiro representativa
- Fazer corresponder os campos de exportação aos dados do sistema
Uma vez configurados, os export mappers automatizam a geração de ficheiros, melhoram a conformidade e permitem integrações perfeitas.
