Pessoas

Atualizar tipo e grupo de pessoas em lote

POST · API de Integração v2

POST/v2/pessoas/atualizacoes-em-lote

Atualiza somente os campos informados. grupoEmpresasId=0 remove o grupo; tipoId precisa ser ativo e grupo precisa pertencer ao escritório. O retorno é best-effort.

Autenticação

X-API-Key no cabeçalho. Como autenticar

Corpo da requisiçãoobrigatório

IDs e alterações de tipo/grupo.

application/json

grupoEmpresasIdinteger

Novo grupo de empresas. Omitir preserva; 0 remove o grupo.

formato: int64exemplo: 45

idsinteger[]obrigatório

IDs das pessoas a atualizar (1..1000).

exemplo: [123,124]

tipoIdinteger

Novo ID de tipo. Omitir para preservar a classificação atual.

formato: int64exemplo: 12

Respostas3

Exemplos ilustrativos · nenhuma requisição é enviada

200 · Sucesso

Quando acontece: A operação foi concluída.
Como tratar: Leia os dados retornados; em listagens, confira também a paginação.

Exemplo ilustrativo gerado do schema · application/json

Exemplo · HTTP 200

{
  "atualizadas": [
    123,
    124
  ],
  "ignorados": [
    {
      "id": 125,
      "motivo": "string"
    }
  ],
  "solicitados": 3
}

Contrato de respostas

200Lote processado (ver atualizadas/ignorados).

Lote processado (ver atualizadas/ignorados).

application/json

atualizadasinteger[]

IDs das pessoas atualizadas

exemplo: [123,124]

ignoradosPessoaIgnoradaResponse[]

Pessoas não processadas e seus motivos

Ver propriedades

idinteger

ID da pessoa não processada

formato: int64exemplo: 125

motivostring

Motivo seguro pelo qual a pessoa foi ignorada

solicitadosinteger

Quantidade de pessoas solicitadas

formato: int32exemplo: 3

400Payload, tipo ou grupo inválido.

Payload, tipo ou grupo inválido.

O contrato não declara um corpo para esta resposta.

401Não autenticado (token ausente/inválido).

Não autenticado (token ausente/inválido).

O contrato não declara um corpo para esta resposta.

curl --request POST \
  --url 'https://api.expedit.com.br/v2/pessoas/atualizacoes-em-lote' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: SUA_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "ids": []
}'

Requisição e resposta

As chamadas são enviadas diretamente à API. O domínio deste portal precisa estar autorizado no CORS.

Ver JSON gerado

Corpo gerado dos campos

{
  "ids": []
}

A resposta aparecerá aquiPreencha os campos e envie a requisição para consultar o retorno da API.

Explorar exemplos de resposta

Exemplos ilustrativos · nenhuma requisição é enviada

200 · Sucesso

Quando acontece: A operação foi concluída.
Como tratar: Leia os dados retornados; em listagens, confira também a paginação.

Exemplo ilustrativo gerado do schema · application/json

Exemplo · HTTP 200

{
  "atualizadas": [
    123,
    124
  ],
  "ignorados": [
    {
      "id": 125,
      "motivo": "string"
    }
  ],
  "solicitados": 3
}

Exemplos e campos gerados do contrato OpenAPI. Revise os valores antes de integrar.