> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/connect/transactions/services/global-doc-verification.md). # 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. {% tabs %} {% tab title="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) | Status geral das validações. | | data.validations.authenticityCheck | objeto | Verificações de autenticidade do documento. | | data.validations.authenticityCheck.status | [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) | Status geral da verificação de autenticidade para a imagem correspondente. | | data.validations.authenticityCheck.*{documentSide}*.imagePattern.result | [Status](#status) | Status da verificação de presença/ausência de padrões de imagem. | | data.validations.authenticityCheck.*{documentSide}*.photoEmbedType.result | [Status](#status) | Status da verificação da foto incorporada. | | data.validations.authenticityCheck.*{documentSide}*.barcodeFormatCheck.result | [Status](#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) | 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) | 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) | Status da verificação da integridade da MRZ. | | data.validations.textFieldsCheck.documentExpiry.result | [Status](#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) | 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) | Status geral da verificação da qualidade da imagem para a imagem correspondente. | | data.validations.imageQualityCheck.*{documentSide}*.imageColorness | [Status](#status) | Indica se a imagem não é colorida. | | data.validations.imageQualityCheck.*{documentSide}*.imageFocus | [Status](#status) | Indica se a imagem está em foco. | | data.validations.imageQualityCheck.*{documentSide}*.bounds | [Status](#status) | Indica se o documento não está totalmente presente na imagem. | | data.validations.imageQualityCheck.*{documentSide}*.imageGlares | [Status](#status) | Indica a presença de reflexo na imagem. | | data.validations.imageQualityCheck.*{documentSide}*.perspective | [Status](#status) | Indica se o documento na imagem tem distorção de perspectiva acima do limite. | | data.validations.imageQualityCheck.*{documentSide}*.portrait | [Status](#status) | Indica se o retrato está presente. | | data.validations.imageQualityCheck.*{documentSide}*.imageResolution | [Status](#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](/caf-api/caf-api-pt-br/core-api/transaction-details.md) | | {% endtab %} | | | {% tab title="Exemplo" %} ```json { "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" } ``` {% endtab %} {% tab title="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. | | {% endtab %} | | | {% endtabs %} | | {% hint style="info" %} 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 {% endhint %} {% hint style="info" %} Os campos retornados e não documentados são de uso interno בלבד. {% endhint %} ## 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**. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.caf.io/caf-api/caf-api-pt-br/connect/transactions/services/global-doc-verification.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.