Para ativar a emissão da nota nacional, siga os passos abaixo:

• 1 - Verifique se a cidade está homologada no ambiente nacional, utilizando a rota /Auxiliares/getCidadeById
• 2 - Atualize a empresa utilizando a rota /Empresa/updateCompany e no body informe o seguinte: { nfseNacional: true }

Nesta etapa de emissão, iremos realizar uma validação de esquema do JSON, e de algumas regras de negócio, se tudo estiver OK, você receberá um ID para cada nota enviada, em seguida, enviaremos sua(s) nota(s) para a Prefeitura.

Essa rota é assíncrona, para obter a situação de seu envio, utilize a rota /nfse/consultar/{idNotaOrProtocol}. Se preferir, cadastre um Webhook para sua Organização, ou para sua Empresa, para que receba notificações, sempre que o processamento de uma nota for finalizado.

Observações:

• Sua aplicação deve gerar um IDIntegração único para cada nota enviada, deste modo, mesmo que sua aplicação envie por engano duas requisições iguais, o PlugNotas irá processar somente uma delas, evitando a emissão em duplicidade.
• O tempo de processamento de uma nota pode variar de acordo com a disponibilidade do WEBSERVICE da PREFEITURA.
• Se o seu cliente nunca emitiu por WEBSERVICE, é bem provável que terá de passar por um processo de homologação/liberação junto a PREFEITURA.
• O tamanho máximo para um único envio (lote), é de 500 notas.

Rota

POST

Produção

https://api.plugnotas.com.br/nfse

Sandbox

https://api.sandbox.plugnotas.com.br/nfse

Headers

Body: aplication/json

Para acessar a lista completa de dados da NFSe a ser registrada, acesso a nossa documentação completa sobre NFS-e Nacional

Exemplo

Exemplo de json

[
 {
"idIntegracao": "XXXYY999",
"emitente": {
"tipo": 1,
"codigoCidade": "4115200"
},
"prestador": {
"cpfCnpj": "08187168000160"
},
"tomador": {
"cpfCnpj": "99999999999999",
"razaoSocial": "Empresa de Teste LTDA",
"inscricaoMunicipal": "8214100099",
"email": "teste@plugnotas.com.br",
"endereco": {
"descricaoCidade": "Maringa",
"cep": "87020100",
"tipoLogradouro": "Rua",
"logradouro": "Barao do rio branco",
"tipoBairro": "Centro",
"codigoCidade": "4115200",
"complemento": "sala 01",
"estado": "PR",
"numero": "1001",
"bairro": "Centro"
 }
},
"servico": [
{
"codigo": "100101",
"discriminacao": "Descrição dos serviços prestados",
"iss": {
"tipoTributacao": 6,
"exigibilidade": 1,
"retido": false,
"aliquota": 2
},
"valor": {
"servico": 1
     }
    }
   ]
  }
]

Retorno

Exemplo de retorno:

{
"documents": [
{
"idIntegracao": "XXXYY999",
"prestador": "08187168000160",
"id": "5eb6caf7cbb4e8dce016c39f"
 }
],
"message": "Nota(as) em processamento",
"protocol": "7c09beca-1b2a-4acb-bd63-2f37a0e2ee1a"
}