No Manager SaaS, as empresas ficam organizadas por grupos. Esses grupos não tem uma regra, eles ficam a critério da SoftwareHouse. Temos casos em que a empresa cria um grupo por CNPJ, temos casos em que apenas um grupo é criado e todos os CNPJs ficam lá e temos também as que separam por segmento ou por filiais.
Para que possa usar corretamente o Manager SaaS, precisa-se cadastrar os grupos e CNPJ e isso é possível tanto pela API de comunicação quanto pela interface web.
Usando a Interface
O cadastro pode ser realizado através da interface web. Você pode consultar o nosso vídeo explicativo logo abaixo, para realizar esse procedimento. É simples e rápido!
Usando a API para cadastro
Para realizar o cadastro do grupo, antes você precisa solicitar um token. Para ter esse token, você precisa realizar uma requisição para o Manager SaaS e o retorno da requisição, será o token.
Obtendo o Token
Para isso, você deve realizar uma requisição do tipo POST na rota a seguir:
https://managersaas.tecnospeed.com.br:1337/api/v1/software-house/token
No BODY da requisição poderão ser utilizados os seguintes parâmetros:
| Nome | Descrição |
| E-mail do login da Software House. | |
| senha | Senha da Software House. |
| gerar |
Indica a API que o token deve ser gerado. Valores: 1 - Gerar um novo Token. 0 - Não gerar. |
| api |
Valor fixo 1 |
O retorno da requisição será assim:
Com esse token, você realiza o cadastro do grupo dos seus CNPJs.
Realizando o Cadastro do Grupo
Para realizar o cadastro do grupo é necessário utilizar a rota a seguir, enviando uma requisição do tipo POST, utilizando o Token obtido no procedimento anterior:
https://managersaas.tecnospeed.com.br:1337/api/v1/grupo?token=Token gerado pela Rota software-house/token
No BODY da requisição poderão ser utilizados os seguintes parâmetros:
| Nome | Descrição |
| identificacao | Identificador do grupo. |
| descricao | Descrição do grupo. |
| senha | Senha para o grupo.
|
| confirmacaoSenha | Confirmação da senha do grupo.
|
| usuario | Usuário do Manager SaaS. |
Caso o certificado seja do grupo inteiro, o mesmo pode ser informado como parâmetro juntamente com a senha.
| Nome | Descrição |
| certificadobinario | Arquivo binário do certificado digital. |
| senhacertificado | Senha do certificado digital. |
Atenção! Os parâmetros obrigatórios para o cadastro do grupo são:
- identificacao
- descricao
- senha
- confirmacaoSenha
- usuario
No cadastro, o retorno apresentará a mensagem de sucesso ou não, além da confirmação das informações cadastradas.
{
"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"
}
}
Caso queira saber como consultar os grupos já cadstrados, veja essa documentação.
Comentários
0 comentário
Por favor, entre para comentar.