> 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/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/sdk-mobile/ios-sdk/manejo-de-errores-genericos.md).

# Tratamento de erros genéricos

A inicialização do SDK sempre retorna um resultado. O resultado pode ser negativo e conter um erro.

O SDK iOS dispõe de erros genéricos que fornecem feedback ao integrador sobre o motivo pelo qual o processo foi interrompido.

#### Comuns - Básicos

Estados gerais que não se enquadram em uma categoria funcional específica.

* `.NO_ERROR`: Estado padrão; indica que a operação foi concluída sem incidentes.
* `.UNKNOWN_ERROR`: Ocorreu um erro que não foi identificado ou categorizado especificamente.
* `.OTHER(String)`: Erro genérico para casos não contemplados. Inclui uma mensagem personalizada por meio de um `String`.

#### Comuns - Requisitos

Erros relacionados à disponibilidade de dados, ao ciclo de vida dos processos ou à conectividade.

* `.NO_DATA_ERROR`: O processo precisa de um valor de configuração que não foi informado corretamente ou é nulo.
* `.OPERATION_NOT_CREATED`: A operação não pôde ser inicializada corretamente.
* `.NETWORK_CONNECTION`: Erro de comunicação; o dispositivo não tem acesso à internet ou o servidor não responde.

#### Comuns - Permissões

São acionados quando o usuário ou o sistema operacional negam acesso ao hardware ou a arquivos.

* `CAMERA_PERMISSION_DENIED`: O acesso à câmera do dispositivo foi bloqueado.
* `MIC_PERMISSION_DENIED`: O acesso ao microfone foi bloqueado.
* `LOCATION_PERMISSION_DENIED`: Os serviços de localização (GPS) não estão autorizados.
* `STORAGE_PERMISSION_DENIED`: A permissão de leitura/gravação no armazenamento local foi negada.

#### Comuns - Interação do Usuário

Erros decorrentes do comportamento do usuário ou de restrições da sessão.

* `CANCEL_BY_USER`: O processo foi cancelado explicitamente pelo usuário.
* `SDK_TIMEOUT`: O processo de captura excedeu o tempo máximo de espera configurado no nível do SDK. Os componentes Selphi e SelphID também podem retornar além `.SELPHI_TIMEOUT` ou `.SELPHID_TIMEOUT` com informações adicionais; serializados como `SPI_TIMEOUT` ou `SPD_TIMEOUT` por meio de `toString(addComponentPrefix:)`.

#### Comuns - Erros de Licença

Erros de validação relacionados à chave de Licença ou aos componentes do SDK.

* `.LICENSE_CHECKER_ERROR(String)`: Erro geral durante a validação da Licença com o servidor. O parâmetro `String` indica o detalhe de forma mais explícita.
* `.MISSING_COMPONENT_LICENSE_DATA`: O componente que está sendo iniciado precisa de dados que não foram configurados corretamente na Licença.
* `.COMPONENT_LICENSE_ERROR`: O componente que se tenta usar não está habilitado na Licença.
* `.EMPTY_LICENSE`: O campo da Licença está vazio.

**Além dos genéricos, cada módulo pode conter erros específicos que serão detalhados em suas respectivas páginas da documentação.**