Desenvolvedor CRAvI

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos
Sistemtica de transmisso de arquivos de protestos
Pagina 1
ndice
1. 2. 3. 4. 5. 6. 7.
Checklist..................................................................................................3 Manual do Desenvolvedor.....................................................................4 Envio de Remessa / Cancelamento / Desistncia...............................5 3.1 Exemplo de Cdigo fonte em Visual Basic...............................5 Recebimento de Confirmao / Retorno..............................................7 4.1 Exemplo de Cdigo fonte em Visual Basic...............................7 Anexo I....................................................................................................8 Anexo II...................................................................................................9 Anexo III..................................................................................................9
Pagina 2
Checklist
Lista dos itens necessrios para inicio do desenvolvimento da transmisso / recepo dos arquivos de protesto (Distribuidores / Bancos):
1- Endereo url para envio e recepo dos arquivos utilizando o protocolo HTTPS canal seguro SSL 443.
2- Desenvolvimento de pagina Web, preparada para receber dados via POST
3- Para cada tipo de arquivo o sistema de transferncia dever ser capaz de atender aos horrios a serem definidos entre o CRA - Central de Remessa de Arquivos e a FEBRABAN.
4- XML ser utilizado para transferncia dos dados seguindo o modelo do site da FEBRABAN
Pagina 3
Manual do Desenvolvedor
Documentao dos dados que sero enviados para a Central. Este manual visa explicar o modo de envio de arquivos com base no recurso HTTP Request, utilizando-se do mtodo POST para encaminhamento dos dados. Essa transferncia deve utilizar Internet Segura (SSL), onde todos os dados so transferidos criptografados. Os arquivos devem ser desenvolvidos utilizando o layout FEBRABAN no formato XML. Os sistemas dos bancos iro chamar uma URL do servidor de arquivos da CRA, informando via parmetro, o cdigo de usurio e senha, nome do arquivo, tamanho do arquivo em bytes e contedo do arquivo. Para cada tipo de arquivo o sistema de transferncia dever ser capaz de atender aos horrios a serem definidos entre o CRA - Central de Remessa de Arquivos e a FEBRABAN. Caso exceda os tempos definidos o sistema dever travar automaticamente qualquer tipo de operao, permitindo que ela seja feita somente no dia seguinte.
[c1] Comentrio: Layout est no site da FEBRABAN: http://www.febraban.org.br/Acervo1.asp?id _texto=194&id_pagina=173&palavra=
Documentao dos dados que sero retornados da Central. Os dados retornados (tanto para arquivo de confirmao quanto para arquivo de retorno) seguiro os mesmos mtodos do envio, sendo retornados em string atravs de um arquivo do tipo XML.
Pagina 4
Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos 3 Envio de Remessa / Cancelamento / Desistncia: Atravs de um endereo URL utilizando o mtodo POST que ser disponibilizado para o envio dos arquivos. Esta URL receber os campos conforme as seguintes especificaes:
<html> <head> <title>Central de Remessas de Arquivos </title> </head> <body> <form action=ExemploRecebeArqBancos.asp" method="post" name="frmID" id="frmID"> <input type="hidden" name="user_code" id="user_code" value="" /> <input type="hidden" name="user_pass" id="user_pass" value="" /> <input type="hidden" name="user_arq " id="user_arq" value="" /> <input type="hidden" name="user_dados" id="user_dados" value="" /> <input type="hidden" name="bytes_len " id="bytes_len" value="" /> <input type="hidden" name="user_sign" id="user_sign" value="" />
</form>
</body>
</html>
Devero ser remetidas as seguintes informaes via POST: user_code Usurio fornecido pela CRA. user_pass Senha do usurio fornecida pela CRA. user_arq Nome do Arquivo (Ex.B341DDMM.AAS, DP341DDMM.AAS, CP341DDMM.AAS) user_dados Dados do arquivo XML (LayoutXML). bytes_len Tamanho do Arquivo em bytes (Devido s converses do Post pelo protocolo HTTP/HTTPS este campo s poder ser validado quando o campo user_dados estiver com o seu contedo codificado em Hexadecimal de 2 bytes). user_sign Chave de Assinatura em Base64 do arquivo XML assinado com certificado digital. (Utilizado quando necessrio). 3.1 Exemplo de Cdigo fonte em Visual Basic:
Dim objHTTP As New MSXML2.XMLHTTP60 strBody strBody strBody strBody strBody strBody = = = = = = "user_code=BANCOTESTE&" strBody & "user_pass=MINHASENHA&" strBody & "user_arq=B341DDMM.AAS&" strBody & "user_dados=<?xml version="1.0"?><remessa> &" strBody & "bytes_len=706789&" strBody & "user_sign=0203070E0D4502 "
With objHTTP .open POST, http://www.url.com.br/ExemploRecebeArqBancos.asp .setRequestHeader "Content-type", application/x-www-form-urlencoded .setRequestHeader "Content-length", Len(strBody) .send strBody End With
Pagina 5
Ao serem postadas as informaes, o script retornar um arquivo XML com as seguintes especificaes: Exemplo:
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?> <relatorio> <sistema>Central de Remessas de Arquivos</sistema> <data>01/09/2007</data> <hora>05:43:28</hora> <codigo>00101</codigo> <mensagem>MENSAGEM DO SISTEMA</mensagem> <final>0905</final> </relatorio>
Onde os ns acima representam o seguinte: Sistema Data Hora Cdigo Mensagem Final Nome do Sistema Data de Retorno da Informao Hora de Retorno da Informao Cdigo da ocorrncia Mensagem Cdigo erro ou sucesso (5 posies numricas)
(anexo I)
O elemento <final>00000</final> representa o sucesso no envio da informao. Outros cdigos representam erros que sero descritos no campo Mensagem.
Pagina 6
Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos 4 Recebimento de Confirmao / Retorno:
Atravs de um endereo URL utilizando o mtodo POST que ser disponibilizado para recebimento dos arquivos. Acessando esta URL, o desenvolvedor poder notar que, em cdigo fonte, existem as seguintes especificaes:
<html> <head> <title>Central de Remessas de Arquivos</title> </head> <body> <form action="exemplo" method="post" name="frmID" id="frmID"> <input type="hidden" name="user_code" id="user_code" value="" /> <input type="hidden" name="user_pass" id="user_pass" value="" /> <input type="hidden" name="user_arq" id="user_arq" value="" /> </form> </body> </html>
Devero ser remetidas as seguintes informaes via POST: user_code Usurio fornecido pela CRA. user_pass Senha do usurio fornecida pela CRA. user_arq Nome do Arquivo (Ex. C341DDMM.AAS) 4.1 Exemplo de Cdigo fonte em Visual Basic:
Dim objHTTP As New MSXML2.XMLHTTP60 strBody = "user_code=BANCOTESTE&" strBody = strBody & "user_pass=MINHASENHA&" strBody = strBody & "user_arq=C341DDMM.AAS" With objHTTP .open POST, http://www.url.com.br/reqFileGetConBCO.cfm .setRequestHeader "Content-type", application/x-www-form-urlencoded .setRequestHeader "Content-length", Len(strBody) .send strBody End With
Ao serem postadas as informaes, o script retornar um arquivo XML com as seguintes especificaes: Em caso de sucesso (com os dados convertidos em hexadecimal):
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?> <relatorio> <sistema>Central de Remessas de Arquivos</sistema> <data>01/09/2007</data> <hora>05:43:28</hora> <codigo>00000</codigo> <mensagem>MENSAGEM DO SISTEMA</mensagem> <databinary>0407060A0D45010407060A0D4501(Anexo II) </databinary> </relatorio>
Em caso de erro:
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?> <relatorio>
Pagina 7

<sistema>Central de Remessas de Arquivos</sistema> <data>01/09/2007</data> <hora>05:43:28</hora> <codigo>00101</codigo> <mensagem>MENSAGEM DO SISTEMA</mensagem> <final>99000</final> </relatorio>
Anexo I
Exemplo para mensagens retornadas no sistema de envio de remessas Cdigo Mensagem 00000 ARQUIVO ENVIADO COM SUCESSO 00001 FALTAM CAMPOS PARA A SOLICITAO 00002 NECESSRIA A INFORMAO DO USURIO 00003 NECESSRIA A INFORMAO DA SENHA 00004 NECESSRIA A INFORMAO DO CDIGO DO CLIENTE 00005 A DATA PARECE ESTAR INVLIDA 00006 A SEQUNCIA PARECE ESTAR INVLIDA 00007 USURIO NO LOCALIZADO/BLOQUEADO NO SISTEMA 00008 CLIENTE NO LOCALIZADO NO SISTEMA 00009 ARQUIVO J ENVIADO ANTERIORMENTE 00010 EXISTEM ERROS NO LAYOUT ENVIADO: 10000 A DETERMINAO DE TIPO DE LAYOUT NO PARECE ESTAR VLIDA 91001 IDENTIFICACAO DO REGISTRO 91005 NOME DO PORTADOR 91010 QUANTIDADE DE TITULOS DIVERGENTE-INFORMADO xxxxx /CALCULADO xxxxx 91015 QUANTIDADE DE INDICACOES DIVERGENTE-INFORMADO xxxxx /CALCULADO xxxxx 91020 QUANTIDADE DE ORIGINAIS DIVERGENTE-INFORMADO xxxxx /CALCULADO xxxxx 91030 CONTEDO PERMITIDO: SOMATRIA QT. REMESSA 91040 CONTEDO PERMITIDO: SOMATRIA VLR. REMESSA 91090 COMPLEMENTO DO REGISTRO 99001 CDIGO DO APRESENTANTE INVALIDO xxx 99005 DATA DO MOVIMENTO INVALIDA 99050 SOM. SEGURANA. CAMPOS 09/10/11/12 -INFORMADO xxxxx /CALCULADO xxxxx 99060 SOM. SEGURANCA-VLR.REMESSA-INFORMADA xxxxx,xx /CALCULADO xxxx,xx 99500 ORIGINAIS NO APRESENTADOS 99900 ARQUIVO FORA DE SEQNCIA 99000 HOUVE UM ERRO DURANTE O ENVIO DO ARQUIVO: 99999 PROBLEMAS NO ENVIO DO ARQUIVO
Pagina 8
Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos 6 Anexo II
Os campos marcados para seguir a especificao 2, devero ter os seus dados convertidos para o formato Hexadecimal com duas posies, para no haver problemas de transferncia. Desta forma, a informao MEU TEXTO, iria como 4D455520544558544F. Para retornos de um Hexa, (caractere 13 que representado por D, dever vir como 0D (zero e D), para representar as duas posies. 7 Anexo III
Relao de arquivos enviados: Tipo arquivo Bbbbddmm.aas DPbbbddmm.aas CPbbbddmm.aas Descrio Arquivo de Remessa de ttulos Arquivo de Desistncia Arquivo de Cancelamento
Relao de arquivos Recepcionados: Tipo arquivo Cbbbddmm.aas Rbbbddmm.aas Descrio Arquivo de Confirmao Arquivo de Retorno
Montagem do nome dos arquivos:

Bbbbddmm.aas | | | | | | | | | | | |______ Seqncia do arquivo | | | | |________ Ano do arquivo | | | |_____________ Ms do arquivo | | |________________ Dia do arquivo | |____________________ Cdigo do Apresentante |_______________________ Constante para tipo de arquivo
Pagina 9

Desenvolvedor CRAvI

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Desenvolvedor CRAvI

Uploaded by

Copyright:

Available Formats

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos

Sistemtica de transmisso de arquivos de protestos

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos

2- Desenvolvimento de pagina Web, preparada para receber dados via POST

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos

[c1] Comentrio: Layout est no site da FEBRABAN: http://www.febraban.org.br/Acervo1.asp?id _texto=194&id_pagina=173&palavra=

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos

Exemplo para desenvolvimento da Sistemtica de transmisso de arquivos de protestos 6 Anexo II

Montagem do nome dos arquivos:

You might also like