Este documento contém informações confidenciais. A posse destas informações é permitida apenas às pessoas que a Servicenet a tenha concedido. Caso você não tenha permissão para estar em posse deste documento, entre em contato com a Servicenet através do email suporte@servicenet.com.br e apague imediatamente este documento.
A posse deste documento só poderá ocorrer caso você (ou a empresa que você representa) tenha o contrato de confidencialidade assinado e estabelecido com a Servicenet.
A divulgação parcial ou total deste documento será considerada como quebra do contrato de confidencialidade e a empresa responsável será penalizada como estabelecido nas cláusulas do contrato.
Todo material intelectual aqui definido, é de propriedade exclusiva da Servicenet Tecnologia LTDA. A publicação, transmissão, distribuição, reprodução deste documento parcial ou total sem autorização é crime segundo a Lei de número 9.610 de 19 de Fevereiro de 1998.
Esta documentação é referente as informações fornecidas no manual do GCB - (Gerenciador do Correspondente Banco do Brasil) <V.8.6.1> da transação A68.
A transação A68 é uma pré transação de pagamento obrigatória antes da chamada da transação 268 (Recebimento de Títulos de Cobrança).
Abaixo segue as informações de cada posição nos logs disponibilizada no manual do GCB.
Input A68 |
---|
Rótulo | Tipo | Tamanho Máximo | Informações a ser preenchida |
---|---|---|---|
Fixo | N | 3 | 000 |
Tipo | N | 2 | 01 |
00452 | A | 44 | Código de barras (se barra capturada) |
00007 | N | 10 | Código de barra 1+2 (Se barra digitada) |
00008 | N | 11 | Código de barra 3+4 (Se barra digitada) |
00009 | N | 11 | Código de barra 5+6 (Se barra digitada) |
00010 | N | 1 | Código de barra 7 (Se barra digitada) |
00011 | N | 14 | Código de barra 8 (Se barra digitada) |
00115 | N | 3 | 001 |
00185 | N | 3 | 001 |
Finalizador | A | 1 | @ (arroba) |
A transação A68 Retorna os retornos tipo 1, tipo 2 e tipo R. O Coban não terá permissão de alterar os valores, por isso não haverá reconsulta.
Retorno Tipo “R” |
---|
Campo | Tipo | Tamanho Máximo | Preenchimento |
---|---|---|---|
Tipo-registro | A | 01 | “R” |
Tamanho-registro | N | 04 | 0100 |
Área de Dados de Controle | N | 100 | Dados de Controle. Este campo deverá ser rebatido como INPUT na transação 268 (rótulo 00454) |
Retorno Tipo 1 |
---|
Campo | Tipo | Tamanho Máximo | Preenchimento |
---|---|---|---|
Tipo-registro | A | 01 | “1” |
Tamanho-registro | N | 04 | 0090 |
Agência | N | 04 | Agência detentora da conta |
Conta | N | 11 | Número da conta do cliente (s/DV) |
Nome | A | 25 | Nome do Cliente |
Vazio (uso futuro) | A | 50 | Vazio (uso futuro) |
Retorno Tipo 2 |
---|
Campo | Tipo | Tamanho Máximo | Preenchimento |
---|---|---|---|
Tipo-registro | A | 01 | “2” |
Tamanho-registro | N | 04 | 0730 |
Indicador de nova cobrança | N | 01 | 0-Antiga 1-Piloto 2-Nova 3-Nova em Contingência |
Código de Barras Capturado | A | 44 | Código de Barras Capturado (rótulo 00012) |
Código de Barras Digitado | A | 47 | Código de Barras Digitado (rótulos 00007, 00008, 00009, 00010, 00011) |
Valor Nominal | N | 17 | Valor nominal da Cobrança (rótulo 00099) |
Indicador Permissão para Alterar Valor Nominal | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Desconto | N | 17 | Valor Desconto da Cobrança |
Indicador Permissão para Alterar Valor Desconto | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Abatimento | N | 17 | Valor Abatimento da Cobrança |
Indicador Permissão para Alterar Valor Abatimento | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Juros | N | 17 | Valor Juros da Cobrança |
Indicador de Permissão para Alterar Valor Juros | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Multa | N | 17 | Valor Multa da Cobrança |
Indicador Permissão para Alterar Valor Multa | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Total | N | 17 | Valor total da Cobrança (rótulo 00113) |
Indicador de Permissão para Alterar Valor Total Valor | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Desconto + Abatimento | N | 17 | Valor Desconto + Abatimento da Cobrança (rótulo 00095) |
Indicador de Permissão para Alterar Valor Desconto + Abatimento | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Outros Descontos | N | 17 | Valor Outros Descontos da Cobrança (rótulo 00090) |
Indicador de Permissão para Alterar Valor Outros Descontos | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Juros + Multa | N | 17 | Valor Juros + Multa da Cobrança (rótulo 00098) |
Indicador de permissão para Alterar Valor Juros + Multa | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor Outros Acréscimos | N | 17 | Valor Outros Acréscimos da Cobrança (rótulo 00100) |
Indicador de Permissão para Alterar Valor Outros Acréscimos | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Valor de pagamento Mínimo | N | 17 | Valor de pagamento mínimo da Cobrança |
Valor de pagamento Máximo | N | 17 | Valor de pagamento máximo da Cobrança |
Data de Vencimento | N | 08 | Data de Vencimento da Cobrança(DDMMAAAA) (rótulo 00021) |
Data de Pagamento Sugerida | N | 08 | Data de Pagamento sugerida da Cobrança(DDMMAAAA) |
Indicador de Permissão para Alterar data Pagamento | A | 01 | ‘N’-Não permite alteração ‘ ‘S’-Permite Alteração |
Nome do Beneficiário da Cobrança | A | 80 | Nome do Beneficiário da Cobrança |
Nome Fantasia do Beneficiário | A | 50 | Nome Fantasia do Beneficiário da Cobrança |
Nome reduzido do Beneficiário da Cobrança | A | 30 | Nome reduzido do Beneficiário da Cobrança |
Código Tipo Pessoa Beneficiário | N | 01 | 1-Física 2-Juridica |
Número CPF-CNPJ Beneficiário | N | 14 | Número do CPF ou CNPJ |
Código do Banco Emitente | A | 03 | Código do Banco Emitente da Cobrança |
Código ISPB do Banco Emitente | A | 09 | Código ISPB do Banco Emitente da Cobrança |
Nome do Banco Emitente | A | 60 | Nome d Banco emitente da Cobrança |
Indicador de pesquisa obrigatória outra data | A | 01 | N’-Não chama Tr.A68 novamente ‘S’-Chama a Tr.A68 novamente em caso de alteração da data de pagamento |
Indicador de duplicidade | A | 01 | ‘N’-não recebido ‘S’- duplicidade de pagamento |
Indicador de VR Boleto | A | 01 | ‘N’- valor abaixo ‘S’- valor acima necessita dados pagador |
Nome do Pagador da Cobrança | A | 80 | Nome do Pagador da Cobrança |
Código Tipo Pessoa Pagador | N | 01 | 1-Física 2-Juridica |
Número CPF-CNPJ Pagador | N | 14 | Número do CPF ou CNPJ |
Vazio (uso futuro) | A | 62 | Vazio (uso futuro) |
TOTAL | 730 |
Para melhor entendimento mostraremos um exemplo prático.
O trecho abaixo é o payload retornado pelo Banco do Brasil em uma transação A68:
===
[ Data-Hora ] DEBUG [Thread-645927] - XXXXX.XXXXXXXXXX.XXX.XX : 000001_00000002 : enviaDadosPDV - payload R0100A675ACC39E25333241NN0122004293461180220083104 10090278800000032997 207300104977441000001604270447800001030424379172661049704479800001030462437917266177441000001604200000000000016042S00000000000000000S00000000000000000S00000000000000000S00000000000000000S00000000000016042S00000000000000000S00000000000000000S00000000000000000S00000000000000000S00000000000000000999999999999999992002201820022018S 000000000000000104000360305CAIXA ECONOMICA FEDERAL NNN 000000000000000
===
De acordo com as informações de retorno do manual do GCB podemos “quebrar” a resposta da seguinte forma:
R → Tipo-registro (Retorno tipo R)
0100 → Tamanho-registro (Retorno tipo R)
A675ACC39E25333241NN0122004293461180220083104 → Área de Dados de Controle (Retorno tipo R)
1 → Tipo-registro (Retorno tipo 1)
0090 → Tamanho-registro (Retorno tipo 1)
2788 → Agência (Retorno tipo 1)
00000032997 → Conta (Retorno tipo 1)
(Nessa transação não veio do BB os 25 dígitos referente ao nome do cliente)
(Vazio (uso futuro) - 50 dígitos)
2 → Tipo-registro (Retorno tipo 2)
0730 → Tamanho-registro (Retorno tipo 2)
0 → Indicador de nova cobrança
10497744100000160427044780000103042437917266 → CB capturado
10497044798000010304624379172661774410000016042 → CB digitado
00000000000016042 → Valor nominal da cobrança vindo do BB. - S → Permissão de Alterar Valor Nominal
00000000000000000 → Valor do desconto vindo do BB. - S → Permissão de alterar Valor Desconto
00000000000000000 → Valor do abatimento vindo do BB. - S → Permissão de alterar Valor Abatimento
00000000000000000 → Valor do juros vindo do BB. - S → Permissão de alterar Valor Juros
00000000000000000 → Valor da multa vindo do BB. - S → Permissão de alterar Valor Multa
00000000000016042 → Valor total vindo do BB. - S → Permissão de alterar Valor Total
00000000000000000 → Valor do desconto+abatimento vindo do BB. - S → Permissão de alterar Valor Desconto + Abatimento
00000000000000000 → Valor de outros descontos vindo do BB. - S → Permissão de alterar Valor Outros Descontos
00000000000000000 → Valor do juros+multa vindo do BB. - S → Permissão de alterar Valor Juros + Multa
00000000000000000 → Valor de outros acréscimos vindo do BB. - S → Permissão de alteração Valor Outros Acréscimos
00000000000000000 → Valor de pagamento mínimo da Cobrança
99999999999999999 → Valor de pagamento máximo da Cobrança
20022018 → Data de Vencimento
20022018 → Data de Pagamento Sugerida
S → Permissão para alterar data Pagamento
80 Digitos referente ao Nome do Beneficiário da Cobrança (não veio nessa transação)
50 Digitos referente ao Nome Fantasia do Beneficiário (não veio nessa transação)
30 Digitos referente ao Nome reduzido do Beneficiário da Cobrança (não veio nessa transação)
0 → Código Tipo Pessoa Beneficiário
00000000000000 → Número CPF-CNPJ Beneficiário
104 → Código do Banco Emitente
000360305 → Código ISPB do Banco Emitente
CAIXA ECONOMICA FEDERAL → Nome do Banco Emitente
N → Indicador de pesquisa obrigatória outra data
N → Indicador de duplicidade
N → Indicador de VR Boleto
Dígitos Nome do pagador da cobrança (não veio nessa transação)
0 → Código Tipo Pessoa Pagador
00000000000000 → Número CPF-CNPJ Pagador
Em caso de dúvidas ou outras solicitações, basta entrar em contato conosco através de uma de nossas vias de atendimento.