No Manager SaaS, as empresas são organizadas em grupos. A definição desses grupos é flexível e fica a critério da Software House. Há quem crie um grupo por CNPJ, quem concentre todos os CNPJs em um único grupo e quem opte por separar por segmento ou por filiais.
Para utilizar corretamente o Manager SaaS, é necessário cadastrar os grupos e respectivos CNPJs. Esse cadastro pode ser feito tanto pela API de comunicação quanto pela interface web.
Usando a Interface
O cadastro pode ser feito pela interface web de forma simples e rápida. Confira o vídeo explicativo abaixo para seguir o procedimento.
Usando a API para cadastro
Para cadastrar um grupo via API, primeiro é necessário solicitar um token de autenticação. Esse token é obtido realizando uma requisição ao Manager SaaS, que retornará o valor a ser utilizado nas próximas chamadas.
Obtendo o Token
Faça uma requisição POST para a rota:
https://managersaas.tecnospeed.com.br:1337/api/v1/software-house/token
No BODY da requisição, utilize os seguintes parâmetros:
| Nome | Descrição |
| E-mail de login da Software House. | |
| senha | Senha de acesso da Software House. |
| gerar | Indica à API se um novo token deve ser gerado. Valores: 1 - Gerar um novo token. 0 - Não gerar. |
| api | Valor fixo: 1 |
O retorno será no formato:
Com o token gerado, você já pode prosseguir para o cadastro do grupo de CNPJs.
Realizando o Cadastro do Grupo
Para cadastrar um grupo, envie uma requisição POST para a rota abaixo, incluindo o token obtido anteriormente:
https://managersaas.tecnospeed.com.br:1337/api/v1/grupo?token=TokenGeradoPelaRotaSoftwareHouse/Token
No BODY da requisição, envie os seguintes parâmetros:
| Nome | Descrição |
| identificacao | Identificador do grupo. |
| descricao | Descrição do grupo. |
| senha | Senha de acesso ao grupo. |
| confirmacaoSenha | Confirmação da senha do grupo. |
| usuario | Usuário do Manager SaaS. |
Caso o certificado seja único para todo o grupo, é possível informá-lo junto com a senha, utilizando os parâmetros:
| Nome | Descrição |
| certificadobinario | Arquivo binário do certificado digital. |
| senhacertificado | Senha do certificado digital. |
Atenção! Parâmetros obrigatórios para o cadastro:
- identificacao
- descricao
- senha
- confirmacaoSenha
- usuario
O retorno confirmará se o cadastro foi bem-sucedido e exibirá os dados informados.
{
"mensagem": "Cadastro efetuado com sucesso",
"dados": {
"identificacao": "Grupo-TesteAPISH",
"descricao": "teste tecno",
"idusuario": 4586,
"handle": 3425,
"idsoftwarehouse": 6,
"criadoem": "2017-12-29T11:25:38.000Z",
"atualizadoem": "2017-12-29T11:25:38.869Z"
}
}
Para saber como consultar grupos já cadastrados, acesse esta documentação.
Comentários
0 comentário
Por favor, entre para comentar.