Após criar os grupos, o próximo passo é cadastrar o CNPJ dos seus clientes. Esse cadastro é essencial, pois está diretamente vinculado à licença de uso do cliente.
Durante o cadastro, serão informados dados como o certificado digital do CNPJ e quais documentos fiscais ele utilizará.
Usando a Interface
O processo de cadastro pela interface segue o mesmo fluxo apresentado no vídeo do passo anterior. Caso ainda não tenha assistido, o vídeo está disponível novamente abaixo. O cadastro de empresas inicia no minuto 2:05:
Usando a API para Cadastro
Para cadastrar uma empresa via API, você precisará do token obtido no passo anterior. Em seguida, envie uma requisição POST para a rota abaixo:
POST
https://managersaas.tecnospeed.com.br:1337/api/v1/empresa?token=SEU_TOKEN
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);
- Obter Token: O token da Software House pode ser obtido diretamente via rota da API, saiba como clicando aqui;
- Informações da empresa: Deve-se informar a situação (0=Ativo ou 1=Bloqueado), o CNPJ, Razão Social, Identificaçã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 DOCUMENTO[situacao] =1 e DOCUMENTO[tipocontrato]=1, onde:
- Tipo de Contrato pode ser Bilhetagem=0 ou Ilimitado=1.
- Situação pode ser Ativo=0 ou Inativo=1.
- DOCUMENTO pode ser nfe, nfse, nfce, mdfe, cte, cteos, cfesat ou gnre.
- Para enviar a API deve ser por exemplo nfce[situacao] =1 e nfce[tipocontrato]=1
| Campos | Explicação |
|---|---|
| idgrupo | Handle do Grupo já cadastrado |
| certificadobinario | Binário do Certificado da Empresa |
| senhacertificado | Senha do Certificado |
| cnpj | CNPJ do cliente a ser cadastrado |
| identificacao | Identificação da Empresa |
| razaosocial | Razão Social da Empresa |
| idcidade | Handle da Pesquisa de Cidade ou Codigo do IBGE |
| iduf | Handle da Pesquisa de UF |
| Email de Contato da Empresa | |
| endereco | Endereço da Empresa |
| telefone | Telefone de Contato da Empresa |
| situacao | Situação do Contrato (Bloqueio) |
| motivo | Motivo de Bloqueio |
| DOCUMENTO[situacao] | Situação do contrato com Documento |
| DOCUMENTO[motivo] | Motivo de Inativação do Contrato com Documento |
| DOCUMENTO[tipocontrato] | Tipo de Contrato com o Documento Ilimitado ou Bilhetagem |
| emailCertificate | Email de aviso do vencimento do certificado |
| inscricaoestadual | Inscrição Estadual do Cliente |
| inscricaomunicipal | Inscrição Municipal do Cliente |
Atenção! Os parâmetros obrigatórios na requisição são:
- idgrupo
- idcidade
- cnpj
- razaosocial
- identificacao
- descricao
- 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.
A partir do mês de Outubro de 2019, não será possível cadastrar uma empresa sem certificado, a menos que seja A3, CFe SAT ou NFS-e.
Retorno
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
}
}
Exemplo abaixo em PHP e Python.
Comentários
0 comentário
Por favor, entre para comentar.