API Endpoints
Fracttal →

Crear cuentas de usuarios

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ámetroTipoRequeridoDescripción
emailTextoOpcionalEmail 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_profileEnteroNúmero del tipo de usuario que se creará, se debe enviar 3
enable_notificationsBooleanoOpcionalValor para activar las notificaciones de Fracttal, por defecto es true
only_ssoBooleanoOpcionalValor para activar sólo la autenticación Single Sign On (SSO), por defecto es false
user_typeTextoSe 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_codeTextoOpcionalSe 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_codeTextoOpcionalSe 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_contactTextoEste campo es obligatorio cuando el type_user = THIRD_PARTIESSe envía el nombre del contacto asociado al tercero a relacionar, el cual se puede obtener aquí (campo name).
user_codeTextoCódigo del recurso humano que creará la cuenta en Fracttal.
location_codeTextoOpcionalCódigo de la ubicación de la cuenta de usuario.

Parámetros adicionales del Body cuando se va a crear Recurso Humano

ParámetroTipoRequeridoDescripción
first_nameTextoNombres 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_nameTextoOpcionalApellidos del recurso humano
human_resource_activeTextoOpcionalIndica si el recurso está activo o no
code_asset_locationTextoOpcionalCódigo del activo tipo ubicación en el cual estará localizado el recurso humano. Se puede obtener aquí (campo code)
group_1TextoOpcionalDescripción de la clasificación 1
group_2TextoOpcionalDescripción de la clasificación 2
addressTextoOpcionalDirección
cityTextoOpcionalCiudad
stateTextoOpcionalEstado
zip_codeTextoOpcionalCódigo de área
countryTextoOpcionalPaís
latitudeTextoOpcionalLatitude
longitudTextoOpcionalLonguitud
telephoneTextoOpcionalTeléfono
telephone_2TextoOpcionalTeléfono 2.
smsTextoOpcionalSms
id_hourly_rateEnteroOpcionalId 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_rateTextoOpcionalDescripció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ámetroTipoRequeridoDescripción
third_party_nameTextoNombre del tercero
third_party_activeBooleanoOpcionalIndica si el recurso estará activo o no. Por defecto será true
code_parent_locationTextoOpcionalCódigo del activo tipo ubicación en el cual estará localizado el recurso humano. Se puede obtener aquí (campo code)
group_1TextoOpcionalDescripción de la clasificación 1
group_2TextoOpcionalDescripción de la clasificación 2
addressTextoOpcionalDirección
cityTextoOpcionalCiudad
stateTextoOpcionalEstado
zip_codeTextoOpcionalCódigo de área
countryTextoOpcionalPaís
latitudeTextoOpcionalLatitude
longitudTextoOpcionalLongitud
telephoneTextoOpcionalTeléfono
telephone_2TextoOpcionalTeléfono 2
smsTextoOpcionalSms
faxTextoOpcionalFax
web_pageTextoOpcionalPágina web
visible_to_allBooleanoOpcionalIndica si es visible para todos. Por defecto es false
id_third_party_typeArray de enterosOpcional1: Proveedor de servicios (Por defecto)
2: Fabricante
3: Proveedor
4: Cliente
movilTextoOpcionalTeléfono móvil del contacto
skypeTextoOpcionalSkype del contacto
linkedinTextoOpcionalLinkedin del contacto
roleTextoRol del contacto
parties_nameTextoTitulo del tercero

Parámetros de salida

ParámetroTipoDescripción
idEnteroId de la cuenta
nameTextoNombre del usuario
emailTextoEmail del usuario
activeBooleanoIndica si el usuario está activo o no
user_typeTextoTipo de usuario:

HUMAN_RESOURCES: Recursos humanos
THIRD_PARTIES: Terceros
enable_notificationsBooleanoIndica si las notificaciones de fracttal están activadas para el usuario
only_ssoBooleanoIndica 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
}
Language