> 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/sdks/sdk-web/componentes/selphid-documentos/propiedades/codereader.md).

# codeReader

Paso opcional de captura de QR/código tras extraer el documento.

## Detalles

**Atributo:** `code-reader`

**Tipo:** `CodeReader`

**Valor por defecto:** `CodeReader.Off`

### CodeReader

| Miembro     | Valor         | Descripción                                                                                                                                                 |
| ----------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Off`       | `'off'`       | No abre la pantalla de código ni descarga assets del lector (valor por defecto).                                                                            |
| `Optional`  | `'optional'`  | Abre la pantalla si el catálogo lo pide. Si se agota el presupuesto de captura, salta el código y emite `extractionFinish` sin datos de código.             |
| `Mandatory` | `'mandatory'` | Igual que `optional`, pero si no se lee el código muestra timeout y emite `extractionTimeout`. El reintento reanuda el escaneo del código, no el documento. |

## Morfología

```typescript
import { CodeReader } from '@facephi/selphid-web-component';

selphid.codeReader = CodeReader.Optional;
```

## Descripción

Activa un paso **opcional** de captura de QR/código **durante** una extracción del documento en `facephi-selphid-widget`.

No sustituye ni usa [`barcode`](/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcode.md) / [`barcodeSide`](/sdks/sdk-web/componentes/selphid-documentos/propiedades/barcodeside.md): esos controlan el lector de barcode del motor de documento. `codeReader` monta la misma instancia de `<facephi-selphid>` y se activa solo con `settings.codeReader`.

El resultado del código va en `event.detail.ocrResult` (`encoded` e `images`), no en `result.images`. Con `tokenize: true`, el payload tokenizado actual usa claves como `qr_back_0` y `qr_back_0_content`.

Estados de telemetría relacionados en [`trackStatus`](/sdks/sdk-web/componentes/selphid-documentos/eventos/trackstatus.md): `codeInfo`, `readingCode`, `codesFinished`.

***

## Ejemplo

```jsx
import { CodeReader } from '@facephi/selphid-web-component';

<facephi-selphid-widget
    codeReader={CodeReader.Optional}
    captureRetries={3}
    captureTimeout={10}
/>
```