Sistema de Transferência de Arquivos
Perguntas Frequentes Versão 1.0.1 novembro/2012
Perguntas Frequentes do STA
Versão 1.0.1
Sumário 1
Acesso ................................................................................................................................... 3 1.1 Quais os requisitos necessários para eu participar da homologação do novo Sistema de Transferência de Arquivos? .................................................................................................. 3 1.2 Tenho usuário válido no Sisbacen, habilitado no PSTA300, mas não consigo enviar o arquivo. O que está acontecendo? ............................................................................................ 4 1.3
2
O novo sistema contempla alguma funcionalidade de troca de senha?....................... 4
Arquivos ................................................................................................................................. 4 2.1 O arquivo trafegado será enviado compactado como é feito atualmente ou o XML da mensagem será enviado em aberto? ........................................................................................ 4 2.2
Qual algoritmo de compactação devo usar? ................................................................. 4
2.3
O hash calculado é baseado no conteúdo antes ou depois da compactação? ............ 5
2.4 Existe algum limite de tamanho de arquivo a partir do qual o envio deve ser obrigatoriamente particionado? ................................................................................................. 5 2.5
Posso enviar arquivo pelo PSTA e baixar a resposta pelo STA? ................................. 5
2.6
Como posso optar por receber arquivos pelo STA? ..................................................... 5
2.7 Como posso homologar um tipo de arquivo que não está integrado no ambiente de homologação? ........................................................................................................................... 6 3
Web Services ........................................................................................................................ 6 3.1
Como devo fazer o login dos Web Services? ............................................................... 6
3.2 Meu usuário foi cadastrado no serviço SMES001, porém o sistema continua não reconhecendo esse cadastro. O que devo fazer? ..................................................................... 6 3.3 Estou recebendo a mensagem parâmetro inválido quando faço uma consulta e utilizo os campos "dataHoraInicio" e "dataHoraFim". O que está acontecendo? ................................ 6 Quais são os “Content-Type” suportados pelos Web Services do STA? ..................... 7
3.4 4
Diversos ................................................................................................................................. 7 4.1
A homologação do novo sistema será cobrada? .......................................................... 7
4.2
Onde encontro o manual do sistema? .......................................................................... 7
4.3
O que é um web service? .............................................................................................. 7
2
Banco Central do Brasil, 2013
Perguntas Frequentes do STA
Versão 1.0.1
Perguntas frequentes sobre o STA 1 Acesso 1.1 Quais os requisitos necessários para eu participar da homologação do novo Sistema de Transferência de Arquivos? R: Para participar da homologação do novo STA, observamos que é necessário ter usuário cadastrado no Sisbacen de homologação e credenciado na transação PSTA300 no mesmo ambiente. Tal credenciamento deve ser feito pelo máster Sisbacen de cada instituição. Caso não haja nenhum máster habilitado nesse ambiente, a reabilitação de senha deve ser solicitada ao Deinf/Diate por meio da aplicação BC Correio (https://www3.bcb.gov.br/bccorreio). O remetente, que deve necessariamente ser máster no ambiente de produção, deve informar o email para o qual será enviada a nova senha. Após a verificação de que o solicitante é realmente máster Sisbacen no ambiente de produção, sua senha do ambiente de homologação será alterada e enviada para o email indicado no correio eletrônico. O máster da instituição deve então disponibilizar a transação PSTA300 a usuários, via PTRA700 no ambiente transacional do Sisbacen ou Autranweb, ambos de homologação. Os endereços do Autran Web são https://www3.bcb.gov.br/autranweb (produção) e https://www9.bcb.gov.br/autranweb (homologação). Para acessar o Sisbacen de homologação, acesse a tela principal do Sisbacen e digite “HOMOLOGA” no campo “TRANSACAO” e tecle “Entra”. Após isso, a navegação é idêntica ao Sisbacen de produção.
3
Banco Central do Brasil, 2013
Perguntas Frequentes do STA
Versão 1.0.1
1.2 Tenho usuário válido no Sisbacen, habilitado no PSTA300, mas não consigo enviar o arquivo. O que está acontecendo? R: O envio/recebimento de alguns tipos de arquivo do STA estão associados a uma autorização específica. Por exemplo, o tipo de arquivo “AMES101 (6101)” está associado ao serviço “SMES001”. Os usuários Sisbacen utilizados no envio/recepção desse tipo de arquivo pelo STA de devem estar credenciados nesse serviço no Sisbacen. Para saber se o envio/recebimento de um tipo de arquivo está associado a algum serviço, acesse o STA Web, opção “Consulta -> Tipo de arquivo”. Ali, serão listados todos os tipos de arquivo válidos no STA e será informado o serviço associado na coluna “Serviço”.
1.3 O novo sistema contempla alguma funcionalidade de troca de senha? R: Informamos que a funcionalidade de troca de senhas já se encontra disponível nos seguintes endereços: Homologação: https://www9.bcb.gov.br/senha Produção: https://www3.bcb.gov.br/senha
2 Arquivos 2.1 O arquivo trafegado será enviado compactado como é feito atualmente ou o XML da mensagem será enviado em aberto? R: Os arquivos trafegados no novo sistema deverão estar compactados. Os testes não serão tarifados, mas é bom lembrar que, no ambiente de produção, as instituições são tarifadas por Byte trafegado. Sendo assim, o envio de arquivo descompactado acarretará aumento no valor da tarifação. .
2.2 Qual algoritmo de compactação devo usar? R: O STA aceita o arquivos compactados nos formatos:
ZIP: 1. O nome do arquivo deve terminar com “.zip”; 2. O STA aceita tanto arquivos no formato zip convencional (que permite comprimir arquivos de até 4 GB) quanto no formato Zip64 (que permite compactar arquivos de mais de 4 GB). Nos 2 casos, a terminação do arquivo deve ser “.zip” (e não .zip64); e 3. O método de compressão usado deve ser o Deflate convencional, e não o método Deflate64. GZIP: 1. O nome do arquivo deve terminar com “.gz”; 2. O método de compressão deve ser Deflate.
4
Banco Central do Brasil, 2013
Perguntas Frequentes do STA
Versão 1.0.1
2.3 O hash calculado é baseado no conteúdo antes ou depois da compactação? R: O hash deve ser calculado sobre o arquivo realmente transmitido. Se o arquivo estiver compactado, deve ser calculado após a compactação.
2.4 Existe algum limite de tamanho de arquivo a partir do qual o envio deve ser obrigatoriamente particionado? R: Não, entretanto recomendamos que arquivos grandes (acima de 400 MB) sejam enviados em múltiplas conexões para tornar mais célere o envio. Lembramos que o novo sistema disponibiliza a funcionalidade de retomada de transmissão (resume).
2.5 Posso enviar arquivo pelo PSTA e baixar a resposta pelo STA? R: PSTA e STA são sistemas distintos. Não é possível enviar arquivo pelo PSTA e receber resposta pelo STA e vice-versa. A disponibilização de respostas a arquivos enviados por instituições respeita as seguintes regras: 1. Se o arquivo foi enviado ao Bacen pelo PSTAW10/PSTAC10, o arquivo resposta, quando houver, será disponibilizado pelo PSTAW10/PSTAC10; e 2. Se o arquivo foi enviado ao Bacen pelo STA, o arquivo resposta, quando houver, será disponibilizado pelo STA. Quando o Banco Central for disponibilizar um arquivo que não é uma resposta a outro arquivo, o mesmo será disponibilizado no PSTAW10/PSTAC10, a não ser que a instituição tenha optado pela recepção daquele tipo de arquivo pelo STA. Nesse caso o arquivo será disponibilizado no STA (veja o tópico 2.6).
2.6 Como posso optar por receber arquivos pelo STA? R: É possível optar por receber arquivos pelo STA. Para isso é necessário acessar o menu “Cadastro -> Opção por recebimento de arquivos pelo STA” do STA Web e informar a data e hora a partir da qual a instituição opta por receber arquivos originados no Bacen por meio do STA e não mais pelo PSTAW10/PSTAC10. Qualquer usuário cadastrado na transação PSTA300 poderá consultar as opções de sua instituição, porém, apenas usuários cadastrados no serviço SSTA0030 poderão alterar o cadastro. Outro ponto a destacar é que a opção pelo recebimento do AMES102 deverá ser feita por sistema. Por exemplo, AMES102 (CAM). Nesse caso, apenas os arquivos AMES102 do sistema Câmbio serão disponibilizadas no STA. Arquivos AMES102 de outros sistemas (CCR, CCS e COR) continuarão a ser disponibilizados pelo PSTAW10/PSTAC10. 5
Banco Central do Brasil, 2013
Perguntas Frequentes do STA
Versão 1.0.1
2.7 Como posso homologar um tipo de arquivo que não está integrado no ambiente de homologação? R: Apenas alguns tipos de arquivo farão parte da homologação integrada do STA com aplicações de negócio do Banco Central. Todos os outros tipos ficarão no estado final de “Arquivo recebido no Bacen” ou “Arquivo inconsistente”. O envio de um tipo de arquivo ARQTEST (TEST) acarreta a disponibilização do mesmo arquivo para download, com outro número de protocolo. A única diferença é que, caso o arquivo enviado não esteja compactado, ele será compactado antes da disponibilização. Caso se queira validar o retorno de um tipo de arquivo que não faz parte da homologação integrada, envie um ARQTEST com o conteúdo igual ao arquivo resposta que normalmente é recebido por vocês. Dessa forma, você poderá fazer a homologação do ciclo completo do envio de arquivos.
3 Web Services 3.1 Como devo fazer o login dos Web Services? R: Certifique-se que o login usado na requisição está no formato UUUUUDDDD.operador, onde: UUUUU – Código Sisbacen da sua instituição DDDD – Código Sisbacen da sua dependência operador – Seu nome de usuário
3.2 Meu usuário foi cadastrado no serviço SMES001, porém o sistema continua não reconhecendo esse cadastro. O que devo fazer? R: É necessário que seja feito logout e um novo login no sistema após alguns minutos depois do cadastramento.
3.3 Estou recebendo a mensagem parâmetro inválido quando faço uma consulta e utilizo os campos "dataHoraInicio" e "dataHoraFim". O que está acontecendo? R: O formato da data-hora enviada não está correto. Esses parâmetros devem estar no formato: "yyyy-MM-ddTHH:mm:ss". Exemplo: "2012-01-01T10:24:00".
6
Banco Central do Brasil, 2013
Perguntas Frequentes do STA
Versão 1.0.1
3.4 Quais são os “Content-Type” suportados pelos Web Services do STA? R: As requisições a Web Services do STA não precisam especificar o header “ContentType”. Caso especificados, precisam ser: Consulta a transferências de arquivos - “application/x-www-form-urlencoded” Requisição de protocolo - “application/xml” Upload - “application/octet-stream” Alteração de situação de arquivo - “application/xml” Consulta a posição de Upload - “application/x-www-form-urlencoded” Download - “application/x-www-form-urlencoded”
1. 2. 3. 4. 5. 6.
4 Diversos 4.1 A homologação do novo sistema será cobrada? R: Os testes em ambiente de homologação (sta-h.bcb.gov.br) não serão cobrados. Já o uso do sistema em produção, quando disponível, seguirá as mesmas regras de cobrança que valem para os aplicativos PSTAW10/PSTAC10.
4.2 Onde encontro o manual do sistema? R: O manual e apresentações do sistema podem ser encontrados no endereço http://www.bcb.gov.br/?TRANSFARQ .
4.3 O que é um web service? R: Web Service é uma solução utilizada na integração de sistemas e na comunicação entre aplicações diferentes. Os Web Services do STA devem ser utilizados para automatização de sistemas.
7
Banco Central do Brasil, 2013
