# Atualizar parcialmente uma pessoa por id

Permite atualizar parcialmente o cadastro de uma pessoa existente (por exemplo: alterar email, telefone, tipo de perfil ou endereço) identificada por id. Essa abordagem garante menor impacto e maior controle na atualização dos dados.

Endpoint: PATCH /v1/pessoas/{id}
Version: v1
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    ID da pessoa a ser atualizada

## 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.id` (string)
    ID do endereço
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `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"

  - `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)
    Nome da pessoa
    Example: "João Silva"

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

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

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

  - `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: "11987654321"

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

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

## Response 400 fields (application/json):

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


## Response 204 fields