post https://app.fracttal.com/api/accounts/
Mediante este servicio web se pueden crear cuentas de usuarios. Este endpoint solo puede ser ejecutado por quienes tengan permiso de realizar la creación de cuentas.
Parámetros del body
La siguiente información debe ser enviada en el body de la petición.
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
email | Texto | Opcional | Email con el que se registrará el usuario. En caso que no se envíe, se le asignará el que registró el usuario dentro de Fracttal como recurso humano o como contacto de un tercero |
id_profile | Entero | Sí | Número del tipo de usuario que se creará, se debe enviar 3 |
enable_notifications | Booleano | Opcional | Valor para activar las notificaciones de Fracttal, por defecto es true |
only_sso | Booleano | Opcional | Valor para activar sólo la autenticación Single Sign On (SSO), por defecto es false |
user_type | Texto | Sí | Se debe enviar alguno de los siguientes valores: HUMAN_RESOURCES (para asociar la cuenta a un recurso humano) THIRD_PARTIES (Para asociar la cuenta a un tercero o proveedor) |
personnel_code | Texto | Opcional | Se envía el código del recurso humano registrado en Fracttal, el cual se puede obtener aquí (campo code). Este campo es obligatorio cuando el type_user = HUMAN_RESOURCES. |
third_party_code | Texto | Opcional | Se envía el código del tercero registrado en Fracttal, el cual se puede obtener aquí (campo code). Es requerido si el tipo de usuario es un tercero (user_type = THIRD_PARTIES) |
name_contact | Texto | Este campo es obligatorio cuando el type_user = THIRD_PARTIES | Se envía el nombre del contacto asociado al tercero a relacionar, el cual se puede obtener aquí (campo name). |
user_code | Texto | Sí | Código del recurso humano que creará la cuenta en Fracttal. |
location_code | Texto | Opcional | Código de la ubicación de la cuenta de usuario. |
Parámetros adicionales del Body cuando se va a crear Recurso Humano
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
first_name | Texto | Sí | Nombres del recurso humano. Si el recurso Humano no existe al enviar este campo el api lo crea. Este campo solo se debe usar cuando el type_user = HUMAN_RESOURCES |
last_name | Texto | Opcional | Apellidos del recurso humano |
human_resource_active | Texto | Opcional | Indica si el recurso está activo o no |
code_asset_location | Texto | Opcional | Código del activo tipo ubicación en el cual estará localizado el recurso humano. Se puede obtener aquí (campo code) |
group_1 | Texto | Opcional | Descripción de la clasificación 1 |
group_2 | Texto | Opcional | Descripción de la clasificación 2 |
address | Texto | Opcional | Dirección |
city | Texto | Opcional | Ciudad |
state | Texto | Opcional | Estado |
zip_code | Texto | Opcional | Código de área |
country | Texto | Opcional | País |
latitude | Texto | Opcional | Latitude |
longitud | Texto | Opcional | Longuitud |
telephone | Texto | Opcional | Teléfono |
telephone_2 | Texto | Opcional | Teléfono 2. |
sms | Texto | Opcional | Sms |
id_hourly_rate | Entero | Opcional | Id de la hora ordinaria (No se debe enviar si se envía el campo description_hourly_rate). Se puede obtener aquí (campo id) |
description_hourly_rate | Texto | Opcional | Descripción de la hora ordinaria (No se debe enviar si se envía el campo id_hourly_rate). Se puede obtener aquí (campo description) |
Parámetros adicionales del Body cuando se va a crear un Tercero
Parámetro | Tipo | Requerido | Descripción |
---|---|---|---|
third_party_name | Texto | Sí | Nombre del tercero |
third_party_active | Booleano | Opcional | Indica si el recurso estará activo o no. Por defecto será true |
code_parent_location | Texto | Opcional | Código del activo tipo ubicación en el cual estará localizado el recurso humano. Se puede obtener aquí (campo code) |
group_1 | Texto | Opcional | Descripción de la clasificación 1 |
group_2 | Texto | Opcional | Descripción de la clasificación 2 |
address | Texto | Opcional | Dirección |
city | Texto | Opcional | Ciudad |
state | Texto | Opcional | Estado |
zip_code | Texto | Opcional | Código de área |
country | Texto | Opcional | País |
latitude | Texto | Opcional | Latitude |
longitud | Texto | Opcional | Longitud |
telephone | Texto | Opcional | Teléfono |
telephone_2 | Texto | Opcional | Teléfono 2 |
sms | Texto | Opcional | Sms |
fax | Texto | Opcional | Fax |
web_page | Texto | Opcional | Página web |
visible_to_all | Booleano | Opcional | Indica si es visible para todos. Por defecto es false |
id_third_party_type | Array de enteros | Opcional | 1: Proveedor de servicios (Por defecto) 2: Fabricante 3: Proveedor 4: Cliente |
movil | Texto | Opcional | Teléfono móvil del contacto |
skype | Texto | Opcional | Skype del contacto |
linkedin | Texto | Opcional | Linkedin del contacto |
role | Texto | Sí | Rol del contacto |
parties_name | Texto | Sí | Titulo del tercero |
Parámetros de salida
Parámetro | Tipo | Descripción |
---|---|---|
id | Entero | Id de la cuenta |
name | Texto | Nombre del usuario |
email | Texto | Email del usuario |
active | Booleano | Indica si el usuario está activo o no |
user_type | Texto | Tipo de usuario: HUMAN_RESOURCES: Recursos humanos THIRD_PARTIES: Terceros |
enable_notifications | Booleano | Indica si las notificaciones de fracttal están activadas para el usuario |
only_sso | Booleano | Indica si solo tiene autenticación Single Sign On (SSO) |
Ejemplo:
Petición: (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
}