Obter token Software House
POST
https://managersaas.tecnospeed.com.br:1337/api/v1/software-house/token
Headers
Nome | Descrição | Exemplo |
Content-Type | Indica o tipo de arquivo | application/x-www-form-urlencoded |
Body
Nome | Descrição |
Seu e-mail de cadastro da sua Software House | |
senha | Senha do e-mail cadastrado |
gerar |
enviar com o valor 1 ou 0 |
Retorno
Exemplo de retorno:
{
"mensagem": "Token gerado com sucesso",
"dados": {
"token": "268icdnb5wlryxy9zfr1539887303217",
"tokenexpiracao": "2018-10-18T19:28:23.000Z"
}
}
Consultar Grupos Cadastrados
Para descobrir o handle de um grupo cadastrado, envie uma requisição GET para a rota /api/v1/grupo informando o token obtido como parâmetro e mais alguns filtros, se desejar.
GET
https://managersaas.tecnospeed.com.br:1337/api/v1/grupo
Querystring
Nome | Descrição |
token | Token gerado na requisição anterior |
limit | Número máximo de grupos retornados na requisição |
sort | Filtro para definir o campo que será feita a ordenação do retorno |
Retorno
Exemplo de retorno:
{
"mensagem": "Registros retornados com sucesso",
"dados": [
{
"handle": 3783,
"identificacao": "100",
"descricao": "edoc",
"idsoftwarehouse": 268,
"idusuario": 4651,
"criadoem": "2018-02-22T13:28:52.000Z",
"atualizadoem": "2018-02-22T13:28:52.000Z"
}
],
"total": 33
}
Consultar Empresas Cadastradas
GET
https://managersaas.tecnospeed.com.br:1337/api/v1/empresa
Querystring
Nome | Descrição |
token | Token gerado na requisição anterior |
idgrupo | ID do grupo obtido através do campo handle na requisição de grupos cadastrados |
limit | Número máximo de grupos retornados na requisição |
sort | Filtro para definir o campo que será feita a ordenação do retorno |
Retorno
Exemplo de retorno:
{
"mensagem": "Registros retornados com sucesso",
"dados": [
{
"handle": 3277,
"idgrupo": 2003,
"iduf": 21,
"idcidade": 4120,
"cnpj": "39811528000186",
"identificacao": "empresa-1559",
"descricao": "empresa 15:59",
"certificado": "CN=TECNOSPEED SA:08187168000160, OU=Certificado PJ A1, OU=AC SOLUTI Multipla, OU=AC SOLUTI, OU=Autoridade Certificadora Raiz Brasileira v2, O=ICP-Brasil, C=BR, SE=2A DA 17 05 04 54 38 14",
"inscricaomunicipal": "000",
"inscricaoestadual": null,
"tipocertificado": "CURRENT_USER_STORE",
"pincode": null,
"razaosocial": "empresa 15:59",
"endereco": null,
"telefone": null,
"email": null,
"criadoem": "2017-05-31T21:59:27.000Z",
"atualizadoem": "2017-06-01T16:54:30.000Z",
"nfe": true,
"nfce": false,
"mdfe": false,
"cte": false,
"nfse": false,
"cfesat": false,
"gnre": false,
"cteos": null,
"situacao": 1,
"datainativacao": null,
"motivo": null,
"hashcertificado": "fdf0e0f446dc95a223a4ad177359f358",
"dtvencimentocertificado": "2015-07-28T09:32:43.000Z"
}
],
"total": 1
}
Alterar dados da empresa
PUT
https://managersaas.tecnospeed.com.br:1337/api/v1/empresa/{{HandleEmpresa}}
Querystring
Nome | Descrição |
token | Token gerado na requisição anterior |
handle empresa | O handle da empresa na qual você irá alterar o certificado precisa ir direto na URL, assim como o token. Exemplo: https://managersaas.tecnospeed.com.br:1337/api/v1/empresa/1384?token=2683wubfzj5ve06yldi1539899147171 |
Body
Nome | Descrição |
certificadobinario | Arquivo do certificado com a extensão .pfx |
senhacertificado | Senha do certificado |
Retorno
Exemplo de retorno:
{
"mensagem": "Cadastro atualizado com sucesso",
"dados": {
"handle": 13992,
"idgrupo": 10455,
"iduf": 21,
"idcidade": 4120,
"cnpj": "48531934000186",
"identificacao": "testeapi",
"descricao": "teste api requena",
"certificado": "CN=TECNOSPEED NEGOCIOS LTDA ME:29062609000177, OU=Certificado PJ A1, OU=AC SOLUTI Multipla, OU=AC SOLUTI, OU=Autoridade Certificadora Raiz Brasileira v2, O=ICP-Brasil, C=BR, SE=6D 8C 17 12 21 66 35 C2",
"inscricaomunicipal": "12345",
"inscricaoestadual": "12345",
"tipocertificado": "CURRENT_USER_STORE",
"pincode": null,
"razaosocial": "testeapi",
"endereco": "Av. TesteAPI",
"telefone": "4433000033",
"email": null,
"criadoem": "2018-10-18T21:58:17.000Z",
"atualizadoem": "2018-10-18T22:00:41.000Z",
"nfe": false,
"nfce": false,
"mdfe": false,
"cte": false,
"nfse": false,
"cfesat": false,
"gnre": false,
"cteos": false,
"situacao": 0,
"datainativacao": null,
"motivo": null,
"hashcertificado": "7aa42f90e47b4fb7a3498c6488728c86",
"dtvencimentocertificado": "2018-12-26T10:22:00.000Z",
"senhacertificado": "30287071"
}
}
Comentários
6 comentários
No tópico "Consultar Empresas Cadastradas" o caminho da requisição GET esta indicando para usar api/v1/grupo, porém o correto é usar api/v1/empresa , como está descrito logo acima.
Corrigido Fernando! Obrigado pela observação!
A gestão dos certificados e empresas para o eSocial não pode ser feita por estes métodos também?
Boa Tarde Renan, são produtos separados que ainda não se conversam. Você deve fazer a gestão destas empresas no eSocial através do nosso portal para poder fazer a comunicação via API.
Link do portal do eSocial da TecnoSpeed
Bom Dia Renan,
Por enquanto não temos previsão desta integração entre os dois produtos, porém temos intenção de facilitar o envio do certificado para o eSocial. Ainda sem previsão para entrega.
Por favor, entre para comentar.