> For the complete documentation index, see [llms.txt](https://devcenter.unico.io/unico-people/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devcenter.unico.io/unico-people/unico-people-v1/apis/posicoes/update-contract-data.md).

# Update contract data 🆕

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

<mark style="color:yellow;">`PUT`</mark> \ <mark style="color:$primary;">**Url Produção:**</mark> `https://api.acessorh.com.br`\ <mark style="color:$primary;">**Url Homologação:**</mark> `https://api.rh.homolog.acesso.io`\ <mark style="color:$primary;">**Endpoint:**</mark> `/v1/account/:acc/admissions/batch-update`

### **Headers**

| Name                                            | Type   | Description                                                   |
| ----------------------------------------------- | ------ | ------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | Token de acesso adquirido pela plataforma Identity *(bearer)* |

### **Path Parameters**

| Key                                   | Type   | Description                                                                          |
| ------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| acc<mark style="color:red;">\*</mark> | string | UUID da empresa. [Consulte aqui.](/unico-people/unico-people-v1/apis/organizacao.md) |

### Descrição do body JSON da request. <a href="#descricao-do-body-json-da-request-1" id="descricao-do-body-json-da-request-1"></a>

{% hint style="success" %}

* O payload funciona em batch, com um array de posições diferentes para alterações em lote.
  {% endhint %}

#### **Parâmetros obrigatórios.**

| Key                                            | Type   | Description                                                                                                                                                                                        |
| ---------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| p**osition**<mark style="color:red;">\*</mark> | string | Identificador da posição/admissão a ser alterada. [Consulte aqui.](https://app.gitbook.com/o/oXwaJDbmuu5wv042bkqn/s/Q0NlWOpe7P6qfoBx0BFC/~/changes/8/unico-people-v1/apis/posicoes/list-positions) |

#### **Parâmetros opcionais.**

{% hint style="warning" %}

* Apesar de opcionais, é necessário pelo menos um para que a alteração seja feita.
  {% endhint %}

| Key        | Type   | Description                                                                      |
| ---------- | ------ | -------------------------------------------------------------------------------- |
| 🆕 unit    | string | UID da nova [unidade.](/unico-people/unico-people-v1/apis/organizacao.md)        |
| **role**   | string | UID do novo [cargo.](/unico-people/unico-people-v1/apis/cargos.md)               |
| department | string | UID do novo [departamento.](/unico-people/unico-people-v1/apis/departamentos.md) |
| limitDate  | string | Nova data limite, formato YYYY-MM-DD.                                            |
| additional | object | Campos adicionais (abaixo).                                                      |

#### Additional <a href="#campo-decline" id="campo-decline"></a>

**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.                   |

{% hint style="danger" %} <mark style="color:$danger;">**Importante**</mark>!

* 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.
  {% endhint %}

### Exemplo de requisição <a href="#exemplo-de-requisicao-1" id="exemplo-de-requisicao-1"></a>

```json
{
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 <a href="#exemplo-de-requisicao-1" id="exemplo-de-requisicao-1"></a>

{% code title="200 OK" %}

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

```

{% endcode %}

***