--- title: "Equatorial - Troca de Titularidade" method: POST path: "/br/customer/equatorial/troca-titularidade" tags: ["br"] --- # Equatorial - Troca de Titularidade `POST /br/customer/equatorial/troca-titularidade` ## Request - Base URL: `https://api.directdigital.com.br` - URL: `https://api.directdigital.com.br/br/customer/equatorial/troca-titularidade` - Auth: API key in header `token` Equatorial - Troca de Titularidade ## Query parameters - `test_mode` boolean - `lightweight` boolean ## Request body `application/x-www-form-urlencoded` - object - `arquivos` DocumentUploadDto[], required: Arquivos do processo (PDF, JPEG ou PNG em base64), de 1 a 20; um PDF pode conter vários documentos - `conteudo_base64` string, required: Conteúdo do arquivo em base64 (PDF, JPEG ou PNG), com ou sem o prefixo data:...;base64, - `mime_type` string, required: Tipo do arquivo: application/pdf, image/jpeg ou image/png - `nome_arquivo` string: Nome original do arquivo, só para exibição - `conta_contrato` string: Número da conta contrato na distribuidora, só para auditoria ## Response `200` Success - CustomerEquatorialTitularityChangeResponse: CustomerEquatorialTitularityChangeResponse - `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` CustomerEquatorialTitularityChangeResult: CustomerEquatorialTitularityChangeResult - `Findings` ChecklistItemDto[]: Itens do checklist; os itens por documento trazem DocumentIndex (índice em Inventory) e DocumentKind - `Code` string: Código estável do item, ex.: A4, B2.term, C2 - `Group` string: IdentityDocument, PropertyBondDocument, CrossChecks ou Signature - `Indicator` string: Green, Amber, Red ou Neutral - `Tag` string: Ok, Atenção, Importante, Inconclusivo; nulo em bloco de dados - `Message` string: O que foi verificado e o que se achou, com os valores comparados - `Field` string: Campo do resultado a que o item se refere - `Page` integer: Página do documento de origem - `DocumentIndex` integer: Índice do documento no inventário do processo (base 0); só na consulta por processo - `DocumentKind` string: Tipo do documento no inventário a que o item se refere; só na consulta por processo - `Inventory` SegmentedDocumentDto[]: Documentos encontrados no processo, na ordem em que o DocumentIndex dos itens os referencia - `Kind` string: ApplicationForm, IdentityFront, IdentityBack, IdentityDigitalCnh, CpfCard, CnpjCard, LeaseContract, SaleContract, PowerOfAttorney, DeathCertificate, MarriageCertificate, PropertyDeed, CorporateAct, NotaryCertificate, SignaturePage, UtilityBill, Other, Blank ou Unknown - `Label` string: Tipo em português - `Confidence` integer: Confiança da classificação, 0 a 100 - `Pages` PageRefDto[] - `FileIndex` integer - `PageNumber` integer - `FormIssuer` string: Só para formulário de solicitação: quem o emite, como impresso - `LooksRotated` boolean - `Incomplete` boolean: Verso de identidade sem a frente, ou frente sem verso - `UnclassifiedPages` PageRefDto[]: Páginas que não puderam ser classificadas - `FileIndex` integer - `PageNumber` integer - `SkippedPages` PageRefDto[]: Páginas acima do teto do processo, não analisadas - `FileIndex` integer - `PageNumber` integer - `TotalPages` integer - `RotatedPages` integer: Páginas que chegaram deitadas e foram postas de pé antes da análise - `SegmentationWarnings` string[] - `DeclaredByApi` DeclaredDataDto: DeclaredDataDto - `Cpf` string - `ApplicantName` string - `InstallationAddress` string - `Reason` string: Unknown, RuralLease, Lease, PurchaseAndSale, Death, Assignment ou Other - `ReasonText` string - `PreviousHolderRelation` string: Unknown, None, Spouse, Relative, Tenant, Buyer ou Other - `PreviousHolderRelationText` string - `ContractAccount` string - `DeclaredByForm` DeclaredDataDto: DeclaredDataDto - `Cpf` string - `ApplicantName` string - `InstallationAddress` string - `Reason` string: Unknown, RuralLease, Lease, PurchaseAndSale, Death, Assignment ou Other - `ReasonText` string - `PreviousHolderRelation` string: Unknown, None, Spouse, Relative, Tenant, Buyer ou Other - `PreviousHolderRelationText` string - `ContractAccount` string - `Declared` DeclaredDataDto: DeclaredDataDto - `Cpf` string - `ApplicantName` string - `InstallationAddress` string - `Reason` string: Unknown, RuralLease, Lease, PurchaseAndSale, Death, Assignment ou Other - `ReasonText` string - `PreviousHolderRelation` string: Unknown, None, Spouse, Relative, Tenant, Buyer ou Other - `PreviousHolderRelationText` string - `ContractAccount` string - `ApplicationForm` ApplicationFormDto: ApplicationFormDto - `Issuer` string - `Quality` string - `NewContractAccount` string - `BusinessPartner` string - `Installation` string - `ServiceRequest` string - `NisBpc` string - `ApplicantName` string - `ApplicantCpf` string - `ApplicantPhone` string - `ApplicantEmail` string - `PresentedDocuments` string[]: Caixas marcadas: RgOrRani, Cpf, ProfessionalCard, Cnh, Ctps, Passport, LeaseContract, OwnershipDocument, PowerOfAttorney, RepresentationDocument, DeathCertificate, Other - `OtherPresentedDocuments` string - `SupplyStatus` string: Unknown, Connected, Suspended ou Disconnected - `MeterReading` string - `Reason` string - `ReasonOther` string - `PreviousHolderRelation` string - `PreviousHolderRelationOther` string - `Activity` string: Unknown, Residential, Industrial, Rural ou Commercial - `OccupationDate` string, date-time - `SignaturePlace` string - `SignatureDate` string, date-time - `SignaturePresent` boolean - `ApplicationFormDocumentIndex` integer - `IdentityDocuments` AnalyzedIdentityDocumentDto[]: Um por documento de identificação do processo, com os dados extraídos e a conferência na Receita Federal - `DocumentIndex` integer - `Analysis` IdentityDocumentDto: IdentityDocumentDto - `DocumentKind` string - `DocumentKindLabel` string - `FileNature` string - `PageCount` integer - `Quality` string - `FullName` string - `Cpf` string - `BirthDate` string, date-time - `IssueDate` string, date-time - `IssuingAgency` string - `IssuingState` string - `DocumentNumber` string - `MotherName` string - `FatherName` string - `RgValidUntil` string, date-time - `FraudPercent` integer - `AiGeneratedPercent` integer - `QrCodeSignatureValid` boolean - `ReceitaAvailable` boolean - `ReceitaFound` boolean - `ReceitaName` string - `ReceitaBirthDate` string, date-time - `ReceitaRegistrationStatus` string - `ReceitaDeceased` boolean - `AnalysisFailure` string - `PropertyBondDocuments` AnalyzedPropertyBondDocumentDto[]: Um por documento de vínculo do processo, com os dados extraídos - `DocumentIndex` integer - `Analysis` PropertyBondDocumentDto: PropertyBondDocumentDto - `DocumentKind` string - `DocumentKindLabel` string - `FileNature` string - `PageCount` integer - `TruncatedPages` integer - `IllegiblePages` integer[] - `Quality` string - `PropertyAddress` string - `Landlords` ContractPartyDto[] - `Name` string - `Document` string - `Page` integer - `Tenants` ContractPartyDto[] - `Name` string - `Document` string - `Page` integer - `SignedOn` string, date-time - `TermStart` string, date-time - `TermEnd` string, date-time - `IndeterminateTerm` boolean - `PermissionsClausePresent` boolean - `PartiesDocumentsListed` boolean - `SignatureFieldsPresent` boolean - `Purpose` string - `DigitalSignatureStamps` DigitalSignatureStampDto[] - `SignerName` string - `SignerDocument` string - `SignedAt` string, date-time - `Tool` string - `Page` integer - `EmbeddedSignatureCount` integer - `AddressMatch` AddressMatchDto: AddressMatchDto - `Verdict` string - `ZipCodeMatches` boolean - `NumberMatches` boolean - `Reasons` string[] - `MissingRequiredFields` string[] - `AnalysisFailure` string - `NotarySeals` NotarySealDto[] - `NotaryOffice` string - `OfficialName` string - `ActType` string: SignatureAuthenticityRecognition, SignatureLikenessRecognition, CopyAuthentication, Other ou Unknown - `SignerNames` string[] - `ActDate` string, date-time - `SealCode` string - `Page` integer - `Timings` StepTimingDto[]: Tempo por etapa (segmentação, formulário, cada sub, Receita, montagem) - `Step` string: segmentation, form, receita-applicant, identity, property-bond, receita-landlord ou checklist - `DocumentIndex` integer - `ElapsedMs` integer ## Changes > 15 revisions in range; 1 not diffed. - **2026-10-27** `09bf52e0c8ce`: 1 info - endpoint added [Operation history](https://skmtc.dev/directdigital/apis/backend-apis/changes/br/customer/equatorial/troca-titularidade/post.md) --- [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)