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:
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:
Nome | Descriçã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 |
Caso queira consultar uma empresa especifica, deve adicionar o seguinte campo ainda nos parâmetros da requisição:
Nome | Descrição |
cnpj | CNPJ da Empresa a ser consultada |
Retorno
O retorno trará todas as empresas cadastradas no grupo e as informações das mesmas, como por exemplo:
{
"mensagem": "Registros retornados com sucesso",
"dados": [
{
"handle": 5449,
"iduf": 21,
"idcidade": 4120,
"idgrupo": 3425,
"cnpj": "60642435000161",
"identificacao": "IDENTIFICAÇÃO DA EMPRESA",
"descricao": "DESCRIÇÃO DA EMPRESA",
"certificado": "CN=INFORMAÇÃO DO CERTIFICADO",
"inscricaomunicipal": "000",
"inscricaoestadual": "0000000000",
"tipocertificado": null,
"pincode": null,
"razaosocial": "EMPRESA.LTDA",
"endereco": "RUA",
"telefone": null,
"email": "teste@gmail.com",
"criadoem": "2022-06-30T17:51:51.148Z",
"atualizadoem": "2022-08-24T12:00:00.455Z",
"nfe": {
"situacao": 0, //Essa situação indica que o documento está ativo
"tipocontrato": 0,
"motivo": "",
"dataativacao": "2022-06-30T17:51:51.297Z",
"datainativacao": null
},"nfse": {
"situacao": 1, //Essa situação indica que está inativo
"tipocontrato": 0,
"motivo": null,
"dataativacao": null,
"datainativacao": null
},"nfce": {
"situacao": -1, //Essa situação indica que nunca foi ativo o documento
"tipocontrato": 0,
"motivo": "",
"dataativacao": "2022-06-30T17:51:51.000Z",
"datainativacao": null
}
"situacao": 0,
"datainativacao": null,
"motivo": "",
"hashcertificado": null,
"dtvencimentocertificado": "2023-08-18T19:38:36.000Z",
"multicidades": null
}
],
"total": 1
}
Exemplo retorno de empresas não encontradas:
{
"mensagem":"Grupo não encontrado"
}
Comentários
0 comentário
Por favor, entre para comentar.