# Criar uma nova pessoa

Permite criar uma nova pessoa, informando dados como nome, tipo de pessoa (Física, Jurídica ou Estrangeira), documentos (CPF, CNPJ), email, perfis associados, endereços e outros parâmetros. Esse endpoint viabiliza a automação de cadastro de clientes, fornecedores e transportadoras.

Endpoint: POST /v1/pessoas
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Request body:

  - `application/json` (unknown)
    Dados da pessoa a ser criada

## Request fields (application/json):

  - `agencia_publica` (boolean)
    Indica se a pessoa é uma agência pública
    Example: true

  - `ativo` (boolean)
    Indica se a pessoa está ativa
    Example: true

  - `cnpj` (string)
    CNPJ da pessoa jurídica
    Example: 12.345.678/0001-90

  - `codigo` (string)
    Código da pessoa
    Example: CLI001

  - `contato_cobranca_faturamento` (object)
    Contato de cobrança e faturamento

  - `contato_cobranca_faturamento.emails` (array)
    Emails do contato de cobrança e faturamento
    Example: ["carlos.oliveira@email.com","joao.silva@email.com"]

  - `contato_cobranca_faturamento.whatsapp` (string)
    Telefone do contato de cobrança e faturamento
    Example: 5511999999999

  - `cpf` (string)
    CPF da pessoa física
    Example: 123.456.789-00

  - `data_nascimento` (string)
    Data de nascimento da pessoa física
    Example: 1990-01-01

  - `email` (string)
    Emails da pessoa separados por vírgula
    Example: joao.silva@email.com, maria.silva@email.com

  - `enderecos` (array)
    Lista de endereços

  - `enderecos.bairro` (string)
    Bairro do endereço
    Example: Centro

  - `enderecos.cep` (string)
    CEP do endereço
    Example: 12345-678

  - `enderecos.cidade` (string)
    Cidade do endereço
    Example: São Paulo

  - `enderecos.complemento` (string)
    Complemento do endereço
    Example: Apto 45

  - `enderecos.estado` (string)
    Estado do endereço
    Example: SP

  - `enderecos.logradouro` (string)
    Logradouro do endereço
    Example: Rua das Flores

  - `enderecos.numero` (string)
    Número do endereço
    Example: 123

  - `enderecos.pais` (string)
    País do endereço (Brasil se tipo_pessoa for Física ou Jurídica)
    Example: Brasil

  - `inscricoes` (array)
    Lista de inscrições estaduais e municipais

  - `inscricoes.indicador_inscricao_estadual` (string)
    Indicador de inscrição estadual: NAO CONTRIBUINTE, CONTRIBUINTE ou ISENTO
    Enum: "NAO CONTRIBUINTE", "CONTRIBUINTE", "ISENTO"

  - `inscricoes.inscricao_estadual` (string)
    Inscrição estadual
    Example: 123456789

  - `inscricoes.inscricao_municipal` (string)
    Inscrição municipal
    Example: 123456789

  - `inscricoes.inscricao_suframa` (string)
    Inscrição SUFRAMA
    Example: 123456789

  - `nome` (string, required)
    Nome da pessoa
    Example: João Silva

  - `nome_fantasia` (string)
    Nome fantasia da pessoa jurídica
    Example: Empresa LTDA

  - `observacao` (string)
    Observações sobre a pessoa
    Example: Cliente preferencial

  - `optante_simples` (boolean)
    Indica se a pessoa é optante pelo Simples Nacional
    Example: true

  - `outros_contatos` (array)
    Lista de outros contatos da pessoa

  - `outros_contatos.cargo` (string)
    Cargo do contato
    Example: Gerente

  - `outros_contatos.email` (string)
    Email do contato
    Example: maria.silva@email.com

  - `outros_contatos.nome` (string, required)
    Nome do contato
    Example: Maria Silva

  - `outros_contatos.telefone_celular` (string)
    Telefone celular
    Example: 11983899529

  - `outros_contatos.telefone_comercial` (string)
    Telefone comercial do contato
    Example: 1138185004

  - `perfis` (array)
    Lista de perfis associados à pessoa

  - `perfis.tipo_perfil` (string, required)
    Tipo de perfil: Cliente, Fornecedor ou Transportadora
    Enum: "Cliente", "Fornecedor", "Transportadora"

  - `rg` (string)
    Registro Geral (RG) da pessoa. Para pessoas estrangeiras, este campo representa o identificador estrangeiro.
    Example: 12.345.678-9

  - `telefone_celular` (string)
    Telefone celular
    Example: 11983899529

  - `telefone_comercial` (string)
    Telefone comercial da pessoa
    Example: 1138185004

  - `tipo_pessoa` (string, required)
    Tipo de pessoa: Física, Jurídica ou Estrangeira
    Enum: "Física", "Jurídica", "Estrangeira"

## Response 201:

  - `201` (unknown)
    Created

## Response 201 fields (application/json):

  - `agencia_publica` (boolean)
    Indica se a pessoa é uma agência pública
    Example: false

  - `ativo` (boolean)
    Indica se a pessoa está ativa
    Example: true

  - `cnpj` (string)
    CNPJ da pessoa jurídica
    Example: 12.345.678/0001-90

  - `codigo` (string)
    Código da pessoa
    Example: CLI001

  - `contato_cobranca_faturamento` (object)
    Contato para cobrança e faturamento

  - `contato_cobranca_faturamento.emails` (array)
    Email do contato de cobrança e faturamento
    Example: ["carlos.oliveira@email.com","joao.silva@email.com"]

  - `contato_cobranca_faturamento.whatsapp` (string)
    Telefone do contato de cobrança e faturamento
    Example: 5511999999999

  - `cpf` (string)
    CPF da pessoa física
    Example: 123.456.789-00

  - `data_nascimento` (string)
    Data de nascimento da pessoa física
    Example: 1990-01-01

  - `email` (string)
    Emails da pessoa separados por vírgula
    Example: joao.silva@email.com, maria.silva@email.com 

  - `enderecos` (array)
    Lista de endereços

  - `enderecos.bairro` (string)
    Bairro do endereço
    Example: Centro

  - `enderecos.cep` (string)
    CEP do endereço
    Example: 12345-678

  - `enderecos.cidade` (string)
    Cidade do endereço
    Example: São Paulo

  - `enderecos.complemento` (string)
    Complemento do endereço
    Example: Apto 45

  - `enderecos.estado` (string)
    Estado do endereço
    Example: SP

  - `enderecos.id` (string)
    ID do endereço
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `enderecos.id_cidade` (integer)
    ID da cidade
    Example: 3550308

  - `enderecos.logradouro` (string)
    Logradouro do endereço
    Example: Rua das Flores

  - `enderecos.numero` (string)
    Número do endereço
    Example: 123

  - `enderecos.pais` (string)
    País do endereço
    Example: Brasil

  - `estrangeiro` (boolean)
    Indica se a pessoa é estrangeira
    Example: false

  - `id` (string)
    ID da pessoa
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `inscricoes` (array)
    Lista de inscrições

  - `inscricoes.id` (string)
    ID da inscrição
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `inscricoes.indicador_inscricao_estadual` (string)
    Indicador de inscrição estadual: NAO CONTRIBUINTE, CONTRIBUINTE ou ISENTO
    Enum: "NAO CONTRIBUINTE", "CONTRIBUINTE", "ISENTO"

  - `inscricoes.inscricao_estadual` (string)
    Inscrição estadual
    Example: 123456789

  - `inscricoes.inscricao_municipal` (string)
    Inscrição municipal
    Example: 123456789

  - `inscricoes.inscricao_suframa` (string)
    Inscrição SUFRAMA
    Example: 123456789

  - `nome` (string)
    Nome da pessoa
    Example: João Silva

  - `nome_fantasia` (string)
    Nome fantasia da pessoa jurídica
    Example: Empresa LTDA

  - `observacao` (string)
    Observações sobre a pessoa
    Example: Cliente preferencial

  - `optante_simples` (boolean)
    Indica se a pessoa é optante pelo Simples Nacional
    Example: false

  - `origem` (string)
    Origem da criação da pessoa
    Example: API

  - `outros_contatos` (array)
    Lista de outros contatos

  - `outros_contatos.cargo` (string)
    Escritório do contato
    Example: Escritório Central

  - `outros_contatos.email` (string)
    Email do contato
    Example: maria.silva@email.com

  - `outros_contatos.id` (string)
    ID do contato
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `outros_contatos.nome` (string)
    Nome do contato
    Example: Maria Silva

  - `outros_contatos.telefone_celular` (string)
    Celular do contato
    Example: 11987654321

  - `outros_contatos.telefone_comercial` (string)
    Telefone comercial do contato
    Example: 1112345678

  - `perfis` (array)
    Lista de perfis

  - `perfis.id` (string)
    ID do perfil
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `perfis.tipo_perfil` (string)
    Tipo de perfil: Cliente, Fornecedor ou Transportadora
    Example: Cliente

  - `rg` (string)
    Registro Geral (RG) da pessoa. Para pessoas estrangeiras, este campo representa o identificador estrangeiro.
    Example: 12.345.678-9

  - `telefone_celular` (string)
    Telefone celular
    Example: 11987654321

  - `telefone_comercial` (string)
    Telefone comercial da pessoa
    Example: 1112345678

  - `tipo_pessoa` (string)
    Tipo de pessoa: Física, Jurídica ou Estrangeira
    Example: FISICA

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 429 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada