VERO
Banricompras
Especificação de Interface
Retorno Banricompras por Conveniado
1
Arquivos de Retorno
O Banrisul permite de forma simplificada e segura que o credenciado tenha
controle total sobre as transações efetuadas na rede Banricompras, desde o
momento da compra até o crédito na conta corrente, através da geração diária
dos seguintes arquivos:
BJRVCA1 – Arquivo Geral de Operações
No dia posterior da transação Banricompras, informamos para o
credenciado todas as transações capturadas, mesmo as pendentes. Esta
informação permite identificar se todas as transações foram recebidas no
Banrisul e se existe alguma transação pendente para ser resolvida.
BJRVCP1 –Pendências Resolvidas
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.
BJRVCC1 – Conciliação Financeira
No dia do crédito na conta corrente, informamos a transação neste arquivo,
encerrando o ciclo desta transação Banricompras. 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.
2
Relatórios Recibo de Tarifas
Atendendo as normas de segurança PCI para cartões de crédito e atividades
de Complice, o Banricompras gera mensalmente um Recibo detalhado com todas
as tarifas debitadas para os estabelecimentos durante o mês.
3
Esquema Retorno
4
Arquivo Geral de Operações
4.1 Características
Tamanho do registro:
320
Identificador:
BJRVCA1
Nome no Cliente:
BANRICOMPRAS.BJR02.Dddmm Arquivo
Periodicidade:
Diária
4.2 Descrição
Contempla todas as parcelas das operações de pagamento solicitadas de
forma on-line pela rede comercial ao autorizador Banricompras do Banrisul,
independentemente de as mesmas terem sido ou não completadas.
4.3 Layout dos registros
1.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" Identificador do Arquivo 008 043 050 Alfa "BJRVCA1"
Data Referência Banrisul 008 051 058 Data Data de referência das informações AAAAMMDD Data Geração 008 059 066 Data Data de geração do arquivo AAAAMMDD Hora Geração 006 067 072 Hora Hora de geração do arquivo HHMMSS
Origem 010 073 082 Alfa “VERO”
CNPJ Conveniado 014 083 096 Num CNPJ do conveniado
Brancos 215 097 311 Alfa Brancos
1.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 Vero
015 028 042 Num Identificação do estabelecimento para a Vero Terminal 008 043 050 Alfa Identificação do terminal
Data Movimento 008 051 058 Data Data da operação AAAAMMDD NSU movimento 008 059 066 Num Número sequencial ú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 do Banrisul HHMMSS Data Origem 008 077 084 Data Data informada pela rede AAAAMMDD Hora Origem 004 085 088 Hora Hora informada pela rede HHMM NSU Origem 006 089 094 Num NSU da origem
Cód. Mensagem 004 095 098 Num Código da mensagem ISO Cód. Processamento 006 099 104 Num Código de processamento 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 AAAAMMDD Tarifa Admin Fixa 006 149 154 Num Tarifa fixa de administração (valor fixo)
Taxa Administração 006 155 160 Num Taxa de administração (percentual) Tarifa Admin Cobrada 010 161 170 Num Valor da tarifa de administração cobrada
Tarifa Comunicação 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
AAAAMMDD
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 003 266 268 Num Data do movimento em juliano
NSU Formato Antigo 006 269 274 Num NSU no formato antigo com os seis últimos dígitos
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
BIN 006 291 296 Char 6 primeiros dígitos do PAN
PAN 004 297 300 Char 04 últimos dígitos do PAN
Reserva 011 301 311 Alfa Brancos
1.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" Identificador do Arquivo 008 043 050 Alfa "BJRVCA1"
Data Referência Banrisul 008 051 058 Data Data de referência das informações AAAAMMDD Data Geração 008 059 066 Data Data de geração do arquivo AAAAMMDD Hora Geração 006 067 072 Hora Hora de geração do arquivo HHMMSS
Origem 010 073 082 Alfa “VERO”
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
Sequência Registro 009 312 320 Num Número sequencial do registro
4.4 Observações
4.4.1 Código da Mensagem
Será sempre preenchido com "0200", indicando uma operação de
pagamento.
4.4.2 Código de Processamento
Identifica a forma de pagamento:
"002000" - pagamento à vista
"002800" - pagamento parcelado com parcela à vista (com entrada)
"002890" - pagamento parcelado sem parcela à vista
"002899" - pagamento c/ Crédito 1 Minuto (CDC)
"003900" - pagamento c/ Banco Sim Parcelado (CDC)
“002898” – pagamento pessoa jurídica (Giro Fácil)
4.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:
"PGTA" - pagamento à vista
"PGTP" - pagamento pré-datado (a prazo)
"PGTX" - pagamento parcelado
"PGTF" - pagamento c/ Crédito 1 Minuto (CDC)
"PGTB" - pagamento c/ Banco Sim Parcelado (CDC)
“PGTJ” – pagamento pessoa jurídica (Giro Fácil)
4.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
"20" - Não autorizada
"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
4.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.
4.4.6 Quantidade de parcelas
Informa em quantas parcelas fazem parte da mesma operação quando
de uma operação de pagamento parcelado. No caso das outras formas de
pagamento este campo informa "01".
4.4.7 Data de Efetivação
Data de efetivação do crédito na conta do estabelecimento
5
Arquivo de Pendências Resolvidas
5.1 Características
Tamanho do Registro:
320
Nome do Arquivo:
BJRVCP1
Nome Arquivo Cliente:
BANRICOMPRAS.BJR04.Dddmm Arquivo de Pendências
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.
5.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.
5.3 Layout dos registros
O arquivo de Pendências Resolvidas layout igual ao arquivo Geral de
Operações. No arquivo de Pendências Resolvidas, entretanto, os campos abaixo terão
conteúdos diferentes:
Nome do Arquivo:
"ARQUIVO DE PENDENCIAS RESOLVIDAS"
Identificador do Arquivo:
"BJRVCP1"
6
Arquivo de Conciliação Financeira
6.1 Características
Tamanho do Registro:
320
Identificador:
BJRVCC1
Nome Arquivo Cliente:
BANRICOMPRAS.BJR06.Dddmm Arquivo de Conciliação Financ.
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.
6.2 Descrição
O arquivo de Conciliação Financeira 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.
6.3 Layout dos registros
3.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 DE CONCILIACAO FINANCEIRA" Identificador do Arquivo 008 043 050 Alfa "BJRVCC1"
Data Referência Banrisul 008 051 058 Data Data de referência das informações AAAAMMDD Data Geração 008 059 066 Data Data de geração do arquivo AAAAMMDD Hora Geração 006 067 072 Hora Hora de geração do arquivo HHMMSS
Origem 010 073 082 Alfa “VERO”
CNPJ Conveniado 014 083 096 Num CNPJ do conveniado
Reserva 215 097 311 Alfa Brancos
Sequência Registro 009 312 320 Num “000000001”
3.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 Identificação da rede para a Vero
Estabelecimento 015 014 028 Num Identificação do estabelecimento para a Vero Data Lançamento 008 029 036 Data Data do crédito AAAAMMDD Cód. Lançamento 004 037 040 Num 0001 – à vista
0002 – parcelado com entrada 0003 – parcelado sem entrada 0004 – pré-datado 0005 – Banco SIM parcelado
0006 - Crédito 1 Minuto
0007 – parcelado liquidado pelo cliente 0008 – pré-datado pelo cliente
0009 – Giro Fácil
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
Sequência Registro 009 312 320 Num Número sequencial do registro
3.3.3 Registro de Parcela do Lançamento
Campo Tam Início Fim Tipo Descrição Tipo Registro 002 001 002 Alfa “20”
Rede 011 003 013 Num Identificação da Rede para a Vero
Estabelecimento 015 014 028 Num Identificação do Estabelecimento para a Vero Data Lançamento 008 029 036 Data Data do crédito AAAAMMDD Cód. Lançamento 004 037 040 Num Código de lançamento
Seq. Lançamento 002 041 042 Num Número lançamento para a mesma data e código Data Movimento 008 043 050 Num Data da operação AAAAMMDD NSU movimento 008 051 058 Data Número sequencial único da operação
Parcela 002 059 060 Num Número da parcela da operação
Valor 015 061 075 Num Valor da parcela
Tarifa Admin Fixa 006 076 081 Num Tarifa fixa de administração (valor fixo) Taxa Administração 006 082 087 Num Taxa de administração (percentual) Tarifa Administração 010 088 097 Num Valor da tarifa de administração cobrada Tarifa Comunicação 010 098 107 Num Valor da tarifa de comunicação cobrada
Valor Líquido 015 108 122 Num Valor líquido da parcela
Pedido 040 123 162 Alfa Identificador do pedido (para movimento Internet)
Reserva 149 163 311 Alfa Brancos
Sequência Registro 009 312 320 Num Número sequencial do registro
Obs.: Os registros do Tipo “10” estão relacionados com o registro tipo “20” através dos campos Rede, Estabelecimento, Data Lançamento, Cód. Lançamento, Seq. Lançamento
3.3.4 Trailer
Campo Tam Início Fim Tipo Descrição/Conteúdo Tipo Registro 002 001 002 Alfa “99”
Nome do Arquivo 040 003 042 Alfa "ARQUIVO DE CONCILIACAO FINANCEIRA" Identificador do Arquivo 008 043 050 Alfa "BJRVCC1"
Data Referência Banrisul 008 051 058 Data Data de referência das informações AAAAMMDD Data Geração 008 059 066 Data Data de geração do arquivo AAAAMMDD Hora Geração 006 067 072 Hora Hora de geração do arquivo HHMMSS
Origem 010 073 082 Alfa “VERO”
CNPJ Conveniado 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