> 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/create-position.md).

# Create position 🆕

Cria uma posição na filial selecionada. A criação da posição é uma replica do preenchimento no Dashboard, passando as informações básicas para a identificação do candidato e geração do check-list.

<mark style="color:orange;">`POST`</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/:unit/json/position`

### **Headers**

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

### **Path Parameters**

| Key                                    | Type   | Description                                                                                                  |
| -------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------ |
| unit<mark style="color:red;">\*</mark> | string | UID da filial onde a posição será criada. [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" id="descricao-do-body-json-da-request"></a>

#### **Objeto de profile**

| Key                                          | Type                          | Description                    |
| -------------------------------------------- | ----------------------------- | ------------------------------ |
| **name**<mark style="color:red;">\*</mark>   | string                        | Nome do candidato              |
| **email**<mark style="color:red;">\*</mark>  | string                        | E-mail do candidato            |
| **mobile**<mark style="color:red;">\*</mark> | string, format("11911111111") | Número do celular do candidato |

Exemplo de profile no payload

```json
"profile": {
        "name": "John Doe",
        "email": "John.doe@email.com",
        "mobile": "11911111111"
    },
```

### **Campos obrigatórios no payload**

| Key                                               | Type                         | Description                                                                                                              |
| ------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **limit\_date**<mark style="color:red;">\*</mark> | string, format("YYYY-mm-dd") | Data limite para o preenchimento do cadastro. Valor mínimo válido precisa ser maior ou igual à data atual                |
| **role**<mark style="color:red;">\*</mark>        | string                       | UID ou código do cargo indicado para a vaga. [Consulte aqui](/unico-people/unico-people-v1/apis/cargos.md)               |
| **department**<mark style="color:red;">\*</mark>  | string                       | UID ou código do departamento indicado para a vaga. [Consulte aqui](/unico-people/unico-people-v1/apis/departamentos.md) |
| **pagamento**<mark style="color:red;">\*</mark>   | object                       | Informações sobre o pagamento. A string de "vinculo" é obrigatória.                                                      |

Exemplo de dados obrigatórios no payload

```json
    "limit_date": "2028-01-01",
    "role": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "department": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
    "pagamento": {
        "vinculo": "clt"
    },
```

**Campos opcionais para o payload**

| Key                 | Type                         | Description                                                                                                                   |
| ------------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **num\_matricula**  | string                       | Número da matrícula                                                                                                           |
| **pos\_number**     | string                       | Número da posição                                                                                                             |
| **cost\_center**    | string                       | Centro de custo                                                                                                               |
| **admission\_date** | string, format("YYYY-mm-dd") | Data de admissão                                                                                                              |
| **deficiencia**     | boolean                      | Indica se a vaga é PCD                                                                                                        |
| **jornada**         | string                       | Informações sobre a jornada de trabalho                                                                                       |
| **exame**           | object                       | Informações sobre o agendamento de exame médico                                                                               |
| **docs**            | array\[string]               | UIDs dos [types de documentos](/unico-people/unico-people-v1/apis/documentos.md) adicionais a serem solicitados para a vaga   |
| **benefits**        | array\[string]               | UIDs dos [grupos de benefícios.](/unico-people/unico-people-v1/apis/beneficios.md)(Obs.: Deverá ter apenas um por categoria.) |
| **send\_sms**       | boolean                      | Indica a necessidade do envio da notificação para o candidato através de um SMS/Whats app                                     |
| **send\_email**     | boolean                      | Indica a necessidade do envio da notificação para o candidato através de um e-mail                                            |

#### **Opções do objeto de pagamento - Obrigatório**

| Key                                           | Type             | Description          |
| --------------------------------------------- | ---------------- | -------------------- |
| **vinculo**<mark style="color:red;">\*</mark> | string (options) | Vínculo empregatício |

**Opções de vínculo**

{% code overflow="wrap" %}

```
"clt", "estagio", "aprendiz", "autonomo", "temporario", "verde-amarelo", "intermitente", "estatuario"
```

{% endcode %}

#### **Opções do objeto de pagamento - Opcionais**

| Key                     | Type                         | Description                                                    |
| ----------------------- | ---------------------------- | -------------------------------------------------------------- |
| **recorrencia**         | string (options)             | Recorrência do pagamento                                       |
| **valor**               | string                       | Valor da remuneração                                           |
| **dataInicio**          | string, format("YYYY-mm-dd") | Data de início do contrato de estágio ou aprendiz              |
| **dataTermino**         | string, format("YYYY-mm-dd") | Data de término do contrato de estágio ou aprendiz             |
| **agenteIntegrador**    | string(options)              | Agente integrador do contrato de estágio ou aprendiz           |
| **contaBancaria**       | object                       | Dados referentes à configuração de cartas de abertura de conta |
| jornada\_trabalho       | object                       | <p>Campo para preenchimento do turno de trabalho, ex: <br>{    |
| <br>"entrada": "09:00", |                              |                                                                |
| <br>"saida": "18:00"    |                              |                                                                |
| <br>},</p>              |                              |                                                                |

**Opções de recorrência**

```
"horista", "mensalista", "aulista", "comissionista", "diarista"
```

**Opções de agente integrador**

{% code overflow="wrap" %}

```
        ----KEY----		   ----LABEL----
        "ciee":                    "CIEE",
	"nube":                    "Nube",
	"senai":                   "Senai",
	"senai_pa_barcarena":      "Senai PA - Barcarena",
	"senai_pe_sto_agostinho":  "Senai PE - Santo Agostinho",
	"senai_mt_cuiaba":         "Senai MT - Cuiaba",
	"senai_mt_nova_mutum":     "Senai MT - Nova Mutum",
	"senai_rj_rio_de_janeiro": "Senai RJ - Rio de Janeiro",
	"senai_mg_mariana":        "Senai MG - Mariana",
	"senac":                   "Senac",
	"mudes":                   "Mudes",
	"coep":                    "COEP",
	"rede_cidada":             "Rede cidadã",
	"espro":                   "Espro",
	"espro_sp_av_paulista":    "Espro SP - Av. Paulista",
	"espro_mg_belo_horizonte": "Espro MG - Belo Horizonte",
	"espro_sp_santo_amaro":    "Espro SP - Santo Amaro",
	"espro_sp_osasco":         "Espro SP - Osasco",
	"espro_rj_rio_de_janeiro": "Espro RJ - Rio de Janeiro",
	"guarda_mirim":            "Guarda Mirim",
	"iel":                     "IEL - Instituto Euvaldo Lodi",
	"iaq":                     "IAQ",
	"apae_jo_clemente":        "INSTITUTO JÔ CLEMENTE (APAE)",
	"gerar_guarapuva_ponta":   "GERAR (Guarapuava_Ponta Grossa)",
	"instituto_ser":           "INSTITUTO SER+",
	"perfil_talentos":         "INTAL (Instituto Nacional Talentos de Inclusão Profissional)",
	"intal_sao_paulo":         "INTAL - SÃO PAULO (BARRA FUNDA)",
	"intal_guarulhos":         "INTAL GUARULHOS",
	"intal_sao_bernardo":      "INTAL SÃO BERNARDO DO CAMPO",
	"intal_santo_andre":       "INTAL SANTO ANDRÉ",
	"pestalozzi":              "PESTALOZZI (Maceió)",
	"renapsi":                 "RENAPSI",
	"elo":                     "ELO",
	"pastoral":                "Pastoral",
	"via_de_acesso":           "Via de Acesso",
	"geec":                    "Grupo Educação Etica E Cidadania",
	"cieds":                   "CIEDS",
	"metta_integradora":       "Metta Integradora Empresa Escola Sociedade Simples LTDA",
	"instituto_pater":         "Instituto Pater",
	"cia_de_estagios":         "Cia de Estágios",
	"abecao":                  "ABECAO",
	"outros":                  "Outros",
```

{% endcode %}

{% hint style="info" %}
Os campos de <mark style="color:$warning;">`recorrencia`</mark> e de <mark style="color:$warning;">`valor`</mark> são interdependentes. Caso um seja preenchido o outro se torna obrigatório.
{% endhint %}

**Conta bancária**

| Key          | Type            | Description                                                                                                   |
| ------------ | --------------- | ------------------------------------------------------------------------------------------------------------- |
| **banco**    | string(options) | Código do banco do qual a carta de abertura de conta se refere (obrigatório apenas caso usar conta bancaria.) |
| **carta**    | string          | UID do arquivo contendo a carta de abertura de conta                                                          |
| **template** | string          | UID do modelo de abertura de conta. [Consulte aqui](/unico-people/unico-people-v1/apis/modelo-de-carta.md)    |

<details>

<summary><strong>Opções de banco - expandir</strong></summary>

<table><thead><tr><th width="185.3125">Code</th><th width="424.5625">Label</th></tr></thead><tbody><tr><td>025</td><td>BANCO ALFA</td></tr><tr><td>041</td><td>BANRISUL</td></tr><tr><td>001</td><td>BANCO DO BRASIL</td></tr><tr><td>033</td><td>BANCO SANTANDER</td></tr><tr><td>003</td><td>BANCO DA AMAZÔNIA</td></tr><tr><td>070</td><td>BANCO DE BRASÍLIA</td></tr><tr><td>082</td><td>BANCO TOPÁZIO</td></tr><tr><td>069</td><td>BANCO CREFISA</td></tr><tr><td>085</td><td>COOP CENTRAL AILOS</td></tr><tr><td>077</td><td>BANCO INTER</td></tr><tr><td>004</td><td>BANCO DO NORDESTE</td></tr><tr><td>037</td><td>BANPARÁ</td></tr><tr><td>047</td><td>BANESE</td></tr><tr><td>021</td><td>BANESTES</td></tr><tr><td>218</td><td>BANCO BS2</td></tr><tr><td>237</td><td>BANCO BRADESCO</td></tr><tr><td>260</td><td>NUBANK</td></tr><tr><td>290</td><td>PAGBANK</td></tr><tr><td>301</td><td>BANCO BBC</td></tr><tr><td>265</td><td>BANCO FATOR</td></tr><tr><td>336</td><td>C6 BANK</td></tr><tr><td>318</td><td>BANCO BMG</td></tr><tr><td>341</td><td>BANCO ITAÚ</td></tr><tr><td>380</td><td>PICPAY</td></tr><tr><td>340</td><td>BANCO SUPERDIGITAL</td></tr><tr><td>389</td><td>BANCO MERCANTIL DO BRASIL</td></tr><tr><td>422</td><td>BANCO SAFRA</td></tr><tr><td>399</td><td>BANCO HSBC</td></tr><tr><td>611</td><td>BANCO PAULISTA</td></tr><tr><td>612</td><td>BANCO GUANABARA</td></tr><tr><td>104</td><td>CAIXA ECONÔMICA FEDERAL</td></tr><tr><td>121</td><td>AGIBANK</td></tr><tr><td>643</td><td>BANCO PINE</td></tr><tr><td>151</td><td>BANCO NOSSA CAIXA</td></tr><tr><td>413</td><td>BANCO BV</td></tr><tr><td>212</td><td>BANCO ORIGINAL</td></tr><tr><td>745</td><td>BANCO CITIBANK</td></tr><tr><td>746</td><td>BANCO MODAL</td></tr><tr><td>735</td><td>BANCO POTTENCIAL</td></tr><tr><td>748</td><td>BANCO SICREDI</td></tr><tr><td>413</td><td>BANCO BV</td></tr><tr><td>755</td><td>BANK OF AMERICA MERRILL LYNCH</td></tr><tr><td>756</td><td>SICOOB</td></tr><tr><td>623</td><td>BANCO PAN</td></tr><tr><td>637</td><td>BANCO SOFISA</td></tr><tr><td>738</td><td>BANCO MORADA</td></tr><tr><td>536</td><td>BANCO NEON</td></tr><tr><td>349</td><td>AL5 S.A. CREDITO</td></tr></tbody></table>

</details>

{% hint style="warning" %}
**As opções de código de banco respeitam as configurações da plataforma.**\
\
Essa configuração pode ser sobreposta pelas informações do payload, se e somente se no objeto “**contaBancaria**”, forem especificados ambos os atributos, **“banco”** e **“carta”/”template**” com valores válidos.\
\
Se for informado somente “banco”, vai respeitar as opções de banco cadastradas na empresa.
{% endhint %}

{% hint style="info" %} <mark style="color:$warning;">**Apenas uma opção deve ser escolhida**</mark>: Carta ou template.

<mark style="color:$warning;">**Para o template:**</mark> O ID do modelo de carta pode ser encontrado usando [essa api](/unico-people/unico-people-v1/apis/modelo-de-carta.md).

<mark style="color:$warning;">**Para carta:**</mark> Caso queira criar a posição com uma carta de abertura de conta anexada, é necessário [realizar o seu upload antes.](/unico-people/unico-people-v1/apis/arquivos.md#upload-file)
{% endhint %}

**Exame**

| Key                                           | Type                         | Description                                                     |
| --------------------------------------------- | ---------------------------- | --------------------------------------------------------------- |
| **clinica**<mark style="color:red;">\*</mark> | string                       | UID ou código da clínica. (obrigatório apenas caso usar exame.) |
| **data**                                      | string, format("YYYY-mm-dd") | Data do agendamento                                             |
| **hora**                                      | string, format("HH:MM")      | Hora do agendamento                                             |
| **obs**                                       | string                       | Observações do agendamento                                      |
| **guia**                                      | string                       | UID do arquivo contendo a guia do exame médico                  |

{% hint style="warning" %}
**Obs:** Os campos *data, hora e obs,* não são obrigatórios mas é indicado que eles sejam preenchidos pois são essas informações que serão disponibilizadas para os candidatos no momento do preenchimento da vaga.&#x20;

**\*guia:** Caso queira criar a posição com uma guia de exame médico anexada, é necessário [realizar o seu upload antes.](/unico-people/unico-people-v1/apis/arquivos.md#upload-file)
{% endhint %}

### Exemplo de requisição completa

```json
{
  "profile": {
    "name": "John Doe",
    "email": "john.doe@acessodigital.com.br",
    "mobile": "11911111111"
  },
  "num_matricula": "4242424",
  "limit_date": "2028-01-01",
  "admission_date": "2028-01-01",
  "cost_center": "anywhere",
  "pos_number": "pos-test",
  "role": "b63e065f-d7e0-49e1-91b7-88f74516e3fe",
  "department": "bf559996-a8b9-4f5e-af57-86111b0dbde3",
  "pagamento": {
    "vinculo": "clt",
    "valor": "4200",
    "recorrencia": "mensalista",
    "contaBancaria": {
      "banco": "001",
      "carta": "c9160763-db6c-4e8c-a1ad-ad8709c99be2"
    }
  },
  "deficiencia": false,
  "jornada": "De segunda a sexta das 15 as 19",
  "jornada_trabalho": {
        "entrada": "09:00",
        "saida": "18:00"
    },
  "exame": {
    "clinica": "6dc84ce4-7d9f-48ec-b9b1-a8a895a21fd4",
    "data": "2018-01-01",
    "hora": "14:00",
    "obs": "Comparecer de manhã",
    "guia": "e37dab24-c7a4-4b92-b9d1-32ed538b8300",
  },
  "docs": ["c9e26093-5e0c-4bd2-bea3-ac5182a6179f"],
  "send_sms": true,
  "send_email": true
}
```

### Exemplo de response

{% code title="200 OK" %}

```json
"ok"
```

{% endcode %}

{% hint style="info" %}
Caso a requisição seja realizada com sucesso, o header `position-id`, contendo o UID da position criada, será enviado na resposta.
{% endhint %}