Criar um Tipo de Conta
Use este endpoint para criar um Tipo de Conta. Você pode criar múltiplos Tipos de Conta, mas eles devem ser adicionados um de cada vez.
Cabeçalhos
O tipo de mídia do recurso. O valor recomendado é application/json.
Um identificador único utilizado para rastrear e acompanhar cada requisição.
Token JWT bearer para autenticação.
Obrigatório quando PLUGIN_AUTH_ENABLED=true (exigido em implantações multi-tenant).
Opcional no modo OSS single-tenant padrão.
Formato: Bearer <token>
Parâmetros de caminho
O identificador único da Organização associada ao Ledger.
O identificador único do Ledger associado.
Corpo
Nome do Tipo de Conta.
100Identificador único para o Tipo de Conta que está sendo criado.
Importante: Se a funcionalidade de Tipos de Conta estiver habilitada, este valor se torna obrigatório ao criar contas — apenas keyValues previamente registrados serão aceitos no campo type da API de Contas.
Caracteres aceitos: alfanuméricos (maiúsculos e minúsculos), hifens (-) e underscores (_).
50^[a-zA-Z0-9_-]+$Descrição do Tipo de Conta.
500Um objeto contendo pares de chave-valor para adicionar como metadata, onde o campo name é a chave e o campo value é o valor. Por exemplo, para adicionar um Centro de Custo, use 'costCenter': 'BR_11101997'.
Restrições: as chaves devem ter no máximo 100 caracteres; valores de string no máximo 2000 caracteres. Objetos aninhados não são permitidos (os valores devem ser string, número ou booleano), a estrutura não pode exceder uma profundidade máxima de 10, e é permitido um máximo de 100 chaves.
Resposta
Indica que o recurso foi criado com sucesso e a operação foi concluída conforme esperado.
O identificador único do Tipo de Conta.
O identificador único da Organização.
O identificador único do Ledger.
Nome do Tipo de Conta.
Descrição do Tipo de Conta.
Identificador único do Tipo de Conta criado.
Data e hora de criação (UTC).
Data e hora da última atualização (UTC).
Data e hora da exclusão lógica, se aplicável (UTC).
Um objeto contendo pares de chave-valor para adicionar como metadata, onde o campo name é a chave e o campo value é o valor. Por exemplo, para adicionar um Centro de Custo, use 'costCenter': 'BR_11101997'.
Restrições: as chaves devem ter no máximo 100 caracteres; valores de string no máximo 2000 caracteres. Objetos aninhados não são permitidos (os valores devem ser string, número ou booleano), a estrutura não pode exceder uma profundidade máxima de 10, e é permitido um máximo de 100 chaves.

