> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Processo de Onboarding KYC

> Visão funcional do processo de onboarding KYC.

# Processo de Onboarding KYC

## Visão Geral

O onboarding KYC é uma etapa de validação cadastral utilizada para verificar se uma pessoa física ou jurídica está apta a seguir no processo de proposta no nosso sistema.

Quando essa validação estiver habilitada para o produto contratado, o nosso sistema verifica se a pessoa já concluiu o onboarding e qual foi o resultado da análise.

***

## Fluxo do Processo

```mermaid theme={null}
flowchart LR
    A[API pessoa/salvar]
    B[Origem]
    C[Análise KYC]
    D[Retorno ao nosso sistema]
    E[Validação da Proposta]

    A --> B
    B --> C
    C --> D
    D --> E
```

## Etapas

1. A pessoa é incluída pela API `pessoa/salvar`.
2. Em paralelo, os dados da pessoa são enviados ao **Origem**, responsável pela análise KYC.
3. O Origem executa a análise cadastral.
4. O resultado da análise é recebido pelo nosso sistema.
5. Durante a inclusão da proposta, as APIs consultam o resultado do onboarding.
6. Com base nesse resultado, a proposta é liberada para continuar ou bloqueada.

***

## Possíveis Resultados

| Situação                   | Resultado para o usuário                                                                             |
| -------------------------- | ---------------------------------------------------------------------------------------------------- |
| **Onboarding aprovado**    | A pessoa pode seguir no processo da proposta, desde que as demais validações também sejam aprovadas. |
| **Onboarding pendente**    | `V0002 - Esta pessoa não possui onboarding concluído.`                                               |
| **Onboarding reprovado**   | `V0003 - Esta pessoa foi reprovada por Políticas Internas, restritas à BMP por força regulatória.`   |
| **Produto sem onboarding** | A proposta segue normalmente, sem essa validação específica.                                         |

> **Importante**
>
> A aprovação no onboarding **não garante** a aprovação da proposta. Outras validações de negócio continuam sendo executadas normalmente.

***

## Quando a Proposta Pode Ser Bloqueada

A proposta poderá ser bloqueada quando:

* o onboarding for obrigatório para o produto; e
* a pessoa não possuir um resultado aprovado no momento da inclusão da proposta.

Isso ocorre quando:

* a análise ainda não foi concluída; ou
* a pessoa foi reprovada conforme as políticas internas aplicáveis.

***

## Observações

* A validação de onboarding somente é aplicada quando estiver habilitada para o produto.
* As mensagens apresentadas ao usuário são genéricas por razões regulatórias e de política interna.
* A aprovação do onboarding não substitui as demais validações executadas durante o processo de proposta.