[Beta] Como funciona o sistema de remessa de retorno de pagamento?

O sistema de recepção de arquivos de remessa de retorno de pagamento é composto por apenas uma etapa conforme descrito abaixo.

Etapa 1 | Nova remessa de retorno: envie um arquivo de remessa de retorno

Nessa etapa o usuário é capaz de enviar um arquivo padrão de importação de remessa de retorno de pagamento. Este é um arquivo de confirmação de pagamento emitido pelo banco ou pelo ERP.

1. Clique em "Ações" > "Adicionar nova remessa de retorno";

   1. Caso precise, clique em "Ações" > "Baixar .CSV modelo" para ter acesso ao arquivo de modelo de importação.
2. Um popup será aberto com a opção de adicionar comentários à remessa de retorno e um botão para anexar um arquivo. Este arquivo é um padrão de acordo com a descrição abaixo
   1. ID da Remessa de Pagamento [campo obrigatório]: identificador único da remessa de pagamento que esse registro está incluído, este campo permite a sincronização entre remessas para pagamento e remessas de retorno de pagamento. Este campo é no formado de número inteiro;
   2. ID do Arquivo [campo obrigatório]: ID do arquivo na CUBi no formato de número inteiro;
   3. Valor total pago [campo obrigatório]: valor total pago no formato ####.## (sem separador de milhar, com ponto como separador de decimal);
   4. Data de pagamento efetivado [campo obrigatório]: data do pagamento efetivado no formato DD/MM/AAAA. Por exemplo a data 9 de Janeiro de 2026 deve ser registrada como 09/01/2026 e não como 9/01/2026 ou 09/01/26;
   5. Número do comprovante de pagamento [campo opcional]: código de confirmação da liquidação do pagamento informado pelo banco ou ERP;
   6. Método de Pagamento Efetivado [campo opcional]: código ou descrição do método de pagamento gerado pelo banco ou ERP;
   7. ID do registro externo [campo opcional]: identificador único externo ao sistema da CUBi para controle do usuário em sistemas externos.
3. Ao confirmar o upload do arquivo no formato .csv com os campos descritos acima o sistema tentará conciliar todos os registros presentes na remessa de retorno com registros presentes em remessas de pagamento existentes. Caso um registro na remessa de retorno não seja encontrado em uma remessa de pagamento, a coluna "Check - arquivo + remessa" será preenchida automaticamente com "Não encontrado", caso contrário "Existente".
4. Todo arquivo ficará com o status = "Processando" após o envio e pode levar até 2 minutos até que complete todos as checagens. O usuário deve atualizar a página em Ações > "Atualizar remessas" para verificar se a remessa já está pronta para ser visualizada;
5. Todas as remessas de retorno ficam disponíveis para verificação na aba do menu superior horizontal "Retorno".
6. Depois da sincronização, todos os campos enviados na remessa de retorno e o ID da remessa ficam disponíveis nas tabelas do sistema da CUBi relacionados ao ID do arquivo associado. Se houver mais de uma remessa de retorno para o mesmo ID de arquivo, apenas os dados da remessa mais recente serão associados ao ID do arquivo e o campo de ID da remessa de retorno será concatenado com o ID de todas remessas que continham o ID do arquivo.