Arquivo de retorno Valor Pago Boleto Bancário Formato TXT

Transcrição

1 Arquivo de retorno Valor Pago Boleto Bancário Formato TXT

2 Índice Capítulo Introdução... 3 Capítulo Arquivo Retorno Pedidos em Lote... 4 Capítulo Arquivo Retorno Pedido Individual... 6 Anexo Formato do arquivo de resposta... 8 Página 2 de 9

3 Capítulo 1 Introdução Este documento tem como objetivo orientar os desenvolvedores / lojistas a utilizar o arquivo de retorno para compras realizadas com Boleto Bancário Bradesco. Este arquivo retorna os dados relativos às compras, no formato texto plano, caso prefira utilizar outro formato, o Bradesco disponibiliza este mesmo serviço no formato XML. Para obter o arquivo retorno no formato XML, deve consultar o Arquivo de retorno Boleto Valor Pago - XML.pdf. Página 3 de 9

4 Capítulo 2 Arquivo Retorno Pedidos em Lote Nessa modalidade, será devolvido ao cliente um arquivo contendo todos os pedidos de Boletos Gerados e Pagos na loja no período compreendido de 7 dias anteriores a data atual. Ex.: Data atual informada: 25/04/2011 O resultado (Arquivo TXT) desta consulta será todas os Boletos Gerados e Pagos a partir do dia 18 (7 dias antes da data atual informada no parâmetro data ) até o dia 25 (data atual). Para verificar o formato do arquivo, por favor, consulte o Anexo 1 deste documento O arquivo de retorno referente às compras realizadas com Boleto Bancário Bradesco pode ser obtido diretamente através dos seguintes endereços: Ambiente de testes: chantid=xxxxxx&data=dd/mm/aaaa&manager=<administrador_da_loja>&passwd=<password_da_loja >& Ambiente de produção: ntid=xxxxxx&data=dd/mm/aaaa&manager=<administrador_da_loja>&passwd=<password_da_loja>& Os parâmetros obrigatórios são: Merchantid: Número que identifica o estabelecimento no sistema de compras. Data: Data atual que esta sendo realizada a pesquisa. Deve ser enviada, obrigatoriamente, no formato dd/mm/aaaa. Manager: É o mesmo Manager para acesso ao gerenciador de compras do sistema de pagamentos Bradesco. Passwd: Senha de acesso. É a mesma senha de acesso usada em conjunto com o usuário (manager) para acesso ao gerenciador de compras do sistema de pagamentos Bradesco. A chamada da página que vai fornecer os dados de retorno das compras pode ser feita via GET ou POST, e vai devolver como resposta uma lista de compras, como o exemplo a seguir: Página 4 de 9

5 # # #20/04/2011#11:18:21# # #00/00/0000#010#000000# # # #20/04/2011#10:59:07# # #21/04/2011#021#000000# Vale lembrar que ao final de cada linha com os dados de cada compra, são enviados os caracteres de controle chr(13) & chr(10) para quebra de linha Para esta consulta (Arquivo Retorno TXT Boleto Bancário Bradesco Pedidos em Lote) todas as compras listadas estarão com o seguinte status: Status...Descrição *Boleto Bancário sem Retorno de Geração 10...Boleto Gerado (Boleto Bancário sem retorno para a loja) 11...Boleto Pago Manual (Boleto Bancário sem retorno para a loja) 12...Boleto Cancelado (Boleto Bancário sem retorno para a loja) 21...Boleto Pago Igual (Boleto Bancário sem retorno para a loja) 22...Boleto Pago Menor (Boleto Bancário sem retorno para a loja) 23...Boleto Pago Maior (Boleto Bancário sem retorno para a loja) *Boleto Bancário com Retorno de Geração 13...Boleto Gerado (não informado a geração) 14...Boleto Gerado (informado a geração) 15...Boleto Pago 21...Boleto Pago Igual (Boleto Bancário com retorno para a loja) 22...Boleto Pago Menor (Boleto Bancário com retorno para a loja) 23...Boleto Pago Maior (Boleto Bancário com retorno para a loja) Página 5 de 9

6 Capítulo 3 Arquivo Retorno Pedido Individual Nessa modalidade, será devolvido ao cliente uma única linha contendo as informações de um pedido específico utilizando a opção Boleto Bancário Bradesco. Ex.: Data atual informada: 25/04/2011. O número de pedido solicitado será consultado, caso o pedido se encontre na base de Dados o arquivo TXT será retornado. O período disponível na Base para consulta são os 6 últimos meses. Para verificar o formato do arquivo, por favor, consulte o Anexo 1 desse documento. O arquivo de retorno referente às compras realizadas com Boleto Bancário Bradesco pode ser obtido diretamente através dos seguintes endereços: Ambiente de testes: erchantid=xxxxxx&data=dd/mm/aaaa&manager=<administrador_da_loja>&passwd=<password_da_l oja>&numorder=xxxxxxxxxxxxxxxxx Ambiente de produção: antid=xxxxxx&data=dd/mm/aaaa&manager=<administrador_da_loja>&passwd=<password_da_loja> &NumOrder=XXXXXXXXXXXXXXXXXXX Os parâmetros obrigatórios são: Merchantid: Número que identifica o estabelecimento no sistema de compras. Data: Data atual que esta sendo realizada a pesquisa. Deve ser enviada, obrigatoriamente, no formato dd/mm/aaaa. Manager: É o mesmo Manager para acesso ao gerenciador de compras do sistema de pagamentos Bradesco. Passwd: Senha de acesso. É a mesma senha de acesso usada em conjunto com o usuário (manager) para acesso ao gerenciador de compras do sistema de pagamentos Bradesco. NumOrder: Número do pedido que se deseja pesquisar. A chamada da página que vai fornecer os dados de retorno das compras pode ser feita via GET ou POST, e vai devolver como resposta uma lista de compras, como o exemplo a seguir: Página 6 de 9

7 Vale lembrar que ao final de cada linha com os dados de cada compra, são enviados os caracteres de controle chr(13) & chr(10) para quebra de linha # # #20/04/2011#10:59:07# # #21/01/2011#021#000000# Para esta consulta (Arquivo Retorno TXT Boleto Bancário Bradesco Pedido Individual) todas as compras listadas estarão com o seguinte status: Status...Descrição Boleto não Gerado Erro<>0 Indica o erro Status...Descrição *Boleto Bancário sem Retorno de Geração 10...Boleto Gerado (Boleto Bancário sem retorno para a loja) 11...Boleto Pago Manual (Boleto Bancário sem retorno para a loja) 12...Boleto Cancelado (Boleto Bancário sem retorno para a loja) 21...Boleto Pago Igual (Boleto Bancário sem retorno para a loja) 22...Boleto Pago Menor (Boleto Bancário sem retorno para a loja) 23...Boleto Pago Maior (Boleto Bancário sem retorno para a loja) *Boleto Bancário com Retorno de Geração 13...Boleto Gerado (não informado a geração) 14...Boleto Gerado (informado a geração) 15...Boleto Pago 21...Boleto Pago Igual (Boleto Bancário com retorno para a loja) 22...Boleto Pago Menor (Boleto Bancário com retorno para a loja) 23...Boleto Pago Maior (Boleto Bancário com retorno para a loja) Página 7 de 9

8 Anexo 1 Formato do arquivo de resposta Todas as compras serão devolvidas segundo o layout abaixo: #XXXXXXXXXXXXXXXXXXXXXXXXXXX# #dd/mm/aaaa#hh:mm:ss# #dd/mm/aaaa# #999#999999# Veja na tabela abaixo a posição e a descrição de cada campo. Posição Campo Descrição 1 # Fixo Separador dos campos Fixo 2 -> 28 Número do pedido 27 posições formatadas com espaços à esquerda contendo o número do pedido. 29 # Fixo Separador de campos Fixo 30 -> 39 Valor da Compra 10 dígitos contendo o valor total da compra expresso em centavos. 40 # Fixo Separador de campos Fixo 41 -> 50 Data da compra Data da compra no formato dd/mm/aaaa 51 # Fixo Separador de campos Fixo 52 -> 59 Hora da compra Hora da compra no formato hh:mm:ss 60 # Fixo Separador de campos Fixo 61 -> 107 Linha Digitável Linha Digitável 108 # Fixo Separador de campos Fixo 109 -> 118 Valor pago Valor pago gerado pelo CNAB 119 # Fixo Separador de campos Fixo 120 -> 129 Data do pagamento Data do credito em conta 130 # Fixo Separador de campos Fixo 131 -> 133 Status da compra Status da compra Consulte tabela em anexo 134 # Fixo Separador de campos Fixo 135 -> 140 Detalhe do erro Detalhe do erro no processo de compra Consulte tabela disponível para download. Página 8 de 9

9 141 # Fixo Separador de campos Fixo É importante lembrar que se o arquivo solicitado for um lote de compras, no final de cada linha será enviado uma quebra de linha chr(13) & chr(10). Página 9 de 9