Leitor global de documentos
O serviço Global Document Reader processa documentos de identidade, identificando o país e o tipo do documento, além de extrair as informações contidas nele.
Seção: globalDocReader
Parâmetro obrigatório: documentCountry e arquivos (imagens de qualquer documento)
Campos e regras
Confira os exemplos, regras e atributos para o funcionamento do serviço.
statusCode
string
Refere-se ao status desta consulta específica, não à transação inteira. Consulte nosso guia de status
data
objeto
Objeto contendo os dados principais.
data.files
array
Arquivos resultantes do processamento.
data.files[x].url
string
URL do arquivo.
data.documentType
objeto
Informações sobre o documento.
data.documentType.isoAlpha2CountryCode
string
País emissor do documento (ISO 3166-1 alfa 2).
data.documentType.isoAlpha3CountryCode
string
País emissor do documento (ISO 3166-1 alfa 3).
data.textFields
objeto
Informações extraídas do documento.
data.textFields.fields.{fieldName}
objeto
Campo do documento.
data.textFields.fields.{fieldName}.value
string
Valor do campo.
data.textFields.fields.{fieldName}.originalLanguage
objeto
(Opcional) Informações do campo no idioma original do documento.
data.textFields.fields.{fieldName}.originalLanguage.lang
string
Idioma do documento.
data.textFields.fields.{fieldName}.originalLanguage.value
string
Valor do campo no idioma original do documento.
{
"statusCode": "01",
"data": {
"files": [
{
"name": "CROPPED_DOC_FRONT",
"url": "https://..."
},
{
"name": "CROPPED_DOC_BACK",
"url": "https://..."
}
],
"documentType": {
"isoAlpha2CountryCode": "AR",
"isoAlpha3CountryCode": "ARG",
"type": "IDENTITY_CARD"
},
"textFields": {
"fields": {
"personalNumber": {
"value": "00000000000"
},
"givenNames": {
"value": "JANE DOE",
"originalLanguage": {
"lang": "Espanhol (Argentina)",
"value": "JANE DOE"
}
},
"surname": {
"value": "SILVA",
"originalLanguage": {
"lang": "Espanhol (Argentina)",
"value": "SILVA"
}
},
"name": {
"value": "SILVA JANE DOE",
"originalLanguage": {
"lang": "Espanhol (Argentina)",
"value": "SILVA JANE DOE"
}
},
"finalCheckDigit": {
"value": "0"
},
"expirationDateCheckDigit": {
"value": "4"
},
"expirationDate": {
"value": "2035-06-14"
},
"mrz": {
"value": "IDARG99999999<4<<<<<<<<<<<<<<<^8508085F3506144ARG<<<<<<<<<<<0^SILVA<<JANE<DOE<<"
},
"sex": {
"value": "F"
},
"birthDateCheckDigit": {
"value": "5"
},
"birthDate": {
"value": "1985-08-08"
},
"documentNumber": {
"value": "99999999"
},
"nationalityCode": {
"value": "ARG"
},
"documentNumberCheckDigit": {
"value": "4"
},
"controlNumber": {
"value": "00000000000"
},
"birthPlace": {
"value": "CIUDAD DE BUENOS AIRES",
"originalLanguage": {
"lang": "Espanhol (Argentina)",
"value": "CIUDAD DE BUENOS AIRES"
}
},
"identityCardNumber": {
"value": "000000000000000"
},
"address": {
"originalLanguage": {
"lang": "Espanhol (Argentina)",
"value": "ENDEREÇO DE EXEMPLO"
}
},
"issueDate": {
"value": "2020-02-20"
}
}
}
}
}O país no documento é o mesmo que o país especificado nos parâmetros
Verifica se o país no documento corresponde ao país especificado nos parâmetros.
Documento não expirado
Verifique se o documento não está expirado ou não tem uma data de validade.
Faixas etárias não aceitas
Verifica se a pessoa está na faixa etária configurada.
Tipos de dados
FileName
CROPPED_DOC_FRONT
Área frontal do documento recortada.
CROPPED_DOC_BACK
Área traseira do documento recortada.
DocType
IDENTITY_CARD
Documento de identidade.
DRIVER_LICENSE
Carteira de motorista ou permissão.
PASSPORT
Passaporte.
RESIDENCE_PERMIT
Carteira de identidade ou autorização para estrangeiros.
VISA
Visto.
VOTER_CARD
Título de eleitor ou documento de votação.
UNKNOWN
Documento desconhecido.
Campos
nome
Nome completo da pessoa.
givenNames
Nomes próprios da pessoa.
surname
Sobrenome da pessoa.
socialName
Nome social da pessoa.
sex
Sexo ou gênero da pessoa.
personalNumber
Número de identificação pessoal.
birthDate
Data de nascimento da pessoa.
birthPlace
Local de nascimento.
nationalityCode
Código de nacionalidade.
nationality
Nacionalidade da pessoa.
address
Endereço da pessoa.
uniqueNumber
Número de identificação único.
voterKey
Chave de título de eleitor.
fatherName
Nome do pai.
motherName
Nome da mãe.
documentNumber
Número de identificação do documento.
documentClass
Classe ou categoria do documento.
expirationDate
Data de validade do documento.
issueDate
Data de emissão do documento.
issuingAuthority
Autoridade que emitiu o documento.
issuePlace
Local de emissão do documento.
issuingCountryCode
Código do país emissor.
issuingStateCode
Código do estado emissor (unidade federativa).
mrz
Dados da Zona Legível por Máquina (MRZ).
controlNumber
Número de controle do documento.
optionalData
Campo de dados opcional.
identityCardNumber
Número da carteira de identidade.
identityCardIssuingAuthority
Autoridade que emitiu a carteira de identidade.
identityCardIssuingStateCode
Código do estado emissor da carteira de identidade.
dlCategory
Categoria da carteira de motorista.
firstIssueDate
Data da primeira emissão do documento.
bookletNumber
Número do livreto.
securityNumber
Número de segurança ou verificação.
renachNumber
Número do RENACH (carteira de motorista brasileira).
notes
Observações ou anotações adicionais.
entryDate
Data de entrada ou de registro.
dlCategoryAccExpirationDate
Data de validade da categoria ACC da carteira de motorista.
dlCategoryAExpirationDate
Data de validade da categoria A da carteira de motorista.
dlCategoryA1ExpirationDate
Data de validade da categoria A1 da carteira de motorista.
dlCategoryBExpirationDate
Data de validade da categoria B da carteira de motorista.
dlCategoryB1ExpirationDate
Data de validade da categoria B1 da carteira de motorista.
dlCategoryCExpirationDate
Data de validade da categoria C da carteira de motorista.
dlCategoryC1ExpirationDate
Data de validade da categoria C1 da carteira de motorista.
dlCategoryDExpirationDate
Data de validade da categoria D da carteira de motorista.
dlCategoryD1ExpirationDate
Data de validade da categoria D1 da carteira de motorista.
dlCategoryBeExpirationDate
Data de validade da categoria BE da carteira de motorista.
dlCategoryCeExpirationDate
Data de validade da categoria CE da carteira de motorista.
dlCategoryC1eExpirationDate
Data de validade da categoria C1E da carteira de motorista.
dlCategoryDeExpirationDate
Data de validade da categoria DE da carteira de motorista.
dlCategoryD1eExpirationDate
Data de validade da categoria D1E da carteira de motorista.
optionalDataCheckDigit
Dígito verificador do campo de dados opcional.
finalCheckDigit
Dígito verificador final para validação do documento.
expirationDateCheckDigit
Dígito verificador da data de validade.
documentNumberCheckDigit
Dígito verificador do número do documento.
birthDateCheckDigit
Dígito verificador da data de nascimento.
Atualizado