VERO De Adquirência Especificação de Interface Retorno Adquirência por Conveniado Projeto: Coordenador do Projeto: Analista Responsável: Interfaces Gerados pela Rede Comercial Adquirência Paulo Mello Luciane Garcia Data de criação: 30/05/2011 Data de Atualização: Motivo Atualização: Responsável Atualização: Carlos Malafaia. Página 1
1 Arquivos de Retorno A Banrisul Cartões permite de forma simplificada e segura que o credenciado tenha controle total sobre as transações efetuadas na rede de Adquirência Vero, desde o momento da compra até o crédito na conta corrente, através da geração diária dos seguintes arquivos: BJRVCM8 Arquivo Geral de Operações Acquirer No dia posterior da transação na rede de adquirência Vero, informamos para o credenciado todas as transações capturadas, mesmo as pendentes. Esta informação permite identificar se todas as transações foram recebidas na Banrisul Cartões e se existe alguma transação pendente para ser resolvida. BOKVCM9 Pendências Resolvidas Acquirer Até 30 dias após a data da transação e antes da data do crédito, as pendências resolvidas, são informadas por este arquivo. BJRVCMB Conciliação Financeira Acquirer No dia do crédito na conta corrente, informamos a transação neste arquivo, encerrando o ciclo desta transação com cartão de crédito. Neste arquivo também é possível fazer o fechamento do valor total do lançamento na conta corrente com as transações que compõe este valor. Página 2
2 Esquema Retorno Compra Pagamento Consumidor Lojista Credenciado Banricompras Autoriza Banrisul Protocolo BJRVCA1 (geral) Pendência BOKVCP1 Liquidação Financeira BJRVCC1 Resolveu Pendência Recebeu Transação Créditou na Conta Corrente Lojista Credenciado Banricompras Ex.: Controle Transação Banricompras pelo Credenciado NSU Data Hora Recebida Banrisul Pendente (s/n) Creditada Conta Corrente Página 3
3 Arquivo Geral de Operações Acquirer 3.1 Características Tamanho do registro: 320 Identificador: BJRVCM8 Nome Arquivo Cliente: ADQUIRENTE.BJR72.DDDMM DDDMM: D3006 junho, D3105 maio. Periodicidade: Diária Informações: Próximo dia útil da data da transação (D + 1) 3.2 Descrição Contempla todas as parcelas das operações de pagamento solicitadas de forma on-line pela rede comercial de adquirência ao autorizador da bandeira do cartão de crédito, independentemente das mesmas terem sido ou não completadas. 3.3 Layout dos registros 3.3.1 Header Campo Tam Início Fim Tipo Descrição Tipo Registro 002 001 002 Alfa 00 Nome do Arquivo Identificador do Arquivo Data Referência Banrisul Cartões Data Geração Hora Geração 040 003 042 Alfa "ARQUIVO GERAL DE OPERACOES ACQUIRER" 008 043 050 Alfa "BJRVCM8" 008 051 058 Data data de referência das informações 008 059 066 Data data de geração do arquivo 006 067 072 Hora hora de geração do arquivo Página 4
HHMMSS Origem CNPJ Conveniado Brancos 010 073 082 Alfa BANRISUL CARTÕES 014 083 096 Num CNPJ do conveniado 215 097 311 Alfa brancos Seqüência Registro 009 312 320 Num 000000001 Página 5
3.3.2 Registro de Movimento Campo Tam Início Fim Tipo Descrição Tipo Registro 002 001 002 Alfa 10 CNPJ Estabelecimento 014 003 016 CNPJ de estabelecimento Rede Estabelecimento Terminal Data Movimento NSU movimento Parcela Qtde Parcelas Hora Movimento Data Origem Hora Origem NSU Origem Cod Mensagem Cod Processamento Serviço Situação Valor Valor Parcela Data Crédito 011 017 027 Num identificação da rede para a Banrisul Cartões 015 028 042 Num identificação do estabelecimento para a Banrisul Cartões 008 043 050 Alfa Identificação do terminal 008 051 058 Data data da operação 008 059 066 Num número seqüencial único da operação 002 067 068 Num número da parcela da operação 002 069 070 Num quantidade de parcelas 006 071 076 Num hora da Banrisul Cartões HHMMSS 008 077 084 Data data informada pela rede 004 085 088 Hora hora informada pela rede HHMM 006 089 094 Num NSU da origem 004 095 098 Num código da mensagem ISO 006 099 104 Num código de processamento 004 105 108 Alfa identificação do serviço 002 109 110 Num situação 015 111 125 Num valor da venda 015 126 140 Num valor da parcela 008 141 148 Data data do crédito Página 6
Tarifa Admin Fixa Taxa Administração Tarifa Admin Cobrada Tarifa Comunicação Valor Líquido Prazo Prazo Ùltima Parcela Data Confirmação Hora Confirmação Id Pedido B2B CNPJ/CPF B2B Data do movimento NSU do movimento 006 149 154 Num tarifa fixa de administração (valor fixo) 006 155 160 Num taxa de administração (percentual) 010 161 170 Num valor da tarifa de administração cobrada 006 171 176 Num valor da tarifa de comunicação cobrada 015 177 191 Num valor líquido da parcela 003 192 194 Num prazo informado da parcela 003 195 197 Num prazo informado da última parcela 008 198 205 Data data confirmação / resolução pendência 006 206 211 Hora hora confirmação / resolução pendência HHMMSS 040 212 251 Alfa Identificação informada no B2B 014 252 265 Alfa CNPJ do cliente que realizou a compra B2B 009 266 274 Num Data do movimento em juliano + NSU do movimento JJJNNNNNN Rede Estabelecimento 015 275 289 Num Rede (posição 02 com tamanho de 07) 00 Estabelecimento (posição 12 com tamanho de 04) 00 Rede Própria 001 290 290 Alfa IND_REDE_PROPRIA da tabela REDE S/N Bandeira Reserva Seqüência Registro 003 291 293 Num Bandeira do cartão de crédito 018 294 311 Alfa brancos 009 312 320 Num número seqüencial do registro Página 7
3.3.3 Trailer Campo Tam Início Fim Tipo Descrição Tipo Registro 002 001 002 Alfa 99 Nome do Arquivo Identificador do Arquivo Data Referência Banrisul Cartões Data Geração Hora Geração Origem CNPJ Conveniado 040 003 042 Alfa "ARQUIVO GERAL DE OPERACOES ACQUIRER" 008 043 050 Alfa "BJRVCM8" 008 051 058 Data data de referência das informações 008 059 066 Data data de geração do arquivo 006 067 072 Hora hora de geração do arquivo HHMMSS 010 073 082 Alfa BANRISUL CARTÕES 014 083 096 Num CNPJ do conveniado Qtde Registros G1 009 097 105 Num quantidade de registros tipo 10 Reserva Seqüência Registro 206 106 311 Alfa brancos 009 312 320 Num número seqüencial do registro 3.4 Observações 3.4.1 Código da Mensagem Será sempre preenchido com "9100", indicando uma operação com cartão de crédito. 3.4.2 Código de Processamento Identifica a forma de pagamento: Página 8
"002000"- pagamento com cartão de débito à vista "003000"- pagamento com cartão de crédito à vista "003100"- pagamento com cartão de crédito parcelado lojista "003800"- pagamento com cartão de crédito parcelado emissor 3.4.3 Serviço Será preenchido com um mnemônico, objetivando associar a transação (operação de pagamento), juntamente com a forma de realização de pagamento: "PGCD" - pagamento com cartão de débito "PGCC" - pagamento com cartão de crédito 3.4.4 Situação "00"- OK por confirmação "01"- OK pela resolução de pendências on-line "03"- OK pela resolução de pendências na operação seguinte "04"- OK pela resolução de pendências manual "10" Pendente 13 Pré-autorização "20"- Não autorizada 21 Não autorizada pela rede destino "40"- Cancelada pela origem "41"- Cancelada por resolução de pendências on-line "43"- Cancelada por resolução de pendências na operação seguinte "44"- Cancelada por resolução de pendências manual Página 9
"50" - Estornada 3.4.5 Parcela Informa o número da parcela a que o registro se refere. Notar que há um registro para cada parcela e os dados que se referem à operação como um todo se repetem em cada um deles. 3.4.6 Quantidade de parcelas Informa em quantas parcelas fazem parte da mesma operação quando de uma operação de pagamento parcelado lojista. Para uma operação de pagamento parcelado emissor, o registro é único, informando a quantidade de parcelas. No caso das outras forma de pagamento este campo informa "01". 3.4.7 Data de Efetivação Data de efetivação do crédito na conta do estabelecimento 3.4.8 Rede e Estabelecimento Concatenados Informa a identificação da rede para a Banrisul Cartões composta com a identificação do estabelecimento para a Banrisul Cartões, no seguinte formato: Rede posição 02 com tamanho de 07 00 Estabelecimento posição 12 com tamanho de 04 00 3.4.9 Bandeira Página 10
"001" Banricompras (Não usada, use interface Banricompras). "002" MasterCard "003" Visa "006" Verdecard. 4 Arquivo de Pendências Resolvidas 4.1 Características Tamanho do Registro: 320 Nome do Arquivo: BJRVCM9 Nome Arquivo Cliente: ADQUIRENTE.BJR74.DDDMM DDDMM: D3006 junho, D3105 maio. Periodicidade: Diária. Informação: Até 30 dias após a transação as pendências podem ser resolvidas e são retornadas neste arquivo. Por uma semana temos procedimento on-line, questionamos on-line ao credenciado se a pendência foi resolvida. Após uma semana o credenciado pode solicitar a resolução manualmente até 30 dias da data da transação, nestes casos o retorno também será neste arquivo. 4.2 Descrição Contempla as parcelas de todas operações realizadas anteriormente a data de referência, mas que ficaram pendentes e foram resolvidas na data de referência. 4.3 Layout dos registros O arquivo de Pendências Resolvidas Acquirer possui o layout igual ao arquivo Geral de Operações Aquirer. No arquivo de Pendências Resolvidas, entretanto, os campos abaixo terão conteúdos diferentes: Nome do Arquivo: "ARQUIVO PENDENCIAS RESOLVIDAS ACQUIRER" Identificador do Arquivo: "BJRVCM9" Página 11
5 Arquivo de Conciliação Financeira Acquirer 5.1 Características Tamanho do Registro: 320 Identificador: BJRVCB1 Nome Arquivo Cliente: ADQUIRENTE.BJR76.DDDMM DDDMM: D3006 junho, D3105 maio. Periodicidade: Diária. Informação: Na data da liquidação da operação (crédito em conta corrente), informando o valor do crédito e as transações que compõe este credito, permitindo a conciliação financeira efetiva. 5.2 Descrição O arquivo de Conciliação Financeira Acquirer contém as informações sobre os lançamentos efetivados na conta corrente em uma determinada data de referência. Ele difere do arquivo do item anterior pelo fato de que ele dá informações sobre os créditos realizados na data de referência (independentemente da data em que ocorreram), ou seja, indica a quitação do pagamento, enquanto que o arquivo do item anterior dá informações apenas sobre as operações referentes ao movimento da data de referência (cujos lançamentos ocorrerão no futuro). Cada registro tipo 10, corresponde a um grupo de parcelas, que estão sendo pagas num mesmo lançamento de crédito e os registros tipo 20 indicam as parcelas que estão sendo pagas e que fazem parte deste lançamento. 5.3 Layout dos registros 5.3.1 Header Página 12
Campo Tam Início Fim Tipo Descrição/Conteúdo Tipo Registro 002 001 002 Alfa 00 Nome do Arquivo Identificador do Arquivo Data Referência Banrisul Cartões Data Geração Hora Geração Origem CNPJ Conveniado Reserva 040 003 042 Alfa "ARQUIVO CONCILIACAO FINANCEIRA ACQUIRER" 008 043 050 Alfa "BJRVCC1" 008 051 058 Data data de referência das informações 008 059 066 Data data de geração do arquivo 006 067 072 Hora hora de geração do arquivo HHMMSS 010 073 082 Alfa BANRISUL CARTÕES 014 083 096 Num CNPJ do conveniado 215 097 311 Alfa brancos Seqüência Registro 009 312 320 Num 000000001 5.3.2 Registro de Lançamento Campo Tam Início Fim Tipo Descrição/Conteúdo Tipo Registro 002 001 002 Alfa 10 Rede 011 003 013 Num 00000000000 Estabelecimento 015 014 028 Num 000000000000000 Data Lançamento Cod Lançamento 008 029 036 Data data do crédito 004 037 040 Num 0201 débito à vista 0202 crédito à vista 0203 crédito parcelado lojista 0205 cancelamento/chargeback Página 13
0206 parcela à vista crédito parcelado lojista 0207 crédito parcelado emissor Seq Lançamento CNPJ Estab Agência Conta Valor Lançamento Reserva Seqüência Registro 002 041 042 Num número lançamento para a mesma data e código 014 043 056 Num CNPJ do estabelecimento 004 057 060 Num agência do crédito 010 061 070 Num conta corrente do crédito 015 071 085 Num valor do lançamento em conta corrente 226 086 311 Alfa brancos 009 312 320 Num número seqüencial do registro 5.3.3 Registro de Parcela do Lançamento Campo Tam Início Fim Tipo Descrição Tipo Registro 002 001 002 Alfa 20 Rede Estabelecimento Data Lançamento Cod Lançamento Seq Lançamento Data Movimento NSU movimento Parcela Valor 011 003 013 Num identificação da Rede para a Banrisul Cartões 015 014 028 Num identificação do Estabelecimento para a Banrisul Cartões 008 029 036 Data data do crédito 004 037 040 Num código de lançamento 002 041 042 Num número lançamento para a mesma data e código 008 043 050 Num data da operação 008 051 058 Data número seqüencial único da operação 002 059 060 Num número da parcela da operação 015 061 075 Num valor da parcela Página 14
Tarifa Admin Fixa Taxa Administração Tarifa Administração Tarifa Comunicação Valor Líquido Pedido CNPJ Estab Reserva Seqüência Registro 006 076 081 Num tarifa fixa de administração (valor fixo) 006 082 087 Num taxa de administração (percentual) 010 088 097 Num valor da tarifa de administração cobrada 010 098 107 Num valor da tarifa de comunicação cobrada 015 108 122 Num valor líquido da parcela 040 123 162 Alfa identificador do pedido (para movimento Internet) 014 163 176 Num CNPJ do estabelecimento 135 177 311 Alfa brancos 009 312 320 Num número seqüencial do registro Página 15
5.3.4 Trailer Campo Tam Início Fim Tipo Descrição/Conteúdo Tipo Registro 002 001 002 Alfa 99 Nome do Arquivo Identificador do Arquivo Data Referência Banrisul Cartões Data Geração Hora Geração Origem CNPJ Conveniado 040 003 042 Alfa "ARQUIVO DE CONCILIACAO FINANCEIRA" 008 043 050 Alfa "BJRVCC1" 008 051 058 Data data de referência das informações 008 059 066 Data data de geração do arquivo 006 067 072 Hora hora de geração do arquivo HHMMSS 010 073 082 Alfa BANRISUL CARTÕES 014 083 096 Num CNPJ do conveniado Qtde Registros F1 009 097 105 Num quantidade de registros tipo 10 Qtde Registros F2 009 106 114 Num quantidade de registros tipo 20 Reserva Seqüência Registro 197 115 311 Alfa brancos 009 312 320 Num número seqüencial do registro Obs.: Os registros do Tipo 10 estão relacionados com o registro tipo 20 através dos campos CNPJ Estab, Data Lançamento, Cod Lançamento, Seq Lançamento Página 16