Update contract data 🆕

Alteração de dados contratuais dos candidatos, individual ou em lote.

PUT Url Produção: https://api.acessorh.com.br Url Homologação: https://api.rh.homolog.acesso.io Endpoint: /v1/account/:acc/admissions/batch-update

Headers

Name	Type	Description
Authorization*	string	Token de acesso adquirido pela plataforma Identity (bearer)

Path Parameters

Key	Type	Description
acc*	string	UUID da empresa. Consulte aqui.

Descrição do body JSON da request.

• O payload funciona em batch, com um array de posições diferentes para alterações em lote.

Parâmetros obrigatórios.

Key	Type	Description
position*	string	Identificador da posição/admissão a ser alterada. Consulte aqui.

Parâmetros opcionais.

• Apesar de opcionais, é necessário pelo menos um para que a alteração seja feita.

Key	Type	Description
🆕 unit	string	UID da nova unidade.
role	string	UID do novo cargo.
department	string	UID do novo departamento.
limitDate	string	Nova data limite, formato YYYY-MM-DD.
additional	object	Campos adicionais (abaixo).

Additional

Campos adicionais do cadastro

Key	Type	Description
employeeCode	string	Nova matricula do candidato.
admissionDate	string(data)	Data de admissão, formato YYYY-MM-DD.
admissionDateReason	string	Motivo da alteração da data de admissão.
positionNumber	string	Novo numero da posição.
costCenter	string	Novo centro de custos.

Importante!

• Não é possível alterar dados contratuais de posições que estão arquivadas.

• Apenas os campos enviados no payload são alterados. Campos omitidos permanecem inalterados.

Exemplo de requisição

{
curl --location --request PUT 'https://api.acessorh.com.br/v1/account/1761b1b8-1111-2222-3333-10d2435ea1f5/admissions/batch-update' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--data '[
    {
        "position": "b1e2c3d4-5678-1234-9abc-def012345678",
        "role": "a1b2c3d4-1111-2222-3333-444455556666",
        "department": "d1e2f3g4-7777-8888-9999-000011112222",
        "limitDate": "2025-07-01",
        "additional": {
            "employeeCode": "123456",
            "admissionDate": "2025-06-16",
            "admissionDateReason": "Ajuste por acordo sindical",
            "costCenter": "CC-7890"
        }
    },
    {
        "position": "a9b8c7d6-4321-8765-0fed-cba987654321",
        "additional": {
            "positionNumber": "POS-002"
        }
    }
]'

Exemplo de resposta

200 OK

"[
  {
    "position": "b1e2c3d4-5678-1234-9abc-def012345678",
    "success": true
  },
  {
    "position": "a9b8c7d6-4321-8765-0fed-cba987654321",
    "success": false,
    "error": "unit not found for position"
  }
]

---