Verificação global de documentos

O serviço Global Document Verification processa documentos de identidade, extraindo informações e realizando verificações como qualidade da imagem, tipo de documento, integridade dos dados, validade do documento e pontos de autenticidade, para garantir veracidade e qualidade.

Seção: globalDocVerification

Parâmetro obrigatório: arquivos (quaisquer imagens de documentos)

Campos e regras

Confira os exemplos, regras e atributos para o serviço funcionar.

Esquema

Atributo	Tipo	Descrição
data	objeto	Objeto contendo os dados principais.
data.documentCategory	string	Categoria do documento.
data.documentType	string	Tipo e versão do documento.
data.documentNumber	string	Número do documento.
data.name	string	Nome completo do titular.
data.sex	string	Sexo do titular.
data.birthDate	string	Data de nascimento do titular.
data.birthPlace	string	Local de nascimento do titular.
data.nationality	string	Nacionalidade do titular.
data.nationalityCode	string	Código de nacionalidade do titular.
data.address	string	Endereço completo do titular.
data.issueState	string	Estado ou país emissor do documento.
data.issueStateCode	string	Código do estado/país emissor (ISO 3166-1 alpha-3).
data.authority	string	Autoridade emissora do documento.
data.issueDate	string	Data de emissão do documento.
data.expirationDate	string	Data de expiração do documento.
data.validations.overallStatus	Status	Status geral das validações.
data.validations.authenticityCheck	objeto	Verificações de autenticidade do documento.
data.validations.authenticityCheck.status	Status	Status geral da verificação de autenticidade.
data.validations.authenticityCheck.{documentSide}	objeto	Resultados das verificações de autenticidade realizadas em cada lado do documento. {documentSide} pode ser frente ou verso.
data.validations.authenticityCheck.{documentSide}.result	Status	Status geral da verificação de autenticidade para a imagem correspondente.
data.validations.authenticityCheck.{documentSide}.imagePattern.result	Status	Status da verificação de presença/ausência de padrões de imagem.
data.validations.authenticityCheck.{documentSide}.photoEmbedType.result	Status	Status da verificação da foto incorporada.
data.validations.authenticityCheck.{documentSide}.barcodeFormatCheck.result	Status	Status da verificação do formato do código de barras.
data.validations.documentType	objeto	Verificações do tipo de documento.
data.validations.documentType.validityStatus	Status	Status da verificação do tipo de documento.
data.validations.textFieldsCheck	objeto	Verificações dos campos de texto do documento.
data.validations.textFieldsCheck.status	Status	Status geral da verificação dos campos de texto (comparação cruzada de diferentes fontes, datas e verificação de dígitos verificadores).
data.validations.textFieldsCheck.mrz	Status	Status da verificação da integridade da MRZ.
data.validations.textFieldsCheck.documentExpiry.result	Status	Status da verificação de expiração do documento.
data.validations.imageQualityCheck	objeto	Verificações de qualidade da imagem.
data.validations.imageQualityCheck.status	Status	Status geral da verificação da qualidade da imagem.
data.validations.imageQualityCheck.{documentSide}	objeto	Resultados das verificações de qualidade da imagem realizadas em cada lado do documento. {documentSide} pode ser frente ou verso.
data.validations.imageQualityCheck.{documentSide}.result	Status	Status geral da verificação da qualidade da imagem para a imagem correspondente.
data.validations.imageQualityCheck.{documentSide}.imageColorness	Status	Indica se a imagem não é colorida.
data.validations.imageQualityCheck.{documentSide}.imageFocus	Status	Indica se a imagem está em foco.
data.validations.imageQualityCheck.{documentSide}.bounds	Status	Indica se o documento não está totalmente presente na imagem.
data.validations.imageQualityCheck.{documentSide}.imageGlares	Status	Indica a presença de reflexo na imagem.
data.validations.imageQualityCheck.{documentSide}.perspective	Status	Indica se o documento na imagem tem distorção de perspectiva acima do limite.
data.validations.imageQualityCheck.{documentSide}.portrait	Status	Indica se o retrato está presente.
data.validations.imageQualityCheck.{documentSide}.imageResolution	Status	Indica se a resolução da imagem está abaixo do limite.
statusCode	string	Refere-se ao status desta consulta específica, não à transação inteira. Consulte nosso guia de status

Exemplo

{
    "data": {
        "documentCategory": "DRIVER_LICENSE",
        "documentType": "United Kingdom - Driver License (2021) #1",
        "documentNumber": "XXXXXXXXXXXXXXXX",
        "name": "JANE DOE",
        "sex": "F",
        "birthDate": "11/05/1993",
        "birthPlace": "UNITED KINGDOM",
        "nationality": "UNITED KINGDOM",
        "nationalityCode": "GBR",
        "address": "14 Meadow Lane, Nottingham, NGX XHQ",
        "issueState": "UNITED KINGDOM",
        "issueStateCode": "GBR",
        "authority": "DVLA",
        "issueDate": "01/04/2022",
        "expirationDate": "01/04/2032",
        "validations": {
            "overallStatus": 1,
            "authenticityCheck": {
                "status": 1,
                "back": {
                    "result": 1,
                    "imagePattern": {
                        "result": 1,
                    }
                },
                "front": {
                    "result": 1,
                    "imagePattern": {
                        "result": 1,
                    },
                    "photoEmbedType": {
                        "result": 1,
                    }
                }
            },
            "documentType": {
                "validityStatus": 1
            },
            "textFieldsCheck": {
                "status": 1,
                "mrz": 2,
                "documentExpiry": {
                    "result": 1,
                }
            },
            "imageQualityCheck": {
                "status": 1,
                "back": {
                    "result": 1,
                    "imageColorness": 2,
                    "imageFocus": 1,
                    "screenCapture": 2,
                    "bounds": 1,
                    "imageGlares": 1,
                    "perspective": 1,
                    "portrait": 2,
                    "imageResolution": 1
                },
                "front": {
                    "result": 1,
                    "imageColorness": 2,
                    "imageFocus": 1,
                    "screenCapture": 2,
                    "bounds": 1,
                    "imageGlares": 0,
                    "perspective": 1,
                    "portrait": 1,
                    "imageResolution": 1
                }
            }
        }
    },
    "statusCode": "01"
}

Regras de validação

Regra	Descrição
Validar campos do documento	Indica se todos os campos extraídos do documento são válidos.
Validar autenticidade do documento	Indica se todos os pontos de autenticidade verificados são válidos.

O formato de data usado é dd/MM/yyyy.

• dd = dia com dois dígitos
• MM = mês de dois dígitos
• yyyy = ano com quatro dígitos

Os campos retornados e não documentados são de uso interno בלבד.

Status

Quando o serviço de verificação de documentos é usado, alguns status sobre o que foi analisado podem ser retornados:

Valor	Descrição
0	A verificação foi realizada e o resultado é negativo.
1	A verificação foi realizada e o resultado é positivo.
2	A verificação foi não realizada.