> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/employees.md).

# Employees

O **employee** é o trabalhador vinculado ao originador. Autorização, margem, simulação, proposta e contrato dependem dele: cadastrá-lo é o primeiro passo, e os dados informados são usados na elegibilidade e na formalização.

## Conceitos

| Campo        | Descrição                                                                   |
| ------------ | --------------------------------------------------------------------------- |
| `publicId`   | Identificador público do employee, usado em todos os endpoints subsequentes |
| `cpf`        | CPF do trabalhador (11 dígitos, sem pontuação)                              |
| `name`       | Nome completo                                                               |
| `birthDate`  | Data de nascimento (formato `YYYY-MM-DD`)                                   |
| `motherName` | Nome completo da mãe                                                        |
| `phone`      | Telefone de contato                                                         |
| `email`      | E-mail do trabalhador                                                       |

## Ciclo de vida

```
Criar Employee → [Criar documento de autorização] → Autorização Dataprev → Margem → Simulação → Proposta → Contrato
```

Criar o employee **não** inicia a autorização. Ver [Autorização](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao.md) para os caminhos.

## Operações disponíveis

| Operação                                                                                                                            | Método   | Endpoint                                                           | Observação                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------------ | ---------------------------------------------------------------- |
| [Criar Employee](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/employees/criar-employee.md)                    | `POST`   | `/api/v1/originator/employees`                                     | Cadastra **e** atualiza — idempotente por CPF                    |
| [Buscar Employee](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/employees/buscar-employee.md)                  | `GET`    | `/api/v1/originator/employees/{publicId}`                          |                                                                  |
| [Verificar CPF](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/employees/verificar-cpf.md)                      | `POST`   | `/api/v1/originator/employees/lookup`                              | CPF no corpo; substitui o `GET /by-cpf/{cpf}`, **descontinuado** |
| [Desativar Employee](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/employees/desativar-employee.md)            | `DELETE` | `/api/v1/originator/employees/{publicId}`                          |                                                                  |
| [Cadastrar Vínculo Empregatício](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/employees/cadastrar-vinculo.md) | `POST`   | `/api/v1/originator/employees/{publicId}/employment-relationships` | Para quem consultou a margem em outro provedor                   |

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
