| Índice |
|---|
| exclude | Importante |
|---|
| style | none |
|---|
|
1. Visão Geral
A funcionalidade O Monitor de Pagamentos Online permite facilitar oferece uma visão geral dos pagamentos realizados via PIX, facilitando o acompanhamento e o gerenciamento das ações realizadas pela rotina de Pagar Online.
Com ela, é possível filtrar os pagamentos, visualizar seus status de envio, tanto os retornados pelo banco quanto os gerados pelo sistema, além de conferir as quantidades e os valores envolvidos.
O monitor permite realizar ações individuais, como:
Editar informações do pagamento,
Consultar o histórico de tentativas de comunicação com o banco,
Alterar a chave Pix.
Também é possível executar ações individuais ou por seleção múltipla, como:
- Reenviar para o banco,
Atualizar as informações bancárias,
- Eliminar pagamentos.
Em casos de pagamentos inconsistentes, o sistema apresenta os erros identificados, permitindo que o usuário tome as medidas necessárias para a correção e reenvio.
Ao expandir os detalhes de um pagamento, são exibidas informações complementares como:
Dados do borderô,
Favorecido do pagamento,
Detalhes da execução da transmissão.
Além disso, é possível acessar os arquivos enviados e recebidos durante a comunicação com o banco, oferecendo mais transparência e controle sobre o processo.
operações.
Abaixo estão listadas as principais funcionalidades da rotina:
| Índice |
|---|
| maxLevel | 2 |
|---|
| minLevel | 2 |
|---|
| exclude | Importante |
|---|
| style | none |
|---|
|
01.
...
Ações Principais
As principais ações do Monitor de Pagamentos Online impactam diretamente na atualização e na exibição das informações em toda a tela.
| Deck of Cards |
|---|
|
| Card |
|---|
| default | true |
|---|
| id | refresh |
|---|
| label | Atualizar |
|---|
| No botão atualizar Atualizar será feita a consulta e atualização da GRID tabela de acordo com os filtros informados na tela.  Image Added
|
| Card |
|---|
| id | rpwServer |
|---|
| label | Servidor RPW |
|---|
| Por meio deste botão, é possível definir o servidor RPW responsável pelo processamento do envio ao banco. Ao selecionar o botão de zoom, será exibida uma tela com todos os servidores disponíveis para processamento, sendo necessário selecionar um deles.. 
| Informações |
|---|
| Uma vez informado, o servidor será gravado no perfil do usuário, e não será necessário preenchê-lo novamente em acessos futuros. |
|
| Card |
|---|
| id | quickSearch |
|---|
| label | Busca Rápida |
|---|
| Este campo permite realizar uma busca rápida com base na data do pagamento online efetuado. Ao preenchê-lo, a grid lista de títulos será atualizada automaticamente com os resultados correspondentes.  Image Removed Image Added
| Informações |
|---|
| Este campo deve ser informado no formato dia/mês/ano (DD/MM/AAAA). |
|
| Card |
|---|
| id | advSearch |
|---|
| label | Busca Avançada |
|---|
| A opção Busca Avançada abrirá uma nova tela que permitirá a busca de dados mais específicos na gradetabela, por meio de diversos campos de filtro.  Image Modified
|
|
3. Dados Consolidados
4. Ações Individuais
...
Abaixo é detalhado os Campos de Filtro para Busca Avançada e suas regras: Campo | Descrição |
|---|
| Estabelecimento | Podem ser informados, a partir de uma lista, todos os estabelecimentos que o usuário possui permissão. Caso não seja informado nenhum valor, o resultado da pesquisa apresentará todos os estabelecimentos na consulta. | | Portador | Podem ser informados, a partir de uma lista, os portadores cujo campo Pagamento Online, no programa UFN013aa - Portador Banco, esteja como Sim, além de estar definido para o módulo = APB e Finalidade = Corrente. Além disso, é necessário que o usuário possua permissão para o portador no programa Usuário Pagamento Online. Caso não seja informado nenhum valor, o resultado da pesquisa irá trazer todos os portadores na consulta que atendam esta definição. | | Espécie | Podem ser informados, a partir de uma lista, todas as espécies que o usuário possui permissão, definidas no cadastro Usuário Pagamento Online e que estão cadastradas no programa APB020aa - Manutenção Espécies de Documento Financeiro. Caso não seja informado nenhum valor, o resultado da pesquisa apresentará todas as espécies na consulta. | | Fornecedor | Podem ser informados, a partir de uma lista, todos os fornecedores cadastrados no programa UFN003aa - Fornecedores Financeiro. Caso não seja informado nenhum valor, o resultado da pesquisa apresentará todas as espécies na consulta. | | Série Inicial / Final | Pode ser informado, por meio de uma faixa, a série do título para pesquisa. | | Título Inicial / Final | Pode ser informado, por meio de uma faixa, o número do título para pesquisa. | | Borderô Inicial / Final | Pode ser informado, por meio de uma faixa, o número do borderô para pesquisa. | | Data de Pagamento Inicial / Final | Pode ser informado, por meio de uma faixa, a Data do Pagamento Online. | | Situação Pagamento | Podem ser informados, por meio de uma lista a situação do pagamento online, podendo ser: Aguardando - Status que é necessário o envio novamente ao banco, para atualizar as informações de pagamento. Em Pagamento - Título em pagamento pelo banco. Erro - Título inconsistente, devendo verificar o erro retornado, ou pelo banco, ou pelo sistema, corrigí-lo e realizar o Reenvio. Estornado - Título que foi estornado, por meio do programa de Pagamentos. Pago - Título com pagamento efetivado. Pendente - Título pendente de processamento pelo banco/Datasul Reaberto - Título que foi reaberto, por meio do programa de Pagamentos. |
|
|
02. Dados Consolidados
Apresenta os totalizadores, em termos de quantidade e valores, para cada tipo de situação, conforme filtro informado, tanto na Busca Rápida como na Busca Avançada.
Image Added
Esse painel permite uma visão rápida do status geral dos pagamentos, indicando, por exemplo, quanto já foi efetivamente pago, quanto dos títulos estão com erro, ou ainda a quantidade de títulos em cada situação apresentada na tabela.
As situações consolidadas são:
Pendente\Em Digitação: Total de títulos que estão em processamento no sistema para envio ao banco.
Pagamento: Total de títulos atualmente em fase de pagamento pelo banco.
Pago: Total de títulos que já foram efetivamente pagos.
Erro: Total de títulos com inconsistências. É necessário verificar o erro retornado — seja pelo banco ou pelo sistema —, corrigi-lo e reenviar o pagamento.
Reaberto: Total de títulos que foram reabertos e estão disponíveis para nova tentativa de envio.
Aguardando: Total de títulos que aguardam reenvio ao banco, para atualização das informações de pagamento.
| Informações |
|---|
|
Para alternar entre Valores e Quantidade, basta selecionar os botões  Image Added |
03. Principais campos da Tabela
A tabela do Monitor de Pagamentos Online exibe as principais informações de cada pagamento. Para acessar detalhes mais específicos, é possível expandir a linha do título por meio do botão 
Image Added. Ao expandir, são apresentadas informações complementares, como dados do pagamento, favorecido, atualizações realizadas e a possibilidade de visualizar os arquivos JSON trocados com o banco.
Image Added
Abaixo, são apresentados os detalhes dos campos da tabela e da expansão.
| Expandir |
|---|
|
Campo | Descrição |
|---|
| Estab | Código do estabelecimento do título. | | Título | Chave concatenada do título, separado por | (pipe). Na chave é informado: Código do Fornecedor|Espécie do Título|Série do Título|Código do Título|Parcela | | Situação | Indica o status atual do pagamento do título. - Erro: Ocorre quando há alguma inconsistência no envio ou retorno do pagamento. Um ícone é exibido na coluna Erros, detalhando a falha. Depois da correção, será necessário reenviar o título ao banco.
- Pago: O título foi liquidado tanto no banco quanto no sistema.
- Pendente: O título está em processamento no sistema e ainda não foi enviado ao banco.
- Em Digitação: O título está em digitação no sistema e ainda não foi enviado ao banco.
- Pagamento: Esta situação ocorre após a situação Pendente, ou seja, o título já foi recepcionado pelo banco e o sistema aguarda o retorno para atualização do pagamento.
- Reaberto: Esta situação acontece quando no borderô, por meio da rotina de Pagamentos, houve a reabertura do título ou do borderô, por meio da opção Estornar. Nesta situação, após realizar os possíveis ajustes do título, por meio da ação Editar ou Editar Chave Pix, será possível realizar o Reenvio do Pagamento.
- Aguardando: Caso o banco não retorne o status dentro do prazo esperado, o sistema mantém o título com essa situação. O campo Status do Banco (na expansão) permanece como
"PENDING_VALIDATION". Nesses casos, é necessário acionar a ação Aguardando para solicitar atualização manual ao banco. - Estornado: Esta situação acontece quando no borderô, por meio da rotina de Pagamentos, houve o Estorno, Total (Borderô) ou Parcial (Título), por meio da opção Estornar. Nesta situação, não há nenhuma ação a ser feita no monitor. O título ficará nesta situação.
| | Valor Pagto | Valor líquido do pagamento, considerando juros, abatimentos, multas e descontos aplicáveis. | | Valor Transação | Valor bruto do título. | | Erros | Ícone de exclamação exibido apenas quando a situação do título for Erro. Ao clicar, uma janela é aberta com os detalhes do erro ocorrido durante a tentativa de pagamento. | | Data de Pagamento | Data informada na geração do borderô, por meio da rotina Pagar Online. | | Favorecido | Código e descrição do fornecedor (favorecido) do pagamento. | | Portador | Portador utilizado no pagamento, informado também durante a geração do borderô, via rotina Pagar Online. |
|
| Expandir |
|---|
|
Campo | Descrição |
|---|
| Borderô | Número do borderô no qual o pagamento do título foi incluído. | | Sequência | Sequência do título dentro do borderô. | | QR Code | Código QR utilizado para o pagamento, quando a forma de pagamento permite essa opção. | | Identificação Pagamento Bancário | Chave de pagamento gerada e enviada pelo banco. | | Status do Banco | Situação do pagamento conforme retorno do banco. | | Tipo Conta | Tipo da conta do favorecido utilizada no pagamento. | | Tipo Chave PIX | Tipo da Chave PIX que foi enviado. | | Chave PIX | Tipo da chave Pix utilizada no pagamento (CPF, CNPJ, e-mail, telefone ou chave aleatória). | | Agência/Conta Corrente/Dígito | Dados bancários do favorecido. | | Mensagem | Mensagem enviada ao favorecido, conforme informado na rotina Pagar Online. | | Usuário | Usuário responsável pela última movimentação do pagamento. | | Data | Data da última movimentação do pagamento. | | Hora | Hora da última movimentação do pagamento. | | Pedido de Execução | Número do último Pedido de Execução enviado ao servidor RPW para processar a solicitação. | | Arquivo Enviado / Recebido | Arquivo JSON mais recente trocado entre o sistema e o banco. Ao clicar, é exibida uma nova janela com a visualização completa do conteúdo, além da opção de download. |
|
04. Ações Individuais da Tabela
As ações individuais disponíveis, bem como suas regras de habilitação, podem ser acessadas através do botão 
Image Addede estão detalhadas abaixo.
Image Added
| Deck of Cards |
|---|
|
| Card |
|---|
| default | true |
|---|
| id | edit |
|---|
| label | Editar |
|---|
| A ação Editar permite acessar a rotina Editar Item de Pagamento, utilizada para ajustar as informações do título. Essa opção estará habilitada somente quando a situação do pagamento for "Erro". A edição é necessária para corrigir inconsistências identificadas por meio da ação Erros  Image Addedda tabela, possibilitando o ajuste dos dados e o reenvio do pagamento ao banco.  Image Added
| Informações |
|---|
| A opção de Edição somente será permitida quando no borderô não houver nenhum item com o status de Pago, ou seja, estiver com o status de Parcialmente Baixado. Se a inconsistência for refente a chave Pix, o título deverá ser editado através da opção Editar Chave Pix. |
|
| Card |
|---|
| A ação Eliminar permite excluir um pagamento da tabela. Essa opção estará disponível apenas quando a situação do pagamento for "Erro". Ao selecionar essa ação, será exibida uma tela de confirmação da eliminação.  Image Added
Depois da confirmação, será apresentada uma tela de retorno, indicando se o pagamento foi eliminado com sucesso ou não eliminado, nos casos em que houver alguma inconsistência que não permita a exclusão.  Image Added
|
| Card |
|---|
| id | resend |
|---|
| label | Reenviar Pagamento |
|---|
| A ação Reenviar Pagamento permite realizar um novo envio do pagamento ao banco. Essa opção estará disponível somente quando a situação do pagamento for "Erro" ou "Reaberto". Ao selecionar essa ação, será exibida uma tela de confirmação.  Image Added
Depois da confirmação, o envio será encaminhado ao servidor RPW configurado, indicando o Número do Pedido de Execução, que realizará o processamento da solicitação. Os pedidos de execução podem ser consultados por meio da rotina Monitor Pedido Execução HTML (pedido-execucao-monitor).  Image AddedAo final do processamento será atualizada a situação do título, conforme o retorno obtido. |
| Card |
|---|
| A ação Histórico permite consultar todas as movimentações relacionadas ao pagamento. Essa opção somente estará habilitada quando houver mais de um envio do pagamento ao banco. Ao selecionar essa opção, será aberta uma nova tela com a visualização detalhada dos lançamentos históricos vinculados ao título.  Image Added
|
| Card |
|---|
| id | editPixKey |
|---|
| label | Editar Chave Pix |
|---|
| A ação Editar Chave Pix permite alterar pontualmente a chave Pix de um título quando for identificada alguma inconsistência.
Essa inconsistência pode ocorrer, por exemplo, quando a chave Pix não foi informada ou foi considerada inválida pelo banco. A ocorrência do erro será destacada na coluna "Erros" da tabela. Essa opção estará disponível somente quando a situação do pagamento for "Erro" ou "Reaberto". Para realizar a alteração, a nova chave Pix deverá estar previamente cadastrada no fornecedor, já que será necessário informar tanto a chave quanto o tipo correspondente.
Caso a chave ainda não esteja cadastrada, será possível inseri-la diretamente por meio desta ação.  Image Added
Assim que a chave Pix for ajustada, o título precisa ser reenviado ao banco. A situação será atualizada automaticamente conforme o retorno recebido. | Informações |
|---|
| Mais informações sobre essa tela podem ser encontradas na rotina Editar Item de Pagamento, na seção Botão Código de Barras/Pix. As informações de Código de Barras nesta tela estarão desabilitadas quando ela for acessada a partir da rotina de Pagamento Online. |
|
|
05. Ações Múltiplas para a Tabela
A rotina do Monitor de Pagamentos Online permite a execução de ações em lote, aplicáveis a mais de um item da tabela simultaneamente.
Por meio dos botões Reenviar Pagamento, Aguardando e Eliminar, é possível selecionar múltiplos títulos e realizar a ação desejada de forma conjunta.
Image Added
| Deck of Cards |
|---|
|
| Card |
|---|
| default | true |
|---|
| id | resend |
|---|
| label | Reenviar Pagamento |
|---|
| A ação múltipla Reenviar Pagamento permite reenviar diversos títulos para o banco em um único processo. | Informações |
|---|
| Apenas itens com situação "Erro" ou "Reaberto" podem ser reenviados.
Caso seja selecionado algum item com outra situação, o sistema bloqueará o reenvio e exibirá uma mensagem de aviso.
Será necessário ajustar a seleção na tabela antes de prosseguir.  Image Added
|
Ao confirmar a ação, será exibida uma tela de confirmação. Image Added Após a confirmação, o envio será encaminhado ao servidor RPW configurado, com a geração de um Número de Pedido de Execução, que será responsável pelo processamento. Ao final, será atualizada a situação de todos os títulos reenviados conforme o retorno do banco. Image Added |
| Card |
|---|
| default | true |
|---|
| id | waiting |
|---|
| label | Aguardando |
|---|
| Quando um pagamento é enviado ou reenviado ao banco, há um prazo para que o banco retorne com o status atualizado do título. Caso esse retorno não ocorra dentro do tempo esperado, o sistema mantém o título com a situação "Aguardando" e no Pagamento (visualizado por meio da expansão), o campo Status do Banco permanece como "PENDING_VALIDATION". Nessas situações, é necessário solicitar manualmente uma nova atualização ao banco para obter a situação atualizada do pagamento. Para isso, deve-se utilizar a ação "Aguardando". Ao selecionar os títulos com a situação "Aguardando" e acionar essa opção, o sistema enviará um lote de títulos ao servidor RPW, que, por sua vez, fará a comunicação com o banco.
O objetivo é solicitar o status atualizado de cada título para que a situação seja corretamente refletida no sistema.  Image Added
| Informações |
|---|
| Caso seja selecionado algum item com outra situação, o sistema bloqueará o reenvio e exibirá uma mensagem de aviso.
Será necessário ajustar a seleção na tabela antes de prosseguir. |
Após a seleção válida da ação, o envio será encaminhado ao servidor RPW configurado, com a geração de um Número de Pedido de Execução, que será responsável pelo processamento. Ao final, o sistema atualizará automaticamente a situação de todos os títulos reenviados conforme o retorno do banco. |
| Card |
|---|
| A ação múltipla Eliminar permite excluir, de forma simultânea, diversos títulos que estejam com a situação "Erro". Essa opção estará disponível apenas quando a situação do pagamento for "Erro". Ao selecionar essa ação, será exibida uma tela de confirmação da eliminação dos títulos selecionados.  Image Added
Após a confirmação, o sistema apresentará uma tela de retorno, informando se os pagamentos foram eliminados com sucesso ou não eliminados, nos casos em que houver alguma inconsistência que impeça a exclusão.  Image Added
|
|
