Como dito a uns passos atras, esse passo pode também ser realizado pela API do PlugNotas e aqui daremos um direcionamento sobre essa parte.
Essas duas rotas estão descritas naquela documentação do Swagger, apresentada no passo anterior.
Certificado
Apenas certificados do modelo A1 funcionando com o PlugNotas, com extensão .PFX ou .P12.
POST
https://api.plugnotas.com.br/certificado
Headers
| Nome | Descrição | Exemplo |
| x-api-key | Token de autenticação da SoftwareHouse (vide primeiro passo) | 2da392a6-79d2-4304-a8b7-959572c7e44d |
Body
| Nome | Descrição |
| arquivo | Certificado digital enviado como binário (obrigatório) |
| senha | Senha de instalação do certificado digital (obrigatório) |
| E-mail para notificações como vencimento do certificado (opcional) |
Exemplo
Retorno
Exemplo de retorno (Status code 200):
{
}
Exemplo de retorno com erro (Status code 400):
{
"error": {
"message": "A senha utilizada na tentativa de upload do Certificado está incorreta.",
"data": {
"senha": "xxxx"
}
}
}
Vai vir Status code 400 ou 401
Caso queira saber mais sobre essa rota, clique aqui.
Empresas
POST
https://api.plugnotas.com.br/empresa
Headers
| Nome | Descrição | Exemplo |
| x-api-key | Token de autenticação da SoftwareHouse (vide primeiro passo) | 2da392a6-79d2-4304-a8b7-959572c7e44d |
| Content-Type | Indica o tipo de arquivo | application/json |
Body
Exemplo de arquivo de envio:
{
"cpfCnpj":"29062609000177",
"inscricaoMunicipal":"8214100099",
"inscricaoEstadual":"1234567850",
"razaoSocial":"Tecnospeed S/A",
"nomeFantasia":"Tecnospeed",
"certificado":"5af59d271f6e8f409178fbf3",
"simplesNacional":true,
"regimeTributario":1,
"incentivoFiscal":true,
"incentivadorCultural":true,
"regimeTributarioEspecial":5,
"endereco":{
"tipoLogradouro":"Avenida",
"logradouro":"Duque de Caxias",
"numero":"882",
"complemento":"17 andar",
"tipoBairro":"Zona",
"bairro":"Zona 01",
"codigoPais":"1058",
"descricaoPais":"Brasil",
"codigoCidade":"4115200",
"descricaoCidade":"Maringá",
"estado":"PR",
"cep":"87020-025"
},
"telefone":{
"ddd":"44",
"numero":"3037-9500"
},
"email":"empresa@plugnotas.com.br",
"nfse":{
"ativo":true,
"tipoContrato":0,
"config":{
"producao":true,
"rps":{
"serie":"RPS",
"numero":1,
"lote":1
},
"prefeitura":{
"login":"teste",
"senha":"teste123"
},
"email":{
"envio":true
}
}
},
"nfe":{
"ativo":true,
"tipoContrato":0,
"config":{
"producao":true,
"impressaoFcp":true,
"impressaoPartilha":true,
"serie":1,
"numero":1,
"dfe":{
"ativo":true
},
"email":{
"envio":true
}
}
},
"nfce":{
"ativo":true,
"tipoContrato":0,
"config":{
"producao":true,
"serie":1,
"numero":1,
"email":{
"envio":true
},
"sefaz":{
"idCodigoSegurancaContribuinte":"string",
"codigoSegurancaContribuinte":"string"
}
}
}
}
*Obs: a descrição dos campos do json estão descritas na documentação complementar no fim desse artigo
Exemplo
Retorno
Exemplo de retorno (Status code 200):
{
"message": "Cadastro efetuado com sucesso",
"data": {
"cnpj": "23995875000176"
}
}
Exemplo de retorno com erro (Status code 400):
{
"error": {
"message": "Falha na validação do JSON de Empresa",
"data": {
"fields": {
"certificado": "Preenchimento obrigatório"
}
}
}
}
Vai vir Status code 400, 401 ou 409
Caso queira saber mais sobre essa rota, clique aqui.
Comentários
0 comentário
Por favor, entre para comentar.