Migração Vendor Praxis

# Manual de Implantação e Migração: Vendor Praxis
### *Sistema Web para Emissão de Nota Fiscal, Financeiro e Controle de Estoque*

---

## 📄 Visão Geral do Sistema
O **Vendor Praxis** é a nova solução web completa para gerenciamento empresarial, cobrindo os módulos de emissão de notas fiscais, controle financeiro e gestão de estoque. Dependendo do perfil do cliente, a implantação seguirá um dos dois fluxos descritos abaixo.

---

## 🚀 Cenário 1: Clientes Novos ou Nova Base
*Para empresas que estão iniciando a operação ou que optaram por começar com uma base de dados totalmente limpa.*

### Fluxo de Autoatendimento Automatizado
1. **Cadastro Inicial:** O próprio cliente deve acessar o link de auto-cadastro:
   👉 [https://app.vendor.inf.br/cadastro](https://app.vendor.inf.br/cadastro)
   
   ![registro_vendor.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/registro_vendor.png)

2. **Processo Autônomo:** O fluxo é totalmente automatizado. Assim que o cadastro é concluído, o sistema é liberado para uso imediato pelo cliente.
3. **Validação de Licença:** A liberação automática é realizada e validada através do **CNPJ do cliente**, que deve estar previamente cadastrado e ativo na base de dados da Teorema.
4. **Requisito:** É obrigatório possuir o registro ativo do sistema Vendor Praxis.

---

## 🔄 Cenário 2: Migração do Emissor Delphi para o Vendor Praxis
*Para clientes legados que utilizam o Emissor Delphi e desejam migrar todo o seu histórico de dados para a nova plataforma Web.*

> ⚠️ **Nota Importante:** A migração de dados é estruturada a partir do sistema **Fênix**. Por esse motivo, é fundamental seguir rigorosamente os mesmos passos iniciais aplicados a clientes que possuem sincronização ativa ou que utilizam qualquer outro sistema do ecossistema Web.

### Passo a Passo para Migração

#### Etapa 1: Preparação do Ambiente e Infraestrutura
* **Criação do Grupo Empresarial:** Acesse o painel de controle e crie o `company_group`, configurando corretamente o *alias* e a *ref*:
  🔗 [https://do.teorema.inf.br](https://do.teorema.inf.br)
  
 ![company_group.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/company_group.png)

* **Atualização de Identificadores:** Execute o script SQL específico para atualizar os UUIDs diretamente no banco de dados Firebird.

* **Configuração de Usuários:** Acesse o **módulo Administrador** e atualize o cadastro de todos os usuários que utilizarão a nova plataforma. 
  * *Requisito de segurança obrigatório:* Adicionar um e-mail válido e definir uma senha de, no mínimo, 6 dígitos para cada usuário, viabilizando o login no ambiente web.
  
![cadastro_usuario.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/cadastro_usuario.png)

* **Instalação do Fênix:** Instale o sistema Fênix no ambiente, realize a configuração correta do banco de dados e faça o seu devido registro.
  
![fenix.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/fenix.png)

* **Instalação de Tabelas:** Execute a rotina para instalar as tabelas necessárias através do portal:
  🔗 [https://do.teorema.inf.br](https://do.teorema.inf.br)
  
  ![instalacao_tabelas.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/instalacao_tabelas.png)

#### Etapa 2: Configuração e Dados Iniciais no Vendor Praxis
* **Acesso de Suporte:** Acesse o portal oficial utilizando as suas credenciais de nível **Suporte** e localize o *alias* correspondente ao cliente que está sendo migrado:
  🔗 [http://app.vendor.inf.br](http://app.vendor.inf.br)
  
![login_suporte.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/login_suporte.png)

* **Carga de Dados Padrão:** Dentro do painel do cliente, navegue até o menu **Configurações > Geral** e clique no botão **“Gerar dados padrões”**.
  * 💡 *Nota:* Este botão ficará disponível e visível apenas **após** o registro da licença do sistema Vendor Praxis.
  
  ![Configuracoes_padroes.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/Configuracoes_padroes.png)

* **Homologação e Validação:** Gere uma senha temporária para o usuário do cliente. Realize o login com esse perfil para checar, validar e homologar as permissões de acesso e a integridade de todos os dados migrados.
  
  ![senha_tempo.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/senha_tempo.png)

#### Etapa 3: Parametrização de Documentos Fiscais
* **Configuração do E-doc:** Acessar o menu **Configurações>Empresas**, clicar na empresa listada na grid, irá abrir um modal com a aba **E-doc series**.
* **Continuidade Fiscal:** Insira as informações necessárias para a emissão de notas fiscais e preencha obrigatoriamente o **último número de nota emitida** no antigo Emissor Delphi. Este passo garante a correta continuidade da numeração sequencial dos documentos.

![2026-06-12_10-35-16.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/2026-06-12_10-35-16.png)

* **Configuração Certificado digital:** Acessar menu Configurações > Certificados > **+ Novo Certificado**.
![certificado.png](https://api-php.teorema.inf.br/v2/api/teorema/assets/teorema/documentations/certificado.png)