> 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 🆕

<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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://devcenter.unico.io/unico-people/unico-people-v1/apis/posicoes/create-position.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.