# 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

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Path parameters:

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

## Request body:

  - `application/json` (unknown)
    Dados da pessoa a serem atualizados

## 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 204:

  - `204` (unknown)
    No Content

## 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 404:

  - `404` (unknown)
    Not Found

## Response 404 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