Cria uma conta
Cria uma conta do workspace, com o saldo inicial lançado na data informada. Exige o papel Editor ou um papel com permissão de editar Contas.
Cartão de crédito se cria em POST /cartoes, e esta versão não cria aplicacao_financeira;
os dois tipos aqui respondem 400. Em
contas_a_pagar a finalidade é obrigatória (nos outros tipos, 400), e o tipo só existe em
workspace de pessoa jurídica: em pessoa física responde 422, como o app, que não o oferece.
Em conta de passivo e de patrimônio líquido (emprestimo_contratado, outros_passivos,
capital_social, contas_a_pagar) o saldo inicial é gravado negativo, como no app. Poupança
só existe em BRL.
A resposta é a conta criada, no mesmo formato do GET /contas/{id}. Campo fora da lista
responde 400.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
application/json- body
nome*stringlength <= 200tipo*string"conta_corrente""dinheiro""carteira_ativos""poupanca""imovel""contas_a_receber""emprestimo_concedido""emprestimo_contratado""outros_ativos""outros_ativos_imobilizados""outros_passivos""capital_social""contas_a_pagar"moeda?stringCódigo ISO 4217; sem ele, a moeda padrão do workspace.
banco?stringCódigo da instituição no catálogo (o banco.codigo das contas).
length <= 20agencia?stringlength <= 20numero_conta?stringlength <= 20saldo_inicial?numberPadrão 0.
data_saldo_inicial?stringAAAA-MM-DD; padrão ontem, como no app. Nunca no futuro; poupança e imóvel aceitam no máximo ontem.
datefinalidade?FinalidadeContaO grupo do passivo no balanço em que a conta a pagar entra.
"custos_operacionais""despesas_variaveis""despesas_fixas""lucros""impostos""impostos_sobre_lucro"A conta criada.
application/json- response
id*integernome*stringtipo*TipoContaO tipo da conta como o app mostra. A carteira de investimentos, que o Meu Dinheiro cria
para os investimentos, não aparece na API; contas_a_receber, contas_a_pagar, outros_ativos_imobilizados e capital_social
existem só em workspace de pessoa jurídica.
"conta_corrente""dinheiro""cartao_credito""carteira_ativos""poupanca""aplicacao_financeira""imovel""contas_a_receber""contas_a_pagar""emprestimo_concedido""emprestimo_contratado""outros_ativos""outros_ativos_imobilizados""outros_passivos""capital_social"status*StatusContaactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"moeda*stringCódigo ISO 4217.
banco*|A instituição da conta. Nulo quando não há, ou quando o ícone escolhido para a conta é genérico (uma casa, um carro…), e não um banco.
agencia*string|nullnumero_conta*string|nullfinalidade*|O grupo do passivo no balanço (FinalidadeConta); só em contas_a_pagar, nulo nos outros tipos.
"custos_operacionais""despesas_variaveis""despesas_fixas""lucros""impostos""impostos_sobre_lucro"nullcurl -X POST "https://example.com/contas" \ -H "Content-Type: application/json" \ -d '{ "nome": "Inter PJ", "tipo": "conta_corrente" }'{ "id": 2051, "nome": "Inter PJ", "tipo": "conta_corrente", "status": "active", "moeda": "BRL", "banco": { "codigo": "077", "nome": "Banco Inter S.A." }, "agencia": "0001", "numero_conta": "12345-6", "finalidade": "custos_operacionais"}Lista as contas GET
Todas as contas do workspace: correntes, dinheiro, cartões de crédito, investimentos, poupança, imóveis, empréstimos e as demais contas do balanço. Inclui as inativas e as encerradas; filtre com `status=active` para só as que estão em uso. Não traz saldo. Conta **oculta** para a credencial não aparece (e responde 404 na consulta por id); conta **somente leitura** aparece normalmente.
Uma conta GET
Conta de outro workspace, inexistente ou oculta para a credencial responde 404.