Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

Para consumir essa API é necessario o token de autorização, saiba mais em: Usuários de API

...

Esta API é utilizada para criar usuários internos na plataforma Privacy Tools, abaixo estaremos exibindo o passo a passo para configuração desta API. Para utilizar a API você precisa ter um ‘Usuário Usuário para API’ APIcadastrado, assim você terá acesso às autorizações necessárias para utilização da API.

Info

Caso você ainda não possua, acesso às autorizações, acesse a nossa documentação a respeito: Usuários para API

 

...

Após o envio da requisição, os usuários cadastrado, receberão um link para cadastro de senha em sua caixa de e-mails.

...

Endpoint:

É realizado uma requisição POST utilizando a seguinte URL:

...

Produção - dpo.privacytools.com.br/external_api_v2/external_api_v2/access/internal/save

Demo - demo.privacytools.com.br/external_api_v2/external_api_v2/access/internal/save

...

Composição do JSON para novos usuários internos.

...

Code Block
[
  {
    "areas": "string",
    "companyCode": "string",
    "email": "string",
    "expirationDate": "string",
    "functions": "string",
    "name": "string",
    "profile": "string",
    "role": "string",
    "statusId": 0
  }
]

...

...

Parâmetros

Significado

Onde encontrar?

areas

áreas

Área de negócio a ser vinculada com o usuário.

Informe o nome da área de negócio cadastrada na empresa. Caso o usuário possua mais de uma área a ser vinculada, separe por vírgula as áreas.

Obs.: As áreas de negócio são cadastradas na plataforma em: ‘Configurações’ > ‘Meus acessos’ > Selecione o botão ‘Áreas de negócio’ > Pressione o botão ‘Adicionar’.

companyCode

Código da companhia onde o usuário será cadastrado.

Necessário cadastrar o código de empresa. Para efetuar este cadastro e obter o código.

  1. Acesse o modulo: ‘Configurações’ > ‘Minha empresa’ Selecione o menu ‘Outros’.

  2. No campo

‘Código
  1. ‘Código de Relacionamento da

Empresa’
  1. Empresa’, cadastre o código que irá ser utilizado.

  2. Podendo adicionar um acesso em várias empresas, adicionando o código de cada empresa.

email

E-mail a ser cadastrado para o usuário.

 

 Definido pela propria organização;

expirationDate

Data de expiração a ser cadastrada.

Padrão utilizado: dd-MM-yyyy HH:mm

functions

Funções que o usuário exerce.

Informe o código da função. Caso o usuário possua mais de uma função, separe os códigos de função por vírgulas.

Obs.: As funções são cadastras na plataforma em: ‘Configurações’ > ‘Meus acessos’ > Selecione o botão ‘Funções’ >Pressione o botão ‘Adicionar’.

name

Nome do usuário.

 

Definido pela propria organização;

profile

Perfil do usuário.

Possível utilizar os padrões da plataforma: access, company, admin, finance, website

role

Cargo atribuído ao usuário.

Preencha com o nome do cargo.

statusId

Status do usuário a ser cadastrado.

Códigos possíveis de utilizar e seu significado:

  1. Ativo

  2. Inativo

  1. Após o envio da requisição, o usuário cadastrado, receberá um link para cadastro de senha em sua caixa de e-mails.

 

...

Exemplo JSON preenchido: 

Code Block
[
  {
    "areas": "Financeiro,Area de teste",
    "companyCode": "9999",
    "email": "email@privacytools.com.br",
    "expirationDate": "22-05-2099 00:00",
    "functions": "01,02",
    "name": "Suporte Teste",
    "profile": "admin",
    "role": "Tecnico",
    "statusId": 1
  }
]

...

Info

Ressaltamos que a A inativação não pode ser desfeita, caso precise ativar novamente o usuário terá que criar um novo e-mail.

...