As instruções a seguir são resumidas e oferecem noções básicas sobre o tema. Entre em contato com nosso suporte para esclarecer quaisquer dúvidas.
O "Add in para Excel da Economatica" é um aplicativo que permite que você acesse a base de dados dos servidores da Economatica diretamente através do Excel (sem usar a interface proprietária do sistema Economatica).
Inicialmente clique no ícone abaixo para baixar o programa "Add in para Excel da Economatica".
Em seguida execute este programa.
Após executá-lo seu Excel deve passar a exibir uma aba chamada "Economatica".
Para que seu Excel possa acessar os servidores da Economatica será necessário que você faça log in. O log in será feito através de seu Excel. Clique no botão de "Log in" que encontra-se na aba "Economatica" de seu Excel.
Faça o log in usando o mesmo e-mail e senha que você usa para acessar a interface proprietária do sistema Economatica.
Você deverá editar funções nas células do Excel para que elas apresentem dados extraídos dos servidores da Economatica.
Exemplo de uma função : =economatica("msft";"close";;"2017-11-20").
Se você preencher uma célula com a função acima esta célula passará a apresentar a cotação de fechamento da ação da Microsoft (MSFT) no dia 20/11/2017.
Para cada finalidade específica existe uma função diferente conforme abaixo
Existem 3 maneiras de criar as funções no Excel:
A seguir estão instruções sobre como criar cada uma destas funções usando o editor de funções do Excel. Mais adiante neste documento você encontra instruções sobre as duas outras alternativas (digitar direto na célula do Excel e copiar de uma tela do sistema Economatica)
Para acessar a tela de edição de funções do Excel clique no ícone de função do Excel (detalhe 1 da imagem abaixo), selecione a categoria "Economatica" (detalhe 2 da imagem abaixo) e em seguida clique duplo sobre a função desejada : função ECONOMATICA, função ECOSECURITIES, e outras que serão adicionadas no futuro (detalhe 3 da imagem abaixo).
O Excel então oferecerá sua tela de edição de funções. A seguir estão as instruções sobre o preenchimento de cada um dos campos.
Através da função ECONOMATICA o usuário poderá obter dois tipos de conteúdo :
A seguir estão as instruções sobre sobre como preencher cada campo da função ECONOMATICA de modo a obter o dado desejado.
Não é necessário que todos os campos sejam preenchidos. Você deve preencher apenas os campos que sejam necessários e suficientes para definir o dado que você deseja
No campo "Ticker" você deve colocar o código do ativo cuja informação você deseja.
Para ativos não listados em bolsa (fundos, etc) coloque o mesmo código usado na interface proprietária do sistema Economatica.
O campo "ticker" pode ser preenchido de 3 maneiras diferentes:
No campo “Attribute” você deverá indicar a informação que você deseja. Exemplos : cotação de fechamento, volume negociado, volatilidade, retorno, P/L, setor, lucro líquido, receita líquida, ROE, margem EBITDA e todas as outras centenas de possibilidades que são oferecidas na interface proprietária do sistema Economatica.
Há duas maneiras de preencher o campo "Attribute"
Posicione o cursor no campo "Attribute" e clique no ícone destacado na imagem abaixo para acessar a lista de todos os atributos disponíveis.
Você então acessará uma tela igual à tela de escolha de atributo da interface proprietária do sistema Economatica. Entre em contato com nosso suporte se você tiver dúvidas sobre a navegação nesta tela.
O nome exato que deve ser usado é aquele que aparece nas colunas da janela Screening da versão INGLÊS do sistema Economatica (interface proprietária).
Portanto, para saber os nomes exatos a serem usados no campo "Attribute", você deverá seguir os passos abaixo:
Entre em contato com nosso suporte se você não souber operar a interface proprietária do sistema Economatica.
Dependendo do atributo escolhido no campo anterior, será necessário informar o período desejado.
Exemplo : o atributo “Retorno” pode ser "no ano", "em 1 mês", "desde 05/05/2015", "desde o início da série", etc.
Vários atributos entretanto não estão associados a um período e para eles este campo deve ser deixado em branco. Exemplos : fechamento, patrimônio líquido, setor, etc.
O período deve ser escrito entre aspas duplas, em inglês e obedecendo o padrão dos exemplos abaixo.
Para itens como retorno, volatilidade, etc as opções são:
Para itens como lucro, margem ebitda, etc as opções são:
Neste campo você indicará a data para a qual deseja a informação escolhida no campo "Attribute".
Exemplo : a cotação de fechamento no dia 5/5/2015 ou no dia 31/12/2017 ou no dia de hoje ou há um mês atrás, etc.
Vários atributos entretanto não estão associados a uma data e para eles este campo deve ser deixado em branco. Exemplos : setor, nome da administradora do fundo, etc.
A data deve ser escrita entre aspas duplas, em inglês e obedecendo o padrão dos exemplos abaixo.
Para itens diários como fechamento, volatilidade, P/L, etc as opções são:
Para itens trimestrais como lucro, margem ebitda, patrimônio líquido, etc as opções são:
(*) Estas 4 opções (onde há o sinal "<" antes no nome do mês) são úteis quando se está trabalhando com empresas com exercício fiscal irregular, ou seja, que publicam demonstrativos em datas diferentes de 31/Mar, 30/Jun, 30/Set e 31/Dez.
Este campo deve ser preenchido somente quando você deseja obter uma informação para uma faixa de datas e não apenas para uma única data.
Neste campo você deverá digitar a data inicial da faixa desejada. O final da faixa será a data que você especificou previamente no campo "Date ".
As opções são:
Este campo deve ser preenchido somente quando você deseja obter uma informação para uma faixa de datas e não apenas para uma única data.
As opções são:
(*) valores acumulativos são aqueles que estão associados a um período e não a um único momento. Exemplos: volume negociado no período, captação do fundo no período, cotação máxima do período, etc
A base de dados da Economatica cobre vários países então existem dados em várias moedas diferentes (cotações, demonstrativos financeiros, etc). Através deste campo você poderá converter os dados para outras moedas.
As opções são:
Através deste campo voce pode definir se os valores devem ser apresentados em milhares, milhões, etc.
Este campo deve ser preenchido somente para itens (atributos) onde o multiplicador faz sentido. Exemplos : Ativo Total, Receita, Volume negociado, etc.
Este campo não deve ser preenchido para itens (atributos) como Cotação, Margem líquida, Lucro por ação, etc
As opções são :
Nos casos em que você definiu uma função que traz valores para uma faixa de datas aparecerá uma coluna com as respectivas datas a esquerda dos valores.
Nalgumas situações você pode preferir omitir esta coluna de datas. Por exemplo quando você deseja colocar várias colunas lado-a-lado (Exemplo : cotação de fechamento, P/L, volatilidade, etc) será mais conveniente que a primeira função à esquerda mostre sua coluna de datas e as outras funções omitam as datas.
Para omitir a coluna de datas preencha este campo com "FALSE".
O Header é a descrição que aparece na célula do topo.
Exemplo : "Retorno em 1 ano", "Lucro de 3 meses", etc.
Nas funções de um único ticker e uma única data o header não aparece (por default). O header entretanto aparece (por default) nas duas situações abaixo:
Nalgumas situações você pode preferir omitir o header. Por exemplo quando você está encaixando dados da Economatica em um relatório que já tem um design definido.
Para omitir o header preencha este campo com "FALSE".
Através deste campo você pode escolher um cabeçalho diferente do cabeçalho padrão oferecido pelo sistema. Digite neste campo o cabeçalho desejado
Através do campo "Optionals" você poderá fazer outras definições. Exemplos:
A sintaxe deste campo é complexa. Por favor entre em contato com nossa equipe de suporte para receber instruções.
Através da função ECOSECURITIES o usuário definirá filtros para obter uma lista de determinados ativos.
Exemplos : lista de todas as ações negociadas na bolsa NASDAQ, lista de todos os fundos do Brasil, etc.
A lista consistirá do códigos dos ativos acompanhados da respectiva bolsa/fonte (segundo o padrão ISO).
Exemplo :
Repare que ocasionalmente novos ativos entram na base de dados (emissão de novas ações, etc) por isso a cada vez que a função ECOSECURITIES for atualizada/processada ocorrerá também uma atualização dos itens da lista
A seguir estão as instruções sobre como preencher cada campo (filtro) da função ECOSECURITIES de modo a obter a lista de ativos desejada.
Não é necessário que todos os campos (filtros) sejam preenchidos. Você deve preencher apenas os campos que sejam necessários e suficientes para definir a lista de ativos que você deseja
Neste campo você indicará a qual (is) tipo (s) de ativo pertencem os itens que você deseja listar. As opções são :
Indique se você deseja itens que atualmente estejam ativos ou itens cuja negociação já foi cancelada. As opções são : "ACTIVE" e "CANCELED"
Empresas que sejam emissoras de vários títulos (varias classes de ação, etc) comparecerão na lista repetidas vezes (uma vez para cada um de seus títulos). Se entretanto este campo for preenchido com "TRUE" a empresa comparecerá na lista uma única vez, e estará representada por seu titulo mais liquido
Indique o pais de origem das empresas emissoras dos itens que você deseja. As opções são : "USA", "ARG", "BRA", "CHL", "COL", "MEX", "PER" e outros
Indique a bolsa onde são negociados os itens que você deseja. As opções são os nomes das bolsas segundo o padrão ISO :
A célula no topo da lista de ativos estará preenchida com o cabeçalho "Codigo"
Nalgumas situações você pode preferir omitir o cabeçalho. Por exemplo quando você está encaixando dados da Economatica em um relatório que já tem um design definido.
Para omitir o cabeçalho preencha este campo com "FALSE".
Através deste campo você pode escolher um cabeçalho diferente do cabeçalho padrão oferecido pelo sistema. Digite neste campo o cabeçalho desejado
Através deste campo o usuário poderá fazer filtros usando outras variáveis além daquelas listadas acima. Seguem abaixo explicações resumidas, entre em contato com o suporte da Economatica se precisar de orientações mais detalhadas
Exemplo 1) Selecionar ações de empresas do setor de construção (segundo a classificação setorial da Economatica) :
"Sector Economatica=Construction"
Exemplo 2) Selecionar ações de empresas do setor de construção OU do setor de telecomunicações (os dois setores deverão estar separados por vírgula)
"Sector Economatica=Construction,Telecommunication"
Exemplo 3 - Problema causado por vírgula dentro do texto) Em alguns casos o termo do lado direito da igualdade pode conter uma virgula. Por exemplo, existe uma classificação setorial chamada "Exploration, refining and distribution"
Este texto contém uma virgula entre "exploration" e "refining". Esta vírgula vai induzir o sistema a entender que são duas categorias separadas, sendo uma "Exploration" e a outra "refining and distribution"
Para solucionar este problema deve-se digitar uma barra invertida ("\") antes da vírgula
"Segment Bovespa = Exploration\, refining and distribution"
Exemplo 4) Selecionar fundos cuja classificação Anbima seja Multimercados balanceados :
"Anbima classification=Multimercados balanceados"
Exemplo 5) Selecionar fundos cuja classificação Anbima seja Multimercados balanceados E que o gestor seja JP Morgan.
Para inserir dois ou mais filtros é necessário obedecer a seguinte sintaxe:
Exemplo 6) É possível também escrever o filtro em uma célula :
- Digitar numa célula (D5 por exemplo) o filtro desejado ("Sector Economatica=Construction" por exemplo)
- Preencher o campo OPTIONALS com "D5" (ou seja, com as coordenadas da célula onde está o filtro)
Os filtros do campo OPTIONALS podem usar outros operadores além da igualdade (=) e desigualdade (<>)
Exemplo 1) Nome da empresa CONTÉM a palavra "Health"
"name~health"
Exemplo 2) Nome da empresa NÃO CONTÉM a palavra "Health"
"name!~health"
Exemplo 3) O código ISIN da ação está disponível, ou seja, o valor deste campo NÃO É NULO
"ISIN<>null"
A sintaxe das funções a serem digitadas nas células do Excel devem obedecer a sequência abaixo:
A sintaxe acima representa o caso em que todos os campos são usados. Na grande maioria dos casos entretanto apenas alguns campos serão usados.
Mesmo que um ou mais campos não sejam usados, é necessário manter a ordem da sintaxe indicada acima. Portanto deve-se deixar um espaço vazio no lugar dos campos não usados. Repare nos exemplos abaixo que a posição dos campos não usados está representada por duas virgulas consecutivas (sem nenhum conteudo entre elas).
Os valores permitidos para cada campo são aqueles detalhados anteriormente neste documento.
Os campos devem ser separados pelo caracter que seu windows usa como "Separador de listas". Se você não souber qual caracter seu windows usa como separador de listas você pode seguir a seguinte regra (essa regra não vale se você tiver alterado as definições default de seu windows) : Os campos devem ser separados com vírgula quando seu Excel usa o ponto como separador decimal. Enquanto que os campos devem ser separados por ponto-e-vírgula quando seu Excel usa vírgula como separador decimal. Nos exemplos a seguir os campos estão separados por vírgula.
Exemplo 1) Mostrar setor de atuação da empresa Microsoft (MSFT) segundo a classificação NAICS. Neste caso somente os dois primeiros campos serão usados.
=economatica("msft ","sector naics")
Exemplo 2) Mostrar a cotação de fechamento da GOOG no dia 5 de abril de 2018. No caso da cotação de fechamento o campo "attribute´s period" não é usado, então deve-se deixar um espaço vazio na posição reservada para este campo (é o espaço vazio que está entre duas vírgulas).
=economatica("goog","close",,"2018-04-05")
Exemplo 3) Mostrar o retorno da ação MSFT desde o início do ano até a data mais recente.
=economatica("msft","return","YTD","d-0")
Exemplo 4) Mostrar o lucro da GOOG em cada trimestre nos últimos 4 anos (portanto serão 16 trimestres) até o último disponível, numa escala de datas trimestral e convertido para Euros.
=economatica("goog","net income","3m","latest","4y","q","eur")
Exemplo 5) Mostrar a cotação máxima das últimas 52 semanas para uma lista de 20 tickers (a qual você previamente posicionou entre as células A5 e A24). Mostrar dados ajustados pela inflação. Omitir o cabeçalho. Neste exemplo os campos "range start date", "interval", "multiplier" e "show dates" não serão preenchidos, portanto deve-se deixar espaços vazios nas posições reservadas para cada um destes campos.
=economatica(A5:A24,"high","52w","d-0",,,"inflation adjusted",,,"false")
Exemplo 1) Selecionar todas as ações negociadas na bolsa NASDAQ e que atualmente estejam ativas (ou seja, excluir as canceladas)
=ecosecurities("stock","active",,,"xnas")
Exemplo 2) Selecionar todos os tÍtulos públicos emitidos pelo Brasil que atualmente estejam ativos (ou seja, excluir os cancelados)
=ecosecurities("governmentbond","active",,"bra")
Exemplo 3) Selecionar ações de empresas do setor de construção (usando a classificação setorial da Economatica).
=ecosecurities("stock",,,,,,,"sector economatica=construction")
Exemplo 4) Selecionar fundos do Brasil
=ecosecurities("fund",,,"bra")
Exemplo 5) Selecionar fundos do Brasil e do Mexico (os dois paises deverão estar separados por vírgula)
=ecosecurities("fund",,,"bra,mex")
Exemplo 6) Selecionar fundos do Brasil cuja classificação Anbima seja Multimercados balanceados e que o gestor seja JP Morgan
=ecosecurities("fund",,,"bra",,,,{"Anbima classification=Multimercados balanceados";"Fund manager=JP Morgan"})
É possivel introduzir uma função no Excel fazendo uma cópia de uma tela do sistema Economatia (interface proprietária) e colando o conteúdo no Excel
Para isso voce deverá abrir o sistema Economatica, ou seja, acessar a interface proprietária do sistema Economatica. Entre em contato com nosso suporte se você não souber operar a interface proprietária do sistema Economatica.
Uma vez no sistema Economatica você deverá abrir a janela Screening ou a janela Matrixx e criar colunas contendo os mesmos dados que você quer ter no Excel.
Em seguida você deve pintar os dados desejados, clicar com o botão direito sobre a área pintada e escolher a opção "Export to Excel add in".
Depois cole este conteúdo no seu Excel através de CTRL+V.
Ao fazer isso você estará colando no Excel não os dados propriamente ditos, mas sim as funções que permitirão seu Excel comunicar-se com os servidores da Economatica e preencher as células com os dados desejados.
Após feita esta operação (e salvar sua planilha Excel) não será mais necessário você usar a interface proprietária do sistema Economatica.
Não é possível criar no Excel uma função ECOSECURITIES fazendo uma cópia do sistema Economatica
Em alguns casos a configuração do proxy da rede da sua empresa poderá impedir que você acesse o "Add-In para Excel da Economatica"
Neste caso você receberá a mensagem : "O servidor remoto retornou um erro: (407) Autenticação de Proxy" (o texto exato da mensagem poderá variar de acordo com particularidades de seu ambiente)
Para corrigir este problema você poderá escolher uma das duas soluções apresentadas abaixo:
Solução 1) Solicite ao departamento de TI de sua empresa a liberação do endereço abaixo nas configurações de proxy da rede da sua empresa :
Host : api.overstat.economatica.com
Porta : 443
Protocolo : https
Solução 2) Digite os dados da configuração do proxy na tela específica para este fim disponível no "Add-In para Excel da Economatica"
Para acessar esta tela clique no ícone "About / Help" destacado na imagema abaixo.
A tela de configuração se abrirá no lado direito do vídeo. Preencha os campos indicados na imagem abaixo. Para fazê-lo você deverá obter orientações junto ao departamento de TI de sua empresa.
Atenção : O "Add-In para Excel da Economatica" atualmente não suporta script automatizado de Proxy.
Eventualmente pode aparecer o ícone abaixo na barra de ferramentas de sua planilha
O significado deste ícone encontra-se descrito a seguir
O servidor da Economatica está constantemente sendo atualizado com novos dados. Além das cotações diárias, uma variedade enorme de informações é introduzida na base de dados : novos balanços de empresas, novas composições de carteiras de fundos, dados cadastrais, correções de dados históricos, etc
Aproximadamente a cada 5 minutos (este intervalo pode variar muito) o servidor é carregado com novos dados. Ou seja, aproximadamente a cada 5 minutos a situação da base de dados do servidor é alterada
Este ícone indica que algumas células de sua planilha foram atualizadas em um determinado momento enquanto funções novas que você criou posteriormente foram atualizadas num momento em que o servidor já tinha sido alimentado com novas informações e portanto a base de dados se encontrava em uma nova situação
Este ícone também pode aparecer se sua planilha for muito grande e a atualização de todas as funções for demorada e acontecer alguma atualização no servidor durante a atualização de sua planilha.
Isto RARAMENTE é um problema uma vez que é muito improvável que haja algum conflito entre os dados de sua planilha causado pelo fato de diferentes célualas estarem refletindo diferentes momentos da base de dados
De qualquer maneira, ao clicar neste ícone todas as funções de sua planilha serão atualizadas e, portanto, estarão sincronizadas com um mesmo momento da base de dados.