Arquivo de retorno Pagamento Eletrônico B2B Formato TXT

Transcrição

1 Arquivo de retorno Pagamento Eletrônico B2B 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 8

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 Pagamento Eletrônico B2B. 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 Pagamento Eletrônico B2B XML.pdf. Página 3 de 8

4 Capítulo 2 Arquivo Retorno Pedidos em Lote Nessa modalidade, será devolvido ao cliente um arquivo contendo todos os pedidos de Pagamento Eletrônico B2B da 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 pedidos com Pagamento Eletrônico B2B 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 Pagamento Eletrônico B2B pode ser obtido diretamente através dos seguintes endereços: Ambiente de Produção: =XXXX&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 8

5 # # #21/04/2011#16:22:01# #091#000000# # # #21/04/2011#09:57:47# #091#000000# # # #20/04/2011#09:57:58# #091#000000# # # #19/04/2011#09:58:03# #091#000000# # # #18/04/2011#15:44:17# #090#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 Pagamento Eletrônico B2B Pedidos em Lote) todas as compras listadas estarão com o seguinte status: Status...Descrição 90...SPS-Empresas Pendente - Pagamento Pendente SPS-Empresas Aprovado - Pedido finalizado com sucesso. Página 5 de 8

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 Pagamento Eletrônico B2B. 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 Pagamento Eletrônico B2B pode ser obtido diretamente através dos seguintes endereços: Ambiente de produção: d=xxxxxx&data=dd/mm/aaaa&manager=<administrador_da_loja>&passwd=<password_da_loja>&nu morder=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 8

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 # # #19/01/2011#16:22:01# #091#000000# Para esta consulta (Arquivo Retorno TXT Pagamento Eletrônico B2B Pedido Individual) todas as compras listadas estarão com o seguinte status: Status...Descrição 90...SPS-Empresas Pendente - Pagamento Pendente SPS-Empresas Aprovado - Pedido finalizado com sucesso SPS-Empresas Falha Pedido com Falha SPS-Empresas Cancelado Pedido Cancelado. Página 7 de 8

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# #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 -> 111 Status da compra Status da compra Consulte tabela em anexo 112 # Fixo Separador de campos Fixo 113 -> 118 Detalhe do erro Detalhe do erro no processo de compra Consulte tabela disponível para download. 119 # 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 8 de 8