Bem-vindo(a) ao Suporte da Tecnospeed

Em que podemos ajudar? :)

Artigos nessa seção

Exibir mais

Rota da API - Alterar o certificado digital | NF-e

Avatar
Diego de Oliveira
  • Atualizado
Seguir

 

Obter token Software House

Primeiramente será necessário gerar um token com uma requisição POST na rota /api/v1/software-house/token passando 3 parâmetros: email, senha e gerar

 

 

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
email Seu e-mail de cadastro da sua Software House
senha Senha do e-mail cadastrado
gerar

enviar com o valor 1 ou 0
1: Gera um novo token
0: Devolve o token gerado anteriormente

 

 

Retorno

 

Exemplo de retorno:

 

{
     "mensagem": "Token gerado com sucesso",
     "dados": {
          "token": "268icdnb5wlryxy9zfr1539887303217",
          "tokenexpiracao": "2018-10-18T19:28:23.000Z"
     }
}

 
 
1_-_Obter_token_Software_House.png
 

Consultar Grupos Cadastrados

Com o token em mãos, será necessário descobrir o handle da empresa na qual se deseja fazer a alteração do certificado, mas primeiro você também vai precisar descobrir o handle do grupo. 
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
}

 
 2_-_Consultar_Grupos_Cadastrados.png
 

Consultar Empresas Cadastradas

Agora que você possui o handle do grupo, você consegue obter o handle da empresa enviando uma requisição GET para a rota /api/v1/empresa passando esse handle obtido anteriormente no parâmetro idgrupo

 

 

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
}

 
 
 
3_-Consultar_Empresas_Cadastradas.png
 

Alterar dados da empresa

Por fim, com o handle da empresa e o token, você consegue fazer a alteração do certificado enviando uma requisição PUT na rota /api/v1/empresa/ passando o handle da empresa e o token na URL. No body da requisição você vai passar os parâmetros certificadobinario e senhacertificado, que no caso seria o certificado com a senha do mesmo, veja no exemplo a seguir:

 

 

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"
     }
}

 
 4_-_Alterar_dados_da_empresa.png
 
 

Artigos relacionados

Comentários

6 comentários

Classificar por Data Votos
  • Avatar
    Fernando Henrique Victor

    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.

    0
    Ações de comentário Permalink
  • Avatar
    Diego de Oliveira

    Corrigido Fernando! Obrigado pela observação!

    1
    Ações de comentário Permalink
  • Avatar
    Renan Ceratto

    A gestão dos certificados e empresas para o eSocial não pode ser feita por estes métodos também?

    0
    Ações de comentário Permalink
  • Avatar
    Lucas Santos

    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

    1
    Ações de comentário Permalink
  • Avatar
    Renan Ceratto
    Entendo.. conheço o portal.
     
    Existe alguma previsão desta integração?
    Gostaria de colocar esta interface de anexo do certificado e senha no sistema para que esta informação não precisasse passar por mim.
    O meu cliente faria o upload do certificado digital, colocaria a senha e esta informação ficaria armazenada apenas no servidor de vocês.
    0
    Ações de comentário Permalink
  • Avatar
    Lucas Santos

    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.

    0
    Ações de comentário Permalink

Por favor, entre para comentar.

Ícone de Chat