UC00091 - Conciliador de Cartão de Crédito

Introdução

A partir de um arquivo de movimentações (vendas realizadas) disponibilizado pelas administradoras de cartão, um webservice fará a leitura das vendas listadas no mesmo confrontando-as com os pedidos realizados no sistema da ATS permitindo a conferência, ajuste e até mesmo a liquidação do financeiro com base no que foi pago (de acordo com o arquivo da administradora).

A rotina/funcionalidade de conciliação de cartões será vendida como um módulo a parte. Uma vez que o usuário do sistema possui o Resulth CARD em sua senha, independente se ele utiliza a versão Start ou Business será visível no Menu -> Movimentos -> Receber a rotina Conciliação de cartões.

    
    O webservice que faz a leitura dos arquivos das administradoras de cartão será o mesmo tanto para o sistema Java quanto para o sistema Delphi.

RN01 - Administradora de cartão ou financeira

Para clientes que possuírem o módulo Resulth CARD em sua senha, em Menu -> Cadastros -> Receber/Pagar -> Financeiras/Cartão -> Administradora de cartão ou financeira, sempre que uma administradora de cartão for cadastrada (campo Tipo cartão / financeira = Cartão) o usuário deverá, obrigatoriamente, preencher o campo Administradora da aba "Administradora de cartão ou financeira" da rotina em questão.

Uma vez que o campo Administradora foi preenchido, quando for utilizada a forma de pagamento Cartão em conjunto com a administradora de cartão em questão no PDV serão visualizados na tela dois novos campos conforme regra de negócio RN11 do caso de uso UC00072 - Ponto de venda.

RN02 - Contratos

Será criada em Menu -> Movimentos -> Receber -> Conciliação de cartões a rotina Contratos, onde o usuário poderá cadastrar, para cada filial, os contratos que ele possui com a(s) administradora(s) de cartão.

Tela de pesquisa

Listará todos os contratos cadastrados em um grid com as seguintes colunas:

1. FILIAL: Código (3 dígitos) + nome da filial.
2. Nº CONTRATO: Número do contrato com a administradora de cartão.
3. ADM. CARTÃO: Informação do campo Administradora na aba "Administradora de cartão ou financeira" da administradora de cartão utilizada.
4. FORMA DE PGTO.: Forma de pagamento informada no cadastro do contrato. Nesta coluna será exibido o nome da forma de pagamento concatenado com o banco, agência e conta configurados no cadastro da mesma.

Tela de manutenção

1. Filial: Campo onde deverá ser selecionada, obrigatoriamente, uma filial que possui contrato com a administradora de cartão.
2. Nº Contrato: Campo onde deverá ser informado, obrigatoriamente, o número do contrato da filial com a adminitradora de cartão.
3. Administradora de cartão: Campo onde deverá ser selecionada, obrigatoriamente, a administradora de cartão referente ao número de contrato e filial informados. Neste campo serão listadas somente as administradoras de cartão cadastradas no sistema que possuem informado o campo Administradora na aba "Administradora de cartão ou financeira" de seu cadastro.
4. Forma de pagamento: Neste campo deverá ser selecionada, obrigatoriamente, uma forma de pagamento a ser utilizada na conciliação. Dentre todas as formas de pagamento cadastradas somente serão listadas aquelas que tiverem marcado em seu cadastro o parâmetro Integra banco e que tiverem informado o campo Conta bancária.

    
    O sistema não permitirá que sejam cadastrados registros sem que todos os dados obrigatórios sejam preenchidos. 
    Também não será permitido cadastrar dois registros com filial/nº contrato/administradora de cartão iguais.

    
    Logo abaixo do campo Forma de pagamento deverá ser exibido na tela o seguinte aviso: Neste campo somente serão listadas formas de pagamento que integram com banco 
    e que possuem banco/agência/conta informados em seu cadastro.

RN03 - Conciliação de cartões

Será criada em Menu -> Movimentos -> Receber -> Conciliação de cartões a rotina Conciliação. Quando acessada a nova rotina exibirá ao usuário:

1. Arquivo: Campo que permitirá ao usuário selecionar em seu computador um arquivo de uma administradora de cartão. Atualmente será permitido importar somente arquivos de CONFIRMAÇÃO da administradora CIELO. Caso usuário informe um arquivo que não seja da cielo e que não seja de confirmação a importação será abortada e o sistema exibirá uma mensagem com a não conformidade.
2. Botão [OK]: Quando acionado faz o upload do arquivo informado no campo anterior invocando o webservice para realizar o processamento do mesmo.
3. Botão [Cancelar]: Aborta qualquer operação em andamento e retorna à tela inicial do sistema.
4. Grid: Exibido somente após o webservice processar um arquivo válido, listará os resultados separados por cor conforme segue abaixo:
   • Dados do arquivo importado: Esta seção listará dados contidos no arquivo importado nas cores padrão do sistema (cinza e branco) com as seguintes colunas:
     • OPERADORA: Administradora de cartão referente ao arquivo processado.
     • AUTORIZAÇÃO: Número de autorização obtido no ato da venda pela maquineta.
     • NÚMERO: Número da venda, também obtido no pela maquineta.
     • Nº PARCELA: Em caso de vendas parceladas, informa o número da parcela a qual os demais dados se referem.
     • CONTRATO: Exibe o número do contrato com a administradora de cartão. Vale lembrar que se houver para uma mesma administradora de cartão contratos diferentes para diferentes filiais estes serão exibidos nesta coluna, ou seja, serão consideradas vendas com cartão realizadas em todas as filiais cadastradas no sistema.
     • NÚMERO RO: Exibe o RO da transação. Será utilizado, futuramente, para processar o arquivo de antecipações (CIELO06)
     • TIPO MOVIMENTO: Exibe o tipo de movimento a qual se refere o arquivo informado.
     • VALOR BRUTO: Exibe o valor efetivo da venda/parcela realizada com a forma de pagamento cartão utilizando a administradora de cartão em questão no PDV.
     • VALOR LÍQUIDO: Exibe o valor da venda/parcela deduzido da taxa administrativa informada no cadastro do plano de financeira utilizado na venda.
     • VALOR TAXA: Exibe o valor da taxa deduzida do valor bruto (taxa administrativa). Em outras palavras, representa a diferença entre o valor bruto e o valor líquido.
   • Dados do contas a receber: Esta seção listará os documentos a receber gerados a partir das vendas feitas no PDV e que estão relacionadas no arquivo importado nas cores lilás e branco com as seguintes colunas:
     • TD: Tipo do documento.
     • Nº DOCTO. RECEBER: Número do documento/parcela a receber.
     • DATA EMISSÃO: Data de emissão do documento/parcela a receber.
     • DATA VENCIMENTO: Data de vencimento do documento/parcela.
     • VALOR ORIGINAL: Valor original do documento (sem descontos, acréscimos ou juros/multa).
     • VALOR EM ABERTO: Valor em aberto para o documento/parcela.
     • VALOR DIFERENÇA: Caso haja diferença entre a coluna VALOR LÍQUIDO (dados do arquivo) e a coluna VALOR ORIGINAL (dados do documento) a coluna em questão a exibirá, seja ela positiva ou negativa.
     • SITUAÇÃO: Situação do documento/parcela a receber.
     • AJUSTE: Esta coluna exibe um botão que quando acionado abre em uma nova aba do navegador a rotina de entrada de documento simples (receber) já carregada com os dados do documento/parcela da linha cujo botão em questão foi acionado. Isto permitirá ao usuário ajustar o valor, emissão ou vencimento do documento/parcela a receber caso necessário. Este botão será visível somente para registros cuja diferença de valor é maior que 0,05 ou que a diferença de vencimento é maior que 3 dias em relação ao arquivo.
5. STATUS: Coluna que exibe ao usuário mensagens de informação, erros ou problemas relacionados ao cruzamento dos dados do arquivo importado com os documentos a receber existentes no sistema.

Logo abaixo do grid na parte inferior direita da tela serão exibidos os botões:

• OK: Quando acionado faz a conciliação dos registros contidos no arquivo importado com os documentos a receber relacionados gravando nos mesmos a informação da coluna RO do arquivo para cada venda. Além de gravar o RO nos documentos a receber o sistema também irá gravar os ajustes automáticos realizados no valor e no vencimento antes de lista-los no grid.
  • Se houver no grid documentos cuja linha está na cor vermelha, ou seja, cujo vencimento tem diferença maior que 3 dias ou que o valor tem diferença maior que 0,05 em relação aos dados do arquivo importado, o sistema irá abortar a gravação e exibirá ao usuário uma mensagem com a não conformidade orientando-o a fazer o ajuste manual.
  • Se houver no grid linhas onde na seção de documentos a receber os dados estão vazios, a gravação da conciliação procederá normalmente ignorando estas linhas.
• Cancelar: Aborta a operação atual retornando o usuário para tela inicial do sistema.

Cruzamento de informações

Assim que o arquivo da administradora de cartão for importado o sistema procurará na filial logada por documentos a receber cuja autorização e número (informadas no PDV) correspondem aos respectivos dados contidos no arquivo. Os documentos a receber encontrados serão listados no grid em sua respectiva seção.

    
    Documentos a receber encontrados e listados no grid com diferença de valor maior que 0,05 ou diferença no vencimento maior que 3 dias em relação às informações do arquivo que não 
    foram ajustados manualmente impedirão que os dados da conciliação sejam salvos, ou seja, quando o botão [OK] for acionado o sistema abortará a gravação e exibirá ao usuário uma 
    mensagem com a não conformidade.     

Documentos não encontrados

Caso não sejam encontrados documentos a receber que correspondam as informações contidas no arquivo importado, no grid as linhas do arquivo na seção Dados do contas a receber deverão ficar vazias. Para as linhas do grid que se enquadram nesta situação será exibido na coluna AJUSTES o botão [Pesquisar documento] que quando acionado exibirá ao usuário um pop-up que possibilitará a pesquisa e a seleção de um determinado documento que corresponda à linha do arquivo cujo botão foi acionado.

O pop-up deverá ser chamado Pesquisa de documentos e terá os seguintes campos e funcionalidades:

Filtros

• Período: Campo onde poderá ser informada uma data inicial e final para filtrar vendas realizadas neste período.
• Faixa de valor: Campo onde poderá ser informado um valor inicial e final para filtrar vendas cujo total está nesta faixa.
• Plano de financeira: Campo onde poderá ser informado um plano de financeira (equivalente as parcelas) para filtrar vendas cuja forma de pagamento cartão utilizou o planto em questão.
• Botão [Consultar]: Botão que quando acionado leva em consideração os filtros informados e busca por vendas finalizadas com a forma de pagamento cartão utilizando a administradora de cartão correspondente ao arquivo informado. Vendas finalizadas com outras formas de pagamento ou com outras administradoras de cartão não serão consideradas na filtragem.

Resultados

As vendas que na filtragem se encaixaram nos filtros informados serão listadas em um grid detalhável com as seguintes colunas:

• Mestre
  • Botão [Expandir]: Exibido sempre na primeira coluna do grid este botão exibe o detalhamento da linha cujo botão foi acionado.
  • Selecionar: Checkbox que permite ao usuário selecionar um determinado pedido que terá suas parcelas vinculadas à linha do arquivo da administradora que invocou o pop-up em questão. O sistema não permitirá que dois pedidos sejam selecionados simultaneamente.
  • Nº PEDIDO: Exibe o número do pedido.
  • DATA: Exibe a data do pedido.
  • CLIENTE: Exibe o cliente do pedido.
  • TOTAL: Exibe o total do pedido.
• Detalhe: Quando o botão [Expandir] da primeira coluna for acionado, os documentos/parcelas a receber gerados a partir de um determinado pedido serão listados nas seguintes colunas:
  • TD: Tipo do documento.
  • Nº DOCTO.: Número do documento.
  • EMISSÃO: Data de emissão do documento.
  • VENCIMENTO: Data de vencimento do documento.
  • VALOR BRUTO: Valor bruto do documento/parcela.
  • VALOR LÍQUIDO: Valor líquido do documento/parcela, ou seja, o valor bruto deduzido da taxa administrativa do plano da financeira que o gerou.
  • SITUAÇÃO: Exibe a situação atual do documento/parcela.

Após selecionar o pedido desejado o usuário deverá acionar o botão [OK] na parte inferior direita da tela Pesquisa de documentos. Quando este botão for acionado, antes de vincular as parcelas geradas de um pedido à linha do arquivo importado o sistema fará as seguintes validações:

• O documento/parcela correspondente à parcela do arquivo e os demais documentos com data de vencimento superior deverão estar na situação em aberto, ou seja, não podem estar parcial ou totalmente liquidados.
• A quantidade de parcelas do pedido selecionado deve corresponder a quantidade de parcelas informada no arquivo importado.
• Os documentos/parcelas do pedido selecionado não podem ter um RO associado a eles.

Ajustes de valor e vencimento

Automático

• Documentos a receber com diferença de valor até 0,05 (para maior ou para menor) em relação as informações contidas no arquivo terão seu valor automaticamente ajustado com base no valor do arquivo. Este ajuste será gravado nos documentos a receber somente quando o botão [OK] da rotina de conciliação de cartões for acionado.
• Documentos a receber com diferença de vencimento até 3 dias em relação ao vencimento do arquivo terão o vencimento automaticamente ajustado com base no vencimento do arquivo. A exemplo do valor, o ajuste do vencimento só é gravado quando o botão [OK] for acionado.

Manual

Documentos a receber com diferença de valor maior que 0,05 ou diferença no vencimento maior que 3 dias deverão ser ajustados manualmente pelo usuário. Documentos a receber que se encaixam nesta situação serão tratados da seguinte forma:

• O texto na linha do grid para o documento em questão assumirá a cor vermelha (em todas as seções).
• Na coluna AJUSTE será visível o botão [Ajustar parcela].

Quando usuário acionar o botão [Ajustar parcela] na coluna AJUSTE de um determinado documento o sistema exibirá em uma nova aba a rotina de entrada de documento simples (a receber) já carregada com os dados do documento em questão. Lá o usuário deverá efetuar os devidos ajuste no valor e/ou vencimento do mesmo.

Após ajustar manualmente os dados do(s) documento(s) a receber o usuário deverá importar novamente o arquivo da administradora de cartão para que o sistema faça novamente o cruzamento das informações com o(s) documento(s) em questão com os valores já atualizados.

Webservice

Retorno de vendas

• Administradora: CIELO
• Tipo de arquivo: 'CNF', que remete à "confirmação".
• Tipo de movimento: 'CONFIRMACAO'
• Código da autorização: posições 67 a 72 registro tipo 2.
• Número do documento: Posições 67 a 72 registro tipo 2 (observar que a Redecard não terá este campo - retornar zeros).
• Número da parcela: posições 19 a 20 registro tipo 1. O cartão vem uma vez só, no movimento tipo '2'. Sendo assim, virtualmente criar as demais, lendo os registros do tipo '1', e usando os dados do cartão (autorização e documento) do registro '2'.
• Data: no caso de arquivo do tipo CNF, refere-se a data do vencimento, que deverá ser ajustado pela retaguarda. Proceder da mesma forma acima, usando o registro '2' para obter os dados do cartão, e os registro '1' n vezes para obter, de forma virtual, as datas. Refere-se às posições 32 a 37, no formato AAMMDD, para o registro do tipo '1'.
• Valor Bruto: valor bruto da parcela: posições 127 a 139, sendo as duas últimas decimais, do registro do tipo '2'. No caso da 1a. parcela, ajustar os centavos, observando o número de parcelas (posições 62 a 63), multiplicando pelo valor bruto das posições 127/139, comparando com o total da venda (posições 114 a 126). Repare a linha 27 do arquivo "arquivo de vendas detalhada.ret". A venda total foi de R$ 433,00, em 6 parcelas, em tese, de R$ 72,16. Entretanto, 6 * 72,16 = 432,96, e sendo assim, a primeira parcela desta venda, retornar R$ 72,20.
• Valor Liquido: valor liquido da parcela.
• RO: número do RO, posições 12 a 18.
• Contrato: posições 2 a 11.

Confirmação da venda

O web service de confirmação de venda, que trata arquivos do tipo CIELO01/CIELO02/CIELO03, COM DETALHAMENTO, deverá permitir a confirmação das transações de venda, e deverá permitir que a retaguarda ajuste valores de parcelas e datas de vencimento.

Retorno de antecipações

• Administradora: CIELO
• Tipo de arquivo: ANT, que remete à "confirmação".
• Tipo de movimento: ANTECIPACAO
• Código da autorização: vazio
• Número do documento: vazio
• Número da parcela: mandar o número da parcela, posições 36 a 37.
• Data: mandar a data de vencimento da operação, posições 21 a 28.
• Valor Bruto: posições 55 a 67
• Valor Liquido: refere-se ao valor após desconto. Posições 83 a 95
• RO: número do RO, posições 12 a 33 (não estranhar o tamanho diferente do acima)
• Contrato: posições 2 a 11

Arquivo CIELO

A cielo possui dois tipos de arquivo com a relação das vendas. O sistema deverá processar o arquivo da cielo e retornar uma coleção de registros, que deverá conter 3 tipos de transações:

• Confirmação de venda
• Liquidação
• Antecipação

Na primeira linha de todos os arquivos da cielo (posições 43 a 49), teremos a string CIELOxx, onde xx corresponde ao tipo de venda conforme segue abaxixo:

• CIELO01: Vendas com comprovante.
• CIELO02: Vendas sem comprovante (sites e-commerce é um setor, por exemplo, que gera este arquivo).
• CIELO03: Vendas com comprovante, parceladas.

Em última analise então, arquivos com a string CIELO01, CIELO02 e CIELO03 são arquivos de transação de vendas, que podem ser usados no dia seguinte da venda, para checar se a venda foi ok.

Já os arquivos 04,05,06,07 e 08, são relacionados com pagamentos, e estão assim convencionados.

• CIELO04: pagamento com comprovante
• CIELO05: pagamento sem comprovante
• CIELO06: antecipação
• CIELO07: cessão de direitos (NÃO será processado este arquivo)
• CIELO08: saldo pendente (NÃO será processado este arquivo

Leitura do arquivo

    
    Observação importante: arquivos sem detalhe (sem registro tipo 2) deverão ser recusados.

• Os registros a serem tratados são os começados com '6'. Neste tipo de arquivo, existe apenas uma linha do tipo '5', e o único dado que vamos precisar, seria a data de crédito, posições 21 a 28 (repetir em todas as parcelas, no campo data do movimento).
• Validar a primeira linha do arquivo, e verificar se nas posições 43 a 49 contém uma das seguintes constantes: CIELO01/CIELO02/CIELO03
• O arquivo conterá uma estrutura que contém um registro do tipo '1' (primeiro dígito da linha), um ou mais registros do tipo '2', e se alguns dos cartões tiver mais de uma parcela, mais registros do tipo '1' ao final. Exemplo abaixo (há mais dados à direita):

    
    11002617054490123801/0601131031131202000000+0000000140138-000000
    210026170544901238498453******648300020131031+00000000565500102 
    210026170544901238400970******172900020131031+00000000084500102 
    210026170544901238498453******112900020131031+00000000072200106 
    210026170544901238432031******912700020131031+00000000066680103 
    210026170544901238453211******184200020131031+00000000612500106 
    11002617054490123802/0601131031140102000000+0000000140132-000000
    11002617054490123803/0601131031140131000000+0000000075132-000000
    11002617054490123804/0601131031140305000000+0000000068466-000000
    11002617054490123805/0601131031140331000000+0000000068466-000000
    11002617054490123806/0601131031140501000000+0000000068466-00000

• No caso deste bloco, foram passados 5 cartões diferentes, e isto pode ser observado pela quantidade de registros do tipo '2', em no máximo 6 parcelas (isto é observado pela quantidade de registros do tipo '1' (a primeira linha, e mais 5 depois dos registros '2').

Arquivo de vendas com detalhes