Perguntas Frequentes - Banco Central do Brasil

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