Nota Técnica sobre o Download Múltiplo de Informações sobre Companhias
1. Objetivos
Disponibilizar uma lista de links que possibilitam baixar arquivos que armazenam as informações (IPE, ITR, DFP, IAN, FCA, FRE e SEC) entregues por companhias, ao longo de um período de tempo não superior a 24 horas, disponíveis no site da CVM.
2. Informações
Usar produtivamente o download múltiplo requer emprego de conhecimentos específicos de tecnologia de informação no desenvolvimento de um programa de computador que interage com essa funcionalidade.
O acionamento da funcionalidade é feito por meio de uma única página.
O endereço da página é https://seguro.bmfbovespa.com.br/rad/download/SolicitaDownload.asp.
Login e senha controlam o acesso à funcionalidade da página.
A passagem de parâmetros deve utilizar o método POST.
A resposta do download múltiplo sistema é nenhuma URL, uma URL ou mais de uma URL. Cada URL viabiliza o download de um arquivo que armazena uma informação de companhia:
- um documento IPE.
- um formulário do ENET.
- um formulário preenchido por meio do sistema ITR/DFP/IAN (CVMWIN) e entregue por meio do sistema RAD.
O formato da resposta é XML.
O leiaute do arquivo obtido por meio de download múltiplo está disponível em:
- https://www.rad.cvm.gov.br/ENET/documentos/EspecificacaoArquivoXML_DemonstracaoFinanceiraPadronizada.xlsx, no caso de arquivo que armazena formulário gerado pelo DFP Online;
- https://www.rad.cvm.gov.br/ENET/documentos/EspecificacaoArquivoXML_FormularioCadastral.xlsx, no caso de arquivo que armazena formulário gerado pelo FCA Online;
- https://www.rad.cvm.gov.br/ENET/documentos/EspecificacaoArquivoXML_InformacoesTrimestrais.xlsx, no caso de arquivo que armazena formulário gerado pelo ITR Online;
- https://www.rad.cvm.gov.br/ENET/documentos/EspecificacaoArquivoXML_FormularioReferencia.xlsx no caso de arquivo que armazena formulário gerado pelo FRE Online;
- http://sistemas.cvm.gov.br/port/ciasabertas/Layout_Compactado.zip, no caso de arquivo que armazena formulário gerado pelo CVMWIN e entregue por meio do RAD.
- http://sistemas.cvm.gov.br/port/ciasabertas/Leiaute_de_Formularios_do_EmpresasNET.asp, no caso de arquivo que armazena formulário do ENET.
3. Parâmetros a serem informados via POST para a página
3.1. txtLogin = Login do usuário fornecido pela CVM
3.2. txtSenha = Senha do usuário fornecida pela CVM
3.3. txtData = data para a pesquisa de arquivos (dd/mm/aaaa)
3.4. txtHora = hora inicial para a pesquisa de arquivos (99:99)
3.5. txtDocumento = tipo de documento a ser pesquisado:
- TODOS => Documentos e formulários recebidos pela CVM <1>
- RAD => Os formulários ITR, DFP e IAN recebidos pela CVM <2>
- ITR => Somente Informações Trimestrais recebidas pela CVM <3>
- DFP => Somente Demonstrativos Financeiros recebidos pela CVM <4>
- IAN => Somente Informações Anuais recebidas pela CVM <5>
- IPE => Somente Informações Periódicas recebidas pela CVM <6
- ENET => Formulários do Empresas.Net recebidos pela CVM <7>
<1> Formulários e documentos (ITR, DFP, IAN, FCA, FRE e IPE)
<2> Formulários gerados pelo CVMWIN e armazenados no RAD (ITR, DFP e IAN)
<3> ITRs gerados pelo CVMWIN e armazenados no RAD ou ITRs gerados pelo Empresas.Net e armazenados no Empresas.Net
<4> DFPs geradas pelo CVMWIN e armazenadas no RAD ou DFPs geradas pelo Empresas.Net e armazenadas no Empresas.Net
<5> IANs geradas pelo CVMWIN e armazenadas no RAD
<6> Documentos do IPE
<7> Formulários gerados e armazenados no Empresas.Net (FCA, FRE, ITR, DFP e SEC)
3.6. txtAssuntoIPE = Exibição dos assuntos dos documentos IPE
- SIM => Exibe os assuntos
- NÃO => Não exibe os assuntos
O parâmetro txtAssuntoIPE é opcional. Se não for informado, os assuntos dos documentos IPE não serão exibidos.
4. Resposta - XML
4.1. Para consultas válidas:
<!--?xml version="1.0" encoding="ISO-8859-1" ?-->
<DownloadMultiplo DataSolicitada="dd/mm/aaaa hh:mm" TipoDocumento="XX...X" DataConsulta="dd/mm/aaaa hh:mm">
<Link url="XX...X " Documento="XXX" ccvm="99999" DataRef="99/99/9999 99:99:99" FrmDtRef="XX/XX/XXXX XX:XX" Categoria="XX...X" Tipo="XX...X" Especie="XX...X" Situacao="XX...X" />
<!-- 1 a N Links -->
</DownloadMultiplo>
Onde "url" é o link de acesso ao documento;
Onde "Documento" é o tipo de documento (ITR, DFP, IAN ou IPE) a que se refere o link;
Onde "ccvm" é o código CVM da empresa a que se refere o link;
Onde "DataRef" é a data de referencia do documento a que se refere o link;
Onde "FrmDtRef" é o formato que a data de referencia deverá ser exibida;
Onde "Categoria" é a descrição da categoria se o documento for um "IPE";
Onde "Tipo" é a descrição do tipo se o documento for um "IPE";
Onde "Especie" é a descrição da espécie se o documento for um "IPE";
Onde "Situação" é a descrição do documento (Liberado ou Cancelado).
4.2. No caso de alguma exceção de execução, parâmetro inválido, ou inexistência de informações
<!--?xml version="1.0" encoding="ISO-8859-1" ?-->
- <ERROS>
<NUMERO_DO_ERRO>9999</NUMERO_DO_ERRO>
<DESCRICAO_DO_ERRO>XX...X</DESCRICAO_DO_ERRO>
<FONTE_DO_ERRO> XX...X </FONTE_DO_ERRO>
</ERROS>
Onde "NUMERO_DO_ERRO" é o número de identificação da ocorrência;
Onde "DESCRICAO_DO_ERRO" é a mensagem explicativa da ocorrência;
Onde "FONTE_DO_ERRO>" é a função que gerou a ocorrência.
Tipo de erro 1 (Mensagens de negocio):
- 22014 = Data informada inválida
- 22015 = Hora informada inválida
- 22016 = Nenhum registro localizado
- 22017 = Tipo de documento inválido
Tipo de erro 2 (Exceção de Execução):
- 22013 = Erro ao gerar o XML do download múltiplo.
Sem Tipo de erro (Mensagem de autenticação do usuário)
- 1 = LOGIN INCORRETO
4.3 Exemplos de resultados
O resultado da função download múltiplo correspondente a um documento não depende da ocasião de recebimento desse e sim das ocasiões das ações sobre ele realizadas. Também depende da data de consulta fornecida na chamada da função. O momento de ocorrência da última ação sobre o documento define se um link para baixar o mesmo será fornecido ou não.
Exemplos:
Um documento é liberado em 13/10/2006 e bloqueado em 18/10/2006.
- Ao chamar a função em 13/11/2006, com txtData igual a 18/10/2006, não será fornecido link para baixar o documento por ele estar bloqueado.
- Ao chamar a função em 13/11/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta (nesse exemplo é a ação do dia 18/10/2006).
- Ao chamar a função em 18/10/2006, com txtData igual a 18/10/2006, não será fornecido link para baixar o documento por ele estar bloqueado.
- Ao chamar a função em 18/10/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião de consulta (nesse exemplo é a ação de 18/10/2006).
- Ao chamar a função em dia 13/10/2006, com txtData igual a 13/10/2006, antes de a ação de 18/10/2006 ocorrer, será fornecido link para baixar o documento por ele estar liberado e não sofrer outras ações nos dias posteriores.
Um documento é bloqueado em 13/10/2006 e liberado em 18/10/2006.
- Ao chamar a função em 13/11/2006, com txtData igual a 18/10/2006, será fornecido link para baixar o documento por ele estar liberado em 18/10/2006.
- Ao chamar a função em 13/11/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 18/10/2006, com txtData igual a 18/10/2006, será fornecido link para baixar o documento por ele estar liberado em 18/10/2006.
- Ao chamar a função em 18/10/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 13/10/2006, com txtData igual a 13/10/2006, não será fornecido link para o documento por ele estar bloqueado.
Um documento é cancelado sem visualização em 13/10/2006 e cancelado com visualização em 18/10/2006.
- Ao chamar a função em 13/11/2006, com txtData igual a 18/10/2006, será fornecido link para baixar o documento.
- Ao chamar a função em 13/11/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 18/10/2006, com txtData igual a 18/10/2006, será fornecido link para baixar o documento.
- Ao chamar a função em 18/10/2006, com txtData igual a 13/10/2006, será fornecido link para baixar o documento por ele sofrer ação posterior à data de consulta.
- Ao chamar a função em 13/10/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento.
Um documento é liberado em 10/10/2006, bloqueado em 13/10/2006 e cancelado com visualização em 13/10/2006
- Ao chamar a função em 13/11/2006, com txtData igual a 13/10/2006, será fornecido link para baixar o documento.
- Ao chamar a função em 13/11/2006, com txtData igual a 10/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 13/10/2006, com txtData igual a 13/10/2006, será fornecido link para baixar o documento.
- Ao chamar a função em 13/10/2006, com txtData igual a 10/10/2006, não será fornecido link para o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 10/10/2006, com txtData igual a 10/10/2006, será fornecido link para baixar o documento.
Um documento é liberado em 10/10/2006, bloqueado em 13/10/2006 e liberado em 18/10/2006.
- Ao chamar a função em 13/11/2006, com txtData igual a 18/10/2006, será fornecido link para baixar o documento.
- Ao chamar a função em 13/11/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 13/11/2006, com txtData igual a 10/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 18/10/2006 às 20h, com txtData igual a 18/10/2006, será fornecido link para baixar o documento.
- Ao chamar a função em 18/10/2006, com txtData igual a 13/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função em 18/10/2006, com txtData igual a 10/10/2006, não será fornecido link para baixar o documento por ele sofrer ação posterior à ocasião da consulta.
- Ao chamar a função dia 10/10/2006, com txtData igual a 10/10/2006, será fornecido link para baixar o documento.
5. Manutenção de senha pelo usuário
Opção 1:
- Acessar https://cas.bovespa.com.br/cas/
- Digitar login na caixa de texto "Usuário"
- Digitar senha na caixa de texto "Senha"
- Efetuar clique sobre botão "Login"
- Clique sobre o item de menu "Senhas"
- Digitar senha atual na caixa "Senha atual"
- Digitar nova senha na caixa "Nova senha"
- Digitar nova senha na caixa "Confirmar Nova senha"
- Clique sobre o item de menu "Alterar"
- Efetuar clique sobre botão "OK" do diálogo "Alteração de senha realizada com sucesso"
- Efetuar clique sobre o rótulo "Encerrar"
- Efetuar clique sobre o rótulo "Confirmar"
Opção 2:
- Acessar https://www.rad.cvm.gov.br/ENET
- Digitar login na caixa de texto "Usuário:"
- Digitar senha atual na caixa de texto "Senha:"
- Clique sobre botão "Entrar"
- Clique sobre ícone similar a um triângulo verde com um vértice apontando para a esquerda ("green left pointing triangle icon")
- Clique sobre "Alteração de senha"
- Digitar senha atual na caixa "Senha atual"
- Digitar nova senha na caixa "Nova senha"
- Digitar nova senha na caixa "Confirmar Nova senha"
- Clique sobre botão "Alterar senha"
- Clique sobre botão "OK" do diálogo "Sucesso"
- Clique sobre botão "X Sair"
- Clique sobre botão "Sim" do diálogo "Deseja Realmente Sair"