> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos/extractionfinish.md).

# extractionFinish

A extração do documento foi concluída com sucesso.

## Detalhes

É emitido ao concluir a extração do documento com todos os dados esperados.

**Evento:** `extractionFinish`

**Tipo:** `FacephiSelphidWidgetCustomEvent<SelphidExtractionFinishEvent>` | `CustomEvent<SelphidExtractionFinishEvent>`

### Sintaxe

```typescript
selphid.addEventListener('extractionFinish', onExtractionFinish);
```

### Objeto recebido

O payload útil é do tipo `SelphidExtractionFinishDetail` e está em `event.detail.detail`:

* `eventType` (`string`): Tipo de evento emitido.
* `cameraId` (`string`): ID da câmera utilizada.
* `result` (`object`): Resultados da extração.
  * `alphabetUsed` (`string` | `null`): Alfabeto utilizado na extração (opcional).
  * `diagnostic` (`number`): Código de diagnóstico da extração.
  * `detectionStatus` (`object`): Estado do documento detectado.
    * `status` (`number`): Estado da extração.
    * `quad` (`object`): Posição do documento no frame (opcional).
      * `topLeft` (`{ x, y }`): Canto superior esquerdo.
      * `topRight` (`{ x, y }`): Canto superior direito.
      * `bottomLeft` (`{ x, y }`): Canto inferior esquerdo.
      * `bottomRight` (`{ x, y }`): Canto inferior direito.
    * `glare` (`boolean`): Reflexo detectado no documento (opcional).
    * `internalStatus` (`object`): Estado interno do mecanismo.
      * `standard` (`number`): Código de estado padrão.
  * `extractionData` (`object`): Campos OCR estruturados.
    * `firstName` (`string`): Nome.
    * `lastName` (`string`): Sobrenome.
    * `fullName` (`string`): Nome completo (opcional).
    * `gender` (`string`): Gênero.
    * `nationality` (`string`): Nacionalidade.
    * `dateOfBirth` (`string`): Data de nascimento.
    * `placeOfBirth` (`string`): Local de nascimento.
    * `documentId` (`string`): Identificador do documento.
    * `documentNumber` (`string`): Número do documento.
    * `dateOfExpiry` (`string`): Data de validade.
    * `dateOfIssue` (`string`): Data de emissão.
    * `address` (`string`): Endereço.
    * `documentType` (`number`): Tipo de documento (código numérico).
    * `documentTypeString` (`string`): Tipo de documento (texto).
    * `isSingleSideDocument` (`boolean`): Indica se o documento tem apenas uma face.
    * `residencePermitType` (`string`): Tipo de autorização de residência (opcional).
    * `visaType` (`string`): Tipo de visto (opcional).
    * `debug1` (`number`): Campo interno de depuração.
    * `documentCountryIssuer` (`string`): País emissor do documento.
    * `documentCountryIssuerIso2` (`string`): Código ISO-2 do país emissor.
    * `documentCountryIssuerIso3` (`string`): Código ISO-3 do país emissor (opcional).
    * `section` (`string`): Seção do documento (opcional).
    * `serie` (`string`): Série do documento (opcional).
  * `extractionRaw` (`object`): Dados brutos extraídos do documento.
    * `mrz` (`object`): Dados do MRZ.
      * `rawData` (`string`): Linha MRZ bruta.
      * `opt1` (`string`): Campo opcional 1 do MRZ.
      * `opt2` (`string`): Campo opcional 2 do MRZ.
      * `firstName` (`string`): Nome.
      * `lastName` (`string`): Sobrenome.
      * `documentId` (`string`): Identificador do documento.
      * `documentNumber` (`string`): Número do documento.
      * `documentIssuer` (`string`): Emissor do documento.
      * `dateOfExpiry` (`string`): Data de validade.
      * `dateOfBirth` (`string`): Data de nascimento.
      * `gender` (`string`): Gênero.
      * `nationality` (`string`): Nacionalidade.
    * `ocr` (`object`): Dados do OCR.
      * `firstName` (`string`): Nome.
      * `lastName` (`string`): Sobrenome.
      * `fullName` (`string`): Nome completo (opcional).
      * `documentId` (`string`): Identificador do documento.
      * `documentNumber` (`string`): Número do documento.
      * `dateOfBirth` (`string`): Data de nascimento.
      * `dateOfExpiry` (`string`): Data de validade.
      * `dateOfIssue` (`string`): Data de emissão.
      * `gender` (`string`): Gênero.
      * `nationality` (`string`): Nacionalidade.
  * `images` (`object`): Imagens recortadas do documento.
    * `frontDocument` (`string` | `null` | `undefined`): Frente.
    * `backDocument` (`string` | `null` | `undefined`): Verso.
    * `faceImage` (`string` | `null` | `undefined`): Rosto no documento.
    * `signatureImage` (`string` | `null` | `undefined`): Assinatura.
  * `imagesFullsize` (`object`): Imagens em tamanho real.
    * `frontDocument` (`string` | `null` | `undefined`): Frente completa.
    * `backDocument` (`string` | `null` | `undefined`): Verso completo.
  * `imagesRaw` (`object`): Imagens brutas (`ImageData`).
    * `frontDocument` (`ImageData` | `null` | `undefined`): Frente bruta.
    * `backDocument` (`ImageData` | `null` | `undefined`): Verso bruto.
    * `faceImage` (`ImageData` | `null` | `undefined`): Rosto bruto.
    * `signatureImage` (`ImageData` | `null` | `undefined`): Assinatura bruta.
  * `barCodeExtractionDataFrontDocument` (`object`): Dados do código de barras da frente do documento (opcional).
    * `firstName` (`string`): Nome.
    * `lastName` (`string`): Sobrenome.
    * `gender` (`string`): Gênero.
    * `nationality` (`string`): Nacionalidade.
    * `dateOfBirth` (`string`): Data de nascimento.
    * `placeOfBirth` (`string`): Local de nascimento.
    * `documentNumber` (`string`): Número do documento.
    * `documentAdditionalNumber` (`string`): Número adicional do documento.
    * `dateOfExpiry` (`string`): Data de validade.
    * `dateOfIssue` (`string`): Data de emissão.
    * `address` (`string`): Endereço.
    * `city` (`string`): Cidade.
    * `postalCode` (`string`): Código postal.
    * `documentType` (`string`): Tipo de documento (opcional).
    * `barcodeType` (`string`): Tipo de código de barras (opcional).
    * `rawData` (`Uint8Array`): Dados brutos do código (opcional).
    * `stringData` (`string`): Dados em texto do código (opcional).
  * `barCodeExtractionDataBackDocument` (`object`): Dados do código de barras do verso do documento (opcional). Mesma estrutura que `barCodeExtractionDataFrontDocument`.
  * `tokenizedData` (`string`): Imagens tokenizadas (opcional).
  * `iqaParameters` (`object`): Parâmetros de qualidade da imagem (opcional).
    * `diagnostic` (`string`): Diagnóstico de IQA.
    * `iqaOverExposure` (`number`): Superexposição.
    * `iqaUnderExposure` (`number`): Subexposição.
    * `iqaSharpness` (`number`): Nitidez.
    * `iqaReadability` (`number`): Legibilidade.
    * `documentClass` (`string`): Classe do documento.
    * `documentCaptured` (`string`): Documento capturado.
    * `ocrFields` (`number`): Campos OCR detectados.
    * `imgFields` (`number`): Campos de imagem detectados.
    * `morePagesAvailable` (`boolean`): Indica se há mais páginas disponíveis.
* `videoRecorded` (`Record<string, string>` | `null`): Vídeo gravado do processo, se aplicável.
* `advancedTracking` (`Uint8Array` | `null`): Tracking avançado codificado (opcional).
* `ocrResult` (`OcrDetail`): Resultado OCR estruturado do mecanismo.
  * `version` (`number`): Versão do formato OCR.
  * `type` (`string`): Tipo de documento detectado.
  * `model` (`string`): Modelo OCR utilizado.
  * `ocr` (`object`): Mapa de campos OCR (`{ [field]: { value, confidence?, source? } }`).
  * `images` (`OcrImage[]`): Imagens associadas ao resultado.
  * `viz` (`OcrViz[]`): Campos lidos da zona visual.
  * `mrz` (`OcrMrz[]` ): Resultados MRZ (opcional).
  * `encoded` (`OcrEncoded[]` ): Dados codificados em QR/barcode (opcional). Com [`codeReader`](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/codereader.md) ativado, o código lido aparece aqui (por exemplo, `{ type: 'qr', side: 1, raw: '...' }`), não em `result.images`.
  * `nfc` (`OcrNfc[]` ): Dados NFC (opcional).
  * `checks` (`object` ): Verificações de consistência.
    * `field_inconsistency` (`FieldInconsistency[]` ): Inconsistências entre fontes.
* `coordinates` (`object` | `null` ): Coordenadas do usuário (`latitude`, `longitude` e `accuracy`). Está presente sempre que [geolocation](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/geolocation.md) não for `DISABLED`, e vale `null` quando a localização não foi obtida, seja porque a permissão foi negada ou porque ainda não houve resposta. O resultado da solicitação, com seu motivo, é informado em [geolocationFinish](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/eventos/geolocationfinish.md). Em TypeScript, `coordinates` está tipado em `SelphidExtractionFinishDetail` de `@facephi/sdk-web-wc` e `@facephi/sdk-web-react`; os tipos do pacote `@facephi/selphid-web-component` não o incluem.

## Descrição

Contém os dados do documento, imagens e metadados da captura.

### Considerações

O payload útil está em `event.detail.detail` (consulte [formato dos eventos](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/eventos.md#formato-de-los-eventos)).

A Facephi recomenda extrair os dados OCR no backend usando as imagens da frente e do verso do documento (`result.images.frontDocument`, `result.images.backDocument`) em vez de confiar apenas em `extractionData`.

## Com [`codeReader`](https://docs.facephi.com/docs.facephi-pt-br/sdks/sdk-web/componentes/selphid-documentos/propiedades/codereader.md) no modo `optional`, este evento também pode ser emitido sem dados de código se o orçamento de varredura se esgotar.

## Exemplo

```jsx
<facephi-selphid-widget
    onExtractionFinish={(event) => {
      const { result } = event.detail.detail;
      saveResults(result.images.frontDocument, result.images.backDocument);
    }}
/>
```

```typescript
import { type SelphidExtractionFinishDetail } from '@facephi/sdk-web-wc';

selphid.addEventListener('extractionFinish', (event) => {
  const detail: SelphidExtractionFinishDetail = event.detail.detail;
});
```
