post https://app.fracttal.com/api/accounts/
As contas de usuário podem ser criadas por meio desse serviço da Web. Esse endpoint só pode ser executado por quem tem permissão para realizar a criação de contas.
Parâmetros do Body
As informações a seguir devem ser enviadas no corpo da solicitação.
Parâmetros | Tipo | Obrigatório | Descrição |
---|---|---|---|
email | Texto | Opcional | E-mail com o qual o usuário se registrará. Caso não seja enviado, será atribuído o e-mail registrado pelo usuário na Fracttal como um recurso humano ou como um contato de terceiros. |
id_profile | Inteiro | Sim | Número do tipo de usuário a ser criado, 3 devem ser enviados. |
enable_notifications | Booleano | Opcional | Valor para ativar as notificações da Fracttal, o padrão é true |
only_sso | Booleano | Opcional | Valor para ativar somente a autenticação de logon único (SSO); o padrão é false |
user_type | Texto | Sim | Um dos seguintes valores deve ser enviado: HUMAN_RESOURCES (para associar a conta a um recurso humano) THIRD_PARTIES (para associar a conta a um terceiro ou fornecedor) |
personnel_code | Texto | Opcional | É enviado o código do recurso humano registrado na Fracttal, que pode ser obtido aqui (field code). Esse campo é obrigatório quando type_user = HUMAN_RESOURCES. |
third_party_code | Texto | Opcional | É enviado o código do terceiro registrado na Fracttal, que pode ser obtido aqui (field code). Esse campo é obrigatório quando type_user = THIRD_PARTIES. |
name_contact | Texto | Opcional | É enviado o nome do contato associado ao terceiro a ser relacionado, que pode ser obtido aqui (campo name). Esse campo é obrigatório quando type_user = THIRD_PARTIES.. |
user_code | Texto | Sim | Código do recurso humano que criará a conta na Fracttal. |
location_code | Texto | Opcional | Código de localização da conta de usuário. |
Parâmetros adicionais do órgão ao criar Recursos Humanos
Parâmetro | Tipo | Obrigatório | Descrição |
---|---|---|---|
first_name | Texto | Sim | Nomes do recurso humano. Se o recurso humano não existir ao enviar esse campo, a API o criará. Esse campo só deve ser usado quando type_user = HUMAN_RESOURCES |
last_name | Texto | Opcional | Sobrenome do recurso humano |
human_resource_active | Texto | Opcional | Indica se o recurso está ativo ou não |
code_asset_location | Texto | Opcional | Código do ativo do tipo de localização no qual o recurso humano estará localizado. (Pode ser obtido aqui)(https://api.fracttal.com/reference/consultar-un-activo) (campo code) |
group_1 | Texto | Opcional | Descrição da classificação 1 |
group_2 | Texto | Opcional | Descrição da classificação 2 |
address | Texto | Opcional | Endereço |
city | Texto | Opcional | Cidade |
state | Texto | Opcional | Estado |
zip_code | Texto | Opcional | Código postal |
country | Texto | Opcional | País |
latitude | Texto | Opcional | Latitude |
longitud | Texto | Opcional | Longuitude |
telephone | Texto | Opcional | Telefone |
telephone_2 | Texto | Opcional | Telefone 2. |
sms | Texto | Opcional | Sms |
id_hourly_rate | Inteiro | Opcional | Id da hora normal (não deve ser enviado se o campo description_hourly_rate for enviado). Pode ser obtido aqui (campo id) |
description_hourly_rate | Texto | Opcional | Descrição do horário normal (não deve ser enviado se o campo id_hourly_rate for enviado). Disponível aqui (campo description) |
Parâmetros adicionais do corpo quando um terceiro deve ser criado
Parâmetros | Tipo | Obrigatório | Descrição |
---|---|---|---|
third_party_name | Texto | Sim | Nome do terceiro |
third_party_active | Booleano | Opcional | Indica se o recurso estará ativo ou não. O padrão é true |
code_parent_location | Texto | Opcional | Código do ativo do tipo de localização no qual o recurso humano estará localizado. (Pode ser obtido aqui)(https://api.fracttal.com/reference/consultar-un-activo) (campo code) |
group_1 | Texto | Opcional | Descrição da classificação 1 |
group_2 | Texto | Opcional | Descrição da classificação 2 |
address | Texto | Opcional | Endereço |
city | Texto | Opcional | Cidade |
state | Texto | Opcional | Estado |
zip_code | Texto | Opcional | Código Postal |
country | Texto | Opcional | País |
latitude | Texto | Opcional | Latitude |
longitud | Texto | Opcional | Longitude |
telephone | Texto | Opcional | Telefone |
telephone_2 | Texto | Opcional | Telefone 2 |
sms | Texto | Opcional | Sms |
fax | Texto | Opcional | Fax |
web_page | Texto | Opcional | Página web |
visible_to_all | Booleano | Opcional | Indica se ele é visível para todos. O padrão é falso |
id_third_party_type | Array de inteiros | Opcional | 1: Fornecedor de serviços (padrão) 2: Fabricante 3: Fornecedor 4: Cliente |
movil | Texto | Opcional | Número de telefone celular do contato |
skype | Texto | Opcional | Contato pelo Skype |
linkedin | Texto | Opcional | Linkedin do contato |
role | Texto | Sim | Função do contato |
parties_name | Texto | Sim | Título do terceiro |
Parâmetros de saída
Tipo | Parámetro | Descrição |
---|---|---|
Inteiro | id | ID da conta |
Texto | name | Nome do usuário |
Texto | email | Endereço de e-mail do usuário |
Booleano | active | Indica se o usuário está ativo ou não |
Texto | user_type | Tipo de usuário: HUMAN_RESOURCES: Recursos Humanos THIRD_PARTIES: Terceiros |
Booleano | enable_notifications | Indica se as notificações de fractal estão ativadas para o usuário. |
Booleano | only_sso | Indica se você tem apenas autenticação de logon único (SSO). |
Exemplo:
Solicitação: (POST) https://app.fracttal.com/api/accounts/
{
"email": "[email protected]",
"id_profile": 3,
"enable_notifications": true,
"only_sso": false,
"user_type": "HUMAN_RESOURCES",
"personnel_code": "456123489",
"user_code": "25198772-2",
}
{
"email": "[email protected]",
"id_profile": 3,
"enable_notifications": true,
"only_sso": false,
"user_type": "HUMAN_RESOURCES",
"personnel_code": "456123489",
"user_code": "25198772-2",
"first_name":"Nombre Persona",
"last_name":"Apellido Persona"
}
{
"email": "[email protected]",
"id_profile": 3,
"enable_notifications": true,
"only_sso": false,
"user_type": "THIRD_PARTIES",
"third_party_code": "456123489",
"user_code": "2518772-1",
"name_contact":"Nombre contacto",
"third_party_name":"Nombre Tercero",
"id_third_party_type":[1],
"role":"Mecánico",
"telephone":"234567",
"movil":"300555555"
}
{
"success": true,
"message": "200",
"data": {
"id": 72,
"id_company": 69,
"email": "[email protected]",
"name":"Usuario solo solicitudes",
"active": true,
"enable_notifications": true,
"only_sso": false,
"id_contact": null,
"id_third_paties": null,
"id_human_resources": null
},
"total": 1
}