Pular para o conteúdo

Data Foundation: o Common Finance Model

O Data Foundation é a base de dados financeiros dos seus projetos do PlaidCloud. Seu Common Finance Model reúne dados de ERP de vários sistemas ERP, e de várias instâncias de cada um, em um único modelo: um plano de contas, um conjunto de entidades e uma moeda de relatório. Relatórios, métricas e assistentes de IA criados sobre o modelo leem os mesmos números, seja qual for o ERP de origem.

Seu ERP se conecta por meio da conexão do PlaidCloud, então o razão geral, o balancete, os dados mestres e os orçamentos chegam diretamente da origem, sem nada para exportar. Os arquivos acrescentam dados que um sistema não contém, como taxas de câmbio, direcionadores de alocação ou um orçamento mantido fora do ERP, e podem substituir as linhas do ERP que cobrem. Carregar adapta cada origem ao modelo, converte para a moeda de relatório e verifica se tudo fecha, tudo isso na guia Foundation do projeto. Os modelos, como o Enterprise Profitability, criam seus relatórios e modelos sobre essa base.

Sistemas e instâncias de ERPERP A, instância 1ERP A, instância 2ERP BArquivos: taxas, direcionadoresCommon Finance ModelUm plano de contasUm conjunto de entidadesUma moeda de relatórioCarregado e verificado na guia FoundationRelatóriosMétricasAssistentes de IA
Todo sistema ERP e toda instância chegam a um único modelo, de modo que todo relatório, métrica e resposta de IA leem os mesmos números.

Seu ERP se conecta ao Data Foundation por meio da conexão do PlaidCloud. O Data Foundation lê dela o razão geral, o balancete, os dados mestres, as taxas de câmbio e os orçamentos, e somente lê. Você pode escolher uma conexão existente ou criar uma na guia; os guias de conexão cobrem a configuração de acesso de cada ERP.

  1. No Analyze, abra Projetos e clique em Novo projeto. Informe um nome e, em Começar de, escolha um modelo, como Enterprise Profitability (modelo), em vez de Projeto em branco. Clique em Criar.

    O projeto abre na guia Foundation. Ele é privado para você, e você é o único Arquiteto dele, até compartilhá-lo.

  2. Na guia Foundation, escolha uma conexão existente para o seu ERP ou selecione Criar uma nova conexão. Cada conexão existente lista os fluxos de trabalho que já a usam ou informa Ainda não usado por nenhum workflow.

  3. Para uma nova conexão, informe um Nome da conexão, escolha o Ambiente e preencha as credenciais que a conexão do seu ERP solicita.

    Ainda não tem as credenciais? O formulário mostra uma solicitação de acesso pronta para o administrador do seu ERP. Clique em Copiar solicitação ou Enviar solicitação por e-mail, envie-a e informe os valores que ele devolver.

  4. Clique em Testar conexão. O PlaidCloud faz login e tenta ler cada dataset, depois lista cada um como Legível, Permissão ausente ou Erro. Quando algo estiver faltando, ele indica as permissões que você deve pedir ao administrador do ERP para adicionar.

  5. Defina Meses de histórico: quantos meses para trás carregar, de 1 a 120. O padrão é 24.

  6. Para uma conexão existente, marque as entidades a carregar ou deixe todas desmarcadas para carregar todas as entidades. As entidades inativas e de eliminação ficam ocultas até você optar por exibi-las. Em seguida, clique em Conectar.

  7. Para uma nova conexão, clique em Conectar para criá-la. Depois, marque as entidades a carregar e clique em Conectar novamente para salvá-las. Até que você faça isso, todas as entidades são carregadas.

Depois de conectado, o cartão informa qual conexão, ambiente, entidades e meses de histórico o projeto carrega.

Cada carga lê apenas o que mudou: os períodos abertos e o último período fechado são lidos novamente, e os períodos fechados já carregados são mantidos. Aumentar Meses de histórico lê apenas os meses acrescentados. Uma taxa de câmbio, um mapeamento de entidades ou uma moeda de relatório alterados leem novamente os meses que afetam.

Os arquivos complementam a conexão do seu ERP com dados que um sistema não contém, como taxas de câmbio, direcionadores de alocação, um Mapeamento de entidades ou um orçamento mantido fora do ERP. Cada arquivo pertence a um dos datasets listados em Tabelas do Common Finance Model.

  1. Em Arquivos, escolha a Conta de documentos em que o arquivo será armazenado.

  2. Solte um arquivo CSV ou Excel em Solte aqui um arquivo CSV ou Excel ou clique em Escolher um arquivo. O arquivo é enviado para a pasta /foundation/ da conta de documentos.

    Para um arquivo que já está na conta de documentos, informe o Caminho do arquivo, por exemplo /foundation/budget.csv, e clique em Adicionar arquivo.

  3. O PlaidCloud lê o arquivo e propõe um mapeamento:

    • Delimitador, separador decimal e datas detectados. O delimitador (vírgula, ponto e vírgula, tabulação ou barra vertical), o separador decimal e o formato de data são detectados automaticamente.
    • Dataset: a tabela do Common Finance Model à qual o arquivo pertence, identificada pelo nome do arquivo e pelos cabeçalhos das colunas. Quando a correspondência não for clara, escolha-a na lista.
    • Separador decimal: Ponto (1,234.56) ou Vírgula (1.234,56).
    • Formato de data: exibido quando o arquivo tem datas. Altere-o se o formato detectado estiver errado: YYYY-MM-DD, DD.MM.YYYY, DD/MM/YYYY ou MM/DD/YYYY.
    • Uma grade com Coluna no arquivo, Tipo, Exemplos e Vai para. Altere Vai para para enviar uma coluna para outro campo ou para Não carregar.
  4. Confira para onde vai cada coluna e clique em Confirmar mapeamento.

Quando o PlaidCloud não consegue decidir sozinho o dataset, o separador decimal ou a ordem das datas, por exemplo em um arquivo cujas datas podem ser lidas como dia/mês ou mês/dia, ele pede que você escolha antes de confirmar. Adicionar um segundo arquivo para o mesmo dataset substitui o primeiro.

Os arquivos aceitos são arquivos de texto CSV, TSV e TXT, arquivos Excel .xlsx (lidos a partir da primeira planilha) e arquivos Parquet.

Clique em Carregar no cartão Carregar ou no cartão Última carga. A carga lê o ERP conectado e os arquivos confirmados, adapta tudo ao Common Finance Model, converte para a moeda de relatório, executa as verificações de prontidão e reconstrói os modelos do modelo de projeto.

  • Apenas uma carga por vez é executada em um projeto. Um segundo Carregar informa que já há uma carga em execução.
  • Se outros fluxos de trabalho usarem a mesma conexão de ERP, a primeira carga os lista e pede sua confirmação, porque uma carga lê do ERP e pode deixar esses fluxos de trabalho mais lentos. Clique em Carregar mesmo assim para prosseguir.
  • Uma carga com falha aparece em vermelho e nunca se esconde atrás de resultados anteriores. As linhas de uma carga anterior exibem De uma carga anterior. Carregue novamente. até que uma carga seja bem-sucedida.
  • Se uma entidade e período não puderem ser lidos, o restante ainda é carregado. Execute Carregar novamente para buscar apenas o que falhou.

Um arquivo substitui apenas o que ele cobre, e as demais linhas do seu ERP permanecem.

  • Os arquivos mestres (contas, departamentos, clientes, produtos e valores de segmento) substituem as linhas do ERP com o mesmo código.
  • Os arquivos de transações substituem as linhas do ERP da mesma entidade e do mesmo mês. Os arquivos de razão geral e de balancete também correspondem por razão contábil, os de orçamento por cenário, e os de direcionadores estatísticos por cenário e direcionador.

Se um arquivo deixar de cobrir um mês posteriormente, os dados do ERP para esse mês voltam na próxima carga.

Cada origem nomeia suas entidades com códigos próprios. O Mapeamento de entidades associa esses códigos às entidades do seu cadastro mestre de entidades, para que as linhas de todas as origens cheguem à mesma entidade.

Para usá-lo, adicione um arquivo CSV ou Excel e escolha o dataset Mapeamento de entidades:

Coluna Contém
source_entity O código como a origem o apresenta, como um código de empresa.
entity A entidade à qual ele pertence, como o cadastro mestre de entidades a nomeia.
  • Um código que não está no mapeamento é usado como está.
  • Vários códigos podem corresponder a uma única entidade. Suas linhas são combinadas, e um mês conta como fechado quando está fechado para todos eles.
  • Os códigos do mapeamento se aplicam a todas as origens, portanto os códigos de entidade de cada origem devem ser exclusivos entre as origens.
  • Uma linha de um arquivo de Entidades substitui a entidade do ERP com o mesmo código de entidade.

A verificação Entidades não mapeadas sinaliza qualquer linha cuja entidade não está no cadastro mestre de entidades nem é associada a uma por meio do mapeamento. Enquanto um cadastro mestre de entidades não é carregado, ela exibe – Não se aplica.

Cada carga converte os valores de razão geral, balancete, vendas, estoque e orçamento da moeda local para uma moeda de relatório. Os relatórios e modelos leem os valores convertidos, de modo que entidades em moedas diferentes, de qualquer sistema, somam corretamente.

Para escolher a moeda de relatório, defina a variável de projeto reporting_currency com um código de moeda, como USD. Consulte Gerenciamento de variáveis de projeto. O modelo de projeto a cria em branco. Enquanto ela estiver em branco, cada carga usa a primeira das opções a seguir que indicar exatamente uma moeda:

  1. A moeda do grupo das entidades.
  2. A moeda local das entidades de nível superior, aquelas sem entidade pai.
  3. A moeda local dos arquivos.

Se nenhuma delas indicar exatamente uma moeda, Conversão de moedas mostra um problema até você definir reporting_currency.

Os valores que já estão na moeda de relatório permanecem como estão, portanto um projeto cujos dados estão todos em uma única moeda não precisa de taxas.

Os arquivos de vendas, estoque e orçamento também podem trazer uma moeda. Mapeie uma coluna chamada Currency ou Local Currency e ela é identificada automaticamente, e os valores locais do arquivo são convertidos para a moeda de relatório. Um valor de grupo ou de relatório que já esteja no arquivo é mantido como está. O custo padrão do produto não é convertido.

Uma taxa converte uma unidade de uma moeda na moeda de relatório para um mês: o valor convertido é o valor local multiplicado pela taxa.

  • Do seu ERP, cada carga lê as taxas de câmbio que o ERP mantém.
  • De um arquivo, adicione um arquivo CSV ou Excel e escolha o dataset Taxas de câmbio. Uma taxa no arquivo substitui a taxa do ERP para as mesmas moedas e o mesmo mês. Use um arquivo para gerar relatórios em uma moeda para a qual seus ERPs não publicam taxas ou para adicionar taxas planejadas para os meses do orçamento.
Coluna Contém
from_currency A moeda de origem da conversão, por exemplo EUR.
to_currency A moeda de relatório, por exemplo USD.
period O mês, no formato YYYY-MM.
average_rate A taxa média do mês.
closing_rate A taxa no final do mês.
historical_rate A taxa histórica, para o patrimônio líquido e para contas definidas com a taxa histórica.

Somente as taxas para a moeda de relatório são usadas. Uma taxa cotada no sentido inverso, da moeda de relatório para outra moeda, não é invertida.

Cada linha é convertida a partir de sua própria moeda, portanto uma linha em moeda diferente da de sua entidade é convertida a partir da moeda em que está. Vale a primeira regra que se ajusta à linha:

Linha Taxa
Contas estatísticas e sem lançamento Não convertidas.
Já na moeda de relatório Não convertida.
Conta com um tipo de taxa Essa taxa: média, de fechamento ou histórica. A histórica recorre à de fechamento quando não há taxa histórica. Em um ERP, o tipo de taxa é o tipo de taxa da própria conta. Em um arquivo de plano de contas, mapeie uma coluna de tipo de taxa para fx_rate_type com average, closing ou historical.
Linha de vendas A taxa média do período.
Saldo de estoque A taxa de fechamento do período.
Linha de orçamento Por conta, como no razão geral: a taxa média para contas de demonstração do resultado e a taxa de fechamento para contas de balanço patrimonial.
Conta de demonstração do resultado A taxa média do período.
Conta de patrimônio líquido A taxa histórica ou a taxa de fechamento quando não há taxa histórica.
Qualquer outra conta de balanço patrimonial A taxa de fechamento do período.

Os valores convertidos não são arredondados, para que os totais não se desviem.

Cada carga reconstrói sete dimensões a partir dos dados mestres de cada origem:

Dimensão Construída a partir de
Entidade Entidades e suas entidades pai
Conta Plano de contas e contas pai
Departamento Departamentos e seus departamentos pai
Cliente Clientes e seus clientes pai
Produto Produtos e seus produtos pai
Segmento 1 Valores de segmento de segment_1
Segmento 2 Valores de segmento de segment_2
  • Um registro sem pai, ou que nomeia a si mesmo como pai, é carregado como um membro de nível superior.
  • Como cada carga reconstrói as hierarquias, altere um pai no ERP ou no seu arquivo, e não na dimensão.
  • Um problema em uma hierarquia afeta apenas essa dimensão. A carga e os modelos do modelo de projeto ainda são concluídos.
  • Você pode renomear Segmento 1 e Segmento 2 para o que eles contêm, por exemplo Classe e Local.

Para fornecer hierarquias de segmento a partir de um arquivo, escolha o dataset Valores de segmento:

Coluna Contém
segment A qual segmento o valor pertence: de segment_1 a segment_5. Segmento 1 e Segmento 2 têm dimensões.
segment_value O valor, como as linhas de razão geral, vendas e orçamento o apresentam.
segment_value_name Seu nome.
parent_segment_value Seu pai dentro do mesmo segmento.

Após cada carga, a grade Prontidão lista todas as verificações de cada entidade e período, com um destes status:

Status Significado
● Pronto A verificação foi aprovada.
▲ Requer atenção Vale uma olhada, mas os números são utilizáveis.
■ Problema Corrija antes de confiar nos resultados.
– Não se aplica Ainda não há dados para esta verificação.

As verificações são:

Verificação O que ela confirma
Dados carregados Todo período fiscal tem linhas de razão geral, e toda leitura do ERP foi bem-sucedida. Um período fechado sem linhas é um problema; um período aberto sem linhas requer atenção.
Balancete bate com o razão geral O balancete é igual ao razão geral para cada entidade, período e conta. Quando o balancete e o razão geral trazem departamentos para uma conta, ele também confere cada departamento.
Vendas batem com o razão geral As linhas de vendas são iguais às contas de receita e de CPV do razão geral em cada período.
Produtos/clientes desconhecidos Toda linha de vendas indica um produto e um cliente que existem nos cadastros mestres de produtos e de clientes.
Contas ausentes do plano de contas Toda linha do razão geral indica uma conta que existe no plano de contas. As linhas com uma conta desconhecida ficam fora da demonstração do resultado.
Conversão de moedas Toda linha de razão geral, balancete, vendas, estoque e orçamento tem um valor na moeda de relatório. Uma linha de demonstração do resultado ou de vendas sem taxa é um problema, porque a demonstração do resultado lê valores convertidos. Uma linha de balanço patrimonial, estoque ou orçamento sem taxa requer atenção. Um mês de orçamento ainda sem taxa aparece em âmbar, portanto carregue taxas planejadas para os meses de orçamento. Consulte Conversão de moedas.
Entidades não mapeadas Toda linha de razão geral, balancete e vendas indica uma entidade do cadastro mestre de entidades, diretamente ou por meio do mapeamento de entidades. Não se aplica até que um cadastro mestre de entidades seja carregado. Consulte Mapeamento de entidades.

Cada linha que não está pronta diz o que fazer na coluna O que fazer, como carregar o plano de contas, carregar taxas de câmbio ou executar Carregar novamente para um período.

A grade também mostra duas verificações de configuração, que aparecem somente quando precisam de atenção:

Verificação Quando aparece
Alocação de custos indiretos Apenas uma das variáveis de projeto overhead_department e overhead_driver está definida, ou nenhum direcionador de alocação corresponde a overhead_driver, de modo que a alocação não faria nada. Defina as duas ou limpe as duas para desativar a alocação de custos indiretos.
Comparação com o orçamento Há linhas de orçamento carregadas, mas nenhuma está na versão indicada pela variável de projeto budget_version, de modo que a comparação com o orçamento ficaria vazia.

Depois que uma carga da sua conexão de ERP é concluída sem problemas, Atualizar toda noite aparece no cartão Última carga. Clique nele para executar Carregar toda noite às 2h no seu fuso horário. O cartão então exibe Nightly refresh: Every night at 2:00 e quem o configurou.

A carga noturna é executada como a pessoa que a configurou. Se essa pessoa não puder mais usar a conexão do ERP, a grade informa que a carga noturna foi ignorada; configure-a novamente. Um projeto que tem apenas dados de exemplo não pode ser agendado.

Um arquivo ausente ou vazio em uma carga noturna termina com um alerta que indica o caminho, e não com um erro, e o restante do modelo ainda é carregado.

Um modelo de projeto cria seus relatórios e modelos sobre o Common Finance Model, de modo que funcionem do mesmo jeito seja qual for o ERP que o alimenta. Quando você inicia um projeto a partir de um modelo, como o Enterprise Profitability, ele cria:

  • As tabelas do Common Finance Model, vazias ou preenchidas com dados de exemplo.
  • As dimensões Entidade, Conta, Departamento, Cliente, Produto, Segmento 1 e Segmento 2, construídas a partir dessas tabelas. Consulte Hierarquias.
  • O fluxo de trabalho Carregar e os fluxos de trabalho que ele executa para ler seu ERP e seus arquivos, adaptá-los, verificar a prontidão e criar os modelos do modelo de projeto.
  • Os relatórios e modelos próprios do modelo de projeto. O Enterprise Profitability acrescenta uma tabela de demonstração do resultado com receita, CPV, margem bruta, despesas operacionais diretas e indiretas, contribuição e margem operacional, além de pontes de margem ano a ano e em relação ao orçamento.
  • Métricas e um caminho de análise para fazer perguntas sobre os resultados.

Para explorar antes de conectar seu próprio ERP, marque Começar com dados de exemplo ao criar o projeto. O projeto executa uma primeira carga imediatamente, de modo que a guia Foundation mostra um exemplo completo, incluindo uma entidade em euros convertida para dólares americanos. Quando você conecta seu próprio ERP ou adiciona seus próprios arquivos, as linhas de exemplo são apagadas e seus dados ocupam o lugar delas.

A guia Foundation é onde você conecta, carrega e verifica seus dados. Ela tem estas seções, de cima para baixo:

Seção O que mostra
Última carga Se a última carga foi bem-sucedida, falhou ou ainda está em execução, com os botões Carregar, Atualizar e Atualizar toda noite.
Configuração A lista de verificação de configuração: Conectar seus dados, Carregue seus dados, Verificar se os totais batem, Revise suas hierarquias e Compartilhe com sua equipe. O item atual aparece em negrito.
Arquivos Cada arquivo que você adicionou, seu dataset, como Razão geral ou Taxas de câmbio, e se o mapeamento está ✓ Confirmado ou ○ Aguardando confirmação.
Dados carregados Para cada entidade, o primeiro e o último período carregados e quantos períodos estão prontos.
Períodos Os períodos fiscais de cada entidade e se cada um está ✓ Fechado ou ○ Aberto.
Prontidão A grade de prontidão: uma linha por entidade, período e verificação, com seu status e O que fazer.
Conexão Conecte seu ERP e escolha as entidades e quantos meses de histórico carregar.
Arquivos (adicionar) Adicione um arquivo CSV, TSV, TXT, Excel ou Parquet e confirme como suas colunas são mapeadas.
Carregar Inicie uma carga.

Enquanto uma carga é executada, a guia é atualizada sozinha.

A lista de verificação de configuração acompanha seu progresso:

  • Conectar seus dados e Carregue seus dados são marcados automaticamente quando uma origem é associada e uma carga é bem-sucedida.
  • Verificar se os totais batem é marcado automaticamente quando as verificações de conferência são aprovadas.
  • Revise suas hierarquias: clique em Abrir dimensões para revisar as hierarquias de Entidade, Conta e Departamento e depois marque Eu já revisei. Você mesmo confirma este item.
  • Compartilhe com sua equipe: compartilhe o projeto quando ele estiver pronto. Consulte Gerenciamento de acesso ao projeto.

O Data Foundation adapta todas as origens, ERP ou arquivo, às mesmas quinze tabelas, de modo que relatórios, métricas e modelos criados sobre elas funcionem do mesmo jeito seja qual for a origem. Cada linha também registra seu sistema de origem e quando foi lida. A coluna Dataset é o nome que você escolhe ao adicionar um arquivo.

Dataset Tabela Contém
Entidades cfm_entity Entidades legais com entidade pai, moeda local e de grupo, e país.
Mapeamento de entidades cfm_entity_map Códigos de entidade de origem e a entidade a que cada um pertence. Consulte Mapeamento de entidades.
Taxas de câmbio cfm_fx_rate Taxas mensais média, de fechamento e histórica por par de moedas. Consulte Taxas de câmbio.
Calendário fiscal cfm_fiscal_calendar Uma linha por período fiscal de entidade, com datas de início e fim e se está fechado.
Plano de contas cfm_account Contas com conta pai, tipo (Revenue, COGS, Opex, NonOperating, Asset, Liability, Equity), demonstração, saldo normal e tipo de taxa.
Departamentos cfm_department Departamentos e centros de custo com departamento pai e centro de lucro.
Produtos cfm_product Cadastro mestre de produtos com produto pai, família, grupo, unidade de medida e custo padrão.
Clientes cfm_customer Cadastro mestre de clientes com cliente pai, grupo, região e país. Os nomes dos clientes não são mascarados.
Valores de segmento cfm_segment Valores de segmento com nome e pai. Consulte Hierarquias.
Razão geral cfm_gl_journal Linhas de lançamento na moeda da transação, local e de relatório.
Balancete cfm_trial_balance Débitos, créditos e líquido do período por entidade, conta e departamento, na moeda local e de relatório.
Linhas de vendas cfm_sales_line Linhas de vendas faturadas com quantidade e valores bruto, de desconto, líquido e de CPV.
Saldos de estoque cfm_inventory_balance Estoque de fim de período por produto e armazém.
Orçamento cfm_budget Orçamento e previsão por cenário, versão, conta e departamento.
Direcionadores de alocação cfm_stat_driver Direcionadores estatísticos, como número de funcionários, metros quadrados ou unidades.

Os períodos são escritos como YYYY-MM, e as transações são alocadas pelo período de lançamento. O orçamento é opcional: um ERP sem orçamentos ainda carrega todo o restante.

Um arquivo de balancete pode trazer colunas de débito e crédito, uma coluna de líquido, ou ambas. Com apenas débito e crédito, o líquido é débito menos crédito, e um lado em branco conta como zero. Com apenas o líquido, um líquido positivo vira o débito e um líquido negativo vira o crédito, como valor positivo. Uma coluna de departamento é opcional.

Sintoma O que fazer
Testar conexão informa que o ERP recusou as credenciais Verifique as credenciais da conexão e se o usuário da integração consegue entrar no ERP.
Testar conexão mostra Permissão ausente para um dataset Peça ao administrador do ERP para adicionar as permissões indicadas. O guia de conexão do seu ERP lista o que a conexão precisa.
Uma mensagem de erro do ERP é mais curta que a original do ERP O PlaidCloud remove credenciais, tokens e chaves dos erros do provedor antes de exibi-los, então alguns detalhes ficam de fora. Execute Testar conexão para ver qual dataset é afetado.
Dados carregados é um problema em um período Uma leitura do ERP para esse período falhou. Execute Carregar novamente; os períodos já carregados são ignorados.
Contas ausentes do plano de contas é um problema Adicione as contas ausentes ao plano de contas no ERP ou no seu arquivo e execute Carregar novamente.
Conversão de moedas é um problema A moeda de uma entidade não tem taxa para a moeda de relatório nesse período, ou nenhuma moeda de relatório única foi encontrada. Adicione as taxas a um arquivo de Taxas de câmbio, verifique se a conexão consegue ler as taxas de câmbio do ERP ou defina a variável de projeto reporting_currency. Depois, execute Carregar novamente.
Conversão de moedas requer atenção Linhas de balanço patrimonial, estoque ou orçamento não têm taxa de fechamento, histórica ou planejada para o período. A demonstração do resultado não é afetada. Adicione as taxas, inclusive as planejadas para os meses de orçamento, e execute Carregar novamente.
Entidades não mapeadas é um problema Adicione a entidade ao cadastro mestre de entidades ou associe seu código a uma entidade existente no arquivo de Mapeamento de entidades e execute Carregar novamente.