Guia de Ativação do PlugNotas para Clientes do Manager SaaS – Emissão da NFS-e Nacional – Central de Atendimento

Este guia tem como objetivo orientar os clientes que já utilizam o Manager SaaS e agora precisam ativar o PlugNotas para emissão da NFS-e Nacional.

Abaixo, você encontrará o passo a passo dividido por etapas, com explicações em texto e vídeos tutoriais correspondentes.

1. Criação da TecnoAccount

Antes de começar a integração, é fundamental garantir que sua TecnoAccount esteja ativa e devidamente vinculada ao PlugNotas.

Nesta etapa, você aprenderá a:

Criar ou acessar sua conta TecnoAccount, essa conta deve ser criada com o CNPJ do contrato.
A conta TecnoSpeed é obrigatória para acessar portal do PlugNotas e ativar a API. Ao criar sua conta, utilize o mesmo e-mail e senha usados para acessar o SaaSAdmin. Somente após esse processo será possível iniciar as emissões.

Lembramos também que a senha de cadastro deve seguir o seguinte padrão:

A senha deve conter pelo menos 8 caracteres e no máximo 20
Pelo menos uma letra maiúscula
Pelo menos uma letra minúscula
Pelo menos um número
Pelo menos um caractere especial.
Não pode conter números sequenciais, como por exemplo "12", "56", "76", "654", "456".
Não pode conter números repetidos, como por exemplo "11", "22", "33".
Não pode conter datas, como por exemplo "031995", "01021980", "2002".

Caso a senha já cadastrada no Saas Admin não siga este padrão ela deve ser alterada para uma senha que siga este padrão.

Para alterar a senha deve ser utilizado o botão de Recuperar Senha na Interface do Saas Admin

Saas Admin

Caso sua senha já siga este formato não a necessidade de alterar a mesma.

Se tiver dúvidas, consulte a documentação: Guia para criar a Conta TecnoSpeed.

Verificar o vínculo com o PlugNotas.
Após realizar o login no portal APP2, será criado automaticamente um grupo com o nome “PLUG_CNPJ”(Grupo será criado no SaaS Admin).

Este Grupo não deverá ter seu nome alterado em momento algum.

Todas as empresas que atualmente emitem notas pelo SaaS e passarão a utilizar o ambiente nacional deverão ser migradas para esse novo grupo. A solicitação deve ser feita via ticket, informando o CNPJ e mencionando que a empresa iniciará as emissões da NFS-e Nacional.

Mesmo após a migração, o CNPJ continuará podendo emitir outros documentos fiscais (como CT-e, GNRe, etc.) via SaaS, além de permitir a consulta das NFS-e emitidas anteriormente. Para isso será preciso solicitar a senha desse grupo no ticket de migração.

Esta senha tambem não poderá ser alterada.

Também será preciso realizar o cadastro da empresa no PlugNotas e ativar o parâmetro "nfseNacional" (nfse.config.nfseNacional) para começar transmitir as notas para o ambiente nacional.

Atenção:
Será necessário solicitar a senha do grupo criado pelo PlugNotas para manter o acesso.
Não altere essa senha em hipótese alguma, pois qualquer modificação impedirá a emissão de notas via PlugNotas.

2. Ambientes para emissão/teste

O PlugNotas opera com dois ambientes principais:

Sandbox (Ambiente de Testes)
Neste ambiente, a comunicação ocorre apenas com a TecnoSpeed, sem interação com a RFB ou Prefeituras.
Ele é indicado para validação do fluxo de integração, interpretação dos retornos das rotas e testes iniciais antes do uso real.
O token de testes pode ser obtido na documentação, no link "Ainda não sou cliente..."
Produção (Homologação e Produção Real) - Ao utilizar as rotas de produção, a comunicação passa a ser direta com a RFB ou Prefeituras, podendo ser feita em ambiente de homologação ou produção.
Nessa conexão, deve-se utilizar o token gerado no Portal da API.

Abaixo você encontra um vídeo demonstrativo mostrando como utilizar o postman para realizar testes no ambiente Sandbox.

3. Arquivo de Integração

Nesta etapa, você aprenderá como montar o arquivo JSON com todas as informações necessárias para a emissão da NFS-e Nacional por meio da API do PlugNotas.

Se a empresa prestadora já estiver devidamente cadastrada, este é o momento de construir o JSON que será enviado à API para realizar a emissão da NFS-e.

Para consultar todos os detalhes sobre a estrutura do arquivo, campos obrigatórios e exemplos de requisição, acesse a documentação oficial: 🔗 Rota Emitir NFS-e Nacional

No vídeo abaixo, apresento uma explicação prática sobre os principais campos do JSON e suas finalidades:

4. Fluxo de emissão (Envio, Consulta, Cancelamento e Webhook).

Com o arquivo pronto, é hora de enviar para o PlugNotas e acompanhar o processamento.

Neste passo, você aprenderá:

As rotas para iniciar com as emissões do PlugNotas está nessa documentação: 🔗 Documentação – Rotas da NFS-e Nacional
Na mesma documentação, um pouco acima, você encontrará as rotas relacionadas ao uso do webhook. Para entender em detalhes o funcionamento e o processo de cadastro, acesse a documentação Explicando e cadastrando Webhook.

O vídeo abaixo apresenta uma demonstração prática das principais rotas da API, mostrando como utilizá-las para implementar o fluxo inicial de emissão.