Fluxo de integração e autenticação
Ordene a carga do plano DeRE, autentique as chamadas da Accounts API, identifique a empresa e gerencie mudanças no plano.
Carregue as contas na ordem da hierarquia e autentique as chamadas da Accounts API para preparar a geração do D-1011 (Plano Geral de Contas Comentado, ou PGCC) da DeRE (Declaração de Regimes Específicos).
Antes de iniciar a carga
- Cadastre a empresa declarante na Brinta com o CNPJ e configure a declaração DeRE com a equipe da Brinta.
- Obtenha o token de API no dashboard, em Company Management › API & Integrations.
- Prepare os campos e mappings de cada conta conforme Estrutura da conta e mappings.
Consulte Antes de começar e conceitos básicos para verificar os requisitos e entender os tipos de conta.
Fluxo de integração
- Preparar os dados com a equipe tributária. Para cada conta do plano: tipo, nível, pai, natureza, natureza do saldo, conta COSIF e, se for analítica, codTrib e indicador de ISS.
- Resolver as contas mistas. Toda conta analítica com mais de um codTrib é desdobrada em uma sintética (
000) e uma filha analítica por codTrib (001,002, …), antes de qualquer envio. - Ordenar a carga. Envie primeiro as contas de nível 1, depois as de nível 2, e assim por diante: uma conta só é criada se o pai já existir.
- Criar cada conta com um
POST /accounts. - Interpretar a resposta.
200significa que a conta foi criada. Qualquer outro status significa que ela não foi criada (veja Validações, erros e checklist). - Verificar com
GET /accountsas contas que você quiser conferir. - Avisar a Brinta ao terminar a carga, para que ela gere o D-1011.
Uma resposta 200 confirma que a conta foi gravada, não que ela cumpre as regras da DeRE. Essas regras são verificadas quando a Brinta gera o D-1011, por isso vale validá-las antes do envio. Consulte Validações, erros e checklist para verificar as regras que a API não valida.
Endpoints e autenticação
| Método | Endpoint | O que faz |
|---|---|---|
POST | https://api.brinta.com/accounts | Cria uma conta |
GET | https://api.brinta.com/accounts?account_external_id={código}&company_account_external_id={empresa} | Devolve uma conta pelo código |
Autenticação: Authorization: Bearer <token>, com Content-Type: application/json.
Identificação da empresa
Envie exatamente um destes dois campos: no body, no POST, ou como query parameter, no GET.
| Campo | O que é |
|---|---|
company_account_external_id | O ID da empresa no seu sistema |
company_id | O UUID da empresa na Brinta |
Um token só pode ler e gravar contas das empresas do seu próprio grupo.
Optional: verificar o grupo da empresa
Envie parent_company_id ou parent_company_external_id para verificar se a empresa pertence a esse grupo.
Quando o plano mudar
Uma conta nova ou um desdobramento novo são carregados com o mesmo POST. A Accounts API não permite alterar uma conta existente: as mudanças em contas já criadas são feitas pelo dashboard. Nos dois casos, a Brinta gera uma nova versão do D-1011 com a nova vigência.
Próximo passo
Consulte Exemplos de carga e consulta para enviar contas sintéticas, analíticas e desdobradas e consultar uma conta criada.
Updated 2 days ago