---
title: "Exato - Cadastro Pessoa Jurídica"
method: POST
path: "/br/exato/cadastro/pessoa-juridica"
tags: ["Exato - Consultas"]
---

# Exato - Cadastro Pessoa Jurídica

`POST /br/exato/cadastro/pessoa-juridica`

## Request

- Base URL: `https://api.directdigital.com.br`
- URL: `https://api.directdigital.com.br/br/exato/cadastro/pessoa-juridica`
- Auth: API key in header `token`

Exato - Cadastro Pessoa Jurídica

## Query parameters

- `test_mode` boolean
- `lightweight` boolean

## Request body `application/x-www-form-urlencoded`

- object
  - `cnpj` string, required: CNPJ to be consulted / CNPJ a ser consultado
  - `relacionamentos` boolean: Consulta registros relacionados (apenas documento e nome)

## Response `200`

Success

- ExatoCadastroPessoaJuridicaResponse: ExatoCadastroPessoaJuridicaResponse
  - `ApiResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInput' | 'DataUnavailable' | 'NotFound' | 'InvalidParameters' | 'UnsupportedCombination' | 'RemoteUnavailable' | 'Timeout' | 'RetryLimitReached' | 'RemoteError' | 'InProgress' | 'InsufficientCredits' | 'ConcurrentLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'Created' | 'Updated' | 'Deleted' | 'InternalError' | 'ValidationFailed' | 'Conflict' | 'ResourceLocked' | 'PendingApproval' | 'Approved' | 'Rejected' | 'Cancelled' | 'Paused' | 'Resumed': Novo tipo de resultado unificado para queries e operações administrativas. Substitui TransactionResultType com melhor semântica.
  - `BalanceInBrl` number, double: Saldo atual em BRL.
  - `BalanceInCredits` integer: Saldo atual em créditos.
  - `DataSourceCategory` string: Categoria da fonte de dados
  - `Date` string, date-time: Data da transação.
  - `ElapsedTimeInMilliseconds` integer: Tempo de execução (em milisegundos).
  - `ExecutedDataSourceName` string: Nome de exibição do tipo de consulta que realmente executou.
  - `ExecutedDataSourceTypeId` integer: Id do tipo de consulta que realmente executou (o gravado na transação), que pode diferir do tipo pedido quando a rota é genérica por UF ou quando um master delega a uma sub-consulta.
  - `HasOriginalFiles` boolean: Indica que a transação carrega arquivos originais da fonte (a certidão emitida, por exemplo) para download em OriginalFilesUrl. Falso não significa que a URL não exista: ela é montada sempre.
  - `HasPdf` boolean: Indica que existe PDF de comprovante do resultado.
  - `Message` string: Mensagem.
  - `OriginalFilesUrl` string: Url para download dos arquivos originais da transação (quando disponíveis).
  - `OutdatedResult` boolean: Indica que o resultado é datado.
  - `PdfUrl` string: Url para download do arquivo de comprovante em PDF da transação (quando disponível).
  - `ResultSubtype` string: Subtipo específico do resultado para fornecer contexto adicional (ex: 'duplicate_name', 'invalid_cpf').
  - `ResultTypeCode` integer: Código numérico do resultado (compatível com TransactionResultTypeCode mas extensível).
  - `TotalCost` number, double: Internal use only.
  - `TotalCostInCredits` integer: Custo total da transação em créditos.
  - `TransactionResultType` 'Success' | 'SuccessWithRemarks' | 'InvalidInputData' | 'UnavailableData' | 'EntityNotFound' | 'InvalidParameters' | 'ParametersNotSupported' | 'RemoteSystemUnavailable' | 'Timeout' | 'AttemptsLimitReached' | 'RemoteSystemError' | 'AsyncExecutionInProgress' | 'AwaitingExecution' | 'BirthDateRequired' | 'InsufficientBalance' | 'SimultaneousTransactionsLimitReached' | 'TransactionUnavailable' | 'AccessDenied' | 'TransactionCancelled' | 'InternalError': <table class="transaction"><thead><tr><th>TransactionResultType Code</th><th>TransactionResultType</th><th>Definitivo</th><th>Faturavel</th><th>Erro</th></tr></thead><tbody><tr><td>1</td><td>Sucesso</td><td>Verdadeiro</td><td>Verdadeiro</td><td>Falso</td></tr><tr><td>2</td><td>Sucesso parcial ou com observações</td><td>Verdadeiro</td><td>Verdadeiro</td><td>Falso</td></tr><tr><td>3</td><td>Entrada ou documento inválido</td><td>Verdadeiro</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>4</td><td>Dados não disponíveis</td><td>Verdadeiro (no dia)</td><td>Falso</td><td>Falso</td></tr><tr><td>5</td><td>Entidade ou documento inexistente/não encontrado</td><td>Verdadeiro</td><td>Verdadeiro</td><td>Falso</td></tr><tr><td>6</td><td>Parâmetros de entrada inválidos</td><td>Verdadeiro</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>7</td><td>Combinação de parâmetros não suportados</td><td>Verdadeiro</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>8</td><td>Fonte de dados ou sistema remoto indisponível</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>9</td><td>Limite de tempo esgotado</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>10</td><td>Limite de tentativas atingido</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>11</td><td>Erro na fonte de dados ou sistema remoto</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>12</td><td>Transação em execução</td><td>Falso</td><td>Falso</td><td>Falso</td></tr><tr><td>101</td><td>Saldo em créditos insuficiente, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>102</td><td>Limite de transações simultâneas atingido, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>103</td><td>Transação não disponível, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>104</td><td>Credenciais inválidas ou acesso negado, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>105</td><td>Transação cancelada, entre em contato</td><td>Falso</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>255*</td><td>Erro interno não esperado, entre em contato</td><td>Verdadeiro (no dia)</td><td>Falso</td><td>Verdadeiro</td></tr><tr><td>* Consulta em manutenção, tente refazer mais tarde ou entre em contato com a Exato para notificação do problema</td></tr></tbody></table>
  - `TransactionResultTypeCode` integer: Código do tipo de resultado da transação.
  - `UniqueIdentifier` string: Identificador único da transação. Recomendado armazenar para controle e depuração.
  - `Result` ExatoCadastroPessoaJuridicaResult: ExatoCadastroPessoaJuridicaResult
    - `Empresa` Empresa: Empresa
      - `Cnpj` integer
      - `Eid` string
      - `Matriz` boolean
      - `NomeEmpresarial` string
      - `NomeEmpresarialAnteriores` string[]
      - `NomeFantasia` string
      - `NomeFantasiaAnteriores` string
      - `SituacaoCadastral` integer
      - `SituacaoCadastralDescricao` string
      - `SituacaoCadastralData` string, date-time
      - `SituacaoCadastralMotivo` integer
      - `NomeCidadeExterior` string
      - `PaisCodigo` integer
      - `PaisNome` string
      - `CodigoNaturezaJuridica` integer
      - `NaturezaJuridicaDescricao` string
      - `InicioAtividadeData` string, date-time
      - `CnaeFiscal` integer
      - `CnaeFiscalDescricao` string
      - `CnaesSecundarias` integer[]
      - `CnaesSecundariasNormalizado` DictionaryInt32String: Dictionary<Int32,String>
      - `ResponsavelQualificacao` integer
      - `CapitalSocial` number, double
      - `Porte` string
      - `SimplesOpcao` boolean
      - `SimplesOpcaoData` string, date-time
      - `SimplesExclusaoData` string, date-time
      - `ImeiOpcao` boolean
      - `ImeiOpcaoData` string, date-time
      - `SituacaoEspecial` string
      - `SituacaoEspecialData` string, date-time
      - `Efr` string
      - `CertidaoBaixa` string
      - `SintegraInscricaoEstadual` string
      - `SintegraInscricaoEstadualNumero` integer
      - `SintegraInscricaoEstadualData` string, date-time
      - `SintegraSituacaoCadastral` string
      - `SintegraSituacaoCadastralAtivaHabilitada` boolean
      - `SintegraSituacaoCadastralData` string, date-time
      - `QtdFuncionarios` integer
      - `FaturamentoAnualPresumido` number, double
      - `SetorPublico` boolean
      - `AtivaComercialmente` boolean
      - `ReceitaRecencia` string, date-time
      - `SintegraRecencia` string, date-time
      - `Recencia` string, date-time
      - `Website` string
    - `Enderecos` Endereco[]
      - `Ordem` integer
      - `EnderecoTipoId` string
      - `MunicipioId` integer
      - `Uf` string
      - `Municipio` string
      - `Bairro` string
      - `TipoLogradouro` string
      - `Logradouro` string
      - `Numero` string
      - `Complemento` string
      - `Cep` integer
    - `Telefones` Telefone[]
      - `Ordem` integer
      - `Ddd` integer
      - `Numero` integer
      - `TelefoneTipoId` string
    - `Celulares` Telefone[]
      - `Ordem` integer
      - `Ddd` integer
      - `Numero` integer
      - `TelefoneTipoId` string
    - `Emails` Email[]
      - `Ordem` integer
      - `EmailEndereco` string
    - `Socios` Socio[]
      - `Empresa` EmpresaRelacionada: EmpresaRelacionada
        - `Cnpj` integer
        - `RazaoSocial` string
        - `MatrizFilial` integer
        - `DataAbertura` string, date-time
        - `RaizCnpj` string
      - `SocioPessoaJuridica` EmpresaRelacionada: EmpresaRelacionada
        - `Cnpj` integer
        - `RazaoSocial` string
        - `MatrizFilial` integer
        - `DataAbertura` string, date-time
        - `RaizCnpj` string
      - `SocioPessoaFisica` PessoaRelacionada: PessoaRelacionada
        - `Cpf` integer
        - `Nome` string
        - `NascimentoData` string, date-time
        - `Obito` boolean
        - `ObitoAno` integer
        - `ObitoData` string, date-time
        - `RendaMensalPresumida` number, double
        - `PepFuncao` string
        - `PepCarenciaFim` string, date-time
        - `TipoRelacionamento` string
        - `ReceitaSituacaoCadastral` string
        - `ReceitaUltimaConsultaData` string, date-time
      - `PercentualCapital` number, double
      - `Entrada` string, date-time
      - `QualificacaoSocio` string
      - `Atual` boolean
      - `Qualificacao` integer
      - `RepresentanteLegal` PartnerLegalRepresentative: PartnerLegalRepresentative
        - `Nome` string
        - `Cpf` integer
        - `CpfMascarado` string
        - `Qualificacao` integer
        - `QualificacaoDescricao` string
    - `Sociedades` Sociedade[]
      - `Empresa` EmpresaRelacionada: EmpresaRelacionada
        - `Cnpj` integer
        - `RazaoSocial` string
        - `MatrizFilial` integer
        - `DataAbertura` string, date-time
        - `RaizCnpj` string
      - `Qualificacao` integer
      - `QualificacaoDescricao` string
      - `PercentualCapital` number, double
      - `Entrada` string, date-time
      - `Atual` boolean
      - `IsMei` boolean
      - `OwnerCpfSource` string
      - `OwnerLegalNature` string
    - `Branches` BranchEstablishmentList: BranchEstablishmentList
      - `Items` BranchEstablishment[]
        - `Cnpj` string
        - `IsHeadquarters` boolean
        - `TradeName` string
        - `RegistrationStatus` integer
        - `RegistrationStatusDescription` string
        - `RegistrationStatusDate` string, date-time
        - `OpeningDate` string, date-time
        - `City` string
        - `State` string
      - `Total` integer
      - `ActiveTotal` integer
      - `SnapshotDate` string, date-time
      - `CnpjRoot` string
    - `Owner` CompanyOwner: CompanyOwner
      - `Person` PessoaRelacionada: PessoaRelacionada
        - `Cpf` integer
        - `Nome` string
        - `NascimentoData` string, date-time
        - `Obito` boolean
        - `ObitoAno` integer
        - `ObitoData` string, date-time
        - `RendaMensalPresumida` number, double
        - `PepFuncao` string
        - `PepCarenciaFim` string, date-time
        - `TipoRelacionamento` string
        - `ReceitaSituacaoCadastral` string
        - `ReceitaUltimaConsultaData` string, date-time
      - `CpfSource` string
      - `LegalNature` string

---

[API](https://skmtc.dev/directdigital/apis/backend-apis.md) - [All operations](https://skmtc.dev/directdigital/apis/backend-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/directdigital/apis/backend-apis/revisions/ed0f26ffe529?raw)