Skip to content
API/
Pessoas
/
/
Atualizar uma pessoa por...

Atualizar uma pessoa por id

Request

Permite substituir ou atualizar integralmente o cadastro de uma pessoa existente identificada por id. Indicada quando há necessidade de modificar vários campos de uma vez.

Security
BearerAuth
Path
idstringrequired

ID da pessoa a ser atualizada

Bodyapplication/jsonrequired

Dados da pessoa a ser atualizada

agencia_publicaboolean

Indica se a pessoa é uma agência pública

Example:false
ativoboolean

Indica se a pessoa está ativa

Example:true
cnpjstring

CNPJ da pessoa jurídica

Example:"12.345.678/0001-90"
codigostring, <= 20 charactersrequired

Código da pessoa

Example:"CLI001"
contato_cobranca_faturamentoobject(AtualizacaoContatoCobrancaFaturamento)

Contato de cobrança e faturamento

cpfstring

CPF da pessoa física

Example:"123.456.789-00"
data_nascimentostringrequired

Data de nascimento da pessoa física

Example:"1990-01-01"
emailstring, <= 100 charactersrequired

Emails da pessoa separados por vírgula

Example:"joao.silva@email.com, maria.silva@email.com"
enderecosArray of objects(AtualizacaoEnderecoPessoa)required

Lista de endereços

inscricoesArray of objects(AtualizacaoInscricaoPessoa)

Lista de inscrições estaduais e municipais

nomestring, <= 200 charactersrequired

Nome da pessoa

Example:"João Silva"
nome_fantasiastring, <= 200 characters

Nome fantasia da pessoa jurídica

Example:"Empresa LTDA"
observacaostring, <= 2000 charactersrequired

Observações sobre a pessoa

Example:"Cliente preferencial"
optante_simplesboolean

Indica se a pessoa é optante pelo Simples Nacional

Example:false
outros_contatosArray of objects(AtualizacaoOutroContatoPessoa)required

Lista de outros contatos da pessoa

perfisArray of objects(AtualizacaoTipoPerfil)required

Lista de perfis associados à pessoa

rgstring, <= 50 characters

Registro Geral (RG) da pessoa. Para pessoas estrangeiras, este campo representa o identificador estrangeiro.

Example:"12.345.678-9"
telefone_celularstringrequired

Telefone celular

Example:"(11) 98765-4321"
telefone_comercialstringrequired

Telefone comercial da pessoa

Example:"(11) 1234-5678"
tipo_pessoastring(TipoPessoa)required

Tipo de pessoa: Física, Jurídica ou Estrangeira

Enum:"Física""Jurídica""Estrangeira"
curl -i -X PUT \
  'https://api-v2.contaazul.com/v1/pessoas/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "agencia_publica": false,
    "ativo": true,
    "cnpj": "12.345.678/0001-90",
    "codigo": "CLI001",
    "contato_cobranca_faturamento": {
      "emails": [
        "carlos.oliveira@email.com",
        "joao.silva@email.com"
      ],
      "whatsapp": "5511999999999"
    },
    "cpf": "123.456.789-00",
    "data_nascimento": "1990-01-01",
    "email": "joao.silva@email.com, maria.silva@email.com",
    "enderecos": [
      {
        "bairro": "Centro",
        "cep": "12345-678",
        "cidade": "São Paulo",
        "complemento": "Apto 45",
        "estado": "SP",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "logradouro": "Rua das Flores",
        "numero": "123",
        "pais": "Brasil"
      }
    ],
    "inscricoes": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "indicador_inscricao_estadual": "NAO CONTRIBUINTE",
        "inscricao_estadual": "123456789",
        "inscricao_municipal": "123456789",
        "inscricao_suframa": "123456789"
      }
    ],
    "nome": "João Silva",
    "nome_fantasia": "Empresa LTDA",
    "observacao": "Cliente preferencial",
    "optante_simples": false,
    "outros_contatos": [
      {
        "cargo": "Gerente",
        "email": "maria.silva@email.com",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "nome": "Maria Silva",
        "telefone_celular": "(11) 98765-4321",
        "telefone_comercial": "(11) 1234-5678"
      }
    ],
    "perfis": [
      {
        "tipo_perfil": "Cliente"
      }
    ],
    "rg": "12.345.678-9",
    "telefone_celular": "(11) 98765-4321",
    "telefone_comercial": "(11) 1234-5678",
    "tipo_pessoa": "Física"
  }'

Responses

OK

Bodyapplication/json
agencia_publicaboolean

Indica se a pessoa é uma agência pública

Example:false
ativoboolean

Indica se a pessoa está ativa

Example:true
cnpjstring

CNPJ da pessoa jurídica

Example:"12.345.678/0001-90"
codigostring

Código da pessoa

Example:"CLI001"
contato_cobranca_faturamentoobject(ContatoCobrancaFaturamento)

Contato para cobrança e faturamento

cpfstring

CPF da pessoa física

Example:"123.456.789-00"
data_nascimentostring

Data de nascimento da pessoa física

Example:"1990-01-01"
emailstring

Emails da pessoa separados por vírgula

Example:"joao.silva@email.com, maria.silva@email.com"
enderecosArray of objects(EnderecoPessoa)

Lista de endereços

estrangeiroboolean

Indica se a pessoa é estrangeira

Example:false
idstring

ID da pessoa

Example:"550e8400-e29b-41d4-a716-446655440000"
inscricoesArray of objects(InscricaoPessoa)

Lista de inscrições

nomestring

Nome da pessoa

Example:"João Silva"
nome_fantasiastring

Nome fantasia da pessoa jurídica

Example:"Empresa LTDA"
observacaostring

Observações sobre a pessoa

Example:"Cliente preferencial"
optante_simplesboolean

Indica se a pessoa é optante pelo Simples Nacional

Example:false
origemstring

Origem da criação da pessoa

Example:"API"
outros_contatosArray of objects(OutrosContatos)

Lista de outros contatos

perfisArray of objects(PerfilPessoa)

Lista de perfis

rgstring

Registro Geral (RG) da pessoa. Para pessoas estrangeiras, este campo representa o identificador estrangeiro.

Example:"12.345.678-9"
telefone_celularstring

Telefone celular

Example:"(11) 98765-4321"
telefone_comercialstring

Telefone comercial da pessoa

Example:"(11) 1234-5678"
tipo_pessoastring

Tipo de pessoa: Física, Jurídica ou Estrangeira

Example:"FISICA"
Response
{
  "agencia_publica": false,
  "ativo": true,
  "cnpj": "12.345.678/0001-90",
  "codigo": "CLI001",
  "contato_cobranca_faturamento": {
    "emails": [ … ],
    "whatsapp": "5511999999999"
  },
  "cpf": "123.456.789-00",
  "data_nascimento": "1990-01-01",
  "email": "joao.silva@email.com, maria.silva@email.com",
  "enderecos": [
    { … }
  ],
  "estrangeiro": false,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "inscricoes": [
    { … }
  ],
  "nome": "João Silva",
  "nome_fantasia": "Empresa LTDA",
  "observacao": "Cliente preferencial",
  "optante_simples": false,
  "origem": "API",
  "outros_contatos": [
    { … }
  ],
  "perfis": [
    { … }
  ],
  "rg": "12.345.678-9",
  "telefone_celular": "(11) 98765-4321",
  "telefone_comercial": "(11) 1234-5678",
  "tipo_pessoa": "FISICA"
}