Pular para o conteúdo principal
Uma Conta deve estar vinculada a um Asset existente. Certifique-se de criar o Asset primeiro antes de criar a Conta.
Para criar uma Conta, siga estes passos:
1
Na página de Contas, clique no botão Nova Conta.
2
O formulário Nova Conta será aberto no lado direito da tela com três abas: Detalhes da Conta, Portfólio e Metadados.
3
Preencha as informações obrigatórias na aba Detalhes da Conta:

Detalhes da Conta

name
string
obrigatório
Nome da Conta - Um nome descritivo para a conta (3-255 caracteres).Exemplo: Conta Corrente João Silva, Tesouraria Operações
alias
string
Alias da Conta - Um identificador único e legível começando com @ (máx. 255 caracteres). Este alias será usado para referenciar a conta em transações.Exemplo: @cliente_joao_corrente, @tesouraria_principal
O alias não pode ser alterado após a criação da conta.
type
string
obrigatório
Tipo - A classificação do tipo de conta. Este campo é obrigatório se a validação de Tipo de Conta estiver habilitada para seu ledger.
  • Se a validação estiver habilitada e existirem tipos de conta, selecione da lista suspensa
  • Se a validação estiver habilitada mas não existirem tipos de conta, você deve criar os tipos de conta primeiro
  • Se a validação estiver desabilitada, insira um valor de tipo personalizado
Exemplos: checking, savings, treasury, revenue, expense
O tipo não pode ser alterado após a criação da conta.
entityId
string
ID da Entidade - Número de identificação do titular da conta (ID do cliente, ID da unidade de negócio, etc.).Exemplo: cliente_123, depto_engenharia, parceiro_acme
assetCode
string
obrigatório
Ativo - A moeda ou commodity que será operada nesta conta. Selecione dos seus ativos existentes.Exemplos: USD, EUR, BRL, BTC
O ativo não pode ser alterado após a criação da conta.
segmentId
string
Segmento - Categoria opcional para agrupar contas com características específicas (ex.: região geográfica, nível do cliente, departamento).Disponível apenas se você tiver criado segmentos.
allowSending
boolean
padrão:"true"
Permitir Envio - Controla se esta conta pode enviar fundos (operações de débito).
Este campo está sempre habilitado no momento da criação e só pode ser modificado ao editar uma conta existente.
allowReceiving
boolean
padrão:"true"
Permitir Recebimento - Controla se esta conta pode receber fundos (operações de crédito).
Este campo está sempre habilitado no momento da criação e só pode ser modificado ao editar uma conta existente.
4
(Opcional) Mude para a aba Portfólio para vincular esta conta a um portfólio para fins de relatório e gerenciamento.
  • Selecione um portfolio da lista suspensa
  • Se não existirem portfolios, você pode criar um primeiro
  • Contas podem ser vinculadas ou desvinculadas de portfolios a qualquer momento
5
(Opcional) Mude para a aba Metadados para adicionar pares chave-valor personalizados para contexto adicional ou fins de integração.
6
Clique no botão Salvar para criar a Conta.

Exemplos Rápidos


Cenário: Criar uma conta corrente para um cliente.
CampoValor
Nome da ContaConta Corrente João Silva
Alias da Conta@cliente_123_corrente
Tipochecking
ID da Entidadecliente_123
AtivoUSD
Permitir Enviotrue
Permitir Recebimentotrue

Notas Importantes


Os seguintes campos são imutáveis após a criação da conta:
  • Alias da Conta - Escolha com cuidado pois será usado em transações
  • Tipo - Não pode ser reclassificado uma vez definido
  • Código do Asset - A moeda/commodity da conta é fixa
Se precisar alterar algum desses campos, você deve criar uma nova conta.
Se a validação de Tipo de Conta estiver habilitada para seu ledger:
  • O campo Tipo se torna obrigatório
  • Você deve selecionar entre tipos de conta predefinidos ou criá-los primeiro
  • Isso garante consistência no plano de contas da sua organização
Veja Gerenciando Contas para mais informações.
Essas flags controlam permissões de transação:
  • Permitir Envio = false: A conta não pode ser usada como origem (lado do débito) em transações
  • Permitir Recebimento = false: A conta não pode ser usada como destino (lado do crédito) em transações
Ambas as flags são habilitadas por padrão e só podem ser modificadas após a criação da conta. Isso é útil para:
  • Congelar contas temporariamente
  • Criar contas somente de recebimento (ex.: escrow)
  • Criar contas somente de envio (caso de uso raro)
Após criar uma conta, ela estará imediatamente disponível para uso em transações. Certifique-se de que todas as informações estejam corretas antes de salvar, especialmente os campos imutáveis.