Exemplos de carga e consulta
Envie contas sintéticas, analíticas e desdobradas pela Accounts API e consulte uma conta criada para a DeRE.
Envie contas sintéticas, analíticas e desdobradas pela Accounts API e consulte os dados de uma conta criada.
Antes de enviar
- Obtenha o token no dashboard, em Company Management › API & Integrations, e defina a variável de ambiente
BRINTA_TOKENcom esse valor. - Substitua
CLI-98765pelo ID da empresa no seu sistema nos exemplos. - Prepare os campos conforme Estrutura da conta e mappings e siga o Fluxo de integração e autenticação.
- Crie os pais antes das filhas. Para os exemplos de desdobramento, carregue primeiro
71000e suas antecessoras, da mesma forma que as sintéticas abaixo.
Plano usado nos exemplos
A tabela apresenta seis contas: duas sintéticas, uma analítica e uma conta mista desdobrada em uma original sintética e duas filhas analíticas. A conta 71000 e suas antecessoras não estão incluídas na tabela. As contas COSIF e os codTrib são reais; a classificação de cada conta é apenas ilustrativa.
| Código | Nome | type | level | Pai | split_code | COSIF | codTrib |
|---|---|---|---|---|---|---|---|
1000 | Ativo | S | 1 | 000 | 1.0.0.00.00.00-9 | ||
11000 | Disponibilidades | S | 2 | 1000 | 000 | 1.1.0.00.00.00-2 | |
1101000 | Caixa | A | 3 | 11000 | 000 | 1.1.1.10.00.00-8 | 118915099 |
7101000 | Rendas de empréstimos | S | 3 | 71000 | 000 | 7.1.1.05.00.00-8 | |
7101001 | Rendas de empréstimos: crédito | A | 4 | 7101000 | 001 | 7.1.1.05.00.00-8 | 311011101 |
7101002 | Rendas de empréstimos: câmbio | A | 4 | 7101000 | 002 | 7.1.1.05.00.00-8 | 311011102 |
1. Criar uma conta sintética de nível 1
Envie a conta 1000, sem pai:
curl -X POST https://api.brinta.com/accounts \
-H "Authorization: Bearer $BRINTA_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"account_external_id": "1000",
"company_account_external_id": "CLI-98765",
"location": "BR",
"name": "Ativo",
"description": "Ativo total",
"type": "S",
"level": 1,
"order_id": 1,
"nature": 1,
"sub_nature": "D",
"split_code": "000",
"valid_from": "2026-10-01T00:00:00Z",
"account_mappings": [
{ "group": "COSIF", "account": "1.0.0.00.00.00-9" }
]
}'Uma conta sintética não tem codTrib nem indicador de ISS, mas tem sua conta COSIF. Uma resposta 200 confirma a gravação; não confirma que a conta passou pelas regras da DeRE.
2. Criar uma conta sintética intermediária
Depois de criar 1000, envie este body com POST /accounts:
{
"account_external_id": "11000",
"company_account_external_id": "CLI-98765",
"location": "BR",
"name": "Disponibilidades",
"description": "Disponibilidades",
"type": "S",
"level": 2,
"order_id": 2,
"nature": 1,
"sub_nature": "D",
"parent_account": "1000",
"split_code": "000",
"valid_from": "2026-10-01T00:00:00Z",
"account_mappings": [
{ "group": "COSIF", "account": "1.1.0.00.00.00-2" }
]
}Para enviar este e os demais bodies JSON da página, salve cada um em conta.json e execute:
curl -X POST https://api.brinta.com/accounts \
-H "Authorization: Bearer $BRINTA_TOKEN" \
-H "Content-Type: application/json" \
-d @conta.jsonO resultado esperado é 200, confirmando a gravação de 11000. O pai 1000 precisa existir, ser sintético e estar ativo; caso contrário, a API rejeita a criação. Consulte Validações, erros e checklist para interpretar o erro retornado.
3. Criar uma conta analítica
Depois de criar 11000, envie a conta 1101000 com codTrib, COSIF e indicador de ISS:
{
"account_external_id": "1101000",
"company_account_external_id": "CLI-98765",
"location": "BR",
"name": "Caixa e equivalentes de caixa",
"description": "Disponibilidades em caixa e em contas de liquidez imediata",
"type": "A",
"level": 3,
"order_id": 3,
"nature": 1,
"sub_nature": "D",
"parent_account": "11000",
"split_code": "000",
"status": "ACTIVE",
"valid_from": "2026-10-01T00:00:00Z",
"account_mappings": [
{ "group": "CodTrib IBS/CBS - DeRe", "account": "118915099" },
{ "group": "COSIF", "account": "1.1.1.10.00.00-8" }
],
"code_mappings": [
{ "type": "dere_ind_trib_iss", "value": "0" }
]
}Salve o body em conta.json e use o comando POST anterior. O resultado esperado é 200. Para verificar a conta gravada, use a consulta ao final desta página; confira os mappings em Account Management no dashboard.
4. Criar uma conta mista desdobrada
Uma conta mista é uma conta analítica com mais de um codTrib. Antes do envio, desdobre-a em uma original sintética e uma filha analítica por codTrib. Se a conta já existir na Brinta, faça as alterações pelo dashboard: a Accounts API não permite editar uma conta existente.
Criar a original sintética
Com 71000 e suas antecessoras já criadas, envie primeiro a original 7101000, agora sintética, com split_code 000:
{
"account_external_id": "7101000",
"company_account_external_id": "CLI-98765",
"location": "BR",
"name": "Rendas de empréstimos",
"description": "Rendas de empréstimos",
"type": "S",
"level": 3,
"order_id": 20,
"nature": 4,
"sub_nature": "C",
"parent_account": "71000",
"split_code": "000",
"valid_from": "2026-10-01T00:00:00Z",
"account_mappings": [
{ "group": "COSIF", "account": "7.1.1.05.00.00-8" }
]
}Envie com POST /accounts. O resultado esperado é 200, confirmando a gravação da original antes das filhas.
Criar uma filha por codTrib
Envie cada body abaixo em uma chamada POST /accounts separada. Cada filha tem seu próprio split_code, um único codTrib e a mesma conta COSIF da original.
{
"account_external_id": "7101001",
"company_account_external_id": "CLI-98765",
"location": "BR",
"name": "Rendas de empréstimos: operações de crédito",
"description": "Rendas de operações de crédito",
"type": "A",
"level": 4,
"order_id": 21,
"nature": 4,
"sub_nature": "C",
"parent_account": "7101000",
"split_code": "001",
"valid_from": "2026-10-01T00:00:00Z",
"account_mappings": [
{ "group": "CodTrib IBS/CBS - DeRe", "account": "311011101" },
{ "group": "COSIF", "account": "7.1.1.05.00.00-8" }
],
"code_mappings": [
{ "type": "dere_ind_trib_iss", "value": "0" }
]
}{
"account_external_id": "7101002",
"company_account_external_id": "CLI-98765",
"location": "BR",
"name": "Rendas de empréstimos: operações de câmbio",
"description": "Rendas de operações de câmbio",
"type": "A",
"level": 4,
"order_id": 22,
"nature": 4,
"sub_nature": "C",
"parent_account": "7101000",
"split_code": "002",
"valid_from": "2026-10-01T00:00:00Z",
"account_mappings": [
{ "group": "CodTrib IBS/CBS - DeRe", "account": "311011102" },
{ "group": "COSIF", "account": "7.1.1.05.00.00-8" }
],
"code_mappings": [
{ "type": "dere_ind_trib_iss", "value": "0" }
]
}O resultado esperado é 200 em cada chamada. Se houver erro, consulte Validações, erros e checklist antes de repetir o envio: a tabela de erros descreve casos em que a conta foi criada, mas a resposta falhou.
5. Consultar uma conta
Consulte a conta pelo código completo e pelo ID da empresa:
curl "https://api.brinta.com/accounts?account_external_id=1101000&company_account_external_id=CLI-98765" \
-H "Authorization: Bearer $BRINTA_TOKEN"Resposta 200:
{
"account_external_id": "1101000",
"company_id": "7b1e2c4a-0d3f-4e5a-9b8c-1a2b3c4d5e6f",
"company_account_external_id": "CLI-98765",
"location": "BR",
"name": "Caixa e equivalentes de caixa",
"description": "Disponibilidades em caixa e em contas de liquidez imediata",
"type": "A",
"level": 3,
"order_id": 3,
"nature": 1,
"sub_nature": "D",
"parent_account": "11000",
"split_code": "000",
"status": "ACTIVE",
"start_date": "2026-10-01T00:00:00Z",
"valid_from": "2026-10-01T00:00:00Z",
"centers": []
}A resposta não inclui account_mappings nem code_mappings. Para conferi-los depois da carga, use Account Management no dashboard.
Próximo passo
Consulte Validações, erros e checklist para verificar as regras da DeRE e concluir a preparação para produção. Ao terminar a carga, avise a Brinta para que ela gere o D-1011.
Updated 2 days ago