Dados e relatórios

Cada transferência gera uma trilha de auditoria completa. Esta página descreve os dados disponíveis para relatórios, conciliação e conformidade.

​

Quais dados são registrados por transferência

---

​

Ciclo de vida do status da transferência

---

​

TED OUT

• Cliente confirmou (CREATED): o plugin criou a transferência e aplicou uma retenção sobre valor + tarifa
• Preparando o envio (PENDING): o plugin prepara a mensagem para a JD
• Processamento bancário (PROCESSING): o plugin enviou a transferência à JD e aguarda o resultado da liquidação. Um timeout mantém a transferência aqui enquanto a conciliação pergunta o resultado à JD. Uma transferência que a JD ainda responde como pendente depois de 24 horas em conciliação fica aqui com a retenção (status de conciliação MANUAL_REVIEW)
• Liquidada (COMPLETED): o STR liquidou a transferência e o plugin confirmou a retenção
• Rejeitada (REJECTED): a JD ou o STR rejeitou a transferência, e o plugin liberou a retenção
• Falhou (FAILED): o ledger recusou a retenção, ou a conciliação não conseguiu liquidar a transferência. Quando a conciliação para depois da última tentativa, a retenção continua em vigor e um operador resolve a transferência (status de conciliação MANUAL_REVIEW)
• Cancelada (CANCELLED): a transferência foi cancelada a partir de CREATED ou PENDING, e o plugin liberou a retenção

​

TED IN

• Transferência detectada (RECEIVED): mensagem de entrada persistida, pendente de processamento interno
• Destinatário validado (PROCESSING): o sistema credita a conta do destinatário
• Valor creditado (COMPLETED): conta do destinatário creditada com sucesso
• Falhou (FAILED): o ledger recusou o crédito, ou o banco remetente fez o chargeback de um crédito concluído

​

P2P

• Confirmada (CREATED): o cliente confirmou a transferência entre contas internas
• Processando (PROCESSING): transação Midaz em andamento
• Liquidada (COMPLETED): as duas contas atualizadas com sucesso
• Falhou (FAILED): o ledger recusou o lançamento

​

Revisão da tarifa antes da confirmação

---

Para TED OUT e P2P, os clientes passam por um fluxo de duas etapas:

• Aguardando confirmação: o plugin calculou e apresentou a tarifa. O cliente ainda não confirmou
• Processada: o cliente confirmou e o plugin criou a transferência
• Expirada: a iniciação expirou sem confirmação. Uma iniciação é válida por 24 horas. Uma iniciação de TED OUT expira antes, no fechamento da janela de operação daquele dia

Os clientes podem revisar a tarifa antes de confirmar a transferência.

​

Histórico de status

---

O plugin registra cada transição de status. Obter transferência as retorna em statusHistory, cada uma com o status anterior, o novo status, a data e hora e um motivo, quando houver.

​

Campos de conciliação

---

Use estes campos para casar os registros de transferência com seus extratos bancários:

​

Retenção de dados

---

​

Consultando seus dados

---

Use Listar transferências para consultar transferências com os seguintes filtros:

• Por data de criação: createdFrom e createdTo
• Por tipo: TED_OUT, TED_IN, um tipo de crédito ao cliente, P2P, CROSS_CORE ou CROSS_CORE_IN. TED_IN não seleciona os créditos ao cliente nem os créditos entre cores
• Por status: por exemplo, apenas transferências COMPLETED para conciliação, ou FAILED para investigação
• Por status de conciliação: reconciliationStatus
• Por valor: minAmount e maxAmount
• Por ledger: ledgerId. Ele corresponde ao ledger do pagador ou, em um P2P entre dois ledgers, ao ledger do destinatário

​

Para desenvolvedores

---

​

Armazenamento

O plugin armazena os dados de transferência no PostgreSQL. O campo recipientAccountId referencia uma conta Midaz quando o destinatário é interno. A organização é o filtro principal.

​

Deduplicação de TED de entrada

Antes de processar uma transferência TED IN, o plugin armazena a mensagem bruta da JD. Isso permite ao plugin recuperar transferências de entrada se o serviço falhar durante o processamento. Cada mensagem armazenada é única pelo NumCabSeq da JD. Se a JD reentregar a mesma mensagem, o plugin a identifica como duplicata e a ignora.

​

O que o plugin envia ao Midaz

O plugin envia cada movimento liquidado ao Midaz como uma transação no ledger, mas o Midaz registra o lançamento contábil, não os detalhes bancários da transferência. A identidade da contraparte (banco, agência, conta, nome e documento do titular) e as referências do BACEN (controlNumber, clearingControlNumber) ficam apenas no registro Transfer do plugin. Para uma TED IN, o crédito entra no ledger a partir da conta @external/BRL. A identidade do remetente não é codificada na transação Midaz. O plugin grava apenas metadados de correlação na transação Midaz: A correlação funciona nos dois sentidos:

• O registro da transferência armazena midazTransactionId, então Obter transferência retorna o detalhe bancário completo de qualquer lançamento do ledger.
• A transação Midaz armazena o identificador da transferência em metadata.aggregateId, então você pode filtrar transações Midaz por ele para achar o lançamento do ledger de uma transferência.

Os metadados personalizados que você passa ao iniciar uma transferência TED OUT ou P2P nunca chegam ao Midaz. O plugin os armazena na transferência e os retorna como clientMetadata.

​

Relacionamentos entre entidades

O modelo de domínio da TED segue estes relacionamentos:

• Cada Transfer pertence a uma única organização Midaz e pode ter vários registros TransferStatusHistory.
• As transferências TED OUT e P2P se originam de uma PaymentInitiation no fluxo de transferência em duas etapas.
• Cada JDIncomingMessage pode criar no máximo um Transfer do tipo TED_IN.