Migração para modelo Híbrido ou Plugnotas

Para utilizar o PlugNotas possuindo uma base ativa no Manager SaaS, é necessário realizar um procedimento interno de Migração de Grupo. Este processo unifica os cadastros e permite que a Software House opere em cenários Híbridos ou Full PlugNotas.

1. A Regra de Unificação de Cadastro

Um CNPJ já cadastrado no Manager SaaS não pode ser simplesmente "recadastrado" no PlugNotas manualmente.

O Impedimento: Se você tentar cadastrar no PlugNotas um CNPJ que já existe no SaaS, o processo não funcionará corretamente enquanto a migração técnica não for realizada, pois quando o contrato é feito para o PlugNotas o método de processamento dos dados de bilhetagem e faturamento do CNPJ, apesar de terem dois produtos diferentes, é o mesmo. Então o CNPJ precisa ser cadastrado no PlugNotas, somente após o processo de migração referido. 

2. Mudança de Arquitetura: O Grupo "PLUG_"

No Manager SaaS, a autenticação e organização são feitas através de Grupos e Usuários. O PlugNotas trabalha de forma diferente: ele utiliza API Keys e não exige que o desenvolvedor gerencie grupos para autenticar cada requisição.

O Grupo de Migração: PLUG_CNPJDASH

Durante o processo de transição, o grupo de autenticação da empresa no banco de dados será alterado para o padrão: PLUG_ seguido do CNPJ da Software House.

Exemplo: Se o CNPJ da sua SoftwareHouse for 1234567890000, o grupo ficará:

PLUG_1234567890000

• Migração de Documentos: Ao realizar esse procedimento, todas as notas fiscais (documentos) emitidas anteriormente por aquele CNPJ também são movidas do grupo antigo para este novo grupo unificado.

• Acesso Híbrido: Após essa migração, o CNPJ fica habilitado para emitir tanto pelo PlugNotas quanto pelo Manager SaaS simultaneamente.

3. Modelos de Operação Pós-Migração

Modelo A: Híbrido

A SH mantém a operação nos dois produtos.

• Como funciona: O cadastro está unificado no grupo PLUG_. Você pode enviar uma nota via API PlugNotas ou via Integração SaaS (API/Pasta) para o mesmo CNPJ. 

• Uso do Grupo: A partir da migração, os CNPJs migrados deverão utilizar o grupo do PlugNotas para acessar o SaaS, inclusive para emitir, e autenticar ferramentas Desktop como o NeverStop e TecnoControl.

⚠️ Nesse modelo, a senha do grupo não poderá ser alterada mais em hipótese alguma. Pois como esse modelo tem a intenção de manter o uso nos dois produtos, a simples modificação afetará toda a integração realizada para este fim.

Modelo B: Full PlugNotas

A SH abandona completamente o Manager SaaS e passa a usar apenas a API do PlugNotas.

• Simplificação: Uma vez que o cliente deixa de usar o SaaS, o conceito de grupo "PLUG_" deixa de ser uma preocupação para o desenvolvedor. A autenticação passa a ser feita exclusivamente pelo Token da Software House, e a gestão de empresas é feita pelos endpoints de /empresa do PlugNotas.

4. O Procedimento de Migração (Database Update)

A migração não é apenas uma configuração de tela; ela envolve um update em massa no banco de dados da TecnoSpeed para garantir que o histórico e o cadastro sejam movidos sem perdas.

As Duas Etapas da Migração:

1. Migração de Grupos: Alteração da titularidade dos CNPJs para o novo grupo unificado. Essa etapa é mais rápida, e simples, então pode ser feita de forma instantânea em relação ao momento da solicitação. 

2. Migração de Documentos: Movimentação física dos registros de notas (XMLs, logs, status) do Grupo Origem (SaaS) para o Grupo Destino (PlugNotas). 

Para determinar a extensão da migração, é feita análise de quantidade de registros e ponderado o tempo de esforço da migração junto ao DBA, então o processo precisa ser validado antes de realizar de fato.

⚠️ Atenção: Agendamento Prévio

Devido à natureza do processo (Update em massa no banco de dados), o procedimento deve ser previamente combinado com a equipe técnica. É necessário definir um horário específico para a execução, garantindo que a transição ocorra com total segurança e sem impacto na emissão em produção.

O processo pode ser feito gradativamente, migrando em momentos diferentes as empresas, os CNPJs não migrados, permanecerão sem modificação, então é possível migrar apenas 1 CNPJ para testar, e em momento posterior migrar os demais.