Serviços / Documentos

Leitura de comprovante de endereço

POST/api/v1/oracle/document/address

Confere se o arquivo é um comprovante de endereço (conta de luz, água, gás, telefone ou internet, fatura de cartão, correspondência de banco ou de órgão público, IPTU) e se ele é dos últimos 3 meses, e devolve titular, CPF/CNPJ, endereço completo e as datas.

Envie a imagem ou o PDF em file. O prazo conta da data de emissão; sem ela, do vencimento; sem os dois, do fim do mês de referência. is_valid só é true quando é comprovante e está no prazo, e descricao diz o motivo quando não está.

É leitura do documento enviado: não confirma o endereço em outra fonte.

Tecnologia: OCR com visão computacional · tempo real

Parâmetros

filefileObrigatório

Imagem, HEIC ou PDF do comprovante de endereço.

file

Campos da resposta

Tipo de documento

document_type

string

Arquivo enviado

filename

string

Parecer e dados do comprovante

validation_result

Parecer da validação. Em faturamento, os meses vêm consolidados.

object

É comprovante de endereço

validation_result.is_proof_of_address

boolean

Tipo de documento

validation_result.tipo_documento

string

Emissor

validation_result.emissor

string

Titular

validation_result.titular

string

CPF/CNPJ do titular

validation_result.cpf_cnpj_titular

string

Logradouro

validation_result.logradouro

string

Número

validation_result.numero

string

Complemento

validation_result.complemento

string

Bairro

validation_result.bairro

string

Município

validation_result.municipio

string

UF

validation_result.uf

string

CEP

validation_result.cep

string

Data de emissão

validation_result.data_emissao

string

Vencimento

validation_result.data_vencimento

string

Mês de referência

validation_result.mes_referencia

string

Documento reconhecido

validation_result.is_valid

boolean

Data considerada

validation_result.data_considerada

string

Origem da data

validation_result.base_da_data

string

Dias desde a data

validation_result.dias_desde_a_data

integer

Dentro de 3 meses

validation_result.dentro_do_prazo

boolean

Data da conferência

validation_result.data_atual

string

Parecer

validation_result.descricao

string

Exemplo de resposta

Modelo de resposta: DocumentValidateOutput
JSON · response
{  "success": true,  "code": 200,  "code_message": "A requisição foi processada com sucesso.",  "errors": [],  "header": null,  "data_count": 1,  "data": [    {      "document_type": "COMPROVANTE_ENDERECO",      "filename": "conta-de-luz.pdf",      "validation_result": {        "is_proof_of_address": true,        "tipo_documento": "Conta de energia elétrica",        "emissor": "Companhia de Energia",        "titular": "FULANO DE TAL DA SILVA",        "cpf_cnpj_titular": "529.982.247-25",        "logradouro": "RUA EXEMPLO",        "numero": "100",        "complemento": "APTO 12",        "bairro": "CENTRO",        "municipio": "SAO PAULO",        "uf": "SP",        "cep": "01001-000",        "data_emissao": "02/10/2026",        "data_vencimento": "20/10/2026",        "mes_referencia": "09/2026",        "is_valid": true,        "data_considerada": "02/10/2026",        "base_da_data": "data_emissao",        "dias_desde_a_data": 16,        "dentro_do_prazo": true,        "data_atual": "18/10/2026",        "descricao": "Comprovante de endereço válido: emitido em 02/10/2026."      }    }  ]}

Casos de uso

Onboarding e KYC

Aceitar só comprovante recente e preencher o endereço do cadastro a partir dele.

Conferência de titularidade

Comparar o titular do comprovante com o cliente, e decidir se pede declaração de residência quando não é o mesmo.