For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentaçãoReferência da API
DocumentaçãoReferência da API
  • Integrações privadas
        • GETListar Leads via Integração
        • GETListar consultores
        • GETListar pessoas
        • POSTCriar pessoa
        • PUTAtualizar pessoa
        • GETListar endereços
  • Entrada pública de leads
LogoLogo
Integrações privadasCRMCadastros

Atualizar pessoa

||View as Markdown|
PUT
/simplificav2/pessoa/:id
PUT
/ords/gestao/simplificav2/pessoa/:id
$curl -X PUT https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/pessoa/1 \
> -H "Authorization: Bearer <token>" \
> -H "Content-Type: application/json" \
> -d '{}'
1{
2 "status": "sucesso",
3 "mensagem": "Solicitação executada com sucesso.",
4 "data": {
5 "id": 1
6 }
7}
Atualiza uma pessoa existente. Regras: - a operação atualiza somente os campos enviados; - campos omitidos continuam com o valor atual; - esta rota não altera `tipo_registro`, `tipo_pessoa_cliente`, `ativo`, motivo de inativação, consultor nem foto; - o estado final continua respeitando as mesmas validações de cadastro usadas no CRM; - e-mail e telefone continuam sendo validados e não podem colidir com outra pessoa; - exclusão e ações de status continuam fora deste endpoint. Exemplos de uso: ```http PUT {{base_url}}/simplificav2/pessoa/164272 Authorization: Bearer {{bearer_token}} Content-Type: application/json { "obs": "Atualizado pela integração" } ``` ```http PUT {{base_url}}/simplificav2/pessoa/164272 Authorization: Bearer {{bearer_token}} Content-Type: application/json { "email": "contato@empresa.com.br", "segmento_id": 9 } ```
Was this page helpful?
Previous

Criar pessoa

Next

Listar endereços

Built with

Atualiza uma pessoa existente.

Regras:

  • a operação atualiza somente os campos enviados;
  • campos omitidos continuam com o valor atual;
  • esta rota não altera tipo_registro, tipo_pessoa_cliente, ativo, motivo de inativação, consultor nem foto;
  • o estado final continua respeitando as mesmas validações de cadastro usadas no CRM;
  • e-mail e telefone continuam sendo validados e não podem colidir com outra pessoa;
  • exclusão e ações de status continuam fora deste endpoint.

Exemplos de uso:

1PUT {{base_url}}/simplificav2/pessoa/164272
2Authorization: Bearer {{bearer_token}}
3Content-Type: application/json
4
5{
6 "obs": "Atualizado pela integração"
7}
1PUT {{base_url}}/simplificav2/pessoa/164272
2Authorization: Bearer {{bearer_token}}
3Content-Type: application/json
4
5{
6 "email": "contato@empresa.com.br",
7 "segmento_id": 9
8}

Authentication

AuthorizationBearer
Token privado usado para consultar dados da plataforma. Como usar: - obtenha o token privado da sua empresa; - envie `Authorization: Bearer SEU_TOKEN_PRIVADO`; - não use `x-api-key` neste módulo.

Path parameters

idintegerRequired
Identificador da pessoa.

Request

This endpoint expects an object.
nome_completostring or nullOptional
Novo nome principal da pessoa.
cpfstring or nullOptional
cnpjstring or nullOptional
nascimentostring or nullOptional

Data de nascimento no formato YYYY-MM-DD.

emailstring or nullOptional
celular_1string or nullOptional
celular_2string or nullOptional
telefone_fixostring or nullOptional
origem_idinteger or nullOptional
fornecedorstring or nullOptional

Use S ou N.

sexostring or nullOptional

Use M ou F.

pessoa_indicacao_idinteger or nullOptional
nome_fantasiastring or nullOptional
contatostring or nullOptional
insc_estadualstring or nullOptional
insc_municipalstring or nullOptional
site_urlstring or nullOptional
obsstring or nullOptional
categoria_idinteger or nullOptional
segmento_idinteger or nullOptional
interessesstring or nullOptional

Lista de identificadores separada por ; ou :.

tagstring or nullOptional

Lista textual de tags separada por ; ou :.

Response

Pessoa atualizada com sucesso.
statusstring
mensagemstring
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error

Token privado usado para consultar dados da plataforma.

Como usar:

  • obtenha o token privado da sua empresa;
  • envie Authorization: Bearer SEU_TOKEN_PRIVADO;
  • não use x-api-key neste módulo.