Com os grupos criados, agora é o momento de cadastrar o CNPJ dos seus clientes. O cadastro precisa ser realizado, pois se trata da licença de uso do seu cliente.
Nesse cadastro é informado dados como o certificado digital do CNPJ e quais documentos fiscais esse CNPJ usará.
Usando a Interface
O cadastro da empresa pela interface, segue o mesmo fluxo do vídeo do passo anterior. Caso não tenha visto antes, ele está aqui novamente para ver. O cadastro de empresa começa a partir do minuto 2:05:
Usando a API para cadastro
Para realizar o cadastro de empresa, você vai precisar do token de adquiriu no passo anterior. Após isso, é preciso realizar uma requisição POST na rota abaixo:
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:
- idgrupo
- idcidade*
- cnpj
- razaosocial
- identificacao
- descricao
- inscricaomunicipal (Apenas para NFS-e)
*Obs: O campo "idcidade" poderá ser preenchido com o Código IBGE referente a cidade de cadastro.
*Obs: o campo "IdUF" poderá ser preenchido com os seguintes valores:
| Estado | IdUf | Estado | IdUf |
|---|---|---|---|
| Rondônia | 1 | Sergipe | 15 |
| Acre | 2 | Bahia | 16 |
| Amazonas | 3 | Minas Gerais | 17 |
| Roraima | 4 | Espírito Santo | 18 |
| Pará | 5 | Rio de Janeiro | 19 |
| Amapá | 6 | São Paulo | 20 |
| Tocantins | 7 | Paraná | 21 |
| Maranhão | 8 | Santa Catarina | 22 |
| Piauí | 9 | Rio Grande do Sul | 23 |
| Ceará | 10 | Mato Grosso do Sul | 24 |
| Rio Grande do Norte | 11 | Mato Grosso | 25 |
| Paraíba | 12 | Goiás | 26 |
| Pernambuco | 13 | Distrito Federal | 27 |
| Alagoas | 14 |
Para obter estes valores automatizados, acesse este artigo;
O retorno da requisição será no formato a seguir:
{
"mensagem": "Cadastro efetuado com sucesso",
"dados": {
"handle": 5449,
"idgrupo": 3425,
"cnpj": "60642435000161",
"identificacao": "testeapi",
"descricao": "testeapi",
"certificado": null,
"iduf": 21,
"idcidade": 4120,
"inscricaomunicipal": "12345",
"inscricaoestadual": "12345",
"tipocertificado": "CURRENT_USER_STORE",
"pincode": null,
"razaosocial": "testeapi",
"endereco": "Av. TesteAPI",
"telefone": "4433000033",
"email": null,
"criadoem": "2017-12-29T14:22:25.000Z",
"atualizadoem": "2017-12-29T14:22:25.000Z",
"standby": null,
"nfe": false,
"nfce": false,
"mdfe": false,
"cte": false,
"nfse": false,
"cfesat": false,
"situacao": 0,
"gnre": false,
"datainativacao": null,
"motivo": null,
"dtentradastandby": null,
"dtsaidastandby": null,
"dtvencimentocertificado": null,
"hashcertificado": null,
"cteos": false
}
}
Para mais informações sobre a consulta ou alteração de informação na empresa, pode acessar a documentação complementar clicando aqui.
Comentários
0 comentário
Por favor, entre para comentar.