Skip to main content

Entidades Suportadas

A API de Importação NovaGestão suporta 12 tipos de entidades para importação de dados em massa.

Transações Financeiras

Dados Mestres

Entidades Avançadas

Ordem de Importação

Algumas entidades dependem de outras. Siga esta ordem recomendada:

1. Dados Mestres Primeiro

  • Categorias
  • Centros de Custo
  • Departamentos
  • Regras de Alocação

2. Contas em Segundo

  • Contas Bancárias

3. Transações e Faturas

  • Transações
  • Contas a Pagar
  • Contas a Receber

4. Dados de Planejamento por Último

  • Orçamentos
  • Ajustes de Caixa
  • Diferimentos

5. Usuários a Qualquer Momento

  • Usuários podem ser importados independentemente

Padrões Comuns

Busca de Associações

Entidades podem referenciar outras entidades por nome:
{
  "description": "Material de escritório",
  "amount": "150.00",
  "category_name": "Despesas Operacionais",
  "cost_center_name": "Administração"
}

Detecção de Duplicatas

A maioria das entidades usa atributos únicos para prevenir duplicatas:
EntidadeChave Única
Transaçõescompany_id + reference_number
Contas a Pagarcompany_id + document_number
Contas a Recebercompany_id + document_number
Categoriascompany_id + code
Contascompany_id + name
Se uma duplicata for encontrada, o registro existente é retornado ao invés de criar um novo.

Próximos Passos