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

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.

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