Portfólio

Portfolio é a entidade destinada a armazenar todas as informações transacionais no Gorila. Essas informações podem ser inseridas via API ou pelo front-end, ou ainda calculadas e geradas pelo próprio motor do Gorila.

O portfolioId é o identificador único de cada portfólio. Os portfólios podem receber apelidos (ou IDs de controle) para facilitar o acompanhamento dos portfólios criados.

Status do portfólio

O status do portfólio indica o estado atual do processamento das transações que compõem o portfólio. Ele é definido como PROCESSING quando uma ou mais transações dentro do portfólio ainda estão em fase de cálculo e validação. Durante este estágio, o motor do Gorila está realizando todos os cálculos e verificações necessários para garantir que as transações sejam refletidas corretamente no portfólio. Uma vez que todas as transações no portfólio atingem o status COMPLETED, o status do portfólio também muda para COMPLETED, indicando que todas as transações foram totalmente processadas e integradas ao portfólio de forma precisa. Esse processo de atualização do status assegura que o portfólio esteja sempre consistente e atualizado, refletindo corretamente todas as operações realizadas.

Componentes de caixa e provisões

O motor de cálculo do Gorila sempre leva em consideração os componentes de caixa e as provisões da conta em seus cálculos, a fim de produzir resultados consistentes.

No entanto, nem todos os componentes de caixa são iguais. Abaixo vamos explicar as diferenças entre eles.

• Fluxo de caixa do ativo

  Este tipo de componente de caixa é gerado automaticamente pelo nosso motor e faz parte da modelagem do ativo. Um exemplo seria uma ação que paga dividendos; na data em que a ação fica ex-dividendo, é criada uma provisão de crédito, e no dia em que a empresa liquida esse dividendo, essa provisão se torna um saldo de caixa. Este é um exemplo simples, mas válido para qualquer ativo de qualquer classe de ativos em qualquer moeda.

• Aportes e resgates

  Este componente de caixa está relacionado ao dinheiro que entra e sai de um determinado portfólio. Usando a analogia de um fundo, é o dinheiro que um investidor aporta/deposita no fundo quando deseja investir ou o dinheiro que um investidor resgata/saca de um fundo quando deseja desinvestir.

  Nem sempre as informações sobre este componente de caixa estão disponíveis, são de fácil acesso, ou são precisas e identificáveis. Muitas vezes estão misturadas com outros componentes de caixa. Dada a baixa disponibilidade e qualidade dessas informações no mercado, criamos uma propriedade autoRnC que permite definir os aportes e resgates como manuais ou automáticos.

  Aportes e resgates manuais (autoRnC = False)

  Esta é a opção padrão, o que significa que o usuário precisa fornecer todas as informações relacionadas aos aportes e resgates de cada portfólio, portanto, o usuário precisa de informações precisas para que possamos produzir resultados consistentes.

  Aportes e resgates automáticos (autoRnC = True)

  Esta é a opção usada por usuários que não têm informações precisas sobre os aportes e resgates. O que esta opção faz é manter o impacto de caixa de uma determinada transação em 0. Por exemplo, suponha que o usuário compre um ativo no valor de R$ 100.000,00 que seja liquidado em d+2. Nesse caso, nosso motor gerará automaticamente uma contribuição de caixa em d+2 que será usada para liquidar a transação, mantendo o impacto de caixa dessa transação em 0.

  Vale notar que o parâmetro autoRnC não impacta o que acontece com o fluxo de caixa do ativo, em ambos os casos vamos sempre gerar automaticamente todo o fluxo de caixa "endógeno" do ativo.

Come-cotas automático

É possível também criar portfólios onde não há necessidade de inserir manualmente informação de come-cotas para fundos que se encaixam nessa tributação. Ao criar um portfólio, é possível usar o parâmetro autoComeCotas com o valor true e toda vez que uma transação de um fundo elegível for inserida no passado, todos os come-cotas serão calculados e registrados no portfólio. Quando chega o último dia útil do semestre do come-cotas (nos meses de maio e novembro), é criado automaticamente um come-cotas. Mesmo com esse parâmetro ligado, se um come-cotas for cadastrado manualmente num determinado semestre, o lançamento manual vai prevalecer sobre o automático se cadastrado na data correta (último dia útil de maio e novembro).

Perfil de investimento

Cada portfólio pode estar associado a um Perfil de Investimento, uma alocação-alvo usada para medir o enquadramento da carteira. A associação é feita pelo campo investmentProfileId na atualização do portfólio, e o perfil associado é retornado no campo investmentProfile.

Propriedades restritas ao GorilaVIEW

Existem propriedades de um portfólio que são importantes devido à sua relação com o GorilaVIEW.

Alias

No GorilaVIEW é possível "apelidar" um portfólio compartilhado. Por exemplo, se um usuário compartilha um portfólio chamado "Portfólio do José" e sua organização nomeia portfólios a partir de códigos ou outra identificação interna, é possível sobrescrever o nome desse portfólio. Na verdade, o que ocorre é que a propriedade alias é preenchida. Use essa propriedade para mudar como o nome aparece dentro do GorilaVIEW e também se deseja ter um registro próprio de nomenclatura.

Portfólio conectado e Exclusão de portfólios conectados

Através da funcionalidade de compartilhamento de portfólio no GorilaVIEW, um portfólio que pertence a outro usuário pode constar na Organização para a qual ele foi conectado ou compartilhado. É isso que determina a propriedade connected do portfólio. Porém, o proprietário (OWNER) desse portfólio não é sua Organização. Sua organização (a que recebeu o compartilhamento) tem permissão de EDITOR relativa a esse portfólio e, portanto, não pode excluir o portfólio.

Para remover o portfólio da sua organização é necessário cancelar o compartilhamento através do acesso no GorilaVIEW. Apenas usuários permissionados e administradores da Organização podem fazer isso.

Onde acessar

No GorilaCORE, você pode criar, listar, consultar, atualizar e excluir portfólios. A listagem permite buscar portfólios por nome e filtrar pela data de criação.