---
title: "Cadastro dos dados cadastrais"
method: POST
path: "/api/v1/onboarding-pf/validacao-cadastral"
tags: ["Onboarding PF"]
---

# Cadastro dos dados cadastrais

`POST /api/v1/onboarding-pf/validacao-cadastral`

**Onboarding PF - Cadastro de dados da Validação Cadastral**<br/>Permite que parceiros informem os dados cadastrais para validação da abertura de conta.<br/><br/>**Requisição**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th><th>Obrigatoriedade</th></tr></thead><tbody><tr><td>nome</td><td>Texto</td><td>Nome completo do cliente.</td><td>Sim</td></tr><tr><td>cpf</td><td>Texto</td><td>CPF do cliente (com ou sem máscara).</td><td>Sim</td></tr><tr><td>endereco</td><td>Texto</td><td>Endereço de residência.</td><td>Sim</td></tr><tr><td>numero</td><td>Texto</td><td>Número da residência.</td><td>Sim</td></tr><tr><td>bairro</td><td>Texto</td><td>Bairro da residência.</td><td>Sim</td></tr><tr><td>cidade</td><td>Texto</td><td>Cidade de residência.</td><td>Sim</td></tr><tr><td>cep</td><td>Texto</td><td>CEP da residência.</td><td>Sim</td></tr><tr><td>uf</td><td>Texto</td><td>Unidade Federativa (UF) com 2 letras.</td><td>Sim</td></tr><tr><td>datanascimento</td><td>Data</td><td>Data de nascimento no formato YYYY-MM-DD.</td><td>Sim</td></tr><tr><td>naturalidade</td><td>Texto</td><td>Naturalidade do cliente.</td><td>Sim</td></tr><tr><td>numeroident</td><td>Texto</td><td>Número do documento de identidade.</td><td>Sim</td></tr><tr><td>dataident</td><td>Data</td><td>Data de emissão da identidade (YYYY-MM-DD).</td><td>Sim</td></tr><tr><td>uforgaoident</td><td>Texto</td><td>UF emissor do documento.</td><td>Sim</td></tr><tr><td>email</td><td>Texto</td><td>E-mail válido do cliente.</td><td>Sim</td></tr><tr><td>ddd</td><td>Texto</td><td>DDD do telefone (2 dígitos).</td><td>Sim</td></tr><tr><td>telefone</td><td>Texto</td><td>Telefone de contato (até 10 caracteres, sem ddd).</td><td>Sim</td></tr><tr><td>cargo</td><td>Texto</td><td>Cargo ocupado (obrigatório se PPE = S).</td><td>Condicional</td></tr><tr><td>periodo</td><td>Texto</td><td>Período do cargo (obrigatório se PPE = S).</td><td>Condicional</td></tr><tr><td>observação</td><td>Texto</td><td>Observação do cargo (obrigatório se PPE = S).</td><td>Condicional</td></tr><tr><td>tipoident</td><td>Texto</td><td>Tipo do documento.</td><td>Sim</td></tr><tr><td>orgaoident</td><td>Texto</td><td>Órgão emissor.</td><td>Sim</td></tr><tr><td>nacionalidade</td><td>Texto</td><td>“N” para nacional, “S” para estrangeiro.</td><td>Sim</td></tr><tr><td>sexo</td><td>Texto</td><td>“M” para masculino, “F” para feminino.</td><td>Sim</td></tr><tr><td>foto</td><td>Texto</td><td>Imagem em base64 no padrão data:image/... (máx. 8000 caracteres).</td><td>Não</td></tr><tr><td>ppe</td><td>Texto</td><td>“S” se PPE, “N” caso contrário.</td><td>Não</td></tr><tr><td>complemento</td><td>Texto</td><td>Complemento do endereço (ex: apto, bloco).</td><td>Não</td></tr><tr><td>nomemae</td><td>Texto</td><td>Nome da mãe do cliente.</td><td>Não</td></tr><tr><td>nomepai</td><td>Texto</td><td>Nome do pai do cliente.</td><td>Não</td></tr><tr><td>renda</td><td>Float</td><td>Renda anual estimada.</td><td>Não</td></tr><tr><td>jwt_documento</td><td>Texto</td><td>Token jwt do documento.</td><td>Sim</td></tr><tr><td>jwt_liveness</td><td>Texto</td><td>Token jwt da prova de vida.</td><td>Sim</td></tr></tbody></table><br/><br/>**Resposta - Sucesso (200)**<br/><table><thead><tr><th>Campo</th><th>Tipo</th><th>Descrição</th></tr></thead><tbody><tr><td>message</td><td>Texto</td><td>Mensagem de confirmação do cadastro</td></tr><tr><td>data.contaUuid</td><td>Texto</td><td>Uuid da conta</td></tr><tr><td>data.nomeCliente</td><td>Texto</td><td>Nome do conta</td></tr><tr><td>data.numeroConta</td><td>Texto</td><td>Numero da conta</td></tr><tr><td>data.statusConta</td><td>Texto</td><td>Status da conta</td></tr><tr><td>data.statusContaEnum</td><td>Texto</td><td>Status ENUM da conta</td></tr><tr><td>statusCode</td><td>Inteiro</td><td>Código HTTP da resposta</td></tr><tr><td>status</td><td>Booleano</td><td>Status lógico da operação</td></tr></tbody></table>

## Headers

- `client-id` string, uuid, required

## Request body

- object
  - `nome` string
  - `cpf` string
  - `endereco` string
  - `numero` string
  - `bairro` string
  - `cidade` string
  - `cep` string
  - `uf` string
  - `datanascimento` string, date
  - `naturalidade` string
  - `numeroident` string
  - `dataident` string, date
  - `uforgaoident` string
  - `email` string, email
  - `ddd` string
  - `telefone` string
  - `cargo` string
  - `periodo` string
  - `observação` string
  - `tipoident` string
  - `orgaoident` string
  - `nacionalidade` string
  - `sexo` string
  - `foto` string
  - `ppe` string
  - `complemento` string
  - `nomemae` string
  - `nomepai` string
  - `renda` number, float
  - `jwt_documento` string
  - `jwt_liveness` string

## Response `200`

Dados recebidos com sucesso.

- object
  - `message` string
  - `data` object
    - `contaUuid` string
    - `nomeCliente` string
    - `numeroConta` string
    - `statusConta` string
    - `statusContaEnum` string
  - `errors` string
  - `statusCode` integer
  - `status` boolean

## Other responses

- `401` — Invalid client data.
- `403` — Invalid token.

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)