> 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/conectar/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/api-core/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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.caf.io/caf-api/caf-api-pt-br/conectar/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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.