Pular para o conteúdo principal
Fontes externas fornecem dados de transações de sistemas fora da sua organização. Este guia cobre como conectar bancos, ERPs, processadores de pagamento e outros sistemas externos ao Matcher.

​
Tipos de fontes suportados

  • Bancos: Extratos diários, feeds em tempo real e exportações históricas de instituições financeiras.
  • ERPs: SAP, Oracle, NetSuite, Microsoft Dynamics e outros sistemas empresariais.
  • Processadores de Pagamento: Stripe, Adyen, PayPal, Square e transações de gateways de pagamento.
  • Bandeiras de Cartão: Arquivos de liquidação Visa, Mastercard, Elo e Amex.

​
Métodos de ingestão

Dados externos podem ser ingeridos através de múltiplos canais:
MétodoCaso de UsoTempo Real
Upload de ArquivoUploads manuais de CSV/JSON/XMLNão
SFTP PullRecuperação agendada de arquivosNão
Integração via APIConexão direta com APISim
Serviço FetcherColeta automatizada de dadosConfigurável
Webhook PushSistema externo envia dadosSim

​
Ingestão baseada em arquivos

O método mais comum para extratos bancários e exportações de ERP.

​
Upload manual

Use o endpoint de upload de arquivos para importar arquivos de transação manualmente.
Referência da API: Upload de arquivo de transação

​
Opções de autenticação SFTP

Tipo de AuthConfiguração
password"password": "encrypted_password"
ssh_key"ssh_key_id": "key_001" (armazenado no vault)
certificate"certificate_id": "cert_001"

​
Conexões bancárias

​
Formato bancário padrão

A maioria dos bancos fornece extratos em formato CSV ou MT940: 
{
  "name": "Chase Business Account",
  "type": "BANK",
  "direction": "EXTERNAL",
  "settings": {
    "bank_name": "Chase",
    "account_number": "****1234",
    "currency": "USD",
    "statement_format": "CSV",
    "timezone": "America/New_York"
  }
}

​
Formato Mt940/mt942

Para extratos bancários formatados em SWIFT: 
{
  "name": "International Bank SWIFT",
  "type": "BANK",
  "direction": "EXTERNAL",
  "settings": {
    "statement_format": "MT940",
    "swift_bic": "CHASUS33",
    "parse_options": {
      "date_format": "YYMMDD",
      "amount_decimal_indicator": ","
    }
  }
}

​
Open banking / psd2

Para conexões bancárias em tempo real via APIs de Open Banking, crie uma fonte com connection_type: OPEN_BANKING: 
{
  "name": "Bank via Open Banking",
  "type": "BANK",
  "direction": "EXTERNAL",
  "connection_type": "OPEN_BANKING",
  "settings": {
    "provider": "plaid",
    "institution_id": "ins_001",
    "account_ids": [
      "acc_001",
      "acc_002"
    ],
    "sync_frequency": "hourly"
  }
}
Referência da API: Criar fonte

​
Conexões ERP

​
Integração SAP

{
  "name": "SAP S/4HANA",
  "type": "ERP",
  "direction": "INTERNAL",
  "connection_type": "API",
  "settings": {
    "erp_type": "SAP",
    "base_url": "https://sap.company.com/sap/opu/odata/sap/",
    "auth": {
      "type": "oauth2",
      "client_id": "matcher-integration",
      "token_url": "https://sap.company.com/oauth/token"
    },
    "entities": [
      "JournalEntry",
      "AccountingDocument"
    ],
    "company_codes": [
      "1000",
      "2000"
    ],
    "sync_frequency": "daily"
  }
}

​
Integração Oracle

{
  "name": "Oracle Financials",
  "type": "ERP",
  "direction": "INTERNAL",
  "connection_type": "API",
  "settings": {
    "erp_type": "ORACLE",
    "base_url": "https://oracle.company.com/fscmRestApi/resources/",
    "auth": {
      "type": "basic",
      "username": "integration_user"
    },
    "ledger_id": "300000001",
    "legal_entity": "Company Inc"
  }
}

​
Exportação de arquivo de ERP genérico

Para ERPs sem integração direta via API: 
{
  "name": "Legacy ERP Export",
  "type": "ERP",
  "direction": "INTERNAL",
  "connection_type": "FILE",
  "settings": {
    "file_format": "CSV",
    "delimiter": "|",
    "encoding": "UTF-8",
    "date_format": "YYYYMMDD",
    "amount_format": {
      "decimal_separator": ".",
      "thousands_separator": ",",
      "scale": 2
    }
  }
}

​
Conexões de processadores de pagamento

​
Integração Stripe

{
  "name": "Stripe Payments",
  "type": "PAYMENT_GATEWAY",
  "direction": "EXTERNAL",
  "connection_type": "API",
  "settings": {
    "provider": "stripe",
    "api_key_id": "secret_stripe_001",
    "sync_objects": [
      "charges",
      "payouts",
      "refunds"
    ],
    "sync_frequency": "hourly",
    "lookback_days": 7
  }
}

​
Integração Adyen

{
  "name": "Adyen Settlements",
  "type": "PAYMENT_GATEWAY",
  "direction": "EXTERNAL",
  "connection_type": "API",
  "settings": {
    "provider": "adyen",
    "merchant_account": "CompanyECOM",
    "api_key_id": "secret_adyen_001",
    "report_types": [
      "settlement_detail",
      "payment_accounting"
    ],
    "sync_frequency": "daily"
  }
}

​
Integração PayPal

{
  "name": "PayPal Business",
  "type": "PAYMENT_GATEWAY",
  "direction": "EXTERNAL",
  "connection_type": "API",
  "settings": {
    "provider": "paypal",
    "client_id": "paypal_client_id",
    "client_secret_id": "secret_paypal_001",
    "environment": "live",
    "sync_objects": [
      "transactions",
      "payouts"
    ],
    "sync_frequency": "hourly"
  }
}

​
Arquivos de liquidação de bandeiras de cartão

​
Liquidação Visa

{
  "name": "Visa Settlement",
  "type": "CARD_NETWORK",
  "direction": "EXTERNAL",
  "settings": {
    "network": "VISA",
    "file_format": "TC33",
    "member_id": "12345678",
    "settlement_currency": "USD"
  }
}

​
Liquidação Mastercard

{
  "name": "Mastercard IPM",
  "type": "CARD_NETWORK",
  "direction": "EXTERNAL",
  "settings": {
    "network": "MASTERCARD",
    "file_format": "IPM",
    "ica": "12345",
    "settlement_currency": "USD"
  }
}

​
Segurança de conexão

​
Armazenamento de credenciais

Todas as credenciais devem ser armazenadas de forma segura em um vault criptografado e referenciadas por ID nas configurações de fonte.

​
Lista de IPs permitidos

Configure IPs de origem que podem enviar dados: 
{
  "settings": {
    "security": {
      "allowed_ips": [
        "192.168.1.0/24",
        "10.0.0.5"
      ],
      "require_tls": true,
      "min_tls_version": "1.2"
    }
  }
}

​
Assinaturas de webhook

Para fontes que enviam via webhook, verifique as assinaturas: 
{
  "settings": {
    "webhook": {
      "signature_header": "X-Signature",
      "signature_algorithm": "HMAC-SHA256",
      "secret_id": "secret_webhook_001"
    }
  }
}

​
Requisitos de formato de dados

​
Campos obrigatórios

Toda transação deve incluir:
CampoTipoDescrição
transaction_idStringID único da fonte
amountDecimalValor da transação
currencyStringCódigo ISO 4217
dateDateData da transação

​
Campos recomendados

CampoTipoDescrição
referenceStringReferência de pagamento
counterpartyStringNome da contraparte
typeStringcrédito/débito
posting_dateDateData de liquidação

​
Mapeamento de campos

Configure como os campos da fonte mapeiam para o Matcher: 
{
  "settings": {
    "field_map_id": "fmap_bank_001"
  }
}
Consulte Mapeamento de Campos para detalhes.

​
Melhores práticas

Configure SFTP ou polling de API para extratos bancários em vez de uploads manuais. Isso garante disponibilidade de dados consistente e oportuna.
Configure retentativas automáticas para fontes baseadas em API. Falhas transitórias são comuns; retentativas evitam intervenção manual.
Configure alertas para falhas de conexão e cenários sem dados. Monitoramento proativo evita atrasos na conciliação.
Ajuste a frequência de sincronização às suas necessidades de conciliação. Diária para extratos bancários; horária para processadores de pagamento.
Armazene todas as chaves de API e senhas no vault. Nunca inclua credenciais nos payloads de configuração.
Valide o mapeamento de campos e a qualidade dos dados com arquivos de amostra antes de habilitar a ingestão automatizada.

​
Próximos passos

Mapeamento de Campos

Configure como os campos da fonte mapeiam para o Matcher.

Upload de Arquivos

Procedimentos de upload manual de arquivos.