VERO De Adquirência Especificação de Interface Retorno Adquirência por Conveniado 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. Página 4
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 040 003 042 Alfa "ARQUIVO GERAL DE OPERACOES ACQUIRER" Identificador do Arquivo Data Referência Banrisul Cartões 008 043 050 Alfa "BJRVCM8" 008 051 058 Data data de referência das informações Data Geração 008 059 066 Data data de geração do arquivo Hora Geração 006 067 072 Hora hora de geração do arquivo HHMMSS Origem 010 073 082 Alfa BANRISUL CARTÕES CNPJ Conveniado 014 083 096 Num CNPJ do conveniado Brancos 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 011 017 027 Num identificação da rede para a Banrisul Cartões Estabelecimento 015 028 042 Num identificação do estabelecimento para a Banrisul Cartões Terminal 008 043 050 Alfa Identificação do terminal Data Movimento 008 051 058 Data data da operação NSU movimento 008 059 066 Num número seqüencial único da operação Parcela 002 067 068 Num número da parcela da operação Qtde Parcelas 002 069 070 Num quantidade de parcelas Hora Movimento 006 071 076 Num hora da Banrisul Cartões HHMMSS Data Origem 008 077 084 Data data informada pela rede Hora Origem 004 085 088 Hora hora informada pela rede HHMM NSU Origem 006 089 094 Num NSU da origem Cod Mensagem 004 095 098 Num código da mensagem ISO Cod Processamento 006 099 104 Num código de processamento Página 6
Serviço 004 105 108 Alfa identificação do serviço Situação 002 109 110 Num situação Valor 015 111 125 Num valor da venda Valor Parcela 015 126 140 Num valor da parcela Data Crédito 008 141 148 Data data do crédito Tarifa Admin Fixa 006 149 154 Num tarifa fixa de administração (valor fixo) Taxa Administração Tarifa Admin Cobrada Tarifa Comunicação 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 Valor Líquido 015 177 191 Num valor líquido da parcela Prazo 003 192 194 Num prazo informado da parcela Prazo Ùltima Parcela 003 195 197 Num prazo informado da última parcela Data Confirmação 008 198 205 Data data confirmação / resolução pendência Hora Confirmação 006 206 211 Hora hora confirmação / resolução pendência HHMMSS Id Pedido B2B 040 212 251 Alfa Identificação informada no B2B CNPJ/CPF B2B 014 252 265 Alfa CNPJ do cliente que realizou a compra B2B Data do movimento NSU do movimento 009 266 274 Num Data do movimento em juliano + NSU do movimento JJJNNNNNN Página 7
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 003 291 293 Num Bandeira do cartão de crédito BIN 006 294 299 Char 6 primeiros dígitos do PAN PAN(4 últimos dígitos) 004 300 303 Char 4 últimos dígitos do PAN Reserva 008 304 311 Alfa brancos Seqüência Registro 009 312 320 Num número seqüencial do registro Página 8
3.3.3 Trailer Campo Tam Início Fim Tipo Descrição Tipo Registro 002 001 002 Alfa 99 Nome do Arquivo 040 003 042 Alfa "ARQUIVO GERAL DE OPERACOES ACQUIRER" Identificador do Arquivo Data Referência Banrisul Cartões 008 043 050 Alfa "BJRVCM8" 008 051 058 Data data de referência das informações Data Geração 008 059 066 Data data de geração do arquivo Hora Geração 006 067 072 Hora hora de geração do arquivo HHMMSS Origem 010 073 082 Alfa BANRISUL CARTÕES CNPJ Conveniado 014 083 096 Num CNPJ do conveniado Qtde Registros G1 009 097 105 Num quantidade de registros tipo 10 Reserva 206 106 311 Alfa brancos Seqüência Registro 009 312 320 Num número seqüencial do registro Página 9
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: "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 Página 10
"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 "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 formas de pagamento este campo informa "01". 3.4.7 Data de Efetivação Página 11
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 "001" Banricompras (Não usada, use interface Banricompras). "002" MasterCard "003" Visa "006" Verdecard. 007 - Banricard 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 Página 12
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 Acquirer. 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" 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. Página 13
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. Página 14
5.3 Layout dos registros 5.3.1 Header Campo Tam Início Fim Tipo Descrição/Conteúdo Tipo Registro 002 001 002 Alfa 00 Nome do Arquivo 040 003 042 Alfa "ARQUIVO CONCILIACAO FINANCEIRA ACQUIRER" Identificador do Arquivo Data Referência Banrisul Cartões 008 043 050 Alfa "BJRVCC1" 008 051 058 Data data de referência das informações Data Geração 008 059 066 Data data de geração do arquivo Hora Geração 006 067 072 Hora hora de geração do arquivo HHMMSS Origem 010 073 082 Alfa BANRISUL CARTÕES CNPJ Conveniado 014 083 096 Num CNPJ do conveniado Reserva 215 097 311 Alfa brancos Seqüência Registro 009 312 320 Num 000000001 Página 15
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 008 029 036 Data data do crédito Cod Lançamento 004 037 040 Num 0201 débito à vista 0202 crédito à vista 0203 crédito parcelado lojista 0205 cancelamento/chargeback 0206 parcela à vista crédito parcelado lojista 0207 crédito parcelado emissor Seq Lançamento 002 041 042 Num número lançamento para a mesma data e código CNPJ Estab 014 043 056 Num CNPJ do estabelecimento Agência 004 057 060 Num agência do crédito Conta 010 061 070 Num conta corrente do crédito Valor Lançamento 015 071 085 Num valor do lançamento em conta corrente Reserva 226 086 311 Alfa brancos Seqüência Registro 009 312 320 Num número seqüencial do registro Página 16
5.3.3 Registro de Parcela do Lançamento Campo Tam Iníc io 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 Tarifa Admin Fixa Taxa Administração Tarifa Administração Tarifa Comunicação 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 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 Página 17
Valor Líquido Pedido CNPJ Estab Reserva 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 Seqüência Registro 009 312 320 Num número seqüencial do registro Página 18
5.3.4 Trailer Campo Tam Iníc io 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 197 115 311 Alfa brancos Seqüência Registro 009 312 320 Num número seqüencial do registro Observação: 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 19