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.

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.

    
    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.

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.
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á o resultado nas seguintes colunas:
   • OPERADORA: Administradora de cartão referente ao arquivo processado.
   • Nº AUTORIZAÇÃO: Número de autorização obtido no ato da venda pela maquineta.
   • Nº DOCTO. CARTÃO: 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:

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.

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-000000

• 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

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.

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