API Endpoints
Fracttal →

Criar contas de usuário

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âmetrosTipoObrigatórioDescrição
emailTextoOpcionalE-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_profileInteiroSimNúmero do tipo de usuário a ser criado, 3 devem ser enviados.
enable_notificationsBooleanoOpcionalValor para ativar as notificações da Fracttal, o padrão é true
only_ssoBooleanoOpcionalValor para ativar somente a autenticação de logon único (SSO); o padrão é false
user_typeTextoSimUm 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_codeTextoOpcionalÉ 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_codeTextoOpcionalÉ 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_contactTextoOpcionalÉ 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_codeTextoSimCódigo do recurso humano que criará a conta na Fracttal.
location_codeTextoOpcionalCódigo de localização da conta de usuário.

Parâmetros adicionais do órgão ao criar Recursos Humanos

ParâmetroTipoObrigatórioDescrição
first_nameTextoSimNomes 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_nameTextoOpcionalSobrenome do recurso humano
human_resource_activeTextoOpcionalIndica se o recurso está ativo ou não
code_asset_locationTextoOpcionalCó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_1TextoOpcionalDescrição da classificação 1
group_2TextoOpcionalDescrição da classificação 2
addressTextoOpcionalEndereço
cityTextoOpcionalCidade
stateTextoOpcionalEstado
zip_codeTextoOpcionalCódigo postal
countryTextoOpcionalPaís
latitudeTextoOpcionalLatitude
longitudTextoOpcionalLonguitude
telephoneTextoOpcionalTelefone
telephone_2TextoOpcionalTelefone 2.
smsTextoOpcionalSms
id_hourly_rateInteiroOpcionalId da hora normal (não deve ser enviado se o campo description_hourly_rate for enviado). Pode ser obtido aqui (campo id)
description_hourly_rateTextoOpcionalDescriçã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âmetrosTipoObrigatórioDescrição
third_party_nameTextoSimNome do terceiro
third_party_activeBooleanoOpcionalIndica se o recurso estará ativo ou não. O padrão é true
code_parent_locationTextoOpcionalCó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_1TextoOpcionalDescrição da classificação 1
group_2TextoOpcionalDescrição da classificação 2
addressTextoOpcionalEndereço
cityTextoOpcionalCidade
stateTextoOpcionalEstado
zip_codeTextoOpcionalCódigo Postal
countryTextoOpcionalPaís
latitudeTextoOpcionalLatitude
longitudTextoOpcionalLongitude
telephoneTextoOpcionalTelefone
telephone_2TextoOpcionalTelefone 2
smsTextoOpcionalSms
faxTextoOpcionalFax
web_pageTextoOpcionalPágina web
visible_to_allBooleanoOpcionalIndica se ele é visível para todos. O padrão é falso
id_third_party_typeArray de inteirosOpcional1: Fornecedor de serviços (padrão)
2: Fabricante
3: Fornecedor
4: Cliente
movilTextoOpcionalNúmero de telefone celular do contato
skypeTextoOpcionalContato pelo Skype
linkedinTextoOpcionalLinkedin do contato
roleTextoSimFunção do contato
parties_nameTextoSimTítulo do terceiro

Parâmetros de saída

TipoParámetroDescrição
InteiroidID da conta
TextonameNome do usuário
TextoemailEndereço de e-mail do usuário
BooleanoactiveIndica se o usuário está ativo ou não
Textouser_typeTipo de usuário:

HUMAN_RESOURCES: Recursos Humanos
THIRD_PARTIES: Terceiros
Booleanoenable_notificationsIndica se as notificações de fractal estão ativadas para o usuário.
Booleanoonly_ssoIndica 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
}
Language