Sistema Galgo - Guia do Aplicativo – Consumir PL/Cota · Sistema Galgo. GUIA DO USUÁRIO: significa o conjunto de documentos elaborado pela Galgo S.A. com a finalidade de orientar

PRODUTO SISTEMA GALGO

PROCESSO CONSUMIR PL/COTA

MANUAL

GUIA DO APLICATIVO

CONSUMIR PL/COTA

Av. Santo Amaro 48 Conjunto 51 04506 000 São Paulo SP Brasil Tel. 55 11 3036 2500 www.galgosistemas.com.br

Classificação da Informação: Pública

2

CONTROLE DE VERSÃO

Data Versão Histórico da Versão Elaborador Revisores

04/04/2016 1.0 Elaboração do Documento Luiz

Bassetto

Roberta Paschoal

Valdemar Arantes

18/04/2016 1.1

Inclusão dos capítulos e complementos

referentes a nova versão do aplicativo,

que contempla a interface de Linha de

Comando.

Luiz

Bassetto

Roberta Paschoal

Valdemar Arantes

23/05/2016 1.2

Nova versão do aplicativo, incluindo:

• Configurações da instalação

• Inclusão na tela dos campos para

ativação da VPN

Complemento das descrições do

arquivo de configurações e dos filtros

de data.

Complemento do teste de conexão com

o sistema.

Luiz

Bassetto

Roberta Paschoal

Valdemar Arantes

18/07/2016 1.3

Nova versão do aplicativo, incluindo:

• Nova opção no filtro Status da

Informação (reenvios por alteração

no valor da cota).

Luiz

Bassetto

Roberta Paschoal

Valdemar Arantes

03/08/2016 1.4 Inclusão da seção Início Rápido Luiz

Bassetto

Roberta Paschoal

Valdemar Arantes

22/03/2017 1.5

• Reorganização do Guia

• Atualização dos contatos de

suporte

Luiz

Bassetto Elisangela Pedron



3


24/05/2017 1.6

• Alteração no preenchimento da

configuração de Controle de VPN

pelo aplicativo

• Definição da formatação do arquivo

XML gerado pela versão de linha

de comando, com o formato UTF-8

Luiz


30/08/2017 2.0

• Ajuste no cabeçalho e rodapé do

documento para adequação de

Classificação da Informação.

Leonardo

Ribeiro Elisangela Pedron

20/07/2018 2.1

• Inclusão do filtro Moedas como

critério para consulta

• Atualização da data/hora inicial do

período de Envio

• Alteração nas regras de controle do

período de envio, conforme

descrito na SEÇÃO II –

CONTROLE DO PERÍODO DE

ENVIO

• Alterações nas mensagens de erro

• Alteração no padrão do nome do

arquivo gerado no consumo

Luiz


07/12/2018 2.2

• Complemento da SEÇÃO II –

CONTROLE DO PERÍODO DE

ENVIO, com destaque sobre o

consumo em duplicidade

Luiz Bassetto

Elisangela Pedron



4


22/07/2019 2.3

• Versão do aplicativo: 3.2.8

• Atualização da SEÇÃO I – INÍCIO

RÁPIDO, com inclusão do item 8,

sobre a criação de pasta pelo

aplicativo.

• Atualização da SEÇÃO II – DO

CONTROLE DAS INFORMAÇÕES

CONSUMIDAS com detalhe sobre

os horários considerados no

consumo.

• Atualização da SEÇÃO V – DA

INTERFACE POR LINHA DE

COMANDO – CLI, com ressalvas

sobre o controle do horário de

envio.

• Atualização dos dados de contato

de suporte no caput do CAPÍTULO

III – INFORMAÇÕES DE

SUPORTE.

Luiz




5


09/10/2019 2.4

• Versão do aplicativo: 3.2.9

• Alteração do item 6 da SEÇÃO I –

INÍCIO RÁPIDO, devido inclusão

de opção de download dos dois

formatos de arquivo ao mesmo

tempo

• Alteração da SEÇÃO III –

CONSULTA EFETUADA COM

SUCESSO E ARQUIVOS

GERADOS, devido alteração do

padrão de nomes dos arquivos

gerados

• Alteração do item 5 da SEÇÃO II –

VALIDAÇÃO DA VERSÃO DO

JAVA, sobre a configuração da

variável de ambiente JAVA-HOME

Evandro

Paulino Luiz Bassetto



6

APRESENTAÇÃO

O Guia do Aplicativo – Consumir PL/Cota tem por objetivo apresentar à Entidade Usuária as

orientações necessárias para a utilização do mesmo, bem como algumas informações básicas

sobre o serviço e as informações obtidas. Informações complementares sobre o aplicativo e

o Serviço PL/Cota podem ser obtidas junto à equipe de suporte do Sistema Galgo.

O aplicativo apresenta algumas facilidades aos usuários, dentre as quais, destacamos:

• Agilidade ao efetuar o consumo (tela com dados já preenchidos, conexão pelo Web

Service, opção de usar filtro automático)

• Controle automático da conexão pela VPN, otimizando tempo de uso do link (para

Entidades com conexão ao sistema através de VPN RTM)

• Facilidade de integração, para Entidades que desejam implementar Web Services,

através da versão de linha de comando.

• Conversão do arquivo XML gerado pelo sistema, para o formato CSV, facilitando o uso

das informações pelas Entidades Usuárias que não tem sistema próprio adequado à

leitura do XML.

• Controle automático do período de envio como filtro de busca, minimizando o risco de

consumo de informações duplicadas, e respectivos impactos na tarifação da Entidade

Usuária (vide detalhes na SEÇÃO II – CONTROLE DO PERÍODO DE ENVIO).

O aplicativo está disponível em duas versões. A versão desktop (UI) apresenta uma tela

semelhante à tela de consulta de PL/Cota do Sistema Galgo, com os mesmos campos para

realização da consulta. A versão de linha de comando (CLI) permite que a Entidade Usuária

automatize o processo de consulta e, opcionalmente, desenvolva uma integração com um

sistema interno ou uma base de dados. Esses processos são de responsabilidade da Entidade

Usuária. Os arquivos gerados pelo sistema, sempre no formato XML, podem ser convertidos

para o formato CSV pelo aplicativo, opção que o usuário pode fazer no momento do consumo.



7

O aplicativo, em sua versão desktop, grava parte das informações preenchidas no formulário

para facilitar a próxima utilização. Essas informações são gravadas em um arquivo de

configurações, criado pelo aplicativo no momento da instalação. A cada nova execução do

aplicativo, o arquivo é atualizado com os dados desta execução. As credenciais de acesso

também são gravadas. A senha é criptografada.

O aplicativo foi desenvolvido com base no Java – versão 8, podendo, dessa forma, ser

executado em qualquer equipamento/sistema operacional que possua a versão 8 ou superior

do Java instalado.



8

ÍNDICE

APRESENTAÇÃO ................................................................................................................................... 6

DEFINIÇÕES ........................................................................................................................................... 9

CAPÍTULO I – UTILIZANDO O APLICATIVO ....................................................................................... 15

SEÇÃO I – INÍCIO RÁPIDO .............................................................................................................. 15

SEÇÃO II – CONTROLE DO PERÍODO DE ENVIO ......................................................................... 21

SEÇÃO III – CONSULTA EFETUADA COM SUCESSO E ARQUIVOS GERADOS ....................... 31

SUBSEÇÃO I – DO ARQUIVO DE LOG ....................................................................................... 32

SEÇÃO IV – OCORRÊNCIAS NA CONSULTA ................................................................................ 33

SEÇÃO V – DA INTERFACE POR LINHA DE COMANDO – CLI .................................................... 36

SEÇÃO VI – INSTALAÇÃO NA REDE – VÁRIOS USUÁRIOS ........................................................ 39

SEÇÃO VII – CONEXÃO AUTOMÁTICA DA VPN ............................................................................ 42

CAPÍTULO II – INFORMAÇÕES COMPLEMENTARES DO USO DO APLICATIVO .......................... 44

SEÇÃO I – CONTEÚDO DO APLICATIVO ....................................................................................... 44

SEÇÃO II – DO CONTROLE DAS INFORMAÇÕES CONSUMIDAS ............................................... 45

SUBSEÇÃO I – DOS REENVIOS DE INFORMAÇÕES ................................................................ 48

SEÇÃO III – CONSULTA DE CÓDIGOS STI DOS FUNDOS ........................................................... 48

SEÇÃO IV – REGRAS PARA CONEXÃO AUTOMÁTICA DA VPN ................................................. 53

CAPÍTULO III – INFORMAÇÕES DE SUPORTE ................................................................................. 53

SEÇÃO I – REQUISITOS PARA A UTILIZAÇÃO ............................................................................. 54

SUBSEÇÃO I – REQUISITOS DE CONEXÃO .............................................................................. 54

SUBSEÇÃO II – USUÁRIO E PERMISSÕES ............................................................................... 56

SUBSEÇÃO III – COMPROMISSOS ............................................................................................. 57

SEÇÃO II – VALIDAÇÃO DA VERSÃO DO JAVA ............................................................................ 58

SEÇÃO III – VALIDAÇÃO DA CONEXÃO COM O SERVIDOR DE WEB SERVICE DO SISTEMA

GALGO .............................................................................................................................................. 65



9

DEFINIÇÕES

As definições abaixo listadas atendem ao Regulamento e às Normas para Uso do Sistema

Galgo, ainda que nem todos os termos sejam utilizados em todos os documentos.

CATEGORIA DE USUÁRIO: indica os possíveis tipos de usuário do Sistema Galgo. Cada

categoria tem atuações específicas, conforme descrito no Guia do Usuário. As categorias

disponíveis são: Master Entidade, Master Entidade de Negócios, Master Entidade de

Segurança, Master do Papel, Master de Negócios do Papel, Master de Segurança do Papel,

Usuário Final de Segurança, Usuário Final e Usuário Sistema Externo.

COMPROMISSO: acordo entre partes provedora e consumidora, registrado no sistema, que

define as regras das transferências de informações relativas aos Serviços disponíveis no

Sistema Galgo, conforme descrito no Manual de Serviços e Funcionamento Operacional e no

Manual de Tarifação. Um Compromisso é específico para cada combinação Provedor,

Consumidor, Papel da Entidade Consumidora, Serviço, Fundo de Investimento ou Carteira

Administrada ou Clube de Investimento e Moeda.

COMUNICADO: significa qualquer forma de manifestação escrita, através da qual a Galgo

S.A. dá conhecimento às Entidades Usuárias de quaisquer alterações promovidas no

Regulamento e/ou nas Normas para Uso do Sistema Galgo, utilizando, para tal, meios de

comunicação distintos, tais como: e-mail, carta, carta-circular ou o website da Galgo S.A.

(www.galgosistemas.com.br).

DELEGAÇÃO DO REGISTRO: opção dada à instituição Administradora do fundo, de atribuir

à outra instituição a possibilidade de efetuar no Sistema Galgo os processos relacionados às

atividades de registro de fundos e envio de comunicados, para fundos administrados pela

primeira.

ENTIDADE CONSUMIDORA: pessoa física ou jurídica, usuária do Sistema Galgo, identificada

como Entidade Consumidora (que pode consultar informações) em um Compromisso.

ENTIDADE INTEGRADA: pessoa física ou jurídica que concluiu as etapas de formalização e

de adequação da infraestrutura e evidências de acesso, descritas nos capítulos I e IV do

Manual de Procedimentos para Integração.

http://www.galgosistemas.com.br/Docs/GALGO_SA_Regulamento.pdf

http://www.galgosistemas.com.br/Docs/GALGO_SA_Manual_de_Servicos_e_Funcionamento_Operacional.pdf

http://www.galgosistemas.com.br/Docs/Galgo_SA_Manual_de_Tarifacao.pdf

http://www.galgosistemas.com.br/Docs/GALGO_SA_Regulamento.pdf

http://www.galgosistemas.com.br/

http://www.galgosistemas.com.br/Docs/GALGO_SA_Manual_de_Procedimentos_para_Integracao.pdf



10

ENTIDADE INTERESSADA: pessoa física ou jurídica interessada em contratar os Serviços

do Sistema Galgo, oferecidos pela Galgo S.A.

ENTIDADE PROVEDORA: pessoa jurídica, usuária do Sistema Galgo, identificada como

Entidade Provedora (que pode enviar a informação) em um Compromisso, de acordo com as

regras dos Serviços e dados cadastrais do registro do fundo selecionado no Compromisso.

ENTIDADE USUÁRIA: pessoa física ou jurídica que concluiu as etapas descritas nos capítulos

I e IV do Manual de Procedimentos para Integração e possui Usuário Master da Entidade

cadastrado, passando a deter, por conseguinte, acesso aos Serviços do Sistema Galgo. Pode

atuar como Entidade Consumidora e/ou Provedora.

EXPURGO: processo em que as informações relativas às Transações são excluídas da base

de dados do Sistema Galgo, conforme prazos definidos na Tabela de Retenção (vide Capítulo

IV – Seção 5 – Manual de Serviços e Funcionamento Operacional), não sendo mais possível

a utilização ou consulta pelos usuários do sistema.

FALHA: funcionamento anormal ou incompleto, de caráter não repetitivo, de uma

Funcionalidade ou Serviço do Sistema Galgo.

FUNCIONALIDADE: designação genérica do Sistema Galgo para todos os grupos de

Transações que não estão relacionadas aos Serviços, como por exemplo: Cadastro de

Usuários, Compromissos, Consulta de Log, etc.

FUNÇÃO CRÍTICA: significa um Serviço ou Funcionalidade do Sistema Galgo cujo

funcionamento está diretamente relacionado ao cumprimento de obrigações pelas Entidades

Usuárias junto aos Órgãos Reguladores, sendo que o não atendimento de tais obrigações

pelas Entidades Usuárias pode ensejar em aplicação de multa por tais Órgãos Reguladores.

FUNÇÃO NÃO CRÍTICA: significa um Serviço ou Funcionalidade do Sistema Galgo cujo

funcionamento não está diretamente relacionado ao cumprimento de obrigações pelas

Entidades Usuárias junto aos Órgãos Reguladores.

GALGO S.A.: significa a Galgo Sistemas de Informações S.A., sociedade por ações de capital

fechado.





11

GUIA DO SERVICE DESK: significa o documento elaborado pela Galgo S.A. com o objetivo

de apresentar às Entidades Usuárias os procedimentos para utilização do Service Desk do

Sistema Galgo.

GUIA DO USUÁRIO: significa o conjunto de documentos elaborado pela Galgo S.A. com a

finalidade de orientar os usuários na utilização do sistema, apresentando as informações

detalhadas (conceitos, regras e passo a passo) das Funcionalidades e Serviços disponíveis

no Sistema Galgo.

INCIDENTE: interrupção, falha ou erro não planejado em um Serviço, Funcionalidade ou na

infraestrutura do Sistema Galgo.

INDISPONIBILIDADE: Serviço, Funcionalidade ou infraestrutura inoperante. No Sistema

Galgo a indisponibilidade é controlada em cada canal de acesso (Portal ou Web Service).

INFORMAÇÕES: representa o conjunto que compõe um Serviço do Sistema Galgo, como por

exemplo, (i) a identificação do fundo de investimento, (ii) a data base da informação, (iii) o

valor da cota do fundo na data base, e (iv) o valor do PL do fundo na data base; para o Serviço

PL/Cota. Os Serviços disponíveis no Sistema Galgo estão descritos no Manual de Serviços e

Funcionamento Operacional do Sistema Galgo.

INVESTIDOR: no Sistema Galgo, corresponde aos veículos de investimento existentes no

mercado que podem adquirir cotas de fundos: Carteiras Administradas, Clientes Por Conta e

Ordem, Clubes de Investimento ou Fundos de Investimento. É o cotista indicado num

Compromisso do Serviço Extrato de Conciliação de Cotas.

JANELA DE MANUTENÇÃO: período fora do horário de cobertura do Sistema Galgo,

compreendido pelos sábados, domingos e feriados nacionais.

NORMA: significa o conjunto de documentos elaborados pela Galgo S.A. que complementam

as definições, as orientações, as regras e os procedimentos operacionais contidos no

Regulamento do Sistema Galgo, Capítulo I – Seção II – Item 5.

ÓRGÃO REGULADOR: significa qualquer órgão, seção, departamento ou pessoa, integrantes

da Administração Pública direta ou indireta, de qualquer esfera, seja federal, estadual, distrital

ou municipal, e vinculada a qualquer Poder, seja executivo, legislativo ou judiciário, bem como

qualquer pessoa ou entidade não integrante da Administração Pública, mas que disponha de

competência autorreguladora e/ou jurisdicional, tais como bolsa de valores e/ou câmaras





12

arbitrais, que, por força de lei, normativos, sejam estes decretos, regulamentos, resoluções,

instruções, portarias e/ou circulares, e/ou instrumentos jurídicos aplicáveis, tenha autoridade

sobre a Galgo S.A.

PAPEL: representa um conjunto de atividades desempenhadas pela Entidade Usuária no

mercado, como por exemplo: Administração, Custódia, Controladoria, Gestão. No Sistema

Galgo, uma entidade pode desempenhar um ou mais papéis. Os papéis associados às

Entidades Usuárias delimitam as Transações que as mesmas podem executar no sistema e

podem ser utilizados como meio de segmentação de perfis no controle de acesso efetuado

pelo Usuário Master da Entidade.

PERÍODO DE APURAÇÃO: período compreendido entre o dia 26 do mês anterior e dia 25 do

mês de apuração da tarifa.

PRESTADOR DE SERVIÇOS: Entidades Usuárias ou instituições do mercado, identificadas

no cadastro de um fundo de investimento, carteira administrada ou clube de investimento, e

associadas a um ou mais papéis listados no mesmo.

PROBLEMA: Incidente não solucionado de forma definitiva, ao qual foi aplicada uma Solução

de Contorno.

RECIBO: retorno do Sistema Galgo com o resultado do processamento do Envio, Reenvio ou

Cancelamento de Transações efetuadas pela Entidade Usuária através de upload de arquivo

ou Web Service.

RETENÇÃO: é o período em que as informações ficam armazenadas na base de dados do

Sistema Galgo e, portanto, disponíveis para utilização pelos usuários do sistema.

SERVICE DESK: Central de atendimento responsável por recepcionar, registrar e gerenciar

os Incidentes abertos pelos usuários do Sistema Galgo.

SERVIÇO: designação genérica no Sistema Galgo para todo tipo de informação que possa

participar do processo de transferência, tais como: Extrato de Conciliação de Cotas, PL/Cota,

etc.

SISTEMA GALGO: significa um sistema de transferência de informações padronizadas para

os mercados financeiro e de capitais brasileiro, criado para funcionar como integrador entre

as instituições que atuam ou prestam serviços para fundos de investimento, carteiras



13

administradas e clubes de investimento nas atividades de administração, controladoria,

custódia, distribuição e negociação de ativos.

SOLUÇÃO DE CONTORNO: solução temporária que permita ao usuário efetivar a Transação

desejada, até a resolução completa do Incidente ou Problema.

TERCEIRO: significa qualquer pessoa física ou pessoa jurídica que não se configure como

Entidade Interessada, Entidade Integrada ou Entidade Usuária, que venha a obter

informações através de Entidades Usuárias.

TERMO DE DECLARAÇÕES E COMPROMISSOS: significa o documento celebrado pela

Entidade Interessada junto à Galgo S.A. formalizando seu interesse em se integrar ao Sistema

Galgo, seguindo as etapas estabelecidas no Manual de Procedimentos para Integração.

TRANSAÇÃO: significa a ação executada pela Entidade Usuária referente a um dos Serviços

ou a uma das Funcionalidades disponíveis no Sistema Galgo.

USUÁRIO FINAL: pessoa física vinculada à Entidade Usuária, cadastrada no Sistema Galgo

pelo Usuário Master da Entidade, com permissões atribuídas para acessar o sistema, de

acordo com definições internas da Entidade Usuária.

USUÁRIO MASTER DA ENTIDADE: pessoa física designada pela Entidade Usuária,

responsável pela gestão dos Usuários Finais e Usuários Sistema Externo (cadastro dos

usuários, atribuição de permissões, regras de uso e demais atividades relacionadas ao

controle de acesso). Possui seis categorias específicas, como forma de segmentar as

atividades de gestão dos usuários: Master Entidade, Master Entidade de Negócios, Master

Entidade de Segurança, Master do Papel, Master de Negócios do Papel e Master de

Segurança do Papel. As definições de cada categoria e regras para a segmentação das

atividades estão descritas no Guia do Usuário.

USUÁRIO SISTEMA EXTERNO: usuário que representa um sistema da Entidade Usuária,

utilizado para acessar o Sistema Galgo no processo de transferência de informações de forma

automática (através de Web Service). Cadastrado pelo Usuário Master da Entidade, com

permissões atribuídas para acessar o sistema, de acordo com definições internas da Entidade

Usuária.

VENDOR: qualquer pessoa física ou jurídica que preste serviço de desenvolvimento,

manutenção e/ou operação de sistemas às Entidades Interessadas, Entidades Integradas ou

http://www.galgosistemas.com.br/Docs/GALGO_SA_Termo_de_Declaracoes_e_Compromissos.docx




14

às Entidades Usuárias, cujas informações transmitidas e/ou armazenadas tenham relação

com as informações dos Serviços disponíveis no Sistema Galgo, conforme exposto no Manual

de Serviços e Funcionamento Operacional.

WEB SERVICE: solução utilizada na integração de sistemas e na comunicação entre

aplicações diferentes. Com esta tecnologia é possível que novas aplicações possam interagir

com aquelas que já existem e que sistemas desenvolvidos em plataformas diferentes sejam

compatíveis. Os Web Services são componentes que permitem às aplicações enviar e receber

dados em formato XML.





15

CAPÍTULO I – UTILIZANDO O APLICATIVO

SEÇÃO I – INÍCIO RÁPIDO

O aplicativo Consumir PL/Cota é de fácil utilização. Siga os passos abaixo para iniciá-lo. Caso,

alguns dos pré-requisitos não estejam corretos, siga as orientações indicadas.

1. Efetuar o download do aplicativo pelo link recebido (ou clique aqui) e salvar o arquivo

no micro (na pasta de sua preferência. Sugerimos que o arquivo seja salvo na raiz C://).

2. Descompactar/extrair o arquivo zipado.

3. Abrir a pasta criada após a extração (PLCotaUI-n.n.n, onde n.n.n representa o número

da versão do aplicativo) e em seguida abrir a pasta /bin.

Figura 1: pasta .../bin do aplicativo, com as quatro versões do aplicativo (Windows desktop e linha de

comando; outros sistemas operacionais, desktop e linha de comando).

4. Executar o arquivo PLCotaUI.bat. Caso o micro não apresente as extensões dos nomes

dos arquivos (.bat, no caso), verifique a coluna Tipo para identificar o arquivo correto

(arquivo em lotes do Windows, conforme tela acima). Será exibida a tela do aplicativo,

conforme abaixo:

http://www.galgosistemas.com.br/files/documento/documento/PLCotaUI.zip



16

Figura 2: tela do aplicativo, versão desktop

Caso a tela acima não seja exibida, clique aqui para efetuar os testes de pré-

requisitos.

5. Selecionar o Ambiente de Produção e preencher os campos obrigatórios: Usuário,

Senha, Salvar na pasta e Formato do arquivo (xml ou csv).



17

O usuário que pode ser utilizado no aplicativo é da categoria Sistema Externo (o

seu usuário e senha, caso você seja usuário do Sistema Galgo, não funciona no

aplicativo). Caso não possua informações deste usuário, entrar em contato com a

equipe de suporte da Galgo S.A. (clique aqui).

6. Preencher os demais campos da tela (filtros para a consulta), conforme opção desejada.

No quadro abaixo apresentamos o detalhamento de cada campo:

Campo Obrig* Observações

Ambiente S Indica se o consumo será efetuado no ambiente

de Produção ou de Homologação

Usuário S Identificação do Usuário Sistema Externo

Senha S Senha do Usuário Sistema Externo

Data Base da Informação N

Permite selecionar o período referente à data

base da informação que deseja consumir:

• Somente a data base inicial: sistema

apresentará todas as informações

disponíveis1 com data base igual à

informada e data final limitada a 120 dias

posteriores à Data Inicial.

• Somente a data base final: sistema

apresentará todas as informações

disponíveis com data base igual à informada

e anteriores, limitado a 120 dias passados.

• Data Base Inicial e Data Base Final,

podendo ser iguais: o sistema apresentará

todas as informações disponíveis com as

datas base compreendidas no período

informado.

1 As informações disponíveis dependem de: (i) envio efetuado pela Entidade Provedora; (ii)

compromisso formalizado para a mesma Entidade/Papel do usuário; (iii) fundo associado ao usuário



18


Data/Hora de Envio C

Permite selecionar o período de envio das

informações a serem consumidas. Podem ser

informadas:

• Data/Hora inicial: sistema apresentará

todas as informações enviadas (e

reenviadas) a partir da data/hora informada,

limitado a 120 dias posteriores à data Inicial.

• Data/Hora final de envio: sistema

apresentará todas as informações enviadas

(e reenviadas) na data informada e

anteriores, limitado a 120 dias passados.

O aplicativo possui controle automático do

período de envio. Clique aqui para saber como

esse controle funciona.

Status da Informação N

Permite selecionar o status da informação.

Opções: Enviada, Reenviada, Cancelada

Automaticamente, Cancelada Manualmente,

Rejeitada, Reenvio de Cota. A Entidade

Consumidora tem acesso somente às

informações Enviadas, Reenviadas ou Reenvio

de Cota. Os demais status estão disponíveis

somente para a Entidade Provedora.

Atuação no

Compromisso N

Permite selecionar a atuação da Entidade no

processo de transferência. Opções: Consumidor

ou Provedor. Aplicável somente para usuários

que possuem as permissões.

(diretamente ou através de um Grupo), se a Entidade Consumidora utiliza a Associação de Fundos como

complemento do controle de acesso.



19


Moeda N

Permite selecionar uma ou mais moedas,

relacionadas às informações divulgadas.

Opções: todas as moedas cadastradas

conforme Tabela ISO 4217. Se não selecionada

nenhuma moeda, serão exibidas informações

de todas as moedas.

Códigos STI dos Fundos

de Investimento N

Identificação dos fundos que o usuário deseja

consumir. Os códigos podem ser listados de

várias formas: separados por vírgula, separados

por espaço, copiar uma lista do Excel ou de

outro arquivo qualquer. Os códigos podem ser

informados apenas com números ou formatados

no padrão do Sistema Galgo. Exemplo: 012345-

6 ou 123456.

Clique aqui para saber como pesquisar os

códigos STI dos fundos.

Salvar na pasta S

Diretório em que o aplicativo salvará os arquivos

gerados. Utilize o botão para identificar o

caminho a ser utilizado.

[área de notificações do

aplicativo] - - -

Campo utilizado pelo aplicativo para apresentar

informações sobre a consulta realizada, como

por exemplo:

• Consulta com sucesso ou não

• Total de registros consultados

• Tempo de execução da consulta

• Mensagens de erro (se aplicável)



20


Formato do Arquivo S

Permite selecionar o formato do arquivo que

será gerado pelo sistema. Opções: XML (padrão

do Sistema Galgo), CSV (conversão pelo

aplicativo) ou XML/CSV** (gera os dois arquivos

para a mesma consulta).

* C = campo de preenchimento condicional (por exemplo, se preenchida Data Inicial de Envio, a Hora Inicial

de Envio é obrigatória); N = campo de preenchimento opcional; S= campo de preenchimento obrigatório.

** A seleção da opção XML/CSV resultará a geração de dois arquivos da mesma

consulta, um no formato XML e outro no formato CSV, com as mesmas informações.

Esta opção não é considerada uma consulta duplicada e não gera custo duplicado no

faturamento.

7. Clicar no botão para efetuar a consulta. O quadro entre os campos Salvar

na Pasta e Formato do Arquivo (em destaque na figura abaixo) apresentará informações

sobre a consulta realizada.

Figura 3: destaque para a Área de Notificações do Aplicativo

8. Se for informada uma pasta inexistente no campo Salvar na Pasta, o aplicativo criará a

pasta no diretório especificado.

9. É recomendável fechar o aplicativo após cada consulta, principalmente se o mesmo é

utilizado por mais de um usuário, devido controle do período de envio, conforme seção

seguinte.



21

SEÇÃO II – CONTROLE DO PERÍODO DE ENVIO

O aplicativo utiliza o filtro de Período de Envio de forma automática, conforme regras abaixo,

com o objetivo de facilitar o controle do consumo pelo usuário, minimizando o risco de

consumo de informações duplicadas, e respectivos impactos na tarifação da Entidade

Usuária.

O modelo de tarifação do Sistema Galgo, conforme Tabela de Tarifação, considera nas

tarifas variáveis o total de transações realizadas para cada serviço. O sistema não possui

controle para que o usuário não consuma informações duplicadas, o que pode ocorrer, de

acordo com os filtros que o usuário utilize no momento do consumo.

O controle automático do filtro Período de Envio disponível no aplicativo visa, conforme

descrito acima, minimizar o risco do consumo em duplicidade. Destacamos abaixo, alguns

pontos importantes:

a) Se o aplicativo será utilizado por mais de um usuário na Entidade (instalação em mais

de um micro), é necessário efetuar a configuração em rede para que o controle pelo

Período de Envio seja único entre os usuários.

b) Se o aplicativo será utilizado por mais de um usuário, para que a configuração em rede

tenha efeito, é necessário que após cada consulta realizada, o aplicativo seja fechado

e aberto novamente no momento da próxima consulta.

c) O aplicativo tem controle apenas sobre o filtro do Período de Envio. A Entidade Usuária

que utilizar outros filtros além do Período de Envio, deverá ter controle próprio sobre as

informações consumidas, para evitar o consumo em duplicidade.

O aplicativo apresenta o seguinte comportamento para os campos do Período de Envio:

• Se não informadas a Data Final e a Hora Final do Período de Envio, o aplicativo sempre

preencherá os campos com a data e hora da consulta menos dez minutos.

http://galgosistemas.com.br/Docs/Sistema%20Galgo_Tabela_Tarifacao.pdf

http://galgosistemas.com.br/Docs/Sistema%20Galgo_Tabela_Tarifacao.pdf



22

A hora final do Período de Envio, quando preenchida pelo aplicativo, sempre

considerará a hora atual menos 10 minutos para evitar que o envio e a consulta da

mesma informação, simultaneamente (pelas respectivas Entidades Usuárias) gere uma

perda de informação para a Entidade Consumidora.

• Sempre que uma consulta for efetuada, o aplicativo irá limpar o conteúdo dos campos

Data Final e Hora Final do Período de Envio, para que na próxima consulta sejam

utilizadas a data e hora atualizadas (data e hora da consulta menos dez minutos,

independente do usuário fechar ou não o aplicativo.

Seguem abaixo detalhes de como o aplicativo utiliza o período de envio:

• No primeiro consumo no equipamento do usuário:

✓ Data inicial: data do consumo

✓ Horário inicial: 00:00

✓ Data final: data do consumo

✓ Horário final: horário do consumo menos 10 minutos

• A partir do segundo consumo no equipamento do usuário:

✓ Data inicial: data do último consumo realizado

✓ Horário inicial: horário do último consumo realizado, acrescido de um minuto

✓ Data final: data do consumo

✓ Horário final: horário do consumo menos 10 minutos

Exemplo: usuário utilizou o aplicativo pela primeira vez no dia 30/03/2016, às 11:44h, efetuou

um segundo consumo às 14:17h e o próximo consumo ocorreu somente no dia seguinte, às

09:21h. Os valores utilizados pelo aplicativo foram:

Filtro 1º consumo 2º consumo 3º consumo

Data Inicial 30/03/2016 30/03/2016 30/03/2016

Horário Inicial 00:00:00 11:35:00 14:08:00



23

Filtro 1º consumo 2º consumo 3º consumo

Data Final 30/03/2016 30/03/2016 31/03/2016

Horário Final 11:34:59 14:07:59 09:11:59

A cada consumo que efetua, o usuário pode alterar quaisquer filtros da pesquisa, ou preencher

outros para serem utilizados em conjunto.

Para não utilizar o filtro de período de Envio, apagar a data inicial e a data final, o aplicativo

ocultará os campos de hora inicial e hora final, conforme figura abaixo:

Figura 4: tela do aplicativo, com Período de Envio em branco (campos de horas inicial e final não são exibidos).

Os filtros são atualizados de forma automática, após cada consulta realizada com

sucesso2, da seguinte forma:

a. A data/hora final de envio da consulta realizada com sucesso é atribuída aos campos

data/hora inicial de envio (acrescidos de um minuto) para a execução da próxima

consulta;

b. Os campos de data/hora final de envio ficam em branco para a execução da próxima

consulta;

2 A consulta é considera realizada com sucesso somente quando houver retorno de pelo menos uma

informação. Caso a consulta não retorne nenhuma informação ou ocorra algum erro, a data/hora inicial

de envio não será atualizada.



24

c. Se o usuário definir uma data/hora final de envio para execução da próxima consulta,

estes serão os valores considerados;

d. Se o usuário não definir uma data/hora final de envio, no momento da nova consulta (ao

clicar no botão ) o aplicativo preencherá automaticamente os campos

data/hora final de envio com a data/hora atual (do momento da consulta) menos 10

minutos.

e. Se a consulta não for concluída com sucesso, o aplicativo manterá os valores dos

campos data/hora inicial de envio e apagará os valores dos campos data/hora final de

envio, e a próxima consulta seguirá as regras dos itens c e d acima.

A atualização da Data/Hora inicial do período de envio sem que o aplicativo seja fechado

ocorre somente no micro do usuário que efetuou a consulta. Caso a Entidade tenha mais de

um usuário utilizando o aplicativo, com o arquivo de configurações em rede (conforme SEÇÃO

VI – INSTALAÇÃO NA REDE – VÁRIOS USUÁRIOS), a consulta pelo segundo usuário

utilizará a data e hora atualizada somente se o segundo usuário abrir o aplicativo após a

execução da consulta pelo primeiro usuário.

Se for preciso refazer o consumo de algum período anterior, o usuário pode verificar o

nome dos arquivos gerados pelo aplicativo, que apresentam a data/hora da execução do

consumo, permitindo identificar os intervalos de consumo realizados.

Vide exemplos nas telas seguintes:

Tela 1 Primeira utilização do aplicativo, com data inicial de envio igual à data da consulta,

hora inicial de envio igual a 00:00:00 e data final de envio em branco



25

Tela 2 Efetivação da consulta, com Data e Hora Final da consulta preenchidas pelo

aplicativo (data e hora do momento da consulta menos 10 minutos). No quadro de notificações



26

do aplicativo pode-se observar que a consulta foi concluída com sucesso (1 registro

retornado).



27

Tela 3 Atualização da tela após clicar no botão da mensagem de Operação

concluída (da tela acima): a Data e Hora Inicial passam a apresentar a Data e Hora final da

consulta efetivada anteriormente (tela 2) (acrescidos de um minuto) e a Data Final fica em

branco, até execução de nova consulta.



28

Tela 4 Execução de nova consulta, Data e Hora Inicial apresenta os valores da consulta

anterior.



29

Tela 5 Efetivação da consulta, com Data e Hora Final da consulta preenchidas pelo

aplicativo (data e hora do momento da consulta menos 10 minutos). No quadro de notificações

do aplicativo pode-se observar que a consulta foi concluída sem sucesso (nenhuma

informação retornada).



30

Tela 6 Atualização da tela após clicar no botão da mensagem de Operação

concluída (da tela acima): a Data e Hora Inicial não foram alteradas devido consulta não

retornar registros e a Data Final fica em branco, até execução de nova consulta.



31

SEÇÃO III – CONSULTA EFETUADA COM SUCESSO E ARQUIVOS GERADOS

Na conclusão do consumo efetuado com sucesso, será exibida a mensagem abaixo:

Figura 5a: exemplo de mensagem de consumo efetivada com sucesso.

Na parte inferior da tela do aplicativo, na caixa de mensagens, também serão apresentados

o status e outras informações de cada consumo, como por exemplo, o número de registros

retornados, conforme tela abaixo.

Figura 5b: exemplo de mensagem de consumo efetivada com sucesso.

Note que no exemplo acima, o aplicativo gerou dois arquivos devido filtro utilizado gerar

retorno de mais de 500 informações.

O limite de 500 informações por página da consulta pelo sistema é tratado de forma

automática pelo aplicativo. O usuário não precisa efetuar mais de uma consulta.



32

Caso o Sistema Galgo não retorne nenhuma informação, será apresentada a tela seguinte:

Figura 6: exemplo de mensagem de consumo efetivado com sucesso, sem nenhuma informação retornada.

Na parte inferior da tela do aplicativo, na caixa de mensagens, será exibida mensagem

correspondente.

Será gerado um arquivo, com todas as informações disponíveis, exceto se o consumo retornar

mais de 500 itens, nesse caso o aplicativo gerará mais de um arquivo. Os arquivos serão

gerados no formado indicado e salvos na pasta indicada.

Os arquivos gerados apresentam o seguinte padrão de identificação:

plcota_AAAAMMDD_HHMMSS _pag_NNNN.xml ou

plcota_AAAAMMDD_HHMMSS _pag_NNNN.csv (de acordo com o formato selecionado no

ato do consumo)

Onde:

• AAAAMMDD_HHMMSS corresponde à data/hora final do Período de Envio.

• pag_NNNN corresponde à sequência dos arquivos gerados, para uma consulta que

gerou mais de 500 registros no retorno.

SUBSEÇÃO I – DO ARQUIVO DE LOG

Todo consumo efetuado através do aplicativo gera um registro de log. Os arquivos de log são

salvos na pasta .../bin/log (conforme figura 1). O log permite que o usuário confirme detalhes

de alguma ocorrência, mesmo que o consumo tenha sido finalizado (o aplicativo encerrado).



33

O registro do log apresenta as seguintes informações:

• A versão do aplicativo.

• Informações do consumo executado: todos os campos preenchidos na tela do aplicativo

ou pela linha de comando.

• Mensagens da conclusão do consumo.

SEÇÃO IV – OCORRÊNCIAS NA CONSULTA

A consulta poderá não ser efetivada, caso alguma ocorrência seja verificada pelo sistema,

como no exemplo da tela abaixo.

Figura 7: exemplo de mensagem de consumo não efetivada por conta de ocorrência específica.

As seguintes situações de erro podem ocorrer no consumo, para as quais são exibidas as

respectivas mensagens:

1. Erro PC.0002: Erro Genérico. Este código ocorre para erros não esperados pelo

sistema. Verificar o detalhamento do erro no quadro de mensagens (parte inferior da

tela do aplicativo) e abrir um chamado no Service Desk (vide CAPÍTULO III –

INFORMAÇÕES DE SUPORTE).



34

2. Erro PC.0137: Lista vazia de resultados. Este erro ocorre quando não existem

informações para serem retornadas, devido ao filtro de busca realizado ou às

permissões do usuário que está realizando a consumo. As permissões aqui consideram:

existência de compromisso formalizado para a data base e moeda da informação

consumida, papel associado ao usuário igual ao papel do compromisso, fundo

associado ao usuário (ou ao grupo).

3. Erro PC.0237: O usuário não tem permissão de acesso. Caso seja apresentado este

código de erro, verificar:

✓ Se o login e a senha do usuário Sistema Externo estão corretos e se o usuário

possui a permissão de Consulta de PL/Cota.

✓ Se foi feita a troca da senha inicial do usuário Sistema Externo (senha expirada

enviada por e-mail no momento do cadastro do usuário), pelo usuário Master

responsável. Esta alteração deve ser feita no Portal do Sistema Galgo (pelo

navegador).

✓ Se o status do usuário Sistema Externo apresentado é “ativo”.



35

Caso o consumo seja efetuado em um equipamento em que não há conexão com o Sistema

Galgo (link dedicado ou VPN, ou o usuário não configurou o aplicativo para efetuar a conexão,

será exibida a mensagem:

Figura 8: exemplo de mensagem de erro devido falta de conexão com o Sistema Galgo.

Caso o usuário tenha informado os dados da VPN, mas o aplicativo não consiga estabelecer

uma conexão, será exibida a mensagem:

Figura 9: exemplo de mensagem de erro devido falta de conexão com o Sistema Galgo.



36

SEÇÃO V – DA INTERFACE POR LINHA DE COMANDO – CLI

A execução do aplicativo por linha de comando no prompt tem o objetivo de oferecer à

Entidade Usuária uma opção à execução pela interface visual, possibilitando a automação da

realização do consumo pela Entidade. Para efetuar o consumo, os mesmos campos

apresentados na tela do aplicativo (tanto os obrigatórios como os opcionais) e seus valores

correspondentes, devem ser informados na linha de comando, conforme tabela abaixo:

Campo Obrig Observações

-amb S Indica se a consulta será efetuada no ambiente de

Produção (P) ou de Homologação (H).

-login S Identificação do Usuário Sistema Externo.

-senha S Senha do Usuário Sistema Externo.

-dtBaseInicial N

Data Base da Informação – data inicial, para consulta

por período da data da informação. Utilizar o formato

yyyy-MM-dd.

-dtBaseFinal N

Data Base da Informação – data final, para consulta por

período da data da informação. Utilizar o formato yyyy-

MM-dd.

-dtTmEnvioInicial N

Data/Hora de Envio – Inicial, para consulta por período

de envio da informação. Utilizar o formato yyyy-MM-

ddThh:mm:ss.

-dtTmEnvioFinal N

Data/Hora de Envio – Final, para consulta por período

de envio da informação. Utilizar o formato yyyy-MM-

ddThh:mm:ss.



37


-statusInfo N

Status da Informação. Opções: 0 – Todas; 1 – Enviada;

2 – Reenviada; 3 – Cancelada Manualmente; 4 –

Cancelada Automaticamente; 5 – Rejeitada; 6 – Reenvio

de Cota.

Para usuários que atuam como Consumidores, estão

disponíveis somente as opções 0, 1, 2 e 6. Para usuários

que atuam como Provedores, todas as opções estão

disponíveis.

Se não informado, assume valor default 0.

-atua N

Atuação no Compromisso. Opções: C – Consumidor e P

– Provedor.

Se não informado, assume valor default C.

-moedas N

Moeda base da informação. Opções: todas as moedas

cadastradas na norma ISO 4217. Permite seleção

múltipla. Se não selecionada nenhuma moeda, serão

exibidas informações de quaisquer moedas.

-codSTI N

Lista de códigos STI dos fundos para serem consumidas

informações.

Se não informado, o sistema retornará as informações

de todos os fundos que o usuário tem acesso,

considerando-se os demais filtros informados.

-folder S

Diretório em que o aplicativo salvará os arquivos

gerados, onde as barras de separação devem ser

invertidas. Exemplo: a pasta c:\user\temp deve ser

digitada como c:/user/temp.

Se o caminho possuir brancos, utilize aspas para

delimitá-lo. Exemplo: “c:/user/my folder/plcota”.



38


-fileType N

Formato do arquivo a ser gerado pelo aplicativo.

Opções: CSV e XML.

Se não informado, assume o valor default XML.

-qtMax N

Quantidade máxima de registros por consulta. Valor

máximo = 500. Se o consumo retornar mais de qtMax

registros, o mesmo será paginado, gerando mais de um

arquivo de retorno.

Se não informado, assume valor máximo acima (500),

que retorna sempre o número máximo de registros por

arquivo gerado.

-vpnNome N

Nome da VPN configurada para acesso ao Sistema

Galgo.

Preencher somente se optar pela ativação da conexão

pelo aplicativo.

-vpnLogin N

Nome do Usuário de acesso à VPN configurada.


pelo aplicativo.

-vpnSenha N

Senha do Usuário de acesso à VPN configurada.


pelo aplicativo.

Observação: a execução do comando plcota --help executado na tela do prompt (no diretório onde está

salvo o aplicativo) apresenta como resultado a relação dos atributos com opções de preenchimento

para execução do aplicativo.

O controle de consumo pelo período de envio das informações, utilizado na interface

visual, conforme descrito na SEÇÃO II – CONTROLE DO PERÍODO DE ENVIO não é

aplicável na interface de linha de comando, onde todos os filtros devem ser preenchidos de

acordo com as opções e controles do usuário. O usuário deve utilizar os filtros de forma a

evitar o consumo em duplicidade, para não ter impactos na tarifação.



39

O exemplo abaixo pode ser utilizado para executar o aplicativo, uma vez que as informações

dos atributos sejam alteradas para dados reais de sua entidade. Não foram considerados

todos os atributos.

Z:\bin\plcota -amb H -login SISTEMAEXTERNO1.ENTIDADE1 -senha Senha001 -dtTmEnvioInicial

2016-04-07T15:00:00 -folder C:\\Users\\public\\plcota -moedas BRL,USD -fileType CSV -vpnNome

"NOME DA VPN" -vpnLogin LOGIN_VPN -vpnSenha SENHA_VPN

Destacamos alguns pontos sobre a utilização da interface por linha de comando:

• Se for informada uma lista de códigos STI dos fundos, esta deve estar entre aspas

(“...”).

• O caminho da pasta onde o aplicativo salvará os arquivos deve estar entre aspas (“...”).

O padrão do separador do caminho a ser utilizado é a barra simples (/) ou a barra dupla (\\)

inversa.

• Os atributos referentes à VPN (os últimos três, no exemplo acima) devem ser

informados somente se for para o aplicativo efetuar a ativação da conexão no momento do

consumo.

SEÇÃO VI – INSTALAÇÃO NA REDE – VÁRIOS USUÁRIOS

A Entidade pode optar pela instalação do aplicativo num ambiente de rede, para que mais de

um usuário possa utilizar o aplicativo, com a facilidade do controle do consumo e das

informações previamente preenchidas.



40

Esta facilidade considera a utilização de um único login/senha para acesso ao sistema.

Se a Entidade Usuária considerar que cada usuário do aplicativo deverá ter suas próprias

informações para acesso, deverá ser criado um Usuário Sistema Externo para cada usuário

que irá fazer a consulta.

A utilização por vários usuários, cada qual com suas credenciais, implica na alteração

frequente do arquivo de configurações. Neste caso, as facilidades do aplicativo em salvar

configurações da última consulta realizada podem não ser efetivas.

Para que isso seja possível, além de efetuar a instalação numa pasta da rede, ao invés de

numa pasta local (item 1 da SEÇÃO I – INÍCIO RÁPIDO), é necessário efetuar a configuração

para que o arquivo de propriedades seja salvo na rede também.

Ao executar o aplicativo pela primeira vez, é criada uma subpasta na pasta principal do usuário

do equipamento, onde é salvo o arquivo de propriedades, conforme figura abaixo:

Figura 10: pasta criada na primeira execução do aplicativo, com o arquivo de propriedades

Para configurar o arquivo de propriedades para uso na rede, execute os seguintes passos:



41

1. Executar o aplicativo a partir do micro onde foi efetuada a instalação (descompactação

do arquivo na pasta da rede), e clicar no botão configurações ( ). Será exibida a tela

abaixo:

Figura 11: exibição do menu de configurações do aplicativo.

2. Selecionar a opção Alterar pasta do arquivo de configuração. Será exibida a seguinte

tela:

Figura 12: tela de configuração do diretório padrão do arquivo de configurações.

3. Selecionar o novo diretório (na rede) através do botão e clicar em . A

partir dessa alteração, outros usuários podem acessar o aplicativo, usando a mesma

configuração.

O aplicativo não controla acessos simultâneos. Se outro usuário alterar

novamente a configuração do arquivo de propriedades, afetará todos os usuários. Se o



42

arquivo de propriedade não estiver na rede, cada usuário que executar o aplicativo terá

um arquivo de propriedades salvo no próprio micro.

SEÇÃO VII – CONEXÃO AUTOMÁTICA DA VPN

As instituições que utilizam a conexão por VPN podem utilizar este aplicativo para ativar a

conexão, bem como finalizá-la após o uso (desde que a mesma já esteja configurada no

equipamento onde será executado o aplicativo), propiciando uma facilidade e melhor controle

do tempo de conexão da VPN para a Entidade. Para ativar e desativar a conexão da VPN

pelo aplicativo, os seguintes passos devem ser seguidos:

1. Uso da interface visual (aplicativo do desktop):

a. Ao abrir o aplicativo, clicar no botão de configurações ( ) e selecionar a opção

Configurar VPN.

Figura 13: exibição do menu de configurações do aplicativo.

b. Preencher os campos referentes à VPN, exibidos na tela, conforme segue:



43

Figura 14: tela de configuração dos dados da VPN para ativação e desativação automáticas pelo Aplicativo.


O aplicativo deve controlar

a VPN N

Definir o aplicativo para efetuar a conexão

automática da VPN durante período do

consumo.

Nome da VPN C

Identificação da VPN, conforme cadastro

efetuado pela Entidade Usuária.

Obrigatório se selecionada a opção acima.

Usuário da VPN C

Identificação do Usuário de acesso à VPN.

Obrigatório se selecionada a opção do

aplicativo controlar a VPN.

Senha do Usuário da VPN C

Senha do Usuário de acesso à VPN.

Obrigatório se selecionada a opção do

aplicativo controlar a VPN.

c. Clicar em para concluir a configuração.



44

As informações de configuração da VPN são gravadas no arquivo de

propriedades. A senha é gravada criptografada.

O controle da VPN pelo aplicativo implica na ativação e desativação da mesma, a

cada consumo efetuado (veja detalhes das regras de ativação da VPN em SEÇÃO IV –

REGRAS PARA CONEXÃO AUTOMÁTICA DA VPN).

2. Uso da interface por linha de comando: a identificação da VPN, bem como do usuário e

sua senha devem ser informadas nas próprias linhas de comando (conforme SEÇÃO V – DA

INTERFACE POR LINHA DE COMANDO – CLI).

CAPÍTULO II – INFORMAÇÕES COMPLEMENTARES DO USO DO

APLICATIVO

SEÇÃO I – CONTEÚDO DO APLICATIVO

O aplicativo disponibilizado contempla quatro versões para execução, considerando a opção

pela forma de execução e o sistema operacional de seu equipamento:

• Interface Visual (UI)

✓ Windows: executar o arquivo:

PLCotaUI-<Versão_Do_App>\bin\PLCotaUI.bat

✓ Linux/UNIX: executar o arquivo:

PLCotaUI-<Versão_Do_App>/bin/PLCotaUI

• Linha de Comando (CLI)

✓ Windows: executar o arquivo:



45

PLCotaUI-<Versão_Do_App>\bin\PLCota.bat

✓ Linux/UNIX: executar o arquivo:

PLCotaUI-<Versão_Do_App>/bin/PLCota

(Onde PLCotaUI-<Versão_Do_App> é a pasta criada na descompactação efetuada, caso o

endereço não tenha sido alterado).

O aplicativo grava parte das informações preenchidas no formulário para facilitar a

próxima utilização. Essas informações são gravadas em um arquivo de configurações, criado

pelo aplicativo no momento da instalação. A cada nova execução do aplicativo, o arquivo é

atualizado com os dados desta execução. As credenciais de acesso também são gravadas.

A senha é criptografada.

SEÇÃO II – DO CONTROLE DAS INFORMAÇÕES CONSUMIDAS

As informações disponibilizadas no consumo podem não corresponder à lista esperada pelo

usuário, sendo vários os motivos ou ocorrências possíveis, bem como as ações que podem

ser tomadas:

• Filtros utilizados limitaram informações disponíveis: rever os filtros preenchidos e ajustá-

los, caso necessário

• Código de Fundo informado inválido: rever códigos informados (Clique aqui para saber

como consultar o Código STI dos fundos)

• Compromisso não formalizado: acessar o menu Compromissos ➔ Consulta ➔ Busca

Avançada e preencher os campos para confirmar a existência dos compromissos para os

fundos que deseja consultar informações



46

• Fundo não associado ao Usuário: solicitar ao Usuário Master da Entidade a confirmação

de que os fundos dos quais deseja consultar as informações estão associados ao Usuário

utilizado no aplicativo.

• Provedor não enviou a informação para a data: consultar o Painel de Compromissos

para verificar se as informações estão pendentes, conforme os passos seguintes:

• Selecionar o menu Compromissos ➔ Painel de Compromissos

• Selecionar a opção , selecionar a

opção PL/Cota no campo Serviço e clicar em . O sistema exibirá a seguinte

tela:

Figura 15: Painel de Compromissos com visão Consumidor para o Serviço PL/Cota.

• Os status Concluído no Prazo e Concluído com Atraso representam informações

enviadas na data do consumo, dentro do horário previsto ou após o horário previsto,



47

respectivamente. Considera também envios previstos para dias anteriores, cumpridos

somente na data do consumo.

• Os status Em Aberto no Prazo, A Vencer e Vencidos do Dia representam

informações com envio previsto para a data do consumo (que não necessariamente

corresponde à data base da informação), ainda não enviados pelos Provedores.

• O status Vencidos dos Dias Anteriores representa informações com envio previsto

para dias anteriores ao dia do consumo, ainda pendentes de envio pelos Provedores.

• Ao selecionar um dos status apresentados (com quantidade ou % maior que zero),

é exibida uma nova tela com gráficos por tempo no status ou por serviço (nesse caso

apresentará um único, devido filtro selecionado no passo inicial desta consulta).

Figura 16: segunda tela do Painel de Compromissos com os gráficos por tempo e por serviço.

• Ao selecionar o gráfico relativo ao Serviço será apresentada a tela com a lista de

fundos com envio de informações pendentes, conforme segue:



48

Figura 17: terceira tela do Painel, com a lista de informações que compõem o status selecionado.

• Nessa tela é possível identificar a(s) Entidade(s) Provedora(s), as datas base das

informações e os fundos com informações pendentes (considerando que tenha sido

selecionado um status com informações pendentes).

SUBSEÇÃO I – DOS REENVIOS DE INFORMAÇÕES

Além das ocorrências indicadas anteriormente, podem ocorrer reenvios de informações pelos

provedores. As ocorrências de reenvios podem ser acompanhadas pelo Painel de

Compromissos, conforme passos descritos acima, selecionando o status Reenviados para

acessar a lista de fundos com reenvios efetuados na data.

A partir da lista de informações reenviadas, um novo consumo pode ser efetuado, a fim de

receber as informações atualizadas.

SEÇÃO III – CONSULTA DE CÓDIGOS STI DOS FUNDOS

Para consultar os códigos STI dos fundos que deseja consumir as informações de PL/Cota,

usando o campo Código STI dos Fundos de Investimento como filtro, considere uma das três

opções abaixo:

• Opção 1 – lista de fundos com Compromissos Formalizados:



49

✓ Selecionar o menu Compromissos ➔ Relatórios ➔ Consulta.

✓ Preencher os campos conforme exemplo abaixo e clicar no botão para

a gerar o relatório.

Figura 18: tela da consulta do relatório de compromissos no Sistema Galgo.

✓ Selecionar a opção “Abrir com o” para abrir o relatório com a lista de

Compromissos formalizados, onde poderá ser verificado o Código STI dos fundos

(coluna H do arquivo exibido).

• Opção 2 – consulta da lista geral de fundos que a Entidade Usuária tem acesso:

✓ Selecionar o menu Fundos de Investimento ➔ Consulta.

✓ Clicar no botão para que o sistema exiba a lista de fundos

relacionadas com a Entidade Usuária.



50

✓ Identificar o(s) Código(s) STI do(s) fundo(s) desejado(s).

Figura 19: tela da consulta de fundos no Sistema Galgo.

• Opção 3 – consulta de fundos específicos:

✓ Selecionar o menu Fundos de Investimento ➔ Consulta.



51

✓ Clicar no botão (ao lado do campo “Fundos de Investimento /...” para que o

sistema exiba a tela de filtro de busca.

✓ Preencher o campo do filtro de busca com a informação do fundo e clicar no botão

no final da tela.



52

Figura 20: tela do filtro de busca para consulta de fundos específicos.

✓ O sistema exibirá a lista de fundos que correspondem ao filtro de busca informado.



53

✓ Identificar o(s) Código(s) STI do(s) fundo(s) desejado(s).

SEÇÃO IV – REGRAS PARA CONEXÃO AUTOMÁTICA DA VPN

A conexão automática da VPN ocorrerá de acordo com as seguintes regras:

1. Se os dados da VPN não forem inclusos no arquivo config.properties ou não forem

informados nas linhas de comando, o aplicativo não tentará ativar a conexão VPN.

2. Se os dados da VPN estiverem incorretos, a ativação da conexão não ocorrerá e o

aplicativo apresentará mensagem de erro correspondente (vide SEÇÃO IV – OCORRÊNCIAS

NA CONSULTA).

3. Se a VPN já estiver com a conexão ativa (conexão ativada manualmente por um usuário

da Entidade antes de abrir o aplicativo), o aplicativo não alterará essa conexão, ou seja,

mesmo após a execução do aplicativo a VPN continuará ativa.

4. Se os dados constantes nas linhas de comando ou no arquivo config.properties

estiverem corretos e a VPN estiver desativada no momento da execução do aplicativo, este

ativará e desativará a conexão com a VPN na execução do consumo. A desativação ocorre

no final do consumo, independente do usuário fechar ou não o aplicativo.

CAPÍTULO III – INFORMAÇÕES DE SUPORTE

As informações contidas neste capítulo são direcionadas à Entidade Usuária que não tenha

conseguido utilizar o aplicativo seguindo os passos iniciais.

A verificação dos requisitos ou a realização dos testes prévios podem requerer a participação

de um representante técnico de sua instituição, caso as regras de segurança limitem os

acessos dos usuários em algumas atividades no micro.



54

Para esclarecimentos sobre os requisitos, problemas na instalação ou nos testes, entre em

contato com a equipe da Galgo S.A., conforme canais abaixo:

• (11) 3036-2505

• (11) 3036-2506

• [email protected]

SEÇÃO I – REQUISITOS PARA A UTILIZAÇÃO

SUBSEÇÃO I – REQUISITOS DE CONEXÃO

O Sistema Galgo é acessado somente através de link privado. A Entidade Usuária pode optar

por um link dedicado ou por uma conexão através de uma VPN. Para utilizar o aplicativo, é

necessário confirmar se o equipamento onde o mesmo será executado tem acesso ao

sistema. Para isso, deve-se executar os seguintes passos:

1. Ativar o prompt (cmd): abrir o menu Iniciar do Windows, digitar CMD no campo de

pesquisa e executar o aplicativo apresentado

Figura 21: comando para abrir o prompt.

2. Na tela do prompt, executar o comando telnet ws.producao.sistemagalgo 7843. O

resultado positivo será a exibição de uma tela sem nenhuma descrição.

mailto:[email protected]



55

Figura 22: teste de conexão com o servidor do Sistema Galgo.

Figura 23: resultado positivo do teste de conexão com o servidor do Sistema Galgo.

3. Em caso de resultado negativo, executar um dos dois comandos pelo prompt:

tracert ws.producao.sistemagalgo (ou)

ping ws.producao.sistemagalgo

Estes testes devem exibir como resposta positiva o número do IP em destaque nas

figuras abaixo.



56

Figura 24a: resultado positivo do teste de reconhecimento de IP do Sistema Galgo.

Figura 24b: resultado positivo do teste de reconhecimento de IP do Sistema Galgo.

Casos os testes acima não apresentem o resultado positivo, favor entrar em contato com a

equipe de suporte da Galgo S.A. (clique aqui).

SUBSEÇÃO II – USUÁRIO E PERMISSÕES

Para utilizar este aplicativo, é necessário que a Entidade tenha criado um usuário da categoria

Sistema Externo. Para a criação do usuário, destacamos alguns pontos:

• Devem ser associados todos os Papéis da Entidade ao Usuário Sistema Externo

• Devem ser associadas, pelo menos, as permissões relacionadas ao aplicativo (PL/Cota

➔ Consulta)



57

• O usuário deve ser associado a todos os fundos dos quais serão consultadas as

informações. A associação pode ser diretamente aos fundos ou ao Grupo de Fundos (pode

ser utilizado o mesmo grupo de fundos que os demais usuários já estão associados, por

exemplo).

Lembramos que o Usuário Master Entidade é responsável pela gestão do Usuário

Sistema Externo.

A não associação dos fundos ao usuário (diretamente ou através de um grupo), implica

na indisponibilidade da informação no momento da consulta.

Caso seja necessário apoio para efetuar as etapas acima, favor entrar em contato com a

equipe de suporte da Galgo S.A.

SUBSEÇÃO III – COMPROMISSOS

O consumo de informações do Sistema Galgo é efetuado somente se existir ao menos um

Compromisso formalizado correspondente ao fundo, Serviço, data base e Papel da Entidade

Consumidora.

A Entidade Consumidora deverá solicitar os Compromissos para o Serviço PL/Cota dos

fundos que desejar consumir informações, para que as contrapartes recebam as solicitações,

avaliem, aprovem e façam o envio das informações previstas.

A solicitação de Compromissos é efetuada pelo Usuário Final da Entidade. Além da solicitação

do compromisso, o Usuário Final da Entidade também deve solicitar ao Usuário Master da

Entidade que atualize a lista de fundos associados (vide SUBSEÇÃO II – USUÁRIO E

PERMISSÕES).



58

Caso o usuário identifique que não recebeu uma informação esperada, deverá verificar

se os requisitos acima descritos foram atendidos. Após regularização, o consumo poderá ser

refeito.

SEÇÃO II – VALIDAÇÃO DA VERSÃO DO JAVA

O aplicativo foi desenvolvido em Java, e consequentemente, depende de que o micro onde

será executado o aplicativo tenha o Java instalado na versão 8 ou superior.

Se a versão instalada não corresponder à versão 8 (ou superior), será apresentada a tela

abaixo:

Figura 25: tela de prompt de comando por erro na execução do aplicativo – divergência na versão do Java.

Para saber qual versão do Java está instalada, deve-se executar nesta mesma tela a seguinte

linha de comando java-version.



59

Figura 26: tela de prompt de comando com o resultado do comando java-version.

Caso a versão seja a 8 e o erro persista, é necessário verificar se está ocorrendo conflito de

versão entre o Java instalado e o que foi utilizado para executar o aplicativo. Para isto, deve-

se verificar se a variável de ambiente JAVA_HOME está definida no equipamento e está

apontando para a versão 8 do Java, executando o seguinte comando

"%JAVA_HOME%"\bin\java -version (as aspas envolvendo %JAVA_HOME%, são

necessárias caso JAVA_HOME esteja apontando para um caminho que contenha espaços).

Figura 27: tela do prompt de comando com o resultado do comando "%JAVA_HOME%"\bin\java -version.

Caso esteja apontando para outra versão, executar os seguintes passos para reconfigurar

JAVA_HOME:

1. Clicar com o botão direito do mouse em Computador –> Propriedades. Será

apresentada a seguinte janela:



60

Figura 28: tela propriedades do computador.

2. Clicar na opção Configurações avançadas do sistema. Será apresentada a tela

abaixo:



61

Figura 29: tela propriedades do sistema.

Observações: para acessar a tela acima no Windows 10, seguir os seguintes passos:

• Acessar a opção Configurações no menu Iniciar

• Selecionar a opção Sistemas

• Selecionar a opção Sobre

• Selecionar Informações do Sistema no grupo Configurações Relacionadas

• Clicar em Configurações Avançadas

Vide sequência de telas abaixo:



62

3. Clicar em Variáveis de Ambiente. Será apresentada a janela com todas as variáveis

do sistema:



63

Figura 30: tela variáveis de ambiente.

4. Selecionar a variável JAVA_HOME nas Variáveis do Usuário ou nas Variáveis do

Sistema e clicar no botão Editar.

Figura 31: tela de edição de variável de ambiente.



64

5. No campo Valor da variável, preencher com o caminho completo até a pasta home da

versão do Java 8 (ex. C:\Program Files\Java\jre1.8.0_66) e clicar em para

atualizar a variável. A pasta home do Java é a que contém a instalação do Java (geralmente

pastas dentro de C:\Program Files\Java ou C:\Program Files (x86)\Java). Por exemplo:

6. Para verificar a configuração efetuada, clicar no menu Iniciar, na caixa de pesquisa,

digitar cmd, na lista de resultados, clicar duas vezes em cmd e digitar

"%JAVA_HOME%"\bin\java -version.

7. No resultado deste comando o sistema deve apontar para a versão Java 8 conforme

tela abaixo:

Figura 32: tela do prompt de comando com resultado da versão.



65

SEÇÃO III – VALIDAÇÃO DA CONEXÃO COM O SERVIDOR DE WEB SERVICE DO

SISTEMA GALGO

Para verificar se o micro onde será utilizado o aplicativo possui acesso servidor de Web

Service do Sistema Galgo, execute os seguintes passos:

• Abrir o navegador.

• Copiar o link abaixo e colar no navegador:

https://ws.producao.sistemagalgo:7843/ServicePLCota?wsdl

Será exibido um arquivo xml conforme imagem parcial abaixo:

Figura 33: resultado positivo do teste de conexão com o servidor do Sistema Galgo

• Caso negativo, é necessário o suporte da área de TI para verificar as conexões de rede.

https://ws.producao.sistemagalgo:7843/ServicePLCota?

Documents

Sistema Galgo - Guia do Aplicativo – Consumir PL/Cota · Sistema Galgo. GUIA DO USUÁRIO: significa o conjunto de documentos elaborado pela Galgo S.A. com a finalidade de orientar