> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Estados KYB: sessão, funcionalidades e AML > Estados exatos de sessões KYB, funcionalidades, registos e triagens AML na Didit. Desde $2.00 por verificação, por país e nível. A Verificação de empresas (KYB) acompanha o estado a vários níveis: a **sessão**, as **funcionalidades** individuais, a **consulta ao registo** e o **resultado AML**. Esta página é a referência de todos os estados. A API devolve os valores de estado como etiquetas exatas, sensíveis a maiúsculas e minúsculas, como `"In Progress"` e `"Not Finished"`, as mesmas strings que os webhooks transportam. Faça a comparação com essas strings exatas, e não com nomes em maiúsculas. ## Estado da sessão O estado geral de uma sessão de Verificação de empresas (KYB), o campo que mais vezes vai usar para tomar decisões. | Estado | Significado | | - | - | | `"Not Started"` | Sessão criada, mas a empresa ainda não abriu a ligação alojada. | | `"In Progress"` | O fluxo alojado está ativo: consultas ao registo, carregamento de documentos ou triagem AML em curso. | | `"Awaiting User"` | A aguardar uma ação do utilizador final (normalmente a submissão das pessoas-chave ou a resposta a um pedido de nova submissão). Transita automaticamente quando o utilizador concluir a ação pendente. | | `"Approved"` | Todas as funcionalidades obrigatórias foram aprovadas. A empresa está verificada. | | `"Declined"` | Uma verificação crítica falhou (empresa dissolvida, entidade sancionada, incluída na lista de bloqueio) ou uma regra do fluxo rejeitou a sessão. | | `"In Review"` | Uma ou mais funcionalidades requerem revisão manual por um analista. | | `"Resubmitted"` | A sessão anteriormente recusada ou com pedido de nova submissão foi reenviada com dados atualizados. | | `"Abandoned"` | A empresa nunca concluiu o fluxo (tempo esgotado). | | `"Expired"` | A sessão expirou antes de a empresa a concluir. | > [!NOTE] > > `"Awaiting User"` é transitório: não precisa de retirar manualmente as sessões deste estado. Assim que o utilizador final concluir a ação pendente (por exemplo, submeter a lista de pessoas-chave ou reenviar um documento pedido), a Didit reavalia a sessão e a passa automaticamente para `"In Review"`, `"Approved"` ou `"Declined"`, conforme o resultado. ## Estado da funcionalidade Cada funcionalidade KYB tem o seu próprio estado, que se agrega no estado da sessão. | Estado | Significado | | - | - | | `"Not Finished"` | Funcionalidade ainda não iniciada ou em execução. | | `"Approved"` | Funcionalidade aprovada. | | `"Declined"` | Funcionalidade falhou (erro crítico). | | `"In Review"` | Funcionalidade requer atenção de um analista. | | `"Resub Requested"` | A empresa tem de voltar a submeter dados relativos a esta funcionalidade (por exemplo, recarregar um documento). | | `"Awaiting User"` | A funcionalidade aguarda uma ação do utilizador final. Aplica-se à funcionalidade de pessoas-chave enquanto o utilizador tiver de submeter as pessoas envolvidas. Transita automaticamente após a submissão. | ### Nomes das funcionalidades KYB Estes são os valores de `features` numa sessão KYB e nos webhooks: * `KYB_REGISTRY`: consulta ao registo de empresas. * `AML`: triagem AML ao nível da empresa. * `KYB_DOCUMENTS`: recolha de documentos e OCR. * `KYB_KEY_PEOPLE`: pessoas-chave, ou seja, UBOs, acionistas, administradores, representantes e outros responsáveis. ## Estado do registo (do fornecedor) A situação oficial da empresa, tal como obtida junto de fontes de registo oficiais. Reflete a situação jurídica ou regulamentar da entidade, conforme reportada pelo registo de cada jurisdição, pelo que os valores exatos variam consoante a fonte. Surge na decisão KYB em `company.registry_status`. | Estado | Significado | | - | - | | `ACTIVE` | A empresa está ativa e em situação regular. | | `DISSOLVED` | A empresa foi dissolvida. | | `DEREGISTERED` | A empresa foi cancelada do registo. | | `STRUCK_OFF` | A empresa foi eliminada do registo. | | `CLOSED` | A empresa foi encerrada. | | `INACTIVE` | A empresa está inativa (sem atividade comercial). | | `AUTHORISED` | Autorizada (normalmente para entidades reguladas). | | `APPOINTED_REPRESENTATIVE` | Representante designado de outra empresa autorizada. | | `UNAUTHORISED` | Anteriormente autorizada, atualmente não autorizada. | | `NO_LONGER_AUTHORISED` | A autorização foi revogada. | | `SEE_FULL_DETAILS` | O estado exige inspeção manual. | > [!NOTE] > > Como `registry_status` reflete valores brutos do registo, use `verification_status` abaixo quando precisar de um indicador consistente e válido em todas as jurisdições para orientar a lógica do produto. ## Estado de verificação da empresa Um estado padronizado, orientado para o negócio, por resultado da empresa. Normaliza os diferentes estados de registo e de empresa de vários países e fontes num indicador único e consistente, que pode ser interpretado diretamente no seu produto. Surge na decisão KYB em `company.verification_status`. | Estado | Significado | | - | - | | `verified` | A empresa aparenta estar ativa e válida. | | `failed` | A empresa aparenta estar inativa, dissolvida ou com problemas identificados. | | `unknown` | Informação insuficiente ou estado ambíguo. | ## Estado de obtenção dos dados da empresa Indica o progresso da obtenção dos dados de um registo de empresa específico junto de registos externos ou oficiais. Use-o para determinar quão completa está a informação obtida para uma determinada empresa. Surge na decisão KYB em `company.fetch_status`. | Estado | Significado | | - | - | | `pending` | Nesta fase, só foi obtida informação parcial ou básica da empresa. | | `resolved` | Os dados completos da empresa foram obtidos com sucesso junto de fontes oficiais. | ## Estado da verificação AML Devolvido por cada triagem (empresa ou pessoa). | Estado | Significado | | - | - | | `"Approved"` | Nenhum resultado acima do limiar. | | `"Declined"` | Resultado de alta gravidade (sanção confirmada ou correspondência PEP). | | `"In Review"` | Foi encontrado um resultado que requer revisão de um analista. | | `"Not Finished"` | A triagem ainda não foi concluída. | ## Como uma decisão se explica A decisão KYB não inclui uma única cadeia de códigos de motivo. Cada array de funcionalidades (`registry_checks[]`, `document_verifications[]`, `key_people_checks[]`, `aml_screenings[]`) inclui `warnings[]` com etiquetas `KYB_*` e AML, e `decision_trace` regista a forma como a decisão foi alcançada. Consulte as etiquetas em [Avisos KYB](https://docs.didit.me/pt/business-verification/warnings.md) e registe-as junto ao estado da sessão. Quando um revisor define o estado manualmente em oposição à própria agregação da plataforma, a decisão inclui `status_override`, com a hora `overridden_at` e o `automatic_status` que a plataforma teria definido. Consulte o [esquema de resposta](https://docs.didit.me/pt/business-verification/response-schema.md). ## Próximos passos > [card] [Esquema de resposta](https://docs.didit.me/pt/business-verification/response-schema.md) > > Onde cada estado aparece no payload. > [card] [Avaliação de risco](https://docs.didit.me/pt/business-verification/risk-assessment.md) > > O que determina o resultado de um KYB. > [card] [Webhooks](https://docs.didit.me/pt/business-verification/webhooks.md) > > Eventos disparados nas alterações de estado. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.