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
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
Corrigido Fernando! Obrigado pela observação!
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.
A gestão dos certificados e empresas para o eSocial não pode ser feita por estes métodos também?
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.
Por favor, entre para comentar.