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.
É o arquivo de log do GCB onde será encontrado as transações com os respectivos retornos do Banco. É importante observar que o trace segue alguns padrões predefinido pelo Banco.
Neste manual, passaremos as principais informações para que seja feito a verificação de uma transação no traceGcb.
Conforme dito anteriormente o trace segue um certo padrão predefinido e é importante conhecermos, exemplo, para pagamento de contas, antes de realizar um pagamento de uma conta é realizado automaticamente uma consulta da conta.
[ 23/08/2016-11:17:56 ] DEBUG [Thread-5548502] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : lePayLoadPDV - payload = 0000100012004508266000000035010006180008905622017406963121500022000110011300043501@ → THREAD DE CONTROLE
[ 23/08/2016-11:17:56 ] DEBUG [Thread-5548507] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : transmitirTrnBB - MEP = BBCRIPTO000000000000000000000000000000000000000000000000000000000000015358287067212 31 0022J9613416000106721200830001001004F00001000120045082660000000350100061800089056220174069631215000220001100113000435010004400010@ → THREAD DA CONSULTA DA CONTA
[ 23/08/2016-11:17:56 ] DEBUG [Thread-5548502] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : lePayLoadPDV - payload = 0000100012004508266000000035010006180008905622017406963121500022000110011300043501@ → THREAD DE CONTROLE
[ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : transmitirTrnBB - MEP = BBCRIPTO000000000000000000000000000000000000000000000000000000000000015358287067212 31 0031J9613419000106721200830001001004F00001000120045082660000000350100061800089056220174069631215000220001100113000435010004400011@ → THREAD DE PAGAMENTO
Observe que a Thread de controle se repete.
Dito isso, segue a lista de alguns comandos que irão auxiliar na hora de verificar uma determinada transação.
Obs: Lembramos que utilizamos linux.
Comandos: cat (exibe conteúdo de um arquivo), tail (exibe últimas linhas de um arquivo), head (exibe primeiras linhas de um arquivo), grep (realiza buscas em um arquivo).
Favor realizar uma pesquisa sobre cada comando.
Exemplo prático:
Pagamento de convênios: Para localizar um recebimento de convênio o ideal é que tenha em mãos o código de barra da conta em questão para facilitar a localização.
Linha Digitável: 83840000000-6 41310038007-4 00202563320-8 00667869603-8
Código de Barra: 83840000000 41310038007 00202563320 00667869603 → Sem dígito verificador
Valor: 41,31
Para 4 blocos, basta utilizar o comando grep para realizar a busca com o código de barra.
# grep -a 83840000000413100380070020256332000667869603 traceGcb.trc
Após realizar essa busca, será exibido como no primeiro exemplo.
Thread de controle
Thread de consulta
Thread de controle
Thread de pagamento
Normalmente ocorre dessa forma, porém há casos que fogem ao padrão. Basta verificar cada Thread até localizar a de pagamento.
# grep -a Thread-xxxxx traceGcb.trc
Vale lembrar que a transação completa começa pela thread de controle onde localizamos o header e o payload da transação essa a thread de controle é a imediatamente acima do inicio da transação
Segue abaixo um exemplo completo de uma transação para melhor visualização.
Thread de controle – Thread-5548502
Thread de pagamento - Thread-5548508
==
[ 23/08/2016-11:17:56 ] DEBUG [Thread-5548502] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : leHeaderPDV - header = 00006721228700000010672120083000000010000000000000000300000000000000005358001P000000300000000000003501000000083 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548502] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : lePayLoadPDV - payload = 0000100012004508266000000035010006180008905622017406963121500022000110011300043501@ [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548502] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : prenderPDV - PDV - 000067212000001067212008300000001 preso para a transacao 5358 - P [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548502] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : recebeDadosPDV - esperando dados no canal socket de ec2-54-207-18-7.sa-east-1.compute.amazonaws.com :
==
[ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : Inicio da Transacao - 5358 P [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : TransacaoPgtoGRI - inicio [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : getPendencia - nao obteve pendencia CLP - 000067212000001067212008300000001 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : setRegistroChave - inicio [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : getChave - vai verificar se a chave = J9613419 senha = esta livre [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : getChaveLivre - retornara a chave = J9613419 senha = esta livre [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : getChave - pegou a chave =J9613419 (8) senha = (8) convenio = 000067212 (9) [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : setRegistroChave - chave com logon pronto [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : getRegistroAgenciaChave - AC = 2870J96134190672120083 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : setRegistroAgenciaChave - retornando registroAgenciaChave RAC = 2870 p/ a chave = J9613419 senha = sessaoGT = A33R230336000674 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : incluirPendencia - CLP = 000067212000001067212008300000001 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : geraPendencia - Pendencia Gerada CLP - 000067212000001067212008300000001 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : transmitirTrnBB - MEH = 7171A33R230336000674000J9613419505000000217 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : transmitirTrnBB - MEP = BBCRIPTO000000000000000000000000000000000000000000000000000000000000015358287067212 31 0031J9613419000106721200830001001004F00001000120045082660000000350100061800089056220174069631215000220001100113000435010004400011@ [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : transmitirTrnBB - MEC = J9613419 senha = sessaoGT = A33R230336000674 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.obterResposta: Validando par?metros… [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.enviar: Enviando headerCliente… [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.enviar: total de bytes a enviar:228 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.enviar - execucao do finaly [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.receber: Lendo o header Cliente da resposta… [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.receber: O valor do header Cliente eh: 7171A33R230336000674000J9613419505000000884 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.receber: O tamanho da resposta eh:884 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.receber-Socket: executando o finaly do receber [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : ComunicacaoServcom.obterResposta: Comunica??o finalizada. [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : transmitirTrnBB - MRH = 7171A33R230336000674000J9613419505000000877 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : transmitirTrnBB - MRP = BBCRIPTO1358 287067212 31 00520052017F1012500000000000064372CAERN CIA AGUAS ESG RN 012016082320160823111756000000000000035015C884AFC82FE42B5288920810 F060823/08/2016 BANCO DO BRASIL 11:17:56287021283 CORRESPONDENTE BANCARIO 0052 COMPROVANTE PAGAMENTOS COM COD.BARRA ======================================CONVENIO: CAERN CIA AGUAS ESG RN ————————————– 82660000000 35010006180 00890562201 74069631215 NR. DOCUMENTO 830.001NR. CONVENIO 64.372-6DATA DO PAGAMENTO 23/08/2016VLR DO PAGAMENTO 35,01======================================NR.AUTENTICACAO 5.C88.4AF.C82.FE4.2B5 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : desformatarRegistros - mensagem 1358 287067212 31 00520052017F1012500000000000064372CAERN CIA AGUAS ESG RN 012016082320160823111756000000000000035015C884AFC82FE42B5288920810 F060823/08/2016 BANCO DO BRASIL 11:17:56287021283 CORRESPONDENTE BANCARIO 0052 COMPROVANTE PAGAMENTOS COM COD.BARRA ======================================CONVENIO: CAERN CIA AGUAS ESG RN ————————————– 82660000000 35010006180 00890562201 74069631215 NR. DOCUMENTO 830.001NR. CONVENIO 64.372-6DATA DO PAGAMENTO 23/08/2016VLR DO PAGAMENTO 35,01======================================NR.AUTENTICACAO 5.C88.4AF.C82.FE4.2B5 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : desformatarRegistros - Quantidade de sub-registros:017 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : desformatarRegistros - Continuacao:F [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : COBAN:67212 LOJA:0083 PDV:00000134 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : alterarPendenciaMemoria - CLP = 000067212000001067212008300000001 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : gravaLog - Gravei no log [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : enviaDadosPDV - header 000067212287000000106721200830000000100000000000000003J9613419003100525358001P000000400000000000003501000000781 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : enviaDadosPDV - payload 1012500000000000064372CAERN CIA AGUAS ESG RN 012016082320160823111756000000000000035015C884AFC82FE42B5288920810 F0646 COBAN:67212 LOJA:0083 PDV:000001 23/08/2016 BANCO DO BRASIL 11:17:56287021283 CORRESPONDENTE BANCARIO 0052 COMPROVANTE PAGAMENTOS COM COD.BARRA ======================================CONVENIO: CAERN CIA AGUAS ESG RN ————————————– 82660000000 35010006180 00890562201 74069631215 NR. DOCUMENTO 830.001NR. CONVENIO 64.372-6DATA DO PAGAMENTO 23/08/2016VLR DO PAGAMENTO 35,01======================================NR.AUTENTICACAO 5.C88.4AF.C82.FE4.2B5 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : liberarUsoChave - J9613419 senha = sessaoGT = A33R230336000674 [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : liberarPDV - PDV - 000067212000001067212008300000001 liberado [ 23/08/2016-11:17:56 ] DEBUG [Thread-5548508] - ec2-54-207-18-7.sa-east-1.compute.amazonaws.com : 000001_00000001 : Fim da Transacao - 5358 P
Para recebimento de títulos ocorre da mesma forma, para extrair o código de barras a partir da linha digitável utilizamos a seguinte página: http://boletobancario-codigodebarras.blogspot.com.br/ com o código de barras em mãos o procedimento é o mesmo.
Para localizar transações como saque/saldos em conta corrente, poupança, benefício. É interessante que tenha em mãos o horário aproximado em que a transação foi realizada pois a pesquisa é feita a partir do número do PDV do terminal em que a transação foi realizada combinado com o tipo de operação.
# grep -a 00001322 traceGcb.trc | grep -a “5296 P”
Código das Operações
5A68 - Transação Pré Pagamento de Título
5268 - Recebimento de Títulos
5358 - Recebimento de Convênios
5949 - Seguro de Acidentes Pessoais
5284 - Pagamento Benefício com Cartão
5020 - Saldo Benefício com Cartão
5801 - Consulta Opções do Cartão
5216 - Saque CC com Cartão
5006 - Saldo CC com Cartão
5009 - Extrato CC com Cartão
5208 - Depósito CC/PP
5296 - Saque PP com Cartão
5047 - Saldo PP com Cartão
5833 - Extrato PP com Cartão
5259 - Recarga celular pré-pago
5A01 - Consulta de Alívio
5A02 - Consulta de Transação
5315 - Cancelamento de Transação
5357 - Recebimento de GRU
9900 - Operação de controle
Também pode ser feito a busca a partir de um erro específico, por exemplo, “ERRO NA 301”, baseado no horário em que foi realizado a transação utilizando o comando grep para realizar a busca.
# grep -a “CHAVE/AGENCIA” traceGcb.trc
Em caso de dúvidas ou dificuldades estamos a disposição para auxiliar no que for preciso.
Em caso de dúvidas ou outras solicitações, basta entrar em contato conosco através de uma de nossas vias de atendimento.