Gerenciando Empresas Via API – Central de Atendimento
15 de dezembro de 2021 15:09
Esse artigo explica como você pode realizar o gerenciamento das empresas cadastradas nos grupos do Manager SaaS.
Para saber como gerenciar Grupos via API, acesse este artigo.
Para realizar o cadastro de empresa, primeiro é necessário ter obtido o token e ter cadastrado o grupo no qual a empresa será criada, assim como ter o handle do mesmo. Após isso, é preciso realizar uma requisição POST na rota abaixo, lembrando que se deve informar o token:
https://managersaas.tecnospeed.com.br:1337/api/v1/empresa?token=6zl7aiaxfdhen4s4i1514552593339
Os parâmetros se dividem em três grupos:
Informações do grupo: O handle do grupo será informado no parâmetro idgrupo, em idUF o código da UF e o código da cidade (para as emissões de NFS-e);
Informações da empresa: Deve-se informar a situação (0=Ativo ou 1=Bloqueado), o CNPJ, Razão Social, Identificação, Descrição, Inscrição Estadual, Inscrição Municipal, endereço, telefone certificado;
Informações para a liberação de licença: Para a liberação de licença, deve-se informar o documento e a situação do contrato, por exemplo nfce[situacao] =1 e nfce[tipocontrato]=1, onde:
Tipo de Contrato pode ser Bilhetagem=0 ou Ilimitado=1.
Situação pode ser Ativo=0 ou Inativo=1.
Não é necessário informar todos os documentos como no exemplo do Postman.
Atenção! Os parâmetros obrigatórios na requisição são:
iduf (Não utilize os códigos do IBGE, utilize a requisição Listar UF's no final deste link)
inscricaomunicipal (Apenas para NFS-e)
OBS.: A partir do mês de setembro de 2019, o campo "iduf" não será obrigatório. O campo "idcidade" irá suprir a necessidade do mesmo. Também a partir desta data, o campo "idcidade" poderá ser preenchido com o Código IBGE referente a cidade de cadastro.
Cadastrando empresa que usará o certificado A3
Obs: Disponível apenas para NFe e NFCe:
Caso a empresa cadastrada vá utilizar o certificado A3 para assinatura das notas, deve-se adicionar os três seguintes campos na sua requisição:
removercertificado=false
selecionaA3Saas=true
selecionaCertiSAT=false
O retorno da requisição será no formato a seguir:
"handle": 5449,
"idgrupo": 3425,
"cnpj": "60642435000161",
"descricao": "testeapi",
"criadoem": "2017-12-29T14:22:25.000Z",
"atualizadoem": "2017-12-29T14:22:25.000Z",
"standby": null,
"dtentradastandby": null,
"dtsaidastandby": null,
"dtvencimentocertificado": null,
"hashcertificado": null,
"cteos": false
Em anexo, exemplo em PHP.
Os dados que foram cadastrados podem ser alterados por meio de uma requisição PUT na rota a seguir, na qual será informado o handle da empresa como parte da URL (no exemplo, 5449):
https://managersaas.tecnospeed.com.br:1337/api/v1/empresa/5449?token=6zg9mjudrqe86ko6r1514568674381
Os dados da empresa que serão alterados devem ser passados como parâmetro no body da requisição. Por exemplo:
O retorno trará todos os dados da empresa, incluindo os alterados. Por exemplo:
"atualizadoem": "2017-12-29T18:06:47.000Z",
"dtvencimentocertificado": null
Para realizar a consulta das empresas cadastradas, é necessário informar o Token e o id do grupo (que é o handle recebido na consulta anterior) e enviar a seguinte requisição GET:
https://managersaas.tecnospeed.com.br:1337/api/v1/empresa?token=6zg9mjudrqe86ko6r1514568674381&idgrupo=3425&skip=0&limit=10&sort=identificacao
Os parâmetros da requisição são:
token Token da Software House.
idgrupo Número de identificação do grupo. (Handle)
skip Indica de qual registro o resultado deve ser retornado. Por exemplo: Numa consulta de 7 empresas no total, utilizando o skip = 2 será retornado 5 registros (os dois primeiros serão ignorados).
limit Limita o número de registros da consulta.
sort Utilizado para indicar uma coluna para ordenação. Por exemplo: identificacao ou handle
O retorno trará todas as empresas cadastradas no grupo e as informações das mesmas, como por exemplo: