Criar uma nova pessoa

Pessoas

Request

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.

Security

BearerAuth

Bodyapplication/jsonrequired

Dados da pessoa a ser criada

agencia_publicaboolean

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

Example:true

ativoboolean

Indica se a pessoa está ativa

Example:true

cnpjstring

CNPJ da pessoa jurídica

Example:"12.345.678/0001-90"

codigostring, <= 20 characters

Código da pessoa

Example:"CLI001"

contato_cobranca_faturamentoobject(CriacaoContatoCobrancaFaturamento)

Contato de 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, <= 100 characters

Emails da pessoa separados por vírgula

Example:"joao.silva@email.com, maria.silva@email.com"

enderecosArray of objects(CriacaoEnderecoPessoa)

Lista de endereços

inscricoesArray of objects(CriacaoInscricaoPessoa)

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 characters

Observações sobre a pessoa

Example:"Cliente preferencial"

optante_simplesboolean

Indica se a pessoa é optante pelo Simples Nacional

Example:true

outros_contatosArray of objects(CriacaoOutroContatoPessoa)

Lista de outros contatos da pessoa

perfisArray of objects(CriacaoPerfilPessoa)

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_celularstring

Telefone celular

Example:"11983899529"

telefone_comercialstring

Telefone comercial da pessoa

Example:"1138185004"

tipo_pessoastring(TipoPessoa)required

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

Enum:"Física""Jurídica""Estrangeira"

Example:"Física"

curl -i -X POST \
  https://api-v2.contaazul.com/v1/pessoas \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "agencia_publica": true,
    "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",
        "logradouro": "Rua das Flores",
        "numero": "123",
        "pais": "Brasil"
      }
    ],
    "inscricoes": [
      {
        "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": true,
    "outros_contatos": [
      {
        "cargo": "Gerente",
        "email": "maria.silva@email.com",
        "nome": "Maria Silva",
        "telefone_celular": "11983899529",
        "telefone_comercial": "1138185004"
      }
    ],
    "perfis": [
      {
        "tipo_perfil": "Cliente"
      }
    ],
    "rg": "12.345.678-9",
    "telefone_celular": "11983899529",
    "telefone_comercial": "1138185004",
    "tipo_pessoa": "Física"
  }'

Responses

Created

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

telefone_comercialstring

Telefone comercial da pessoa

Example:"1112345678"

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": "11987654321",
  "telefone_comercial": "1112345678",
  "tipo_pessoa": "FISICA"
}