--- title: "Exato - Cadastro Pessoa Física" method: POST path: "/br/exato/cadastro/pessoa-fisica" tags: ["Exato - Consultas"] --- # Exato - Cadastro Pessoa Física `POST /br/exato/cadastro/pessoa-fisica` ## Request - Base URL: `https://api.directdigital.com.br` - URL: `https://api.directdigital.com.br/br/exato/cadastro/pessoa-fisica` - Auth: API key in header `token` Exato - Cadastro Pessoa Física ## Query parameters - `test_mode` boolean - `lightweight` boolean ## Request body `application/x-www-form-urlencoded` - object - `cpf` string: Person's CPF (Brazilian Tax ID) / CPF a ser consultado - `telefone` string: Telefone com DDD (10-11 dígitos). Alternativa ao CPF - resolve o CPF automaticamente. - `relacionados` boolean: Indica se deve consultar as entidades relacionadas. Cobrança de um crédito adicional. - `get_rf_information_when_contact_not_found` boolean: Indica se deve retornar informações da Receita Federal (CPF, Nome, Data de Nascimento, Óbito) caso não exista nenhum dado de contato (endereço, telefone, email) disponível ## Response `200` Success - ExatoCadastroPessoaFisicaResponse: ExatoCadastroPessoaFisicaResponse - `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':
TransactionResultType CodeTransactionResultTypeDefinitivoFaturavelErro
1SucessoVerdadeiroVerdadeiroFalso
2Sucesso parcial ou com observaçõesVerdadeiroVerdadeiroFalso
3Entrada ou documento inválidoVerdadeiroFalsoVerdadeiro
4Dados não disponíveisVerdadeiro (no dia)FalsoFalso
5Entidade ou documento inexistente/não encontradoVerdadeiroVerdadeiroFalso
6Parâmetros de entrada inválidosVerdadeiroFalsoVerdadeiro
7Combinação de parâmetros não suportadosVerdadeiroFalsoVerdadeiro
8Fonte de dados ou sistema remoto indisponívelFalsoFalsoVerdadeiro
9Limite de tempo esgotadoFalsoFalsoVerdadeiro
10Limite de tentativas atingidoFalsoFalsoVerdadeiro
11Erro na fonte de dados ou sistema remotoFalsoFalsoVerdadeiro
12Transação em execuçãoFalsoFalsoFalso
101Saldo em créditos insuficiente, entre em contatoFalsoFalsoVerdadeiro
102Limite de transações simultâneas atingido, entre em contatoFalsoFalsoVerdadeiro
103Transação não disponível, entre em contatoFalsoFalsoVerdadeiro
104Credenciais inválidas ou acesso negado, entre em contatoFalsoFalsoVerdadeiro
105Transação cancelada, entre em contatoFalsoFalsoVerdadeiro
255*Erro interno não esperado, entre em contatoVerdadeiro (no dia)FalsoVerdadeiro
* Consulta em manutenção, tente refazer mais tarde ou entre em contato com a Exato para notificação do problema
- `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` ExatoCadastroPessoaFisicaResult: ExatoCadastroPessoaFisicaResult - `Pessoa` Pessoa: Pessoa - `Cpf` integer - `ExternalId` string - `CpfPrincipal` integer - `CpfsAlternativos` integer[] - `Nome` string - `NomeSocial` string - `Homonimos` integer - `NascimentoData` string, date-time - `Nascimento` string - `Idade` integer - `Signo` string - `Sexo` string - `MaeNome` string - `MaeCpf` integer - `PaiNome` string - `PaiCpf` integer - `Obito` boolean - `ObitoAno` integer - `ObitoData` string, date-time - `Nis` integer - `NisLista` integer[] - `Cns` integer - `RgNumero` string - `RgUf` string - `RgDataEmissao` string, date-time - `RgOrgaoEmissorCodigo` integer - `TituloEleitorNumero` integer - `TituloEleitorZona` string - `TituloEleitorSecao` string - `MunicipioNascimento` string - `RendaMensalPresumida` number, double - `ReceitaDataInscricao` string, date-time - `ReceitaUltimaConsultaData` string, date-time - `ReceitaSituacaoCadastral` string - `PepFuncao` string - `PepCarenciaFim` string, date-time - `RendaMensalPresumidaIndiceConfianca` number, double - `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 - `Parentes` 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 - `PessoasMesmoEndereco` 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 - `EmpresasMesmoEndereco` EmpresaRelacionada[] - `Cnpj` integer - `RazaoSocial` string - `MatrizFilial` integer - `DataAbertura` string, date-time - `RaizCnpj` 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 - `Empregadores` Empregador[] - `EmpresaRelacionada` EmpresaRelacionada: EmpresaRelacionada - `Cnpj` integer - `RazaoSocial` string - `MatrizFilial` integer - `DataAbertura` string, date-time - `RaizCnpj` string - `DataAdmissao` string, date-time - `DataDesligamento` string, date-time - `OutrosRelacionamentos` 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 - `PhoneResolution` PhoneResolutionInfo: PhoneResolutionInfo - `InputPhone` string - `ResolvedCpf` string - `ConfidenceScore` integer - `Candidates` PhoneResolutionCandidate[] - `Cpf` integer - `Nome` string - `Score` integer - `LegalRepresentations` LegalRepresentation[] - `Empresa` EmpresaRelacionada: EmpresaRelacionada - `Cnpj` integer - `RazaoSocial` string - `MatrizFilial` integer - `DataAbertura` string, date-time - `RaizCnpj` string - `RepresentedPartnerName` string - `RepresentedPartnerDocument` string - `RepresentedPartnerQualificacao` integer - `RepresentedPartnerQualificacaoDescricao` string - `Qualificacao` integer - `QualificacaoDescricao` string - `Entrada` string, date-time - `Atual` boolean - `Ativa` boolean - `LegalRepresentationsQty` integer --- [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)