> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Quando os Dados do Cliente Podem Ser Atualizados

> Quais campos e documentos do cliente podem ser alterados com PATCH e uploads de documentos, com base no status de cada perfil de verificação e nos perfis que já os avaliaram.

Se um campo ou documento pode ser alterado depende de duas coisas: o **status** de cada um dos perfis de verificação do cliente, e **quais perfis já avaliaram** aquele campo. Esta página apresenta a regra e depois a aplica aos clientes pessoa física.

## A regra

Um campo ou documento está **bloqueado** quando é um critério `complete` de um perfil de verificação cujo status é `pending` ou `approved`. Todo o resto pode ser alterado com `PATCH /v2/customer/{id}` ou `POST /v2/document`.

| Status do perfil                    | Efeito sobre os critérios que ele avaliou                                                       |
| ----------------------------------- | ----------------------------------------------------------------------------------------------- |
| `incomplete`                        | Nada bloqueado. Forneça ou corrija qualquer campo ou documento.                                 |
| `pending`                           | Todos os critérios `complete` bloqueados enquanto a análise está em andamento.                  |
| `approved`                          | Todos os critérios `complete` bloqueados.                                                       |
| `rejected`, `resubmission_required` | Nada bloqueado. Corrija o que `criteria.errors` lista e o perfil é reenviado por conta própria. |

Critérios compartilhados por vários perfis ficam bloqueados se **qualquer** um desses perfis estiver em `pending` ou `approved`. Critérios que nenhum perfil bloqueante do cliente avaliou continuam editáveis, e é isso que permite [adicionar um perfil a um cliente em pending ou approved](/pt-BR/concepts/onboarding/verification-profiles/onboard-new-customer#adicionar-um-perfil-depois). Documentos que você já enviou para um perfil anterior são reavaliados para um perfil recém-adicionado e aparecem no `criteria.pending` dele até que essa verificação termine; os campos de dados são transferidos como `complete` imediatamente.

Um `PATCH` rejeitado retorna 400 `customer/field-locked-by-verification-profile` e não aplica nada. O corpo nomeia cada campo bloqueado e o perfil que o bloqueia:

```json theme={"dark"}
{
  "status": 400,
  "code": "customer/field-locked-by-verification-profile",
  "detail": "One or more fields are locked by a verification profile that is pending or approved.",
  "errors": [
    {
      "detail": "personalInformation.actingAsIntermediary is locked by verification profile kyc_profile_a (pending).",
      "pointer": "/personalInformation/actingAsIntermediary"
    }
  ]
}
```

Uploads de documentos retornam o mesmo código; a entrada de erro carrega `parameter: "documentType"` e nomeia o perfil bloqueante em `detail`. Remover um perfil de `enabledVerificationProfiles` enquanto ele está em `pending` ou `approved` retorna o mesmo código com `pointer: "/enabledVerificationProfiles"`.

## Sempre imutáveis

`firstName`, `lastName`, `dateOfBirth`, `email` e `phone` não podem ser alterados após a criação em nenhum status. Crie um novo cliente se esses dados estiverem errados.

## Clientes pessoa física

Os bloqueios seguem as entradas `kyc_profile_*` do cliente. A tabela mostra quais perfis avaliam cada critério; um critério fica bloqueado enquanto qualquer perfil marcado estiver em `pending` ou `approved`.

| Critério                                                                    | Campo ou documento                                                               | A               | C | D |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | --------------- | - | - |
| `residential_address`                                                       | `address`                                                                        | ✓               | ✓ | ✓ |
| `tax_identification_number`                                                 | `personalInformation.taxIdentificationNumber*`                                   | ✓               | ✓ | ✓ |
| `identity_document`, `liveness_report_document`, `source_of_funds_document` | uploads de documentos                                                            | ✓               | ✓ | ✓ |
| `source_of_funds`, `occupation_soc_code`                                    | `personalInformation.sourceOfFunds`, `occupationSocCode`                         | ✓               | ✓ | ✓ |
| `account_purpose`, `employment_status`, `acting_as_intermediary`            | `personalInformation.accountPurpose`, `employmentStatus`, `actingAsIntermediary` | ✓               | — | — |
| `expected_monthly_payments`                                                 | `personalInformation.expectedMonthlyPayments`                                    | ✓               | — | ✓ |
| `country_of_birth`, `nationality`                                           | `personalInformation.countryOfBirth`, `nationality`                              | Residentes EEA+ | ✓ | ✓ |
| `sex`                                                                       | `personalInformation.gender`                                                     | —               | ✓ | ✓ |
| `proof_of_address_document`, `w8_ben_document`                              | uploads de documentos                                                            | —               | ✓ | ✓ |
| `state_of_birth`                                                            | `personalInformation.stateOfBirth`                                               | —               | — | ✓ |
| critérios de atividade esperada                                             | `personalExpectedActivity`                                                       | —               | — | ✓ |
| `ip_address`                                                                | `ipAddress`                                                                      | —               | — | ✓ |

**Exemplo — perfil A em pending ou approved, adicionando o perfil C.** Tudo na coluna A está bloqueado. `gender`, `countryOfBirth` e `nationality` (para um cliente fora da EEA+), mais os uploads de comprovante de endereço e W-8BEN, estão abertos porque apenas C os avalia. Depois de fornecidos, `kyc_profile_c` passa para `pending` e também os bloqueia.

**Exemplo — perfil A rejeitado.** Nada está bloqueado. Corrija os campos listados em `criteria.errors`, reenvie documentos se solicitado, e o perfil é reenviado automaticamente.

## Clientes pessoa jurídica

`PATCH /v2/customer/{id}` ainda não está disponível para clientes pessoa jurídica, incluindo alterações em `enabledVerificationProfiles`; ele retorna 400 `customer/operation-not-allowed`. Os uploads de documentos da empresa e de seus representantes não são afetados. Entre em contato com [support@spherepay.co](mailto:support@spherepay.co) se uma empresa existente precisar de um novo perfil.

***

## Guias relacionados

<CardGroup cols={2}>
  <Card title="Visão geral dos perfis de verificação" icon="badge-check" href="/pt-BR/concepts/onboarding/verification-profile">
    Status, critérios e requisitos por perfil.
  </Card>

  <Card title="Cadastrar um cliente com perfis" icon="user-plus" href="/pt-BR/concepts/onboarding/verification-profiles/onboard-new-customer">
    Escolha perfis na criação e adicione um depois.
  </Card>
</CardGroup>
