Escolar Documentos
Profissional Documentos
Cultura Documentos
SUMÁRIO
6.2 Parcerias Varejistas * só deve ser utilizado para contrato do tipo Parcerias. .................................................................. 22
7. HEADER ........................................................................................ 23
7.1 Detalhes do Header ........................................................................................................................................................... 23
8. INPUT IV ....................................................................................... 24
8.1 Observações: .................................................................................................................................................................. 24
10.4 Remoção de pendência (9902) – Para convênios que não permitem cancelamento ..................................... 30
3
#interna
15.3 Comprovante............................................................................................................................................................... 54
4
#interna
18.5.3 Comprovante.......................................................................................................................................................... 92
5
#interna
24.2 Saque Conta Corrente com cartão Smartcard (com chip) .......................................................................................... 105
24.3 Saque Conta Corrente Cartão sem chip (trilha) .......................................................................................................... 108
25.2 Saldo de Conta corrente com cartão Smartcard (com chip) ....................................................................................... 109
6
#interna
26.2 Extrato de Conta-corrente com cartão Smartcard (com chip) .................................................................................... 111
27.2 Depósito em dinheiro Conta corrente/Poupança sem cartão (208) ............................................................................... 113
28.2 Saque Poupança com cartão sem chip (trilha) ............................................................................................................ 116
29.2 Saldo de Poupança com cartão Smartcard (com chip) ............................................................................................... 118
8
#interna
33.1.4 Simulação por Valor do Crédito ou Parcela (Seq. 50) ............................................................................................ 131
33.2.5 Fluxograma CDC – Crédito Antecipação 13º Salário / IRPF (8BM) ......................................................................... 141
33.4 Detalha valores solicitados no CDC passíveis de cancelamento (C068) .......................................................................... 142
9
#interna
34.3 Input IV (entrada de dados – payload) 892 versão dados adicionais ................................................................................. 145
10
#interna
40. RECEBIMENTO DO PROGRAMA MINHA CASA MINHA VIDA (246) ...... 172
40.1 Input IV ....................................................................................................................................................................... 172
11
#interna
12
#interna
1. ORIENTAÇÕES IMPORTANTES
13
#interna
O roteiro de execução de transação segue um padrão definido pelo Banco do Brasil para efetuar
transações com os Correspondentes e Parceiros Varejistas. Poderão ocorrer alterações nos padrões aqui
definidos, sempre que necessário ou em virtude de alguma alteração legal. Neste documento, sempre que
a palavra Correspondente for citada, ela estará englobando tanto os clientes Correspondentes como os
Parceiros Varejistas.
O funcionamento das transações baseia-se na troca de mensagens (Strings) entre clientes
(Correspondentes e Parceiros Varejistas) e o Banco do Brasil, formatadas de acordo com um protocolo
padrão de mensagem.
A conexão (ligação) entre o cliente e o Banco do Brasil deverá preferencialmente ser realizada
através de uma rede Frame Relay1 das Concessionárias de Telecomunicações com o acesso do Banco do
Brasil em Brasília. O acesso ao Banco é feito através de conexão TCP / IP2, utilizando SOCKET3 para
envio das mensagens na porta 80.
A implantação do atendimento pelo Correspondente e Parceiro Varejista está suportada nos quatro
pilares de procedimentos abaixo:
1 - Recebimento do Roteiro de Execução de Transação que possibilitará o futuro Correspondente,
juntamente com a sua software house (se for o caso), desenvolver as interfaces da aplicação dos pontos
de vendas;
2 - Montagem de ambiente de laboratório, simulando o ambiente de produção. Esse ambiente será
interligado ao ambiente de desenvolvimento do Banco do Brasil por meio de conexão TCP / IP, através da
Internet.
Na ocasião, o Correspondente informará o IP de origem necessário para a conexão. Não poderá
ser utilizado endereço IP fornecido por servidor DHCP (IP dinâmico). Deverá ser utilizado IP Fixo.
Conforme definição do Banco, as conexões com entidades externas deverão utilizar endereço IP público,
que geralmente são iniciados pelo octeto 200 (válidos na Internet). Os endereços abaixo NÃO deverão ser
usados:
10.0.0.0 a 10.255.255.255,
172.16.0.0 a 172.31.255.255,
192.168.0.0 a 192.168.255.255.
Após os testes, a aplicação será homologada por funcionários do Banco do Brasil.
3 - Será gerado um arquivo retorno CBF800-homologacao, que deverá ser utilizado para
conciliação automática do movimento do correspondente. No ambiente da produção esse arquivo é gerado
diariamente.
4 - O Correspondente deverá providenciar o circuito de ligação ao ambiente de produção. Este
procedimento poderá ser conduzido simultaneamente ao processo de homologação da aplicação. Deverá
1
O Frame Relay é uma eficiente tecnologia de comunicação de dados usada para transmitir de maneira rápida e barata a informação digital através de uma rede de dados, dividindo
essas informações em frames (quadros) a um ou muitos destinos de um ou muitos end-points.
2
O modelo TCP/IP - como muitos outros modelos de protocolos - pode ser visto como um grupo de camadas, em que cada uma resolve um grupo de problemas da transmissão de
dados, fornecendo um serviço bem definido para os protocolos da camada superior.
3
Elemento computacional que mapeia diretamente a uma porta de transporte (TCP ou UDP) e mais um endereço de rede. Com esse conceito é possível identificar unicamente um
aplicativo ou servidor na rede de comunicação IP.
14
#interna
ser informado ao Banco do Brasil - Diretoria de Tecnologia a quantidade de PDVs4 instalados, bem como
previsão de possível expansão para que seja feita as especificações técnicas do circuito para solicitação à
Concessionária.
Pode-se ainda utilizar o serviço frame-relay público das concessionárias, com as seguintes
características: porta de 64 Kbps e CIR de 16 Kbps.
10.0.0.0 a 10.255.255.255,
172.16.0.0 a 172.31.255.255,
192.168.0.0 a 192.168.255.255.
- Nome da Empresa;
- Cidade (UF);
- Rua / Av, Bairro, Complemento, CEP;
- Pessoa e telefone do contato que receberá o circuito do Correspondente;
- Horário de operação do Correspondente.
4
PDV ou ponto de venda é o terminal de autenticação de venda dos produtos em uma loja.
15
#interna
2. REQUISITOS DE HARDWARE
-
- até 10 PDV's
1 micro PC 500Mhz;
128 MB de memória RAM;
Unidade de CD-ROM de 12X;
HD de 10 Gb SCSI;
Linux , Windows XP, Windows 2000
1 micro PC 500Mhz;
256 MB de memória RAM;
Unidade de CD-ROM de 12X;
HD de 20 Gb SCSI;
Linux , Windows XP, Windows 2000
1 micro PC 700Mhz;
512 MB de memória RAM;
Unidade de CD-ROM de 12X;
HD acima de 32Gb SCSI;
Linux , Windows XP, Windows 2000
1 micro PC 933Mhz;
512 MB de memória RAM;
Unidade de CD-ROM de 12X;
HD acima de 32Gb SCSI;
Linux , Windows XP, Windows 2000
17
#interna
3. INSTALAÇÃO DO GCB
http://www.bb.com.br
18
#interna
Deverá ser utilizado o código do convênio definitivo, fornecido pela Tecnologia do BB quando
da homologação da aplicação do Correspondente Bancário. Caso o correspondente não possua esse
código, ele deverá entrar em contato com sua Agência de relacionamento que terá condições de
informá-lo.
Procedimento de Cadastramento:
19
#interna
- Parar o GCB;
- Na pasta de chaves:
- Digitar a chave precedida da letra ‘J’ – maiúscula;
- Digitar a senha. Observar que deverá ser digitada da mesma forma como foi cadastrada
no Gerenciador Financeiro;
- Digitar o código do convenio;
- Clicar em ‘Adicionar chave’;
- Clicar no disquete, para gravar a inclusão.
Repetir o passo acima quantas vezes forem necessárias para cadastrar todas as. Reiniciar o
GCB após todas as chaves estarem cadastradas.
5. MODELOS DE REDE
-
20
#interna
6.1 CORRESPONDENTES
Para ENVIO e RECEPÇÃO de uma mensagem ao Banco, deverão ser seguidos os itens abaixo:
1. Cliente gera mensagem de solicitação de execução da transação de negócio, calculando o total de
registros / rótulos.
Input IV
2. Cliente verifica o tipo da transação e o total calculado no item anterior e gera Header.
Header + Input IV
21
#interna
Obs.:
• Na documentação de cada transação serão informados os campos variáveis e a formatação das
entradas (Input IV) e saídas (Output III).
• Os passos acima serão sempre executados, seja uma transação de consulta ou efetivação. No
caso de ocorrência de erros, o processo será detalhado mais nos próximos itens.
6.2 PARCERIAS VAREJISTAS * SÓ DEVE SER UTILIZADO PARA CONTRATO DO TIPO PARCERIAS.
Para ENVIO e RECEPÇÃO de uma mensagem ao Banco, deverão ser seguidos os itens abaixo:
1. Cliente gera mensagem do serviço PCA, calculando a quantidade de registros.
Gera mensagem de solicitação de execução de serviço Parceria Varejista, calculando o tamanho total de
registros / rótulos.
MensagemPCA
2. Cliente verificar o tipo do serviço PCA e o total calculado no item anterior e gera o HeaderPCA
HeaderPCA + MensagemPCA
4. Cliente verifica o tipo da transação e o tamanho calculado no item anterior e gera Header.
Header + Input IV
22
#interna
7. HEADER
-
5 – erro da Aplicação
9 – erro outros
Erro N 3 Código de erro
NroRotulos N 3 Quantidade rótulos contidos na Input IV
Valor Pagamento N 17 Valor da transação
TamPayload N 9 Dados (*4)
Payload N ... Dados (*4)
(*1) - O BB utilizará como informação apenas as 4 casas de menor grandeza para registrar nos sistemas
corporativos, porém todas as 6 posições serão utilizadas para geração e conferência de pendência.
(*2) - O BB utilizará como informação apenas as 4 casas de menor grandeza para registrar nos sistemas
corporativos, porém todas as 8 posições serão utilizadas para geração e conferência de pendência.
(*3) - A versão da transação será sempre informada pelo Banco, confirmar. (Atual = 001 para a maioria das
transações, verificar no título da seção com o nome da transação qual a versão válida).
(*4) - No caso da transação transmitida do PDV para o BB (solicitação), os dados são relativos à Input IV da
transação a ser realizada. (vide tabela de transações). No caso da transação transmitida do BB para o PDV
(resposta), os dados são relativos a Output III da transação realizada (vide tabela de transações).
(*5) - IMPORTANTE! Caso o perfil de Correspondente contenha substabelecimentos as transações que devem ser
utilizadas são as que começam com o byte ‘5’, EX: 5020, 5A02, 5284, 5268, 5358 5315, etc. Além de preencher os
campos ConvênioSE e LojaSE.
8. INPUT IV
8.1 OBSERVAÇÕES:
1) Os campos Rótulo, Tamanho e Informação, podem ser repetidos quantas vezes forem necessários
para todos os dados solicitados por cada transação (não repetir os campos “Fixo” e nem “Tipo”), o total de
rótulos deve ser informado no campo “NroRotulos” do HEADER.
2) No campo “Tamanho” deve ser informado, com quatro posições, a quantidade exata de
bytes contida no campo “Informação”, observado o valor máximo permitido. Por exemplo, o valor máximo
24
#interna
pode ser 17, mas se a sua informação só possui 5 bytes então o preenchimento do campo “Tamanho”
será 0005.
3) O campo Rótulo e sua informação somente são enviados se possuírem dados. Quando o
rótulo for 00012 a informação deverá ser precedida de um 0 (zero), completando com isso as 45 posições.
Ver mais sobre o rótulo 00012 nas transações 268 e 358.
4) Ao final da entrada INPUT IV deve ser enviado o caractere @ (arroba). O formato da saída
OUTPUT III é variável conforme o tipo de transação solicitada.
0000100095000330000022000110002100082007052800113000370000099000410000001200450041940
00000000000004521000012698148000000066@
9. SIMULAÇÃO DE TRANSAÇÕES
Estado da pendência 1 – pendência sem 5 - pendência com buffer 9 - pendência automática sem
0 - PDV sem pendência
buffer (output III) (output III) buffer (output III)
25
#interna
OBS.:
- A gravação da pendência no momento do envio ao BB será sem o payload;
- Quando a mensagem (msgpdv) vem do PDV o campo tipoTrn pode ser C, P ou X;
- Quando se trata de uma pendência o campo tipoTrn passa a ser tipoPendência 1, 5 ou 9.
- P/ retorno do BB c/ erro:
Se erro = erro gerador de pendência(203,212,217 e 218), então executa rotina estorno;
Se erro # erro gerador de pendência, então remove pendência (disco / memória);
- P/ retorno do BB s/ erro:
passa pendência em memória para tipo 5;
coloca output III (resposta da transação pagamento) no payload da pendência.
IMPORTANTE:
26
#interna
A transação 9903 - Consulta Pendência deverá ser sempre acionada antes dos procedimentos
listados abaixo:
- Sangria do terminal;
- Fechamento do terminal;
- Substituição do operador;
- Afastamento temporário do operador;
- Horário limite de recebimento do correspondente.
Na impossibilidade da transação 9903 ser acionada automaticamente, via sistema, o
Correspondente deverá criar transações de acionamento manual para que as pendências sejam resolvidas
no menor espaço de tempo.
A transação 9900 deve ser encaminhada pelo PDV após a impressão completa do comprovante da
transação. Neste caso, a impressão ocorreu com sucesso e o GCB irá remover a pendência existente e
permitirá que o PDV execute outra transação.
9900 - ENVIO para o GCB
27
#interna
A transação 9901 pode ser solicitada pelo PDV quando houver a necessidade de reimpressão do
comprovante da transação. Por exemplo, nos casos em que o comprovante foi impresso incompleto ou por
falta de bobina de papel, neste caso, o PDV solicita novamente o comprovante ao GCB e após a
impressão, encaminha normalmente a 9900 para remoção da pendência.
28
#interna
Convênio N 9 999999999
Agência N 4 9999
Loja N 6 999999
PDV N 8 99999999
Operador N 9 999999999
NSUpdv N 8 99999999
Chave (JNNNNNNN) A 8 00000000
NSUchave N 4 0000
AutChave N 4 0000
CodTrn A 4 9901
VrnTrn N 3 001
TipoTrn A 1 X
OrigemDoErro N 1 0
Erro N 3 000
NroRotulos N 3 000
Valor Pagamento N 17 00000000000000000
TamPayload N 9 999999999
Payload A 99999BANCO DO ESTADO SUL
S.A0090099999200999999999900000000000000020099X999946
X619999 F0646 COBAN:99999 LOJA:9999 PDV:9999
99/99/9999 BANCO DO BRASIL 18:17:20999999999
CORRESPONDENTE BANCARIO 0099
COMPROVANTE DE PAGAMENTO DE TITULOS
======================================BANCO DO
ESTADO --------------------------------------
999999999999992698148800000006634 00000000000000
NR. DOCUMENTO 99.999.999DATA DO PAGAMENTO
99/99/9999VLR DOCUMENTO 9,99VALOR
COBRADO
9,99======================================NR.AUTEN
TICACAO 9.9X9.999.99X.999.999
A transação 9902 deve ser solicitada quando for necessário a remoção de pendência do PDV, no
caso de estorno da transação ou não recebimento de resposta do GCB.
Neste caso, o GCB ao receber o pedido de 9902 do PDV, encaminha o pedido de cancelamento da
transação ao banco para tentar garantir o cancelamento da transação.
Devido a regras de negócio estabelecidas não é permitido cancelar pagamentos efetuados com
alguns convênios. Nesses casos, quando enviada uma transação 315 ou 9902, o retorno conterá um
comprovante de pagamento. A remoção da pendência ocorrerá após a impressão do comprovante de
pagamento.
9902 - ENVIO para o GCB
30
#interna
======================================
TELEBRASILIA CELULAR S A
--------------------------------------
84600000000 42800047000 10000000000
22412922009
NR. DOCUMENTO 10.001
NR. CONVENIO 86.377-7
DATA DO PAGAMENTO 06/09/2001
VLR DO PAGAMENTO 42,80
======================================
NR.AUTENTICACAO F.FBE.928.9E7.4A6.990
A transação 9903 deve ser solicitada na hipótese de ocorrência de erro (TIME-OUT) na execução
da 9900.
Neste caso, se o operador tentar executar outra transação de pagamento, receberá erro 101 (PDV
COM PENDÊNCIA), o PDV gera a transação 9903 e o GCB informa a pendência existente e o PDV gera
outra transação 9900 ou 9902.
9903 - ENVIO para o GCB
31
#interna
AutChave N 4 0000
CodTrn A 4 9903
VrnTrn N 3 001
TipoTrn A 1 X
OrigemDoErro N 1 0
Erro N 3 000
NroRotulos N 3 000
Valor Pagamento N 17 00000000000000000
TamPayload N 9 000000000
Payload A
32
#interna
DETALHE
DETALHE-2
TRAILER
OBSERVAÇÃO:
Este arquivo pode ser ou não gerado. Quando gerado, pode ser sempre ou somente com
informação, definir forma esperada. A obtenção deste arquivo junto ao BB será via o aplicativo
Gerenciador Financeiro.
** - No caso de remessa distribuída, este campo conterá o código do arquivo de retorno ao qual se
destina. Por exemplo – uma empresa cadastrada com código 123456789 poderá ter a parte de sua
33
#interna
remessa destinada para uma filial cujo código seja 987654321 e outra parte para a filial cujo código seja
678567456.
0001AAAAMMDDCBF80012345678900000001678567456
Este arquivo conterá os documentos que estão na base do Banco do Brasil, após o fechamento do
processamento para um determinado dia de movimento (observar o horário de movimento da loja).
1 - Sem Remessa
2 - Remessa Centralizada somente c/ Doc. Liquidados
3 - Remessa Centralizada c/ Documentos Liquidados e Cancelados
4 - Remessa Centralizada c/ Documentos Liquidados, Cancelados e Código de Barra
5 - Remessa Distribuída somente c/ Documentos Liquidados
6 - Remessa Distribuída c/ Documentos Liquidados e Cancelados
7 - Remessa Distribuída c/ Doc. Liquidados, Cancelados e Código de Barra
Este arquivo pode ou não ser gerado.
A obtenção deste arquivo junto ao BB será via o aplicativo Gerenciador Financeiro. No caso de
remessa distribuída, é necessário o cadastramento de mais de um código de arquivo retorno (exemplo,
filiais localizadas em estados diferentes e que mantenham controle em separado).
- As três faixas de endereço abaixo não são roteáveis na Internet, conforme RFC 1918, portanto
não deverão ser repassados para a Tecnologia:
10.x.x.x
172.17.x.x até 172.31.x.x
192.168.x.x
- O cliente deve utilizar um endereço fixo de IP. É cada vez maior a quantidade de clientes que
utilizam servidores de IP (DHCP), que geram endereços variáveis, o que tem causado muitas solicitações
de alterações de endereços IP logo após o cadastramento. As áreas negociais deverão exigir declaração
do cliente e / ou de seu provedor de acesso à Internet de que o endereço IP informado é fixo e é o que
será utilizado, antes de enviar o pedido de cadastramento à Tecnologia. Por determinação da área
responsável pelo cadastramento (Tecnologia/GETEC), os pedidos de alteração serão realizados com
menor prioridade, com prazo mínimo de 30 dias para sua efetivação.
1ª etapa:
Após desenvolvimento de sua aplicação o Correspondente iniciará os testes junto ao ambiente de
desenvolvimento do Banco do Brasil. Esses procedimentos serão utilizados para ajustes nas
transações desenvolvidas. Nessa fase os técnicos do BB (Tecnologia) estarão disponíveis para dirimir
possíveis dúvidas e acompanhamento de transações.
Prazo estimado: definido pelo Correspondente.
2ª etapa:
Quando a aplicação estiver estável, deverá ser acordada com a Agência de Relacionamento e
Superintendência do Banco a seqüência de testes, ainda em desenvolvimento. Os funcionários do BB
estarão validando junto ao correspondente as transações desenvolvidas, bem como telas, opções,
comprovante de pagamento emitido e demais procedimentos operacionais.
Prazo estimado: uma semana.
3ª etapa:
Nesta fase o funcionário do BB juntamente com os técnicos da empresa estarão realizando
transações monitoradas pelos técnicos do BB (Tecnologia). Nesta fase, já será fornecido o código
definitivo do convênio. Uma vez homologado o produto, o conjunto de transações efetuado será
utilizado para geração do arquivo retorno (CBF800), no desenvolvimento. Esse arquivo tem a
finalidade de possibilitar a conciliação, pelo Correspondente, dos dados enviados ao Banco do Brasil e
também será validado pelo funcionário do BB.
Prazo estimado: uma semana.
12.1 CONCILIAÇÃO
35
#interna
Com base nas informações contidas no CBF800 e LOG do correspondente, realizar conferência via
sistema, identificando as seguintes situações:
O link (circuito) de PRODUÇÃO deve ser providenciado de modo que possa estar disponível para
operação juntamente com o final da 3ª etapa dos testes. Solicitamos atentar para os prazos das
concessionárias, que em alguns casos é de 30 dias.
Após a entrega dos links de PRODUÇÃO pelas concessionárias, será necessário um período de 4
a 8 dias úteis para que os técnicos de Rede do Banco do Brasil (Tecnologia) juntamente com os técnicos
do Correspondente e da Concessionária configurem a camada de rede e roteadores.
Esclarecemos que os monitores (transações) estarão disponíveis das 00:30 às 23:59 horas, sendo
que no horário das 05:00 às 08:00h ocorrerá INDISPONIBILIDADE de até 30 minutos, diariamente.
Desta forma, o cliente “toma decisões” em relação ao terminal, ou seja, aguarda alguns minutos
para repetir a operação, a refaz imediatamente ou emite um aviso aos responsáveis, baseando-se nas
orientações abaixo.
As mensagens de erro estarão sempre na saída Output III, não cifradas e em formato ASCII, com o
seguinte layout:
Output III
36
#interna
OBSERVAÇÃO:
2 - A presente relação de erro poderá ser alterada a qualquer tempo pelo BB;
3 - As ocorrências de erros tem sua origem nas informações recebidas na INPUT. Com isso, a
análise deverá ser realizada no ponto do sistema em que esta INPUT está sendo montada, se no PDV ou
CONCENTRADOR do Correspondente.
Como exemplo:
- INPUT montada no concentrador: ERRO ‘ agencia invalida ’ , neste caso o erro teria sua
origem no sistema, pois a agência é montada no concentrador.
- Erro com origem no operador: ERRO ‘ utilize opção 1-din ou 2-chq ‘, foi digitado algo pelo
OPERADOR não aceito pelo sistema do BB.
4 - Deverá ser exibido no visor do PDV o seqüencial e o código de erro que deverá ser informado
inicialmente ao Suporte do Correspondente que ,conforme o erro , acionará o Suporte do Banco do
Brasil para análise.
5 - Antes de acionar o Suporte do BB:
✓ Verificar se as transações estão sendo recebidas pelo GCB ;
✓ Confirmar no log do GCB o erro recebido e agindo conforme indicado na tabela a seguir.
37
#interna
Na tabela a seguir, o código da mensagem são os 3 primeiros números que aparecem após uma
descrição (esta mensagem é enviada diretamente do BB).
Exemplo: Na mensagem “Transação não disponível 197/656”, o código é 197.
Código da mensagem Procedimento -Suporte
Mensagem traduzida Procedimento- PDV
de retorno do BB CORRESPONDENTE BANCÁRIO
O pagamento não pode ser
PROCURAR AGENCIA efetuado pelo
BB correspondente bancário, Acionar o Suporte do Banco do Brasil,
197
BB CCC / a68SSS orientar o cliente a passando o código de erro. (CCC / SSS)
procurar uma agência do
BB.
O pagamento não é
CONTA NÃO ACEITA
recebido pelo BB, orientar
788 BB Sem procedimentos.
o cliente a procurar outro
BB CCC / SSS
banco.
O pagamento não pode ser
efetuado pelo
Transação não
correspondente bancário. Acionar o Suporte do Banco do Brasil,
525 disponível
Orientar o cliente a passando o código de erro (CCC / SSS).
BB CCC/SSS
procurar uma Agência do
BB.
Titulo não pode ser
recebido. Encaminhar o
646 DOC VENCIDO Sem procedimentos.
cliente a uma agência do
Banco do Brasil
13.1 INPUT IV
Pré transação de pagamento de Títulos de cobrança, que retorna os dados da Nova Cobrança a serem
apresentados.
Transação A68 execução obrigatória antes da chamada da transação 268 (Recebimento de Títulos de Cobrança).
Input – Consulta 1
38
#interna
Retorno Tipo 1
Retorno Tipo 2
39
#interna
Valor total = valor nominal – outras deduções – desconto/abatimento + juros/multa + outros acréscimos
(00113) = (00099) – (00090) – (00095) + (00098) + (00100)
40
#interna
14.1 INPUT IV
41
#interna
Código da Instituição
N 3 Código instituição bancária.
bancária.
Livre N 8 Campo livre para uso futuro
TOTAL 108
Tipo Registro A 1 F
Tamanho Registro N 4 0038 (tamanho do comprovante)
Linha A 38 Linha formatada ****
TOTAL 38
* Data Contábil do movimento no BB. Esta data será sempre um dia útil.
** Data que a transação foi efetuada, mesmo que não seja dia útil.
*** No campo Nome do cedente ou Nome Instituição bancária, informar nome do cedente quando título BB e
nome da instituição bancária quando outros Bancos.
**** Prevenção de fraudes – Sempre realizar consulta para averiguação dos dados bancários
- Realizar consulta e pegar nome da instituição no retorno da consulta + código da instituição do título.
- Realizar comparação com código e nome do banco no retorno da efetivação.
- Modelo de mensagem para avisar operador sobre procedimentos de segurança:
* Para sua segurança confirme a identificação do Banco impresso no Boleto:
[Número do banco, Nome do Banco] = 237 Banco Bradesco S.A.
Em caso de divergência, contate o beneficiário do boleto, antes de confirmar o pagamento.
***** Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
Ex. Comprovante com 18 linhas (Tamanho do registro = 684, 18 linhas com 38 bytes cada).
****** Os rótulos 00065 e 00138 devem ser enviados sempre que o valor do documento a ser pago for superior a R$ 2.000,00.
======================================
--------------------------------------
034122510700021698152400000006634
00000000000000
42
#interna
DESCONTO/ABATIM 0,00
======================================
NR.AUTENTICACAO X.000.XX0.0XX.XXX.000
Cálculo do dígito:
0 1 2 3 4
a – informações da barra.
b – multiplicadores fixos, começando do último (direita) para o primeiro (esquerda) com 2, 3, 4, 5, 6, 7, 8 e 9 sucessivamente.
PROCEDIMENTOS:
1. Multiplicar os valores da linha ‘a’ (menos o 5º dígito) pelos multiplicadores, o campo de resultado
deverá conter 2 posições;
2. Somar todos os resultados da multiplicação;
3. Divida o somatório por 11 obtendo-se resto;
4. Subtraia o resto obtido de 11 (11 menos o resto) para obter o dígito a ser conferido;
43
#interna
Campo 01
Banco numérico 03
Moeda numérico 01
Campo Livre - 01 numérico 05
Dígito 1 numérico 01 (conferir)
Campo 02
Campo Livre - 02 numérico 10
Dígito 2 numérico 01 (conferir)
Campo 03
Campo Livre-03 numérico 10
Dígito 3 numérico 01 (conferir)
Campo 04
Dígito da barra numérico 01
Campo 05
Fator numérico 04
Valor numérico 10
a 237934260-9
b 212121212
a – informações do campo;
b – multiplicadores fixos para cada campo, começando da direita para esquerda com o número 2, alternando-se 1 e 2;
PROCEDIMENTOS:
Para calcular o dígito de cada campo (campo 01, campo 02 e campo 03):
1. Multiplicar valores da linha ‘a’ pelos multiplicadores, o campo de resultado deverá conter duas
posições;
2. Somar todos os resultados - posição1 (dezena) e posição2 (unidade) do resultado da multiplicação;
3. Dividir o somatório por 10 obtendo resto;
4. Subtrair o resto obtido de 10, (10 menos o resto) para obter o dígito a ser conferido;
5. Conferir o valor de resultado com o dígito do campo.
6. Veja o exemplo abaixo:
44
#interna
7 x 2 = 14 1+4 =5
9 x 1 = 09 0+9 =9
3 x 2 = 06 0+6 =6
4 x 1 = 04 0+4 =4
2 x 2 = 04 0+4 =4
6 x 1 = 06 0+6 =6
0 x 2 = 00 0+0 =0
45
#interna
46
#interna
47
#interna
14.6.1 CONSULTA
A transação de consulta títulos será composta por apenas dois passos, o envio e o recebimento da
resposta.
268 A
268 B
268 A
268 B
CAMPO TIPO TAMANHO PREENCHIMENTO
Convênio N 9 123456789
Agência N 4 9999
Loja N 6 000001
PDV N 8 00000001
Operador N 9 000000001
NSUpdv N 8 00000004
Chave (JNNNNNNN) A 8 J9876543
NSUchave N 4 0003
AutChave N 4 0001
CodTrn A 4 268 *aqui há um espaço à direita
48
#interna
VrnTrn N 3 001
TipoTrn A 1 C
OrigemDoErro N 1 0
Erro N 3 000
NroRotulos N 3 005
Valor Pagamento N 17 00000000000000005
TamPayload N 9 000000113
Payload A 113 10108BANCO BRADESCO S.A.
0020010910200109101137050000000
0000000005
14.6.2 PAGAMENTO
268 A
268 B
9900 ou 9902 A
9900 ou 9902 B
268 A
49
#interna
268 B
======================================
BANCO BRADESCO S.A.
--------------------------------------
237905160630011830806570081452031
00000000000000
NR. DOCUMENTO 10.001
DATA DO PAGAMENTO 10/09/2001
VLR DOCUMENTO 0,05
VALOR COBRADO 0,05
======================================
NR.AUTENTICACAO 9.BE0.A6C.6CD.CAA.942
268 A
268 B
9900 ou 9902 A
9900 ou 9902 B
9900 ou 9902 A
50
#interna
NSUchave N 4 0000
AutChave N 4 0000
CodTrn A 4 9900/9902
VrnTrn N 3 001
TipoTrn A 1 X
OrigemDoErro N 1 0
Erro N 3 000
NroRotulos N 3 000
Valor Pagamento N 17 00000000000000000
TamPayload N 9 000000000
Payload A
9900 ou 9902 B
A transação 9901 deve ser solicitada pelo PDV na hipótese em que a impressão do comprovante não
seja realizada com sucesso.
268 A
268 B
9901 A
9901 B
9900 A
9900 B
51
#interna
9901- A
9901-B HEADER
======================================
BANCO BRADESCO S.A.
--------------------------------------
237905160630011830806570081452031
00000000000000
NR. DOCUMENTO 10.001
DATA DO PAGAMENTO 10/09/2001
VLR DOCUMENTO 0,05
VALOR COBRADO 0,05
52
#interna
======================================
NR.AUTENTICACAO 9.BE0.A6C.6CD.CAA.942
15.1 INPUT IV
* Os rótulos 00065 e 00138 devem ser enviados na etapa de confirmação (tipo P) sempre que o valor do documento a ser
pago for superior a R$ 2.000,00.
Atenção: O registro tipo 1, abaixo, será sempre o primeiro registro a ser enviado como resposta.
- No caso de consulta será o único registro a ser enviado.
- No caso de efetivação de transação versão 1 será enviado o registro tipo 1 (dados da transação) e o registro tipo F (
dados do comprovante) .
- No caso de efetivação de transação GCB versão 8.5.5 em diante será enviado somente o registro tipo F.
* Data Contábil do movimento no BB. Esta data será sempre um dia útil.
** Data que a transação foi efetuada, mesmo que não seja dia útil.
*** Estas Linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
Ex. Comprovante com 10 linhas (Tamanho do registro = 380 e total de bytes = 385).
15.3 COMPROVANTE
======================================
--------------------------------------
12345678901
NR.DOCUMENTO 9.999.999.999
NR.CONVÊNIO 81.033-9
VALOR 1.000,00
======================================
NR.AUTENTICAÇÃO 8.323.EDB.FRG.2B6.1F7
54
#interna
CÁLCULO DÍGITO:
0 1 2 3 4
a 123456789 0123456789 0123456789 0123456789 01234
b 212 12121 2121212121 2121212121 2121212121 21212
a – informações da barra;
b – multiplicadores fixos
PROCEDIMENTOS:
1 – multiplicar valores da linha ‘a’ pelos multiplicadores, o campo de resultado devera conter 2 posições;
2 – somar todos os resultados - posição1 e posição2 do resultado da multiplicação
3 – divida o somatório por 10 obtendo resto
4 – subtraia o resto obtido de 10, jogando resultado em resto
5 – confira o valor de resto com a 4ª posição da barra(digito)
–EXEMPLO: 1 x 2 = 02 0+2 =2
2 x 1 = 02 0+2 =2 2+2=4
3 x 2 = 06 0+6 =6 6 + 4 = 10
5 x 1 = 05 0+5 =5 5 + 10 = 15
6 x 2 = 12 1+2 =3 3 + 15 = 18
OBSERVAÇÃO: a remessa será realizada no formato CAPTURADO, após conferido o dígito.
55
#interna
15.5 FLUXOGRAMA
43
#interna
57
#interna
58
#interna
358 – Consulta
358 A
358 D
358 A - HEADER
358 D - HEADER
CAMPO TIPO TAMANHO PREENCHIMENTO
Convênio N 9 123456789
Agência N 4 9999
Loja N 6 000001
PDV N 8 00000001
Operador N 9 000000001
NSUpdv N 8 00000001
Chave (JNNNNNNN) A 8 J9999999
NSUchave N 4 0001
AutChave N 4 0000
CodTrn A 4 358
VrnTrn N 3 001
TipoTrn A 1 C
OrigemDoErro N 1 0
Erro N 3 000
NroRotulos N 3 003
Valor Pagamento N 17 00000000000004280
TamPayload N 9 000000130
Payload A 130 1012500000000000086377TELEBRASILIA CEL
ULAR S A 00200109062001
090611580500000000000004280
59
#interna
358 – Pagamento
358 A
358 D
9900 A
9900 B
358 A - HEADER
358 D - HEADER
60
#interna
A6990 F0608
06/09/2001 BANCO DO BRASIL 10:46:06
999976543 CORRESPONDENTE BANCARIO 0001
======================================
TELEBRASILIA CELULAR S A
--------------------------------------
84600000000 42800047000 10000000000
22412922009
NR. DOCUMENTO 10.001
NR. CONVENIO 86.377-7
DATA DO PAGAMENTO 06/09/2001
VLR DO PAGAMENTO 42,80
======================================
NR.AUTENTICACAO F.FBE.928.9E7.4A6.990
61
#interna
358 - Pagamento
9900A - HEADER
9900B - HEADER
16.1 INPUT IV
62
#interna
315 – Cancelamento
315 A
315 D
315 A - HEADER
63
#interna
315 D - HEADER
315 – Cancelamento
Devido a regras de negócio estabelecidas não é permitido cancelar pagamentos efetuados com alguns convênios.
Nesses casos, quando enviada uma transação 315 ou 9902, o retorno conterá um comprovante de pagamento.
315 A
315 D
9900 A
9900 B
315 A - HEADER
64
#interna
NroRotulos N 3 004
Valor Pagamento N 17 00000000000000005
TamPayload N 9 000000058
Payload A 58 00001001220008J00056860003200040002001130001500123000326
8@
315 D - HEADER
CAMPO TIPO TAMANHO PREENCHIMENTO
Convênio N 9 123456789
Agência N 4 9999
Loja N 6 000001
PDV N 8 00000001
Operador N 9 000000001
NSUpdv N 8 00000002
Chave (JNNNNNNN) A 8 J9876543
NSUchave N 4 0002
AutChave N 4 0001
CodTrn A 4 358
VrnTrn N 3 001
TipoTrn A 1 P
OrigemDoErro N 1 0
Erro N 3 000
NroRotulos N 3 003
Valor Pagamento N 17 00000000000004280
TamPayload N 9 000000743
Payload A 743 1012500000000000086377TELEBRASILIA CEL
ULAR S A 00200109062001
090610460600000000000004280FFBE9289E74
A6990 F0608
06/09/2001 BANCO DO BRASIL 10:46:06
999976543 CORRESPONDENTE BANCARIO 0001
======================================
TELEBRASILIA CELULAR S A
--------------------------------------
84600000000 42800047000 10000000000
22412922009
NR. DOCUMENTO 10.001
NR. CONVENIO 86.377-7
DATA DO PAGAMENTO 06/09/2001
VLR DO PAGAMENTO 42,80
======================================
NR.AUTENTICACAO F.FBE.928.9E7.4A6.990
9900A - HEADER
NroRotulos N 3 000
Valor Pagamento N 17 00000000000000000
TamPayload N 9 000000000
Payload A
9900B - HEADER
O Banco do Brasil obedece ao formato do código CMC-7 definido pelo Conselho Monetário
Nacional. Conforme Circular BACEN 3109/2003, o valor do rótulo 00026 na INPUT IV da
transação é preenchido com a banda de magnetização conforme leiaute abaixo, tanto para
captura eletrônica dos dados quanto na digitação pelo operador.
66
#interna
Campo 03 numérico 10
Razão contábil e número da numérico 10
conta
Dígito-verificador do Campo 03 numérico 01(módulo 10).
Campo desprezado – caracter de impressão alfa 01
NUMEROS:..... nnnnnnnnnn
PESOS:........... 1212121212
DV = 10 – RESTO
17.1 INPUT IV
Seguem abaixo os rótulos que cada tipo de transação deve conter, para formar o INPUT IV
(payload).
- Sexo
68
#interna
17.3 COMPROVANTES
SEGURADO:
CPF: 256.926.587-04
SEXO: MASCULINO
======================================
ACIDENTAL...............: R$ 5.600,00
69
#interna
======================================
AUTENTICACAO: 7.DCC.043.362.200.0DC
DO BRASIL,
CNPJ 28.196.889/0001-43
E ADMINISTRADORA DE BENS
028907.1.006719-9
CNPJ 01.234.567/0001-89
SEU RECEBIMENTO.
70
#interna
--------------------------------------
03/02/2005 - - 14.45.47
SEGURADO:
CPF: 229.380.013-04
Sexo: Masculino
======================================
Acidental...............: R$ 5.600,00
======================================
AUTENTICACAO: 8.ADC.14F.71E.5B2.601
EM: 03/02/2005
do Brasil,
CNPJ 28.196.889/0001-43
e Administradora de Bens
028907.1.006719-9
CNPJ 31.911.548/0001-17
do Seguro.
======================================
Declaracao do segurado:
VOS **********************************
72
#interna
______________________________________
(assinatura do segurado)
--------------------------------------
SISTEMA COBAN
03/02/2005 - - 14.45.47
SEGURADO:
CPF: 229.380.013-04
Sexo: Masculino
======================================
Acidental...............: R$ 5.600,00
======================================
AUTENTICACAO: 8.ADC.14F.71E.5B2.601
EM: 03/02/2005
73
#interna
do Brasil,
CNPJ 28.196.889/0001-43
e Administradora de Bens
028907.1.006719-9
CNPJ 31.911.548/0001-17
do Seguro.
======================================
Declaracao do segurado:
VOS **********************************
______________________________________
(assinatura do segurado)
-------------------------------------
SISTEMA COBAN
74
#interna
24/01/2005 - - 09.46.33
SEGURADO:
======================================
--------------------------------------
INDIVIDUAL 20.07.2005
INDIVIDUAL 20.07.2005
INDIVIDUAL 20.07.2005
INDIVIDUAL 20.07.2005
INDIVIDUAL 23.07.2005
=====================================
SISTEMA COBAN
75
#interna
SEGURADO:
CPF: 256.926.587-04
SEXO: MASCULINO
======================================
ACIDENTAL...............: R$ 5.600,00
======================================
AUTENTICACAO: 7.DCC.043.362.200.0DC
DO BRASIL,
CNPJ 28.196.889/0001-43
E ADMINISTRADORA DE BENS
76
#interna
028907.1.006719-9
CNPJ 01.234.567/0001-89
SEU RECEBIMENTO.
-------------------------------------
77
#interna
949 – Contratação
949 A
949 D
9900 A
9900 B
949 A - HEADER
78
#interna
949 – Contratação
949 D - HEADER
02/02/2005 - - 15.46.46
SEGURADO:
EDGARD FERREIRA NETO
Data do Nascimento: 09.04.1968
CPF: 229.380.013-04
Sexo: Masculino
======================================
Numero da Proposta: 000000719
Data da Contratacao: 02.02.2005
Plano Contratado: Individual
Cobertura: Morte Acidental
Beneficio(s): Assistencia Funeral
Capital Segurado Cobertura de Morte
Acidental...............: R$ 5.600,00
Custo do Seguro ........: R$ 9,50
Vigencia do seguro: A partir das 24
horas do dia..........: 02.02.2005
ate o dia .............: 01.08.2005
======================================
AUTENTICACAO: 8.135.01E.E2E.003.651
COMPRA CONFIRMADA COM SUCESSO
CNPJ 28.196.889/0001-43
Corretora...: BB-Corretora de Seguros
e Administradora de Bens
S.A., codigo SUSEP nr.
028907.1.006719-9
Estipulante.: TESTE - ACL
CNPJ 31.911.548/0001-17
Conforme declaracoes prestadas no mo-
mento da contratacao, o segurado tem
conhecimento e esta de acordo com os
termos das Condicoes Gerais do Seguro
e com as informacoes sobre os benefi-
cios. Declara, tambem, estar em boas
condicoes de saude, que nao foi inter-
nado em hospitais e nao fez qualquer
cirurgia nos ultimos 3 anos.
A presente proposta esta sujeita a
analise pela Seguradora, podendo ser
recusada no prazo de quinze dias após
seu recebimento.
A vigencia do seguro e de seis meses
contados a partir da data de seu
inicio. Nao esta prevista a renovacao.
CONDICOES GERAIS DO SEGURO DISPONIVEIS
NO SITE DO BB: WWW.BB.COM.BR
ACIONE ASSISTENCIA FUNERAL GRATUITA-
MENTE PELA CENTRAL DE ATENDIMENTO
ALIANCA DO BRASIL: 0800-7297000
-------------------------------------
9900A - HEADER
80
#interna
9900B - HEADER
81
#interna
949 – Cancelamento
949 A
949 D
9900 A
9900 B
949 A - HEADER
949 - Cancelamento
949 D - HEADER
82
#interna
03/02/2005 - - 14.45.47
SEGURADO:
EDGARD FERREIRA NETO
Data do Nascimento: 09.04.1968
CPF: 229.380.013-04
Sexo: Masculino
======================================
Número da Proposta: 000000757
Data da Contratação: 03.02.2005
Plano Contratado: Individual
Cobertura: Morte Acidental
Beneficio(s): Assistência Funeral
Capital Segurado Cobertura de Morte
Acidental...............: R$ 5.600,00
Custo do Seguro.........: R$ 9,50
Vigencia do Seguro: A partir das 24
horas do dia..........: 03.02.2005
ate o dia.............: 02.08.2005
======================================
AUTENTICACAO: 8.ADC.14F.71E.5B2.601
SEGURO CANCELADO A PEDIDO DO SEGURADO
EM: 03/02/2005
______________________________________
(assinatura do segurado)
--------------------------------------
SISTEMA COBAN
03/02/2005 - - 14.45.47
SEGURADO:
83
#interna
______________________________________
(assinatura do segurado)
-------------------------------------
949 – Extrato
949 A
949 D
84
#interna
949 A - HEADER
949 D - HEADER
03/02/2005 - - 14.53.36
SEGURADO:
EDGARD FERREIRA NETO
======================================
Proposta / Ini.Vigencia / Premio
Plano Fim Vigencia R$
--------------------------------------
000000707 02.02.2005 9,50
Individual 01.08.2005
000000710 02.02.2005 9,50
Individual 01.08.2005
000000711 02.02.2005 16,00
Casal 01.08.2005
=====================================
85
#interna
949 – 2ª Via
949 A
949 D
949 A - HEADER
949 D - HEADER
86
#interna
SEGURADO:
EDGARD FERREIRA NETO
Data do Nascimento: 09.04.1968
CPF: 229.380.013-04
Sexo: Masculino
======================================
Numero da Proposta: 000000759
Data da Contratacao: 03.02.2005
Plano Contratado: Individual
Cobertura: Morte Acidental
Beneficio(s): Assistencia Funeral
Capital Segurado Cobertura de Morte
Acidental...............: R$ 5.600,00
Custo do Seguro ........: R$ 9,50
Vigencia do seguro: A partir das 24
Horas do dia..........: 03.02.2005
Ate o dia .............: 02.08.2005
======================================
AUTENTICACAO: E.362.077.A25.095.0BA
COMPRA CONFIRMADA COM SUCESSO
87
#interna
18.1 INTRODUÇÃO
Esta parte do roteiro trata das transações que envolvem benefícios recebidos no Banco do
Brasil em Correspondentes:
- Transação 020 – Consulta Saldo de Benefícios
- Transação 284 – Efetua Pagamento de Benefícios
88
#interna
int f_dukpt (unsigned char * pszPan, unsigned char * pszSenha, char * pszRetorno);
O buffer de retorno, deverá ser alocado pela aplicação, com tamanho mínimo de 33 bytes.
Será preenchido pela função com o resultado da operação de criptografia em formato expandido,
com '\0' no final.
Os primeiros 16 (dezesseis) bytes do buffer de retorno correspondem ao criptograma
gerado(rótulo 00155).
Os 16 (dezesseis) bytes restantes correspondem ao identificador do correspondente(rótulo
00180).
Em caso de sucesso na geração do criptograma a função retorna o valor 0 (zero). Em caso
de erro, valores diferentes de 0 (zero).
18.3.5 EXEMPLO
public static native String gerarDukpt(String cartao, String senha, String retorno);
static { System.loadLibrary("dukpt_w.dll"); }
89
#interna
Esta transação se refere ao benefício recebido pelo cliente munido de cartão magnético de
benefícios do Banco do Brasil no Correspondente Bancário. Além do cartão, o cliente deve
impostar a senha de 6 dígitos.
(*) - Informações geradas pela criptografia (aplicativo DUKPT_W.DLL, DUKPT_L.LIB ou encriptação DUKPT no
PINPAD) DUKPT sobre a senha do cartão do cliente.
90
#interna
* Data contábil do movimento no BB. Esta data será sempre um dia útil.
** Data que a transação foi efetuada, mesmo que não seja dia útil.
*** Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
18.4.6 COMPROVANTE
--------------------------------------
DATA DD/MM/AAAA
NR.DOCUMENTO 9.999.999.999
NR.BENEFICIO ZZZ.ZZZ.ZZZ.ZZ9
======================================
NR.AUTENTICAÇÃO X.0X0.0XX.00X.0XX.000
91
#interna
Esta transação se refere à consulta de saldo do benefício recebido pelo cliente munido de
cartão magnético de benefícios do Banco do Brasil no Correspondente Bancário. Além do cartão,
o cliente deve impostar a senha de 6 dígitos.
(*) Informações geradas pela criptografia DUKPT sobre a senha do cartão do cliente.
Para encriptar utiliza-se o aplicativo DUKPT_W.DLL, DUKPT_L.LIB ou encriptação DUKPT no próprio PINPAD.
* Data que a transação foi efetuada, mesmo que não seja dia útil.
** Este campo se repetirá em todas as linhas do comprovante.
*** Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
18.5.3 COMPROVANTE
CORRESPONDENTE BANCARIO
BENEFICIO ZZZ.ZZZ.ZZZ-Z
======================================
92
#interna
SALDO Z.ZZZ,99
======================================
93
#interna
19.3 COMPROVANTE
======================================
--------------------------------------
======================================
Saldo Atual = Saldo final do movimento anterior - Total de recebimentos do movimento atual +
Total de pagamentos do movimento atual + Total de alívios do movimento.
Para cancelar ou estornar uma transação realizada a partir de ponto Substabelecido não
deverá mais ser utilizada a transação de controle 9902. Ao finalizar ou ocorrer algum problema
com a transação, deverá ser enviada ao GCB a transação 9900 para confirmar e remover a
pendência.
Em seguida, utilizar a transação 5A02 para consultar o estado da transação e obter os
campos para cancelar caso necessário ou desejável. Se for cancelar ou estornar, utilizar a
transação 5315 com os campos obtidos na 5A02, ver documentação abaixo.
Esta transação permite ao correspondente verificar se uma transação está no estado
EFETIVADA, CANCELADA ou NÃO LOCALIZADA.
Esta transação está disponível somente para as transações 5358, 5268, 5284, 5216, 5296,
5357, 5892 e 5217 (enviar os 16 bytes da trilha 2 retornada na transação 8C0).
Input para depósitos manual feito somente com agência e conta do cliente:
Rótulo Tipo Tamanho Máximo Informação a ser preenchida para depósito manual
Fixo N 3 000
Fixo N 2 01
Fixo N 4 0 + Código da transação
Fixo N 13 Valor total
Fixo N 4 Agencia sem DV
Fixo N 11 Conta sem DV (No caso de poupança informar variação:
Ex: variação: 51 conta: 6996 C/P: 00510006996
Finalizador A 1 @ (arroba) (*)
TOTAL 68
Chave a ser informada na transação 5315 será: ‘S‘ + Convênio + últimas 2 posições da Loja
20.3 COMPROVANTE
CONSULTA DE TÍTULO
CONSULTA TRANSACOES
======================================
TRANSACAO: 268
--------------------------------------
DATA......: DD/MM/AAAA
COBAN.....: 99999
LOJA......: 9999
96
#interna
SEQUENCIAL: 0003
VALOR.....: R$ 0,00
======================================
CONSULTA DE CONVÊNIO
CONSULTA TRANSACOES
======================================
TRANSACAO: 358
--------------------------------------
DATA......: DD/MM/AAAA
COBAN.....: 99999
LOJA......: 9999
SEQUENCIAL: 0003
VALOR.....: R$ 0,00
======================================
97
#interna
* Caso o campo Loja seja informado com zeros(0000) serão retornados os valores totais do Convênio
Correspondente.
21.3 COMPROVANTE
DD/MM/AAAA BANCO DO BRASIL HH:MM:SS
======================================
--------------------------------------
98
#interna
======================================
Saldo Atual = Saldo final do movimento anterior - Total de recebimentos do movimento atual +
Total de pagamentos do movimento atual + Total de alívios do movimento.
* Caso o campo Loja seja informado com zeros (0000) serão retornados os valores totais do Convênio
Correspondente.
** Alterar a versão da transação no Header para Versão 002.
*** Usar ação 1 para listar alívio da loja, a ação 3 lista todos os alívios de todas as lojas.
99
#interna
100
#interna
11 - Cartão de Débito;
12 – Transportadora de Valores.
N 17 Valor do alívio (se opção 2):
999999999999999,99
N 16 Protocolo
(se opção 2 ou 3)
N 17 Nosso Número
(se opção 2 – quando alívio por boleto)
N 9 Número Remessa
(se opção 2 – quando alivio por transportadora)
N 2 Código do canal (‘31’)
N 8 Chave J ‘Zeros’
TOTAL 108
* Caso o campo Loja seja informado com zeros (0000) serão retornados os valores totais do Convênio
Correspondente.
Ordem para montar output III. Somente usar estes campos e desconsiderar os demais.
102
#interna
E ==> PVIK
F ==> PVV
G ==> CVV
H ==> constante '20770'
103
#interna
24.1 FLUXOGRAMA
104
#interna
(*) O fluxo alternativo é permitido para os Correspondentes que queiram manualmente (visualmente) decidir se o cartão possui ou não
chip. Esse fluxo poderá ser alterado pelo Banco do Brasil quando for necessária a execução da transação 801, essa transação obtém
dados do cliente e pode ser obrigatória para respeitar alguma nova regra de negócio. Caso isso ocorra, os Correspondentes serão
comunicados previamente para ajuste de sua aplicação. Para o cartão sem chip, o fluxo alternativo não é possível.
105
#interna
(*) Esse campo, rótulos do chip, deverá ser formado pelas seguintes informações:
TAG Nome
82 AIP
5F34 Pan seq. Number
84 Dedicated File (DF) Name
57 Trilha 2 do chip
9F02 Vlr autz
9F03 Vlr Othr
9F1A Cd País
95 TVR
5F2A Cd Moeda
9A Dt Tran
9C Tp Tran
9F37 Nm Rand
9F35 Tipo de terminal
9F45 DAC
9F27 Tipo do criptograma
9F26 Criptograma gerado
9F36 ATC
9F10 Issuer Application Data
Aplicações (AID’s):
001360262778180820258005F3401008407A000000004101057135549063003307530D1511206215743669
0770F9F02060000000000009F03060000000000009F1A020076950500000008005F2A0209869A03110819
9C01009F3704711173709F3501149F450200009F2701009F26082BF35A3550A5BE199F3602000C9F1008
0201038000000000
➢ Exemplo do mesmo Código 00136 de tamanho 262, agora separados os campos para melhor
visualização:
00136 (código)
262 (tamanho até o 9F10)
77 8180
82 02 5800
5F34 01 00
84 07 A0000000041010
57 13 5549063003307530D15112062157436690770F
9F02 06 000000000000
9F03 06 000000000000
9F1A 02 0076
95 05 0000000800
5F2A 02 0986
9A 03 110819
9C 01 00
9F37 04 71117370
9F35 01 14
9F45 02 0000
9F27 01 00
9F26 08 2BF35A3550A5BE19
9F36 02 000C
9F10 08 0201038000000000
107
#interna
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
109
#interna
110
#interna
111
#interna
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
112
#interna
Para os casos em que o depósito necessitar de identificação (para o coban saque fácil), devem ser
enviados os rótulos complementares 00065, 00334, 00340, 00341 e 00342. Os depósitos realizados pelos
clientes abaixo do limite que exige identificação permanecem em funcionamento sem a utilização destes
rótulos.
Para os casos em que o depósito necessitar identificação por ultrapassar o limite determinado de
R$2000,00, devem ser enviados os rótulos 00137 e 00138.
***Para depósitos identificados em poupança ou com o rótulo 00114 informado, o rótulo 00035 deverá ser preenchido da
seguinte forma (2 para variação + 9 para conta):
Exemplo: Variação 51 e conta 78546-5 preenchimento do rótulo 00035 será 51000078546.
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
114
#interna
00035 N 11 Variação*
00113 N 17 Valor do depósito
Conta-corrente = 0 (zero)
00064 N 1
Poupança = 1 (um)
00137 N 1 Tipo de pessoa: 1 – Física / 2 – Jurídica
00138 N 14 CPF ou CNPJ do portador da quantia a ser paga
TOTAL 66
* Exclusivamente para depósito em conta poupança informar 00XX0000000, onde XX preenchido com a variação da
conta . Exemplo: Variação 51 informar 00510000000.
115
#interna
116
#interna
2 - Ilegível
9 - Não tem
00180 A 16 IKSN DUKPT
00155 A 16 SENHA Criptografada
TOTAL 92
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
118
#interna
Hora transação N 6 0
Autenticação A 16 XXXXXXXXXXXXXXXX
Valor N 17 99999999999999999
Livre A 10 XXXXXXXXXX
TOTAL 125
Tipo Registro A 1 F
Tamanho Registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
119
#interna
Autenticação A 16 XXXXXXXXXXXXXXXX
Valor N 17 99999999999999999
Livre A 10 XXXXXXXXXX
TOTAL 120
Tipo Registro A 1 F
Tamanho Registro N 4 0000 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
120
#interna
Valor N 17 99999999999999999
Livre A 10 XXXXXXXXXX
TOTAL 120
Tipo Registro A 1 F
Tamanho Registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
(*) Estas linhas formatadas se repetirão de acordo com a quantidade de operadoras retornadas.
(**) Estas linhas formatadas se repetirão de acordo com a quantidade de valores disponíveis para recarga.
- Confirmação:
(**) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado
- Comprovante:
(**) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
124
#interna
125
#interna
127
#interna
128
#interna
TOTAL 163
- Confirmação:
Campo Tipo Tamanho (em bytes) Preenchimento
Tipo de registro A 1 1 (V – Confirmação)
Tamanho do registro N 4 0065
Data do movimento N 8 AAAAMMDD
Data da transação N 8 AAAAMMDD
Hora da transação N 6 HHMMSS
Autenticação A 16 XXXXXXXXXXXXXXXX
Valor total N 17 99999999999999999
Livre A 10 Espaços
TOTAL 65
- Comprovante:
Campo Tipo Tamanho (em bytes) Preenchimento
Tipo de registro A 1 F – Comprovante
Tamanho do registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha Formatada
TOTAL 38
(*) Estas linhas formatadas se repetirão de acordo com o tamanho do comprovante formatado.
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro(**) A 1 '4'
Tamanho do registro N 4 ‘0098’
Indicador de linha vinculada A 1 ‘espaços’
130
#interna
Tamanho
Código Tipo Descrição
(em bytes)
00177 N 3 Sequencial de tela: 050
00203 N 2 Tipo de crédito: 01 – Novo
00175 N 4 Código da linha de crédito
00680 N 2 Particularidade do Cliente
00681 N 9 “Zeros”
00387 N 9 “Zeros”
00403 N 12 “Zeros”
131
#interna
00682 N 5 “Zeros”
00671 N 11 “Zeros”
00685 N 17 “Zeros”
00686 A 1 ‘Espaços‘
00388 N 17 Valor do crédito solicitado pelo cliente
TAC financiada – ‘N’
00389 A 1
N – Não permite financiar TAC;
00397 A 1 Impressão da simulação: ‘N’.
Vencimento 1ª parcela: DDMMAAAA
Usar campo carência do último retorno.
00415 N 8 Se 1 – DD
Se 2 – MMAAAA
Se 3 - DDMMAAAA
00390 A 1 Seguro: N – Não aceita seguro
00690 N 2 Tipo da sugestão: 21 – Por valor;
00688 N 17 “Zeros”
00687 A 1 Tipo de simulação: V – Valor do crédito;
00614 N 2 “Zeros”
00615 N 2 “Zeros”
00088 A 37 Trilha 2 do cartão
Informações do Chip:
00136 A 512
77 + tamanho até última tag 9F10 + (*) rótulos do chip
TOTAL 164
(*) Se CDC salário de benefício informar o DD informado no vencimento.
- Retorno 6:
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (*) A 1 '6'
Tamanho do registro N 4 ‘0045’
Prazo da simulação N 3 Prazo em meses: 999
Valor parcela N 9 9999999,99
Valor da operação N 9 Valor líquido: 9999999,99
Valor TAC N 7 “Zeros”
Taxa juros a.m. N 5 999,99
CET a.a. N 5 999,99
TAC financiada A 1 ‘N’
Tipo simulação A 1 V – Valor do crédito;
TOTAL 45
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 'B'
Tamanho do registro N 4 ‘00002’
Cálculo com TAC A 1 ‘N’
Financiar TAC A 1 ‘N’
132
#interna
TOTAL 2
(**) Estas linhas formatadas não se repetem.
OBS (1): É obrigatório no retorno da Output III apresentar mensagem pop-up para o operador com
a seguinte informação:
(ATENÇÃO: É obrigatório informar ao cliente previamente a contratação, os valores de custo
efetivo total anual e informações complementares).
OBS (2): Ao enviar a opção ‘1’ para confirmação do CDC, deverão ser acrescentados na ‘INPUT
IV’ os campos abaixo para validação com cartão e senha:
- Retorno 9
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (*) A 1 ‘9’
Tamanho do registro N 4 0038
Contrato CDC A 38 Resumo do contrato de CDC constando os dados da
operação
TOTAL 48
OBS: Mostrar POP-UP com as seguintes informações: (ATENÇÃO: É obrigatório informar ao cliente previamente à
contratação, os valores de custo efetivo total (Anual) e informações complementares).
(*) Estas linhas formatadas se repetem.
- Retorno G
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘G’
Tamanho do registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
- Retorno M
Tamanho
Campo Tipo Preenchimento
(em bytes)
134
#interna
135
#interna
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro(*) A 1 '2'
Tamanho do registro N 4 ‘0085’
Código da linha de crédito N 4 9999
Nome linha de crédito A 60 Nome da linha de crédito personalizada
Particularidade da linha de crédito:
Código particularidade N 2 Ex: 01 - Funcionário BB
12 – Não Correntista
Limite disponível N 13 99999999999,99
Taxa mínima de juros N 5 999,99
Indicador linha consignada A 1 Se linha for consignada ‘S’, deve-se executar a consulta
dos empregadores / benefícios
TOTAL 85
(*) Estas linhas formatadas se repetirão de acordo com a quantidade de linhas de crédito disponíveis.
Tamanho
Código Tipo Descrição
(em bytes)
00177 N 3 Sequencial de tela: 020
00203 N 2 Tipo de crédito: 04 – Antecipe
00175 N 4 Código da linha de crédito
Particularidade da linha de crédito:
00680 N 2
Ex: 01 - Funcionário BB;
136
#interna
12 – Não Correntista.
00088 A 37 Trilha 2 do cartão
Informações do Chip:
00136 A 512
77 + tamanho até última tag 9F10 + (*) rótulos do chip
TOTAL 560
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro(*) A 1 '3'
Tamanho do registro N 4 ‘0079’
Indicador de repetição A 1 Indica se há mais empregadores / benefícios a serem
apresentados: S – Sim;
N – Não.
Código empregador N 9 999999999
Nome empregador / benefício A 60 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
Número convênio N 9 999999999
TOTAL 79
(*) Estas linhas formatadas se repetirão de acordo com a quantidade de empregadores / benefícios disponíveis.
Tamanho
Código Tipo Descrição
(em bytes)
00177 N 3 Sequencial de tela: 030
00203 N 2 Tipo de crédito: 04 – Novo
00175 N 4 Código da linha de crédito
Particularidade da linha de crédito:
00680 N 2 Ex: 01 - Funcionário BB;
12 – Não Correntista.
00681 N 9 Código empregador
00387 N 9 Convênio
00088 A 37 Trilha 2 do cartão
Informações do Chip:
00136 A 512
77 + tamanho até última tag 9F10 + (*) rótulos do chip
TOTAL 578
137
#interna
- Retorno 4:
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro(**) A 1 '4'
Tamanho do registro N 4 ‘0098’
Vencimento N 2 Diferente de zero, campo deve ser protegido – não
permitir alteração.
Identificar carência DDMMAAAA:
1 – Sem carência – apresentar o campo dia de
vencimento na tela.
2 – Com carência – apresentar o campo de dia de
Carência N 1 vencimento protegido na tela. Permitir o cliente informar
somente mês/ano de vencimento da primeira parcela.
3 – Com carência – apresentar campo para o cliente
informar dia, mês e ano de vencimento da primeira
parcela, respeitando o intervalo.
Valor mínimo N 13 Por valor do crédito – valor mínimo de contração:
99999999999,99
Valor máximo N 13 Por valor do crédito – valor máximo de contração:
99999999999,99
Parcela mínima N 13 Por valor da parcela – valor mínimo da parcela:
99999999999,99
Parcela máxima N 13 Por valor da parcela – valor máximo da parcela:
99999999999,99
Número do convênio N 9 Convênio vinculado ao cliente:
999999999
Financiar TAC A 1 ‘S’ ou ‘N’
Seguro A 1 ‘S’, ‘N’, ou ‘E’
- ‘E’: Seguro prestamista do exército (necessário
responder declaração)
Quantidade de parcelas N 1 Parcelas disponíveis para antecipação 13º salário
Data minima de vencimento N 8 Data mínima vencimento antecipação 13º salário
(contratação sem convênio) DDMMAAAA
Data máxima de vencimento N 8 Data máxima vencimento antecipação 13º salário
(contratação sem convênio) DDMMAAAA
Restituição IRPF N 15 Valor da restituição IRPF do cliente
TOTAL 98
(**) Estas linhas formatadas não se repetem.
- Retorno B:
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (*) A 1 'B'
Tamanho do registro N 4 ‘0082’
Parcela máxima N 15 9999999999999,99
Valor aprovado N 15 9999999999999,99
Valor já utilizado N 15 9999999999999,99
Valor disponível N 15 9999999999999,99
Indicador de aniversário A 1 Parcela de aniversário: S – Sim;
138
#interna
N – Não.
Indicador ordem parcela N 1 Indica qual parcela de antecipação do 13º salário
Ano base N 4 Ano base antecipação: AAAA
Cobrança parcela N 8 DDMMAAAA
Vencimento parcela N 8 DDMMAAAA
TOTAL 82
(*) Estas linhas formatadas se repetem.
Tamanho (em
Código Tipo Descrição
bytes)
00177 N 3 Sequencial de tela: 070
00203 N 2 Tipo de crédito: 04 - Antecipe
00175 N 4 Código da linha de crédito
Particularidade da linha de crédito:
00680 N 2 Ex: 01 - Funcionário BB
12 – Não Correntista
00681 N 9 Código empregador
00387 N 9 Convênio
00139 N 11 CPF (se 13º salário informar ‘zeros’): 99999999999
00388 N 17 Valor solicitado: 999999999999999,99
TAC financiada – ‘S’, ‘N’ ou ‘Z’:
S – Permite financiar TAC;
00389 A 1 N – Não permite financiar TAC;
Z – Permite financiar TAC, porém cliente não deseja
financiar.
00415 N 8 Vencimento 1ª parcela: DDMMAAAA
Seguro: S – Aceita oferta de seguro;
N – Não aceita seguro;
00390 A 1
E – Seguro prestamista exército (necessária
declaração).
Tipo da sugestão: 21 – Por valor;
00690 N 2 22 – Por parcela;
00 – Nenhuma.
00691 A 1 Seguro financiado: ‘S’ ou ‘N’
00391 N 17 Valor do seguro financiado: 999999999999999,99
00040 N 3 Parcela a ser antecipada: 999
Parcela em cobrança 13º salário: S – Sim;
00393 A 1
N – Não.
Opção: 0 – Consulta
00044 N 1
1 – Confirmação
Código do Beneficiário: utilizar campo retorno E.
00392 N 9
999999999
00318 N 4 Ano base antecipação 13º salário: AAAA
00020 N 8 Data cobrança: DDMMAAAA
Valor restituição IRPF (se 13º salário informar ‘zeros’):
00326 N 17
999999999999999,99
TOTAL 130
OBS: Ao enviar a opção ‘1’ para confirmação do CDC, deverão ser acrescentados na ‘INPUT IV’
os campos abaixo para validação com cartão e senha:
139
#interna
- Retorno 8
Campo Tipo Tamanho (em bytes) Preenchimento
Tipo de registro (*) A 1 ‘8’
Tamanho do registro N 4 0038
Contrato CDC A 38 Resumo do contrato de CDC constando os
dados da aquisição
TOTAL 38
(*) Estas linhas formatadas se repetem.
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
(*) Estas linhas formatadas se repetem de acordo com o tamanho do comprovante.
- Retorno M
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (*) A 1 ‘M’
Tamanho do registro N 4 0090
Mensagem A 90 Mensagem apresentada em tela
TOTAL 90
(*) Estas linhas formatadas se repetem.
140
#interna
- Retorno 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0243
Indicador de continuação A 1
Tamanho Range N 4 Tamanho Range Data Space
TOTAL 243
141
#interna
- Retorno 2
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0243
Range N 8 Range Data Space
Número contrato N 9
Número contrato CGN N 9
Nome Cliente A 60 Nome Cliente
Tamanho Range N 4 Tamanho Range Data Space
TOTAL 243
- Retorno 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0243
Range N 8 Range Data Space
Tamanho Range N 4 Tamanho Range Data Space
TOTAL 243
142
#interna
- Retorno 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0243
Range N 8 Range Data Space
Tamanho Range N 4 Tamanho Range Data Space
TOTAL 243
Valor Pagamento:
00117 N 17
‘999999999999999,99’
Opção: 1 – Consulta;
00044 N 1
3 – Confirmação.
Informações do Chip:
00136 A 512
77 + tamanho até última tag 9F10 + (*) rótulos do chip
00088 A 37 Trilha 2 do cartão
00180 A 16 IKSN DUKPT
00155 A 16 Senha criptografada
TOTAL 692
- Retorno 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0243
Range N 8 Range Data Space
Tamanho Range N 4 Tamanho Range Data Space
IND-REC-DB2 N 1 Indicador de recibo
Timestamp A 16 Timestamp
RTN-PRCL A 1 Indicador retorno online
ESTN-ARC A 1 Indicador de estorno
HEADER1 A 47 Header 1
HEADER2 A 44 Header 2
VRS-FORM N 4 Versão
IND-DBT-C N 1 Indicador debito conta corrente
IND-DBT-P N 1 Indicador débito poupança
QTDE-VIAS N 1 Quantidade vias comprovante
Nome do convênio A 40 Nome do convênio
144
#interna
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
(*) Estas linhas formatadas se repetem de acordo com o tamanho do comprovante.
Tabela de Mascaras a ser usada na Consulta 2 de acordo com o Retorno tipo H e tipo C:
Código Descrição Máscara
0 Valor zero 0
1 Valor ZZZ.ZZZ.ZZZ.ZZZ.ZZ9,99
2 Data DD/MM/AAAA
3 Mês/ano MM/AAAA
4 Mês/ano MM/AA
5 Dia DD
6 Mês MM
7 Ano AAAA
8 Agencia ZZZ9-9
9 Conta ZZ.ZZZ.ZZZ.ZZ9-9
10 CNJP ZZ.ZZZ.ZZZ/ZZZ9-99
11 CPF ZZZ.ZZZ.ZZ9-99
12 Percentual ZZ9,999
13 Nr do tamanho fixo de 15 com separador ZZZ.ZZZ.ZZZ.ZZZ.ZZ9
147
#interna
de milhar
14 Parcela X/de Y parcelas Z9/99
15 Telefone ZZ99-9999
Nr do tamanho especificado COM
16 ZZZ.ZZZ.ZZZ.ZZZ.ZZ9
separador de milhar
Dado alfanumérico do tamanho
17
especificado
Nr do tamanho especificado SEM
18 ZZZZZZZZZZZZZZ9
separador de milhar
19 Nr de GRD ZZZ.Z.ZZZZZZ9-9
Nr do tamanho fixo de 11 com separador
20 ZZZ.ZZZ.ZZZ9-9
e dv
21 xxx
22 xxx
23 Opção de Menu
24 DDD 999
25 Campo numérico com separador especial 99.99.99999.9999999-9
26 CPF 999.999.999-99
148
#interna
149
#interna
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
(*) Estas linhas formatadas se repetem de acordo com o tamanho do comprovante.
Exemplo:
- A Consulta 2 deve ser executada somente quando o retorno da Consulta 1 retornar os registros
tipo H e tipo C, e não retornar o registro tipo 1.
- Após o retorno do registro tipo 1, seja na Consulta 1 ou na Consulta 2, o passo seguinte a ser
executado é a confirmação.
Input da Consulta 1
150
#interna
151
#interna
9 Conta ZZ.ZZZ.ZZZ.ZZ9-9
10 CNJP ZZ.ZZZ.ZZZ/ZZZ9-99
11 CPF ZZZ.ZZZ.ZZ9-99
12 Percentual ZZ9,999
Nr do tamanho fixo de 15 com separador
13 ZZZ.ZZZ.ZZZ.ZZZ.ZZ9
de milhar
14 Parcela X/de Y parcelas Z9/99
15 Telefone ZZ99-9999
Nr do tamanho especificado COM
16 ZZZ.ZZZ.ZZZ.ZZZ.ZZ9
separador de milhar
Dado alfanumérico do tamanho
17
especificado
Nr do tamanho especificado SEM
18 ZZZZZZZZZZZZZZ9
separador de milhar
19 Nr de GRD ZZZ.Z.ZZZZZZ9-9
Nr do tamanho fixo de 11 com separador
20 ZZZ.ZZZ.ZZZ9-9
e dv
21 xxx
22 xxx
23 Opção de Menu
24 DDD 999
25 Campo numérico com separador especial 99.99.99999.9999999-9
26 CPF 999.999.999-99
- Consulta 2: Na consulta 2 deverão ser reenviados os dados enviados na consulta 1, além dos
campos de rebate constantes nos registros do tipo H e do Tipo C. No Registro H será necessário
apenas a versão formato do registro. O registro tipo “C” contém informações para validação do
campo, nome do campo e também a máscara que deverá ser utilizada para aquele registro. O
Rótulo 453 sempre será preenchido com a versão formato do registro “H”, já os rótulos 456 até o
475 devem ser preenchidos na ordem que chegarem no Registro Tipo “C” e podem assumir mais
de um tipo de informação e podem ou não ser utilizado. Ex: Recebi 3 tipos de registros, somente
vou utilizar os rótulos 456, 457 e 458 e o conteúdo será preenchido na ordem que chegar.
Input da Consulta 2
152
#interna
Input Confirmação:
* Os rótulos 00065 e 00138 devem ser enviados sempre que o valor do documento a ser pago for superior a R$
2.000,00.
Registro C
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A C ‘C’
Tamanho do registro N 4 0088
Rótulo A 35 Nome do rótulo a ser usado
Mascara N 2 Ver tabela de mascara
Tamanho N 3 Tamanho do Campo
Campos Validação 01 N 2 Ver tabela de validação
Campos Validação 02 N 2 Ver tabela de validação
Campos Validação 03 N 2 Ver tabela de validação
Campos Validação 04 N 2 Ver tabela de validação
Hint Registro C A 40 Campo para uso futuro
TOTAL 243
OBS: O registro C pode ser repetido até 21x, todos os registros tipo “C” devem ser utilizados na consulta 2
- Registro 1 – Retornado na ‘Consulta 1’, caso não existam campos adicionais, ou na ‘Consulta 2’,
caso existam
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0137
Nome Convênio A 40 Nome Convênio
Data Movimento N 8 Data Movimento
Data transação N 8 Data transação
Hora transação N 6 Hora transação
Valor Transação N 17 Valor Transação
Barra 1 N 11 Barra 1
154
#interna
Barra 2 N 11 Barra 2
Barra 3 N 11 Barra 3
Barra 4 N 11 Barra 4
Indicador retorno PRCL N 1 Indicador retorno PRCL
Indicador ESTN-ARC N 1 Indicador ESTN-ARC
Número do Range N 8 Número do Range
Tamanho do Range N 4 Tamanho do Range
TOTAL 142
(**) Estas linhas formatadas não se repetem.
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0038 (tamanho do comprovante)
Linha (*) A 38 Linha formatada
TOTAL 38
(*) Estas linhas formatadas se repetem de acordo com o tamanho do comprovante.
Exemplo :
Consulta 1:
155
#interna
Consulta 2:
156
#interna
Retorno Consulta 2 (ou Consulta 1, caso não existam dados adicionais para esta):
Confirmação:
157
#interna
Retorno da confirmação:
======================================
CONVENIO: VIVO DF
--------------------------------------
03165160412
======================================
NR.AUTENTICACAO D.1B7.1BD.F5A.61D.7E0
Primeiro será feita a transação para montagem dinâmico de opções convênio. Ver no manual
como funciona a transação 87A, é aconselhável fazer cache diário da 87A para diminuir consumo
de banda, mas não fazer cache por vários dias, pois as opções de menu podem sofrer alterações.
158
#interna
Input da Consulta 1
Input da Consulta 1 (os campos 00071 a 00081 devem ser enviados sempre que houver mais de
um identificador para a opção escolhida retornada pela 87A, caso possua apenas 1 identificador -
maioria dos casos - eles podem ser suprimidos):
Obs: O valor para ser usado no rótulo 225 deve ser adquirido via transação 87A onde existe a
informação do menu e a informação do campo a ser usado de acordo com o convênio.
No retorno da Consulta 1 será devolvido diversos registros sendo que a quantidade de registros
pode variar de acordo com o convênio. O registros que serão usados na perna 2 serão o registro
tipo Y e o registro TIPO L.
Verificar o que será mostrado Verificar com gestor registros que serão
na tela utilizados.
Input da Consulta 2
No retorno da Consulta 2 será devolvido um retorno tipo 1, um retorno tipo Y e uma mensagem
informando os dados do cliente e aviso sobre a finalização da transação. Após seguir para o
Passo 3 não haverá desfazimento ou cancelamento posterior.
- Retorno Y – Retorno da Consulta 1
Registro Y
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 1
Tamanho do registro N 4 0018
Registro Chave da Transação N 18 Registro será usado no rotulo 226 das pernas 3
CPF/CNPJ: 656543030001-73
RENAVAM: 00120429144 PLACA: FFF1216
TIPO DE PAGAMENTO EXERC VENCIMENTO VALOR (R$)
IPVA SEM DESCONTO 2017 16/02/2017 764,31
Input Confirmação:
- Retorno Confirmação
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0048 (tamanho do comprovante)
Linha (*) A 48 Linha formatada
TOTAL 48
(*) Estas linhas formatadas se repetem de acordo com o tamanho do comprovante.
1ª PERNA – Consulta com CPF, Renavam ou outro código que identifique o convênio.
Inputs:
HEADER:
0000217170018000001011335123400666001000012345000031810000000000000000378
001C000000400000000000000000000000071
161
#interna
PAYLOAD: 0000100225001876115008000001161100166000100007000091180523900004400011@
RETORNO 1ª PERNA
10045201703280000000000000000000000000
Y0018F0D24DA12683B1CC26
Registro tipo L com 88 posições – Não tem quantidade fixa, contém os dados do titular, do convênio e possui sub-
registros tipo I que serão utilizados como opções de pagamento na 2ª perna e serão utilizados de acordo com a opção
de pagamento escolhida. Os outros registros que não serão utilizados como rebate em outras pernas são dados de
apresentação de tela e usados para que o cliente possa escolher qual pagamento será efetuado.
Na resposta que segue temos 2 opções de pagamento, exercícios de 2016 e 2017, o cliente deve escolher apenas um
que será utilizado no Rótulo 70 da 2ª e 3ª pernas.
L0088M1CPF/CNPJ: 000302429938-69
2ª PERNA – Consulta com CPF, Renavam ou outro código que identifique o convênio.
Inputs:
HEADER:
0000217170018000001011335123400666001000012345000031830000000000000000378
001C000000500000000000000000000000099
PAYLOAD:
00001002260018F0D24DA12683B1CC2600225001876115008000001161100166000100007000100000000018000440
0012@
RETORNO 2ª PERNA
162
#interna
Registro Tipo 1: Este registro contem a data do dia e também o valor de pagamento.
10045201703280000000000000000000110880
Registro Tipo Y com 18 posições: Será utilizado nas pernas 3, este é o mesmo do retorno da 1ª perna
Y0018F0D24DA12683B1CC26
O registro contém também uma mensagem de confirmação de transação e os dados do que está sendo pago.
10045201703280000000000000000000110880
Y0018F0D24DA12683B1CC26
CPF/CNPJ: 302429938-69
Inputs:
HEADER:
0000217170018000001011335123400666001000012345000031840000000000000000378
001P000000700000000000000001000000119
PAYLOAD:
00001002260018F0D24DA12683B1CC2600225001876115008000001161100166000100007000100000000018000440
001300067000100011300011@
RETORNO 3ª PERNA
Registros F com 48 posições contendo as linhas do comprovante, serão disponibilizados vários registros
163
#interna
registros pode ser muito grande eles foram divididos em no máximo 16 linhas por transmissão. Ou
seja, o GCB recebe 16 registro e um indicador de continuação que pode conter mais 16 linhas e
Essa transação trabalha com continuação, sendo que o GCB recebe de 16 em 16 linhas por vez.
A cada 16 linhas temos um retorno tipo 1 e no máximo 15 registros tipo 2, mas somente a ultima
continuação pode vim menos registros.
Registro tipo 0 – O sub-registro tipo 0 indica o tipo de tributo a pagar e tem um sub-registro tipo C
vinculado que terá o mesmo radical acompanhado de outras opções que serão enviadas na perna
1 da 378.
Registro tipo C – O sub-registro tipo C tem informações para complementar o menu do registro
tipo 0 oferecendo sub-opções. O registro tipo C tem o tipo de convênio e a opção de pagamento
que será utilizada para seguir com a transação 378. Ex. 76114
Para efeitos da transação estamos tratando apenas dos campos uteis ao funcionamento da
transação, o conteúdo de montagem de tela deve ser gerenciado de acordo com a necessidade
ou obrigatoriedade da transação.
Input da Consulta 1
- Retorno 2
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘2’
Tamanho do registro N 4 0104
Sub-registro tipo C A 104 Contém convênio com as opções de pagamento
e texto para o menu de sub-opções do convênio
165
#interna
escolhido.
TOTAL 48
(*) Estas linhas formatadas se repetem de acordo com o tamanho do comprovante.
-Detalhamento do sub-registro tipo C (utilizado para montagem dos campos dinâmicos que devem
ser informados na 378):
Tamanho
Campo Tipo Preenchimento
(em bytes)
Filler A 1 ‘’
Tipo sub-registro N 1 C
Convênio N 6 Convênio
Opção N 8 Opção
Mascara N 2 Máscara que deve ser utilizada no input
Tamanho N 2 Tamanho que o identificador deve ter
Regras N 8 Regras de validação dos campos (não utilizado)
Rótulo A 35 Rótulo do identificador
Hint A 40 Hint para auxílio no preenchimento do campo
Linhas em branco N 1 Indica quantas linhas em branco vem após o
subregistro. (preenchimento 0).
TOTAL 104
20104 C10224102000002070400000000EXERCICIO: 0
100450000000000000000
20104 C10224103000001161100000000RENAVAM: 0
20104 C10224104000001161100000000RENAVAM: 0
20104 C10224105000001161100000000RENAVAM: 0
20104 C10224106000001161100000000RENAVAM: 0
20104 C10224107000001161100000000RENAVAM: 0
20104 C10224107000002070400000000EXERCICIO: 0
20104 C10224109000001161100000000RENAVAM: 0
20104 C10224110000001161100000000RENAVAM: 0
20104 C10224111000001161100000000RENAVAM: 0
20104 C10224111000002161100000000CONTROLE: 0
20104 010262801000000RENAVAM (débito veículos)
20104 010262802000000CPF (débito taxas)
20104 010262803000000CNPJ (débito taxas)
20104 C10262801000001161100000000Renavam : 0
20104 C10262802000001111800000000CPF : 0
100450000000000000000
20104 C10262803000001101800000000CNPJ : 0
20104 009960001000000Licenciamento Anual / DPVAT
20104 C09960001000001161100000000RENAVAM: 0
C09960002000001161700000000NUMERO DA
GUIA:
168
#interna
Obs.: Para as situações 2 e 3 será retornado o movimento da chave J presente no pool de chaves
cadastradas no GCB. Não é possível especificar a chave desejada; a utilização das chaves
cadastradas é cíclica.
Input da Consulta 1
Situação 1:
Situação 2:
Situação 3:
Situação 1:
Registro 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0048
Registro 1 A 48 XXXXXXXXXXXXXXXXXXXXXXXXXXX
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0038
Registro F A 38 Contém informações sobre a última transação.
169
#interna
Exemplo de execução:
Retornos
header 000011331798800888801133512340066600100001234500003152J001899500150000327
001C000000100000000000000000000000612
Situação 2:
Registro 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0048
Registro 1 A 48 XXXXXXXXXXXXXXXXXXXXXXXXXXX
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0048
Registro F A 48 Contém informações sobre a última transação.
Retornos:
Header:000021717001800000103243700010066600100001234500006165J300023000080000327
001C000000500000000000000000000000682
Payload formatado:
100480018J30002302940000000000000000000050
COBAN:032437 LOJA:0001 PDV:666001
10/01/2018 BANCO DO BRASIL 14.34.14
001800230 CORRESPONDENTE BANCARIO 0006
170
#interna
Situação 3:
Registro 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0048
Registro 1 A 48 XXXXXXXXXXXXXXXXXXXXXXXXXXX
- Retorno F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0048
Registro F A 48 Contém informações sobre a última transação.
Retornos:
Header:000021717001800000103243700010066600100001234500006166J300023000090000327
001C000000500000000000000000000000826
Payload formatado:
100480018J30002302940000000000000000000050
COBAN:032437 LOJA:0001 PDV:666001
10/01/2018 BANCO DO BRASIL 15.02.34
001800230 CORRESPONDENTE BANCARIO 0006
171
#interna
2. Seleção da parcela a ser paga: o operador deve escolher a parcela que será paga
(informando os dados retornados na consulta 1 (Registro tipo ‘1’ e ‘2’) e obterá como
retorno os dados para confirmação da mesma (Registros tipo “V”).
40.1 INPUT IV
Input da Consulta 1
172
#interna
Finalizador A 1 @ (arroba)
* Os rótulos 00065 e 00138 devem ser enviados sempre que o valor do documento a ser pago for superior a R$
2.000,00.
Registro Tipo “2” (poderá se repetir tantas quantas forem as parcelas possíveis de pagamento)
173
#interna
Após a execução da transação 8F7, o fluxo da aplicação deve ser encaminhado para a transação 357, a fim
de realizar o pagamento normalmente com o código de barras do convênio obtido por essa transação. Para
este caso deve ser adicionado o rótulo 00683 à transação 357.
Situação 1:
Situação 2:
Situação 1:
Registro 2
174
#interna
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘2’
Tamanho do registro N 4 0164
Descrição A 60 Descrição do débito
Valor N 17 Valor total
Data Vencimento N 8 Data de vencimento (DDMMAAAA)
Código de barras A 48 Código de barras (rótulo 00880)
Status A 30 Texto de status do débito
Indicador de permissão A 1 ’S’ ou ‘N’ (quando ‘N’ não será permitido o
pagamento)
Situação 2:
Registro 3
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘3’
Tamanho do registro N 4 0306
Nome Emissor A 60 Nome do órgão emissor
Descrição A 30 Descrição do débito
Número de parcelas A 20 Número de parcelas
Identificador A 20 Código identificador do débito
Texto externo A 100 Texto de débito externo
Texto referência A 20 Texto do período de referência
Data Vencimento N 8 Data de vencimento (DDMMAAAA)
Valor N 17 Valor total
Texto de estado A 30 Texto de estado da guia
Indicador de permissão A 1 ’S’ ou ‘N’ (quando ‘N’ não será permitido o
pagamento)
- A transação R58 deve ser executada informando o CPF do cliente que busca pagar a emissão
de 2ª via do seu RG ao governo de SP.
Após a execução da transação R58, o fluxo da aplicação deve ser encaminhado para a transação 358/5358,
a fim de realizar o pagamento normalmente com o código de barras do convênio obtido por essa transação.
175
#interna
00139 N 11 CPF
Registro 1
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘1’
Tamanho do registro N 4 0044
Código de barras A 44 Código de barras
- A transação M57 deve ser executada para realizar a montagem do menu que permite a escolha
da opção que será efetuado o pagamento.
- A transação M57 pode ser executada quantas vezes (máximo 4) forem necessárias até que
sejam retornados registros tipo 3 e 4 para que seja possível a execução da chamada da transação
N57. O indicador último-item informa quando não haverá mais menus a serem retornados.
- Após a execução da transação M57, deve ser executada a transação N57 para capturar os dados
necessários para realizar o pagamento selecionado.
176
#interna
Registro 2
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘2’
Tamanho do registro N 4 0086
Descrição Completa A 40 Descrição Completa
Descrição Reduzida A 20 Descrição Reduzida
Código do Menu N 4 Código do Menu
Versão do Menu N 4 Versão do Menu
Código do Submenu N 4 Código do Submenu
Versão do Submenu N 4 Versão do Submenu
Código do Subnível N 4 Código do Subnível
Versão do Subnível N 4 Versão do Subnível
Último Item A 1 S ou N indicando se é o último nível de menu
Operação A 1 Ordem da operação executada
Registro 3
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘3’
Tamanho do registro N 4 104
Mensagem informativa A 100 Mensagem informativa para exibição antes dos
campos a serem preenchidos
Quantidade de identificadores N 4 Quantidade de identificadores que serão
solicitados para preenchimento (registros 4)
Registro 4
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘4’
Tamanho do registro N 4 0138
Código do Identificador N 4 Código do Identificador
Máscara do campo N 4 Máscara do campo (ver tabela de mascaras
seção 35)
Tamanho do campo N 4 Tamanho do campo
Regra de validação N 4 Regra de validação 1 (ver tabela da validações
seção 35)
Regra de validação N 4 Regra de validação 2 (ver tabela da validações
177
#interna
seção 35)
Regra de validação N 4 Regra de validação 3 (ver tabela da validações
seção 35)
Regra de validação N 4 Regra de validação 4 (ver tabela da validações
seção 35)
Rótulo do campo A 40 Rótulo a ser usado como label do campo
Hint A 40 Dica para ser usada como instrução do campo
Posição do identificador N 4 Ordem de aparecimento na tela
Código do Serviço N 9 Código do Serviço (usado na N57)
Versão do Serviço N 4 Versão do Serviço (usado na N57)
Código da Operação N 9 Código da Operação (usado na N57)
Versão da Operação N 4 Versão da Operação (usado na N57)
- Os dados do identificador retornados no registro tipo 4 da transação M57 serão utilizados nos
campos 00844 a 00861.
- O retorno da transação N57 é formado por registros L que podem ter diferentes formatos que
variam de acordo com o tipo de elemento presente na primeira posição. O retorno destes registros
é dinâmico.
- Caso o elemento “I” do registro “L” retorne o indicador de retorno com valor “0”, o fluxo deve
prosseguir para o passo seguinte. Caso contrário (retorno “1” e código de barras vazio), o sistema
deve reenviar a transação N57 com o rótulo 00952 preenchido com o rastro de débito retornado
na transação anterior para que seja obtido o código de barras e depois então prosseguir para o
passo seguinte.
- Após a execução da transação N57, o fluxo da aplicação deve ser encaminhado para a
transação 357/5357, a fim de realizar o pagamento normalmente com o código de barras do
convênio obtido por essa transação.
178
#interna
Registro L – Elemento T
179
#interna
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘L’
Tamanho do registro N 4 0195
Elemento A 1 ‘T’
Título da tela A 60 Título da tela
Filler A 134 Filler
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘L’
Tamanho do registro N 4 0195
Elemento A 1 ‘M’
Alinhamento N 1 1 – esquerda; 2 – centralizado;
3 – direita; 4 – justificado
Título da tela A 190 Título da tela
Filler A 3 Filler
Registro L – Elemento R
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘L’
Tamanho do registro N 4 0195
Elemento A 1 ‘R’
Tipo de fonte N 1 Tipo de fonte
Rótulo A 95 Rótulo
Filler A 98 Filler
Registro L – Elemento I
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘L’
Tamanho do registro N 4 0195
Elemento A 1 ‘I’
Tipo da fonte N 1 0 – normal; 1 – negrito; 2 – itálico;
3 – itálico negrito; 4 – monoespaçada
Cor da fonte N 1 0 – azul; 1 – azul escuro; 2 – preto; 3 – rosa
escuro; 4 – cinza escuro; 5 – vermelho; 6 –
vermelho escuro; 7 – verde; 8 – verde escuro; 9 –
marrom
Descrição do debito A 40 Descrição do débito
Data de vencimento A 10 Data de vencimento
Valor de débito N 17 Valor de débito
Código de barras A 44 Código de barras
Rastro de débito A 44 Rastro para solicitação do débito
Indicador de retorno N 1 Indicador de retorno (0 quando não houver
retorno ; 1 quando for necessário)
Filler A 36 Filler
180
#interna
Registro L – Elemento C – complemento do elemento ‘I’ e pode ser retornado quantas vezes
forem necessárias para descrever o débito. Está vinculado ao elemento ‘I’ imediatamente anterior.
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘L’
Tamanho do registro N 4 0195
Elemento A 1 ‘C’
Tipo da fonte N 1 0 – normal; 1 – negrito; 2 – itálico;
3 – itálico negrito; 4 – monoespaçada
Cor da fonte N 1 0 – azul; 1 – azul escuro; 2 – preto; 3 – rosa
escuro; 4 – cinza escuro; 5 – vermelho; 6 –
vermelho escuro; 7 – verde; 8 – verde escuro; 9 –
marrom
Descrição do débito A 40 Descrição do débito
Filler A 152 Filler
Registro L – Elemento W
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘W’
Fixo N 2 00
Rastro do comprovante A 20 Rastro do comprovante
181
#interna
- A transação 8C0 deve ser executada informando o protocolo voucher recebido pelo cliente.
Após a execução da transação 8C0, o fluxo da aplicação deve ser encaminhado para a transação 217, a fim
de realizar o saque do benefício pelo cliente.
Registro 3
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘3’
Tamanho do registro N 4 0054
Trilha 2 A 37 Trilha 2 usada na transação de saque
Saldo N 17 Saldo do benefício disponível
182
#interna
Registro F
183
#interna
Ex.: 000100002171721092020000000001
0001
Convênio: 000021717
Data: 21092020 (21 de setembro de 2020
Loja: 000000001
Registro 1
Input da Consulta 2
184
#interna
Tipo N 2 01
00044 N 1 Preencher com 2
Número do benefício a ser consultado, mesmo da
00403 N 12
consulta 1.
Identificador do Pagamento, escolhido pelo operador,
00118 N 14
das ocorrências de pagamento da consulta 1
00117 N 15 Valor do pagamento retornado na consulta 1
Output da Consulta 1
Registro tipo 1
185
#interna
Output da Consulta 2
Registro tipo 2
TOTAL 6
Output da Consulta 3
Registro V
Output do Pagamento
Registro F
Registro F
187
#interna
Registro 1
A transação 485 deve ser enviada em “duas pernas” (consulta e efetivação) e pode ser executada nas 3
situações abaixo. :
1. Cadastramento de senha
2. Alteração de senha com senha anterior
3. Alteração de senha sem senha anterior.
Registro F
A transação 361 deve ser enviada em “duas pernas” (consulta e confirmação). A transação não pode ser
desfeita após confirmação.
189
#interna
Tipo N 2 01
00044 N 1 0 (Consulta) / 1 (Confirma)
00229 N 3 Instituição (FBB – 000)
00113 N 5 Valor total (máx. R$ 200,00)
TOTAL 14
A transação 867 deve ser enviada após a pré-transação A68 (seção 13) e segue as mesmas regras da
transação 268 (seção 14) com exceção da forma de recebimento dos recursos pelo operador.
190
#interna
A transação 878 é composta de 3 pernas e depende da execução prévia da transação 87A para
montagem do menu e escolha do convênio.
Primeiro será feita a transação para montagem dinâmica das opções de convênio (ver no manual
como funciona a transação 87A). É aconselhável fazer cache diário da 87A para diminuir consumo
de banda, mas não fazer cache por vários dias, pois as opções de menu podem sofrer alterações.
191
#interna
Input da Consulta 1
Na Input da Consulta 1, os campos 00071 a 00081 devem ser enviados sempre que houver mais
de um campo a ser preenchido para a opção escolhida, retornada pela 87A. Caso possua apenas
1 campo (maioria dos casos), eles podem ser suprimidos:
Input da Consulta 2
Na Input da Consulta 2, o rótulo 00070 deve ser enviado com os dados digitados no campo
retornado pela Consulta 1 (caso a Consulta 1 retorne registro do tipo C). Caso a Consulta 1
retorne registros do tipo L, o rótulo 00070 deverá ser preenchido com os dados do elemento I,
contido no registro L, da opção/linha/registro selecionado para pagar.
192
#interna
Input da Confirmação
Na Input da Confirmação, os rótulos 01092 e 01093 devem ser preenchidos com os dados dos
registros tipo R e tipo I, respectivamente, devolvidos no retorno da Consulta 2. Obs.: os valores
dos registros tipo R e tipo I retornados na Consulta 2 são diferentes dos retornados na Consulta 1.
Retorno da Consulta 1
No retorno da Consulta 1 podem ser devolvidos diversos registros sendo que a quantidade pode
variar de acordo com o convênio. Os registros que serão usados na perna 2 serão o registro tipo
R, o registro tipo I e o registro tipo L que contenha o elemento I (este último, se houver).
Registro R
Tamanho
Campo Tipo Preenchimento
(em bytes)
193
#interna
Registro I
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘I’
Tamanho do registro N 4 0126
Registro Chave da Transação A 126 Registro será usado no rótulo 01093 da perna 2
TOTAL 131
Registro L (Lista)
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘L’
Tamanho do registro N 4 0088
Dados do Registro L
‘T’ = título da tela (máximo 2 linhas/registro)
‘M’ = Mensagem da tela (máximo 3
linhas/registro)
‘R’ = Rótulo da lista
Elemento A 1
‘I’ = Item da lista; será mostrado na lista para
seleção pelo cliente. Não há, teoricamente, limite
para a quantidade de linhas a serem mostradas
na lista
Dados do Elemento T
Texto A 87 Texto a ser mostrado no título da tela
Dados do Elemento M
Alinhamento N 1 1 = esquerda; 2 = centralizado;
3 = direita; 4 = justificado
Texto A 86 Texto da mensagem a ser mostrada na tela
Dados do Elemento R
Tipo da fonte N 1 0 = proporcional; 1 = monoespaçada
Texto A 86 Texto a ser mostrado na área de título da lista
Dados do Elemento I
Será usado no rótulo 00070 da perna 2 indicando
a linha/registro selecionado. Obs.: se o código
Código A 10
estiver “em branco” a linha será mostrada na lista
mas o operador do PDV não poderá selecioná-la.
Tipo/Estilo da fonte N 1 0 = normal; 1 = negrito; 2 = itálico;
3 = itálico negrito; 4 = monoespaçada
Cor da fonte N 1 0 = azul; 1= azul escuro; 2 = preto; 3 = rosa
escuro; 4 = cinza escuro; 5 = vermelho; 6 =
vermelho escuro; 7 = verde; 8 = verde escuro; 9
= marrom
Texto A 75 Dados a serem mostrados na lista
Obs.: os campos que trazem orientações de formatação de texto (fonte, cor, etc.) podem ser
ignorados ou adaptados conforme preferência de implementação das telas.
194
#interna
Registro C
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘C’
Tamanho do registro N 4 0088
Máscara do campo A 2 Máscara a ser utilizada na entrada de dados
Tamanho do campo N 2 Tamanho que o campo deve ter
Regras de validação do N 8 Regras de validação do campo (não utilizado)
campo
Rótulo do campo A 35 Rótulo do campo
Hint A 40 Dica para auxílio no preenchimento do campo
Quantidade de linhas em N 1 Número de linhas em branco após esta linha
branco
TOTAL 93
Retorno da Consulta 2
No retorno da Consulta 2 podem ser devolvidos diversos registros sendo que a quantidade pode
variar de acordo com o convênio. Os registros que serão usados na perna 3 serão o registro tipo
R e o registro tipo I.
Registro R
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘R’
Tamanho do registro N 4 0153
Registro Chave da Transação A 153 Registro será usado no rótulo 01092 da perna 3
TOTAL 158
Registro I
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro (**) A 1 ‘I’
Tamanho do registro N 4 0126
Registro Chave da Transação A 126 Registro será usado no rótulo 01093 da perna 3
TOTAL 131
195
#interna
Registro P
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘P’
Tamanho do registro N 4 0048
Indicador de troca de data A 1 ‘N’ ou ‘S’
Filler N 13 Preenchido com zeros
Valor da transação N 17 Contém o valor da transação
Número do protocolo N 17 Número do protocolo
TOTAL 53
Obs.: o campo valor da transação contém o valor do tributo selecionado para pagamento.
Retorno da Confirmação
Registro F
Tamanho
Campo Tipo Preenchimento
(em bytes)
Tipo de registro A 1 ‘F’
Tamanho do registro N 4 0048
Linha A 48 Linha formatada para o comprovante
TOTAL 53
Obs.: em caso de sucesso, o comprovante da transação é retornado através dos registros F, em
que cada registro representa uma linha do comprovante.
Exemplo 1
Tela da Consulta 1
Obs.: os campos desta tela são montados de acordo com o retorno da transação 87A.
Input da Consulta 1
Header
000021717001800000100000000000066601900001234500010870000000000000000087
8 001C000000500000000000000000000000086
Payload
000010004400011000700011001020056050007100042023001660001000225001808150
197
#interna
4010000012000@
Retorno da Consulta 1
Header
000021717001800000100000000000066601900001234500010870J30002320033000087
8 001C000001000000000000000000000000754
Payload
R01530000000000000DCF62176C9F108B600000000000000000001000000102005605000
000007000018081504000000200 RAVEL DE PADUA DA SILVA
0310019801000000000000000000000 0I012600000000000000000PREF MUN SAO
PAULO 1000000000000000000000000000001
T00882CONTRIBUINTE: 001.020.0560-5 XXXXXXXXXXXXXXXX
0T00882EXERCICIO: 2023 NOTIFIC: 01 VENCTO: 14/05/2023
0T00882004-Parcela 04 Valor a pagar: 71,88
0C0088160200000000Digite parcela a pagar ou outra:
0T00882Exerc. em aberto:
0
Obs.: Na consulta 2 deverão ser utilizados os dados dos registros R e I. Para este exemplo, a
Consulta 1 retornou um registro do tipo C, solicitando nova entrada de dados, e cujo valor será
enviado no rótulo 00070 da Consulta 2.
Tela da Consulta 2
Obs.: esta tela é montada e exibe campo e textos retornados na Consulta 1 (passo anterior).
Input da Consulta 2
Header
000021717001800000100000000000066601900001234500010923000000000000000087
8 001C000000600000000000000000000000360
Payload
000010004400012000700001400166000100022500180815040100000120000109201530
000000000000DCF62176C9F108B600000000000000000001000000102005605000000007
000018081504000000200 RAVEL DE PADUA DA SILVA
198
#interna
Retorno da Consulta 2
Header
000021717001800000100000000000066601900001234500010923J30002320084000087
8 001C000001100000000000000000000000807
Payload
R01530008700927080DCF654BF6611F6B610000000000000718801000000102005605000
000007000077081504000000510 RAVEL DE PADUA DA SILVA
0310019801000000000000000000000 0I012600000000000000000PREF MUN SAO
PAULO 1000000000000000000000000000001
P0048N00000000000000000000000000718800000000000000000V0088.
Debito em Conta Corrente
V0088NUMERO DO CONTRIBUINTE (S.Q.L.): 001.020.0560-5
V0088EXERCICIO DE LANCAMENTO: 2023
V0088NOTIFICACAO - 01 VENCIMENTO: 14/05/2023
V0088PARCELA 04 VALOR PAGAR: 71,88
Obs.: Na confirmação deverão ser utilizados os dados dos registros R e I retornados nesta
Consulta 2.
Tela da Confirmação
Importante: A tela de confirmação só pode ser exibida após o recebimento de registros do tipo V
no retorno da Consulta 2.
Obs.: esta tela exibe textos de confirmação retornados na Consulta 2 (passo anterior).
199
#interna
Input da Confirmação
Header
000021717001800000100000000000066601900001234500010938000000000000000087
8 001P000001000000000000007188000000727
Payload
00001000440001300066000100008800374001859000000083=161000000000044907900
01360262778180820258005F3401008407A000000004101057135549063003307530D151
12062157436690770F9F02060000000000009F03060000000000009F1A02007695050000
0008005F2A0209869A031108199C01009F3704711173709F3501149F450200009F270100
9F26082BF35A3550A5BE199F3602000C9F10080201038000000000001550016F8FAEE609
6DB17CC0016600010001800016403EA0A000200038002250018081504010000012000010
9201530008700927080DCF654BF6611F6B61000000000000071880100000010200560500
0000007000077081504000000510 RAVEL DE PADUA DA SILVA
0310019801000000000000000000000 001093012600000000000000000PREF MUN SAO
PAULO 1000000000000000000000000000001
@
Obs.: o rótulos 01092 e 01093 foram preenchidos com os valores dos registros tipo R e tipo I,
respectivamente, retornados na Consulta 2.
Retorno da Confirmação
Header
000021717001800000100000000000066601900001234500010938J30002320094000387
8 001P000001000000000000007188000002597
Payload
F0048 COBAN:021717 LOJA:000001 PDV:666019 F0048SISBB -
SISTEMA DE INFORMACOES BANCO DO BRASILF004807/03/2023 -
AUTOATENDIMENTO - 18.32.38F00480018321717
0003F0048 F0048
COMPROVANTE DE PAGAMENTO F0048
F0048CLIENTE: RAVEL DE PADUA DA SILVA F0048AGENCIA: 0018-
3 CONTA: 324.771-
6F0048================================================F0048CONVENIO:
PREFEITURA DO MUNICIPIO DE SAO PAULO F0048CODIGO DE BARRAS:
F004881800000000 71885701230 30749000495 62100039997 F0048--------------
----------------------------------F0048TRIBUTO.................:
IPTUF0048DATA DO PAGAMENTO.......: 07/03/2023F0048NUMERO
CONTRIBUINTE(SQL): 001.020.0560-5F0048DATA DE VENCIMENTO......:
14/05/2023F0048EXERCICIO...............:
2023F0048NOTIFICACAO.............:
01F0048PARCELA.................: 04F0048VALOR DA
PARCELA........: 71,88F0048TOTAL DO PAGAMENTO......:
71,88F0048NSU PRODAM..............: 0.07.000088F0048NSU
BANCO...............:
000069F0048================================================F0048DOCUMENT
O: 030703 F0048AUTENTICACAO SISBB:
B.557.8A2.407.FF1.165F0048==============================================
==F0048Central de Atendimento BB F00484004 0001
Capitais e regioes metropolitanas F00480800 729 0001 Demais
Localidades F0048Consultas, informacoes e servicos
transacionais.F0048
F0048SAC F00480800 729 0722
200
#interna
Exemplo 2
Tela da Consulta 1
Obs.: os campos desta tela são montados de acordo com o retorno da transação 87A.
Input da Consulta 1
Header
000021717001800000100000000000066601900001234500010953000000000000000087
8 001C000000400000000000000000000000073
Payload
000010004400011000700011001160572540016600010002250018761150080000011611@
Retorno da Consulta 1
Header
000021717001800000100000000000066601900001234500010947J30002320069000087
8 001C000000900000000000000000000001405
Payload
R01530000000000000DCF776048898091A00000000000000000040000000000000000000
000000000000076929000000100 RAVEL DE PADUA DA SILVA
0310019801000000000000000000000 0I012600000000000000000SEFAZ SP
5331640210001000000001160572541
L0088M1PROPRIETARIO: TOKIO MARINE SE
L0088M1CPF/CNPJ: 331640210001-00
L0088M1RENAVAM: 00116057254 PLACA: FFF6413
201
#interna
Tela da Consulta 2
Obs.: esta tela é montada e exibe os itens retornados na Consulta 1 (passo anterior).
Input da Consulta 2
Header
000021717001800000100000000000066601900001234500010953000000000000000087
8 001C000000600000000000000000000000369
Payload
000010004400012000700010000000004800166000100022500187611500800000116110
109201530000000000000DCF776048898091A00000000000000000040000000000000000
000000000000000076929000000100 RAVEL DE PADUA DA SILVA
0310019801000000000000000000000 001093012600000000000000000SEFAZ SP
5331640210001000000001160572541
@
Obs.: o rótulo 00070 foi preenchido com o valor do elemento I, do registro L, selecionado no
retorno da Consulta 1 e os rótulos 01092 e 01093 foram preenchidos com os valores dos registros
tipo R e tipo I, respectivamente, retornados na Consulta 1.
202
#interna
Retorno da Consulta 2
Header
000021717001800000100000000000066601900001234500010923J30002320084000087
8 001C000001100000000000000000000000807
Payload
R01530109392940330DCF7855B27054D1110000000000018603240000000000000000000
000010000003076929000000310 RAVEL DE PADUA DA SILVA
0310019801000000000000000000000 0I012600000000000000000SEFAZ SP
5331640210001000000001160572541
P0048N00000000000000000000000018603200000000000000000V0088.
Debito em Conta Corrente
V0088ATENCAO: ESTA OPCAO EFETUA O PAGAMENTO DO TRIBU-
V0088TO NESTE MOMENTO. CASO A TRANSACAO SEJA CONFIR-
V0088MADA, O PAGAMENTO NAO PODERA SER CANCELADO.
V0088
V0088PROPRIETARIO: TOKIO MARINE SE
V0088CPF/CNPJ: 331640210001-00
V0088RENAVAM: 00116057254 PLACA: FFF6413
V0088TIPO DE PAGAMENTO EXERC VENCIMENTO VALOR (R$)
V0088IPVA 2021 1.860,32
V0088
V0088DATA DO PAGAMENTO: 08/03/2023
Obs.: Na confirmação deverão ser utilizados os dados dos registros R e I retornados nesta
Consulta 2.
Tela da Confirmação
Importante: A tela de confirmação só pode ser exibida após o recebimento de registros do tipo V
no retorno da Consulta 2.
Obs.: esta tela exibe textos de confirmação retornados na Consulta 2 (passo anterior).
203
#interna
Input da Confirmação
Header
000021717001800000100000000000066601900001234500010953000000000000000087
8 001P000001000000000000186032000000727
Payload
00001000440001300066000100008800374001859000000083=161000000000044907900
01360262778180820258005F3401008407A000000004101057135549063003307530D151
12062157436690770F9F02060000000000009F03060000000000009F1A02007695050000
0008005F2A0209869A031108199C01009F3704711173709F3501149F450200009F270100
9F26082BF35A3550A5BE199F3602000C9F10080201038000000000001550016F8FAEE609
6DB17CC0016600010001800016403EA0A000200038002250018761150080000011611010
9201530109392940330DCF7855B27054D111000000000001860324000000000000000000
0000010000003076929000000310 RAVEL DE PADUA DA SILVA
0310019801000000000000000000000 001093012600000000000000000SEFAZ SP
5331640210001000000001160572541
@
Obs.: o rótulos 01092 e 01093 foram preenchidos com os valores dos registros tipo R e tipo I,
respectivamente, retornados na Consulta 2.
Retorno da Confirmação
Header
000021717001800000100000000000066601900001234500010953J30002320074000087
8 001C000000900000000000000000000003922
Payload
F0048 COBAN:021717 LOJA:000001 PDV:666019 F0048SISBB -
SISTEMA DE INFORMACOES BANCO DO BRASILF004808/03/2023 -
AUTOATENDIMENTO - 16.02.29F00480018321717
0062F0048 F0048
COMPROVANTE DE PAGAMENTO F0048
F0048CLIENTE: RAVEL DE PADUA DA SILVA F0048AGENCIA: 0018-
3 CONTA: 324.771-
6F0048================================================F0048
BANCO DO BRASIL S.A. - 001 F0048
F0048AGÊNCIA DE RECOLHIMENTO: 0018 F0048TERMINAL DE
RECOLHIMENTO: 021717 F0048CANAL DE PAGAMENTO:
Correspondente Bancário F0048NSU BANCO: 000057228119
F0048NSU PRODESP: 010000003 F0048CÓDIGO SERVIÇO
DETRAN: 008 F0048HORÁRIO DA TRANSAÇÃO: 15:53:48
F0048DATA DA TRANSAÇÃO: 08/03/2023 F0048DATA DA
ARRECADAÇÃO: 08/03/2023 F0048
F0048 IPVA ONLINE - SEFAZ SP F0048
F0048CODIGO DE RECEITA: 036-0 F0048PROPRIETARIO:
TOKIO MARINE SE UF: SPF0048RENAVAM: 00116057254
PLACA: FFF6413F0048CPF/CNPJ: 331640210001-00
F0048CÓDIGO DO MUNICÍPIO: 255-0 F0048
F0048TIPO DE PAGAMENTO EXERC VENCIMENTO VALOR (R$)F0048--------------
------ ----- ---------- ----------F0048IPVA 2021
1.860,32F0048
F0048PAGAMENTO EM: 08/03/2023 F0048--------------
----------------------------------F0048COMPROVANTE DE PAGAMENTO EMITIDO
DE ACORDO COMF0048A PORTARIA CAT-126 DE 16/09/2011, AUTORIZADO
204
#interna
O rótulos abaixo devem ser preenchidos utilizando o formato de graus decimais (DD, em inglês). Exemplos
de dados em graus decimais: Latitude: -15.7801, Longitude: -47.9292.
Os rótulos devem possuir tamanho fixo (0011) e o conteúdo será composto por um byte indicando o sinal e
mais 10 posições válidas. Essas 10 posições válidas são formadas por 3 bytes inteiros mais 7 decimais.
(sinais e vírgulas ou pontos não devem ser enviados). Exemplos de “conversões”:
-15.7801 ➔ 00157801000
-47.9292 ➔ 00479292000
-17.866536 ➔ 00178665360
-41.509087 ➔ 00415090870
206
#interna
207
#interna
57 TABELA DE ERROS
Neste caso o terminal deverá iniciar uma transação 9900 ou 9902. Após
PDV COM PENDÊNCIA AUTOMÁTICA,
1 103 PDV com pendência repetir a operação desejada.
208
#interna
ERRO NO GTS1 OU GTS2 O GCB não conseguiu criar sessão com o BB Analisar disponibilidade de SOCKET e / ou comunicação com BB, verificar
1 121
LOG do GCB. Repetir a operação.
O GCB não pode realizar a identificação do usuário no Verificar LOG do GCB. Repetir operação. Se persistir Contatar o BB
1 122 ERRO NA 301 DA CHAVE / AGENCIA
BB (CHAVE / AGENCIA) informando o erro e o seqüencial.
O GCB identificou que não existe mais espera pela
1 123 EXCEDEU O TEMPO DE RESPOSTA 301 resposta, neste caso inclui mensagem no LOG e não Repetir a operação
envia ao solicitante, que irá cair por time-out.
O GCB estourou o tempo de resposta para o PDV. A
Consultar pendência. Se existir , providenciar cancelamento e Repetir a
1 124 EXCEDEU O TEMPO DE RESPOSTA PGTO transação foi efetuada. O PDV não recebe
operação.
comprovante.
Excedeu o número máximo permitido de transações
1 125 EXCEDEU LIMITE TRANSAÇÕES DA CHAVE/AGENCIA. Entrar em contato com agência de relacionamento.
permitidos para a CHAVE/AGENCIA.
CHAVE J NÃO VINCULADA AO No cadastro da Chave J deve ocorrer a correta
1 126 Verificar o cadastro com equipe CBO.
CONVÊNIO/AGENCIA/LOJA vinculação com o convênio, a agência e a loja.
Aguardar alguns momentos e tentar novamente. Persistindo o erro
verificar o status da comunicação entre os servidores. A falha de
1 133 FALHA DE COMUNICAÇÃO - TIMEOUT Semelhando ao erro 203 . É gerado pelo GCB.
comunicação estará entre o GCB e o Banco. Verificar a rede cliente. Se ok,
entrar em contato com o Banco do Brasil – 0xx61-3101530.
5 135 CONTA BLOQUEADA Conta bloqueada Entrar em contato com agência de relacionamento.
5 136 CONTA ENCERRADA Conta encerrada Entrar em contato com agência de relacionamento.
5 138 CONTA INEXISTENTE Conta inexistente Conta incorreta ou encerrada.
5 140 CONTA PRIVATIVA Conta poupança ou salário Tais contas impossibilitam débito para pagamento.
209
#interna
211
#interna
5 404 TEMPORARIAMENTE NAO DISPONÍVEL Transação não disponível no momento Tente mais tarde
5 405 NÃO DISPONÍVEL PARA ESTA CONTA Conta não possui autorização Entrar em contato com agência de relacionamento.
Programa cliente tentou executar uma transação
utilizando uma sessão inexistente. Periodicamente
3 405 SESSÃO INEXISTENTE ocorre o expurgo de sessões, baseado no intervalo de Repetir a operação.
tempo de utilização. Exemplo: A sessão foi expurgada
por inatividade
Programa cliente tentou executar uma transação
utilizando um tipo de serviço de um canal de
Acionar responsável pelo programa cliente para que o acerto possa ser
3 406 USO OBRIGATÓRIO DE SESSÃO comunicação que exige uso de uma sessão para
providenciado
criptografia, sem a informação obrigatória de número
de sessão
Programa cliente tentou executar uma transação
utilizando um tipo de serviço de um canal de
Acionar responsável pelo programa cliente para que o acerto possa ser
3 407 TENTATIVA DE USO DE SESSÃO SEM IDENTIFICAÇÃO comunicação que exige uso de uma sessão para
providenciado
cifragem, sem a informação obrigatória de identificação
de usuário
Programa cliente tentou executar uma transação
utilizando uma sessão que ainda não esta ativa, por Acionar responsável pelo programa cliente para que o acerto possa ser
3 408 SESSÃO NÃO ESTA ATIVA
ainda não ter passado pelo processo de autenticação providenciado
do usuário
Programa cliente tentou executar uma transação Acionar responsável pelo programa cliente para que o acerto possa ser
3 409 SESSÃO NÃO PERTENCE AO USUÁRIO
utilizando uma sessão pertencente a outro usuário providenciado
Programa cliente tentou executar uma transação para
um tipo de serviço de um canal de comunicação que
3 410 SEQÜENCIAL DE SESSÃO INVALIDO Repetir a operação.
utiliza sessão, não tratando de forma adequado o
controle de seqüência de execução de transação
Programa cliente tentou executar uma transação de
Acionar responsável pelo programa cliente para que o acerto possa ser
negócio cuja versão não corresponde a versão mais
3 411 VERSÃO INCORRETA DA TRANSAÇÃO DE NEGOCIO providenciado. Caso o programa esteja correto verificar versão do
atual, podendo desta forma estar com uma versão
usuário
antiga do programa cliente
A transação de negócio foi temporariamente
3 412 TRANSAÇÃO TEMPORARIAMENTE INDISPONÍVEL Sem providencias. Aguardar pela liberação da transação
bloqueada pelo Banco
5 413 EM BREVE À SUA DISPOSIÇÃO Transação não está liberada pelo sistema do Banco Transação ainda não está em operação.
3 413 USUÁRIO NÃO CADASTRADO Usuário informado não consta no cadastro Usuário deve informar a chave correta
Programa cliente tentou executar uma transação de
negócio de um tipo de serviço de um canal de Acionar responsável pelo programa cliente para que o acerto possa ser
3 414 USUÁRIO NÃO INFORMADO
comunicação que exige autenticação e sem a providenciado
informação obrigatória de chave de usuário
3 415 SENHA EXPIRADA Senha do usuário se encontra expirada ou trata-se do Executar transação de alterar senha através do Gerenciador Financeiro (
212
#interna
213
#interna
214
#interna
Problema interno nos sistemas do Banco Entrar em contato com o Banco e informar transação, código de erro e o
9 520 TRANSAÇÕES SOL/GRI INDISPONIVEL
código entre parênteses.
Problema interno nos sistemas do Banco Entrar em contato com o Banco e informar transação, código de erro e o
9 521 TRANSAÇÕES SOL/GRI INDISPONIVEL
código entre parênteses.
Entrar em contato com o Banco e informar transação, código de erro e o
9 522 TRANSAÇÕES SOL/GRI INDISPONIVEL Problema interno nos sistemas do Banco
código entre parênteses
Entrar em contato com o Banco e informar transação, código de erro e o
9 524 TRANSACOES SOL/GRI INDISPONIVEL Problema interno nos sistemas do Banco
código entre parênteses
Entrar em contato com o Banco e informar transação, código de erro e o
9 525 TRANSACOES SOL/GRI INDISPONIVEL Problema interno nos sistemas do Banco
código entre parênteses
Problema interno nos sistemas do Banco Entrar em contato com o Banco e informar transação, código de erro e o
9 526 TRANSAÇÃO NÃO DISPONIVEL NO GRI
código entre parênteses
5 600 LIMITE DE CRÉDITO ULTRAPASSADO Sem limite de crédito Cliente não possui crédito para quitar obrigação.
5 645 DATA PAGAMENTO INVALIDA Data de pagamento invalida Alterar data de pagamento
5 646 DATA VENCIMENTO INVALIDA Data de vencimento invalida Documento vencido.
5 676 SOMENTE PAGÁVEL NA CONTA CORRENTE Somente para conta corrente Repetir a operação utilizando conta corrente.
5 679 INFORME DATA FUTURA PARA AGENDAMENTO Data para pagamento informada não útil Repetir operação com data correta.
Seqüencial informado na INPUT III menor que o
5 681 SEQÜÊNCIA INVÁLIDA Repetir a operação.
anterior
5 725 COD BARRA - DOCUMENTO VENCIDO Dados recebidos indicando documento vencido Se digitado, redigitar, senão encaminhar a agências do BB
5 788 NÃO RECEBIDO NO BANCO DO BRASIL Documento não pode ser recebido no BB Informar o cliente que documento não pode ser recebido
5 817 CARTÃO NÃO EH TITULAR DA CONTA Cartão adicional da conta Permitido apenas para cartão titular.
5 826 DADOS INCONSISTENTES Dados inconsistentes Verificar dados informados.
5 829 INCONSISTÊNCIA CONVÊNIO DE DÉBITO Convênio inconsistente Verificar dados do convênio.
5 830 PERMITIDO APENAS REC. EM DINHEIRO Pagamento somente em dinheiro Não aceita cheque.
5 863 BLOQUEIO – RESTRIÇÃO CADASTRAL Cliente com restrição Orientar cliente a procurar agência de relacionamento.
5 867 CÓDIGO DE BARRA INVALIDO Dados recebidos na barra estão não numéricos Alterar dados do código de barra
Entrar em contato com o Banco e informar transação, código de erro e o
5 886 USUÁRIO NÃO AUTORIZADO NO ACESSO Usuário sem acesso
código entre parênteses
5 896 UTILIZE OPÇÃO 1-DIN OU 2-CHQ. Tipo de pagamento invalido Alterar tipo de pagamento
5 948 CVV2 NÃO INFORMADO CVV2 não informado Informar dados de CVV2
5 999 ERRO GENÉRICO DE SISTEMA Erro personalizado Mensagem de erro personalizada.
217
#interna
58 SUPORTE TELEFÔNICO
Dúvidas técnicas relacionadas ao sistema GCB poderão ser dirimidas no 0800.729 9905.
Senha 9999, e após a opção ‘1’ Correspondente Banco do Brasil.
59 HISTÓRICO DE VERSÕES
A partir da versão 8.6.6 do GCB e 8.6.6.1 do manual, o versionamento passará a ser definido
conforme diagramação abaixo.
218
#interna
10.1.0 03/04/2020 TR 8C0/58C0 – Confere protocolo para saque F0738551 – André Mano
voucher Amazonas
TR 217/5217 – Saque Voucher
10.0.3 17/02/2020 TR 378 – Correção para substabelecidos F0738551 – André Mano
TR R58 – Alteração do input da transação para Amazonas
emissão de 3 tipos de guias
10.0.2 30/11/2019 TR 8F7 – Alteração interna do canal F738551 – André Mano
Amazonas
10.0.1.1 14/11/2019 TR 357 – Alteração na descrição do input de F0738551 – André Mano
confirmação Amazonas
TR N57 – Alteração da descrição do registro W para
registro L com elemento W
10.0.1 31/10/2019 TR N57 – Inclusão do registro W para recuperar as F0738551 – André Mano
informações do comprovante Amazonas
TR 357/5357 – Inclusão do rótulo 00965 para
recuperar as informações do comprovante
Alteração do tipo informado nos caracteres iniciais
do INPUT IV para TR 357/5357
219
#interna
10.0.0 02/10/2019 Remoção do bloqueio de chave J por excesso de F738551 – Andre Mano
execuções do substabelecido (não houve alterações Amazonas
no manual)
9.0.0.1 01/10/2019 Inclusão do parâmetro de identificação da origem do F0738551 – André Mano
pagamento webservice na TR 357/5357 Amazonas
9.0.0 13/09/2019 Recuperação não cíclica de chave J F0738551 – André Mano
Amazonas
8.6.6.1 23/07/2019 TR 208 – Inclusão dos campos para identificação do F0738551 – André Mano
depósito. Amazonas
TR 87A – Inclusão da descrição dos sub-registros
tipo ‘0’ e tipo ‘C’
TR 378 – Inclusão de rótulos para envio de mais de
um identificador na primeira perna da transação
8.6.6 27/05/2019 Alteração do protocolo da transação N57 F0738551 – André Mano
Amazonas
8.6.5 18/01/2019 Inclusão do suporte ao substabelecido para as F0738551 – André Mano
transações 5N57 e 5M57 Amazonas
8.6.4.2 12/04/2019 TR 8F7 – Alteração do campo que versiona a input e F0738551 – André Mano
descrição do formato dos campos data Amazonas
8.6.4.1 27/11/2018 TR. A68 / 268 – Alteração da descrição F0738551 – André Mano
Amazonas
8.6.4 07/06/2018 Inclusão das transações abaixo: F738551 – André Mano
TR. N57 – Recebimento de convênios sem guias Amazonas
TR. M57 – Recebimento de convênios sem guias
8.6.3 15/05/2018 TR. R58 – Emitir DARE Sefaz SP F738551 – André Mano
Amazonas
8.6.2 06/02/2018 TR. 8F7 – Lista / Detalhamento de Débitos por F0738551 – André Mano
CPF/CNPJ Amazonas
8.6.1 10/01/2018 TR. 327 – Consulta movimento detalhado do F0738551 – André Mano
operador (chaveJ) Amazonas
TR. 327 – Consulta movimento consolidado do
operador (chaveJ)
8.5.9 08/08/2017 TR. 246 – Inclusão da transação Recebimento do F738551 – André Mano
programa minha casa minha vida. Amazonas
TR. 268 – Ajuste na descrição dos rótulos.
TR. A68 – Ajuste na descrição dos campos do
Retorno 2, informando a qual rótulo da TR. 268 eles
se referem.
8.5.8.1 10/07/2017 TR. 357 – Inclusão da possibilidade de execução da F738551 – André Mano
transação sem a realização da ‘consulta 2’ e Amazonas
melhoria na descrição do fluxo da mesma.
8.5.8 04/07/2017 Inclusão dos rótulos ‘00090’, ‘00098’ e ‘00100’ na F738551 – André Mano
transação 268 e inclusão do suporte à transação Amazonas
5357 na transação 5A02.
8.5.7.1 08/06/2017 Remoção do rótulo 00452 da transação 357 e F0738551 – André Mano
substituição do mesmo pelo 00012 Amazonas
220
#interna
221
#interna
de São Paulo
Inclusão CNL2 – Gerador de tíquete por sessão de
atendimento.
Inclusão da TR4A02 – Alívio Numerário Gerencial. F9328977 – Thiago de
Alteração na mensageria CDC – TR8BX. Andrade Albuquerque
8.5 25/09/2014
Inclusão da mensageria CDC – TR8BM.
Adequação do manual para Versão 002 da TR294.
Inclusão da TR8BX – Contrata CDC. F9328977 – Thiago de
Inclusão da TR892 – Recebimento de convênio com Andrade Albuquerque
8.4 14/05/2014 débito em c/c.
Correção da montagem do comprovante da TRQ01 –
Consulta favorecido depósito.
Correção da montagem do comprovante de depósito. F9328977 – Thiago de
8.3.1 27/11/2013
Andrade Albuquerque
Referência ao normativo BACEN 2926 relativo ao F9328977 – Thiago de
8.3 22/11/2013 fator de vencimento de boletos – página 33. Andrade Albuquerque
Inclusão de histórico de versões – fim do documento.
Inclusão da transação Q01 – consulta titularidade F9328977 – Thiago de
8.3 12/09/2013
conta. Andrade Albuquerque
8.2.3 08/07/2013 Correção comprovante COBAN e Substabelecido. F9328977 – Thiago de
Retira pendência automática para Substabelecido, Andrade Albuquerque
pois controle ficará com a transação 5A02.
8.2.2 30/11/2012 Correção do registro F quando houver continuação. F3260058 – Fernando
Monteiro Vargues
8.2.1 20/11/2012 Inclusão das transações de saldo, extrato, depósito e F3260058 – Fernando
saque em conta corrente e poupança. Monteiro Vargues
F9328977 – Thiago de
Andrade Albuquerque
8.2 01/02/2012 Inclusão da SERASA como concentrador de F9328977 – Thiago de
Multiexecução sem controle sequencial. Andrade Albuquerque
7.4 17/05/2010 Correção na montagem do campo chave da TR315 F2749669 – Eduardo
quando utilizada pela TR9902. Rojas Martines
7.0 21/01/2010 Correção da reimpressão do comprovante quando F2749669 – Eduardo
não permite cancelamento. Rojas Martines
6.1.1 11/12/2007 Transações 9902 e 315 nos casos que não permitem F0435959 – Alexandre
cancelamento retornarão 2ª via do comprovante. Gomes Tomita
6.1 01/09/2007 Implementação de nova interface para o usuário. F2749669 – Eduardo
Rojas Martines
6.0.2 04/04/2007 Unificação GCB Correspondente + Parceria F2749669 – Eduardo
Varejista. Rojas Martines
6.0.1 01/08/2006 Retirado PCAR. F2749669 – Eduardo
Rojas Martines
5.3.1 10/05/2006 Incluído PCAR para Parceria Varejista. F2749669 – Eduardo
Rojas Martines
5.3 23/03/2005 Inclusão da TR949 – Seguro Acidentes Pessoais e F2749669 – Eduardo
TR020 – Saldo de Benefício. Rojas Martines
222
#interna
223