Página | 1
Rede Comercial
VERO
Especificação de Interface
Retorno por Conveniado
Projeto: Interfaces Gerados pela Rede Comercial
Coordenador do Projeto: Paulo Mello
Analista Responsável: Débora Mester
Data de criação: 22/02/2008
Data de Atualização: 04/04/2013
Motivo Atualização: Inclusão de novos códigos de lançamento
Página | 2
1 Arquivos de Retorno
A Banrisul Cartões permite de forma simplificada e segura que o credenciado tenha controle total sobre as transações Vero efetuadas, 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 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.
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 Vero. 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, a Vero gera mensalmente um Recibo detalhado com todas as tarifas debitadas para os estabelecimentos durante o mês.
Página | 3 3 Esquema Retorno Lojista Credenciado Banricompras Protocolo BJRVCA1 (geral) Pendência BOKVCP1 Liquidação Financeira BJRVCC1 Consumidor Banrisul Lojista Credenciado Banricompras Compra Pagamento Autoriza Recebeu Transação Resolveu Pendência Créditou na Conta Corrente NSU Data Hora Recebida Banrisul Pendente (s/n) Creditada Conta Corrente Ex.: Controle Transação
Banricompras pelo Credenciado
Página | 4
4 Arquivo Geral de Operações
4.1 Características
• Tamanho do registro: 320 • Identificador: BJRVCA1 • Nome no Cliente: a definir
• Periodicidade: Diária
• Informações: Próximo dia útil da data da transação (D + 1)
4.2 Descrição
Contempla todas as parcelas das operações de pagamento solicitadas de forma on-line pela rede comercial ao autorizador Vero da Banrisul Cartões, independentemente das mesmas terem sido ou não completadas.
4.3 Layout dos registros
4.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 Cartões
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
Página | 5 HHMMSS
Origem 010 073 082 Alfa “BANRISUL CARTÕES”
CNPJ Conveniado 014 083 096 Num CNPJ do conveniado
Brancos 215 097 311 Alfa brancos
Página | 6
4.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 AAAAMMDD
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 AAAAMMDD
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 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
Página | 7 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 |
NSU do movimento
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
Reserva 046 266 311 Alfa brancos
Página | 8
4.3.3 Trailler
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 Cartões
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 “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
4.4 Observações
4.4.1 Código da Mensagem
Será sempre preenchido com "0200", indicando uma operação de pagamento.
Página | 9
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
"002900" - pagamento pré-datado (a prazo) "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
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
"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
"50" - Estornada
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 forma de pagamento este campo informa "01".
4.4.7 Data de Efetivação
Página | 11
5 Arquivo de Pendências Resolvidas
5.1 Características
• Tamanho do Registro: 320 • Nome do Arquivo: BJRVCP1 • Nome Arquivo Cliente: a definir
• 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"
Página | 12
6 Arquivo de Conciliação Financeira
6.1 Características
• Tamanho do Registro: 320 • Identificador: BJRVCC1 • Nome Arquivo Cliente: a definir
• 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”
Página | 13 Identificador do Arquivo 008 043 050 Alfa "BJRVCC1"
Data Referência Banrisul Cartões
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 “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”
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 Banrisul Cartões Estabelecimento 015 014 028 Num identificação do estabelecimento para a Banrisul
Cartões
Data Lançamento 008 029 036 Data data do crédito AAAAMMDD
Cod 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
Página | 14 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
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 Banrisul Cartões Estabelecimento 015 014 028 Num identificação do Estabelecimento para a Banrisul
Cartões
Data Lançamento 008 029 036 Data data do crédito AAAAMMDD
Cod 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 seqüencial ú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
Página | 15
Pedido 040 123 162 Alfa identificador do pedido (para movimento Internet)
Reserva 149 163 311 Alfa brancos
Seqüência Registro 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 Rede, Estabelecimento, Data Lançamento, Cod 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 Cartões
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 “BANRISUL CARTÕES”
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
Página | 16
7 Relatório Recibo de Taxas e Tarifas Vero
7.1 Características
• Tamanho do Registro: Relatório
• Identificador: VERO.BJR11.DDDMM
DDDMM: D3006 junho, D3105 maio. • Periodicidade: Mensal no terceiro dia útil.
7.2 Descrição
O relatório é por estabelecimento com resumo final do conveniado.
O relatório possui assinatura digital concatenada, garantindo a integridades dos dados.