MigrateBIS2To10

Migrate BIS2 To 10 é uma ferramenta criara para migrar os dados do BIS2 para o BIS10. Permitindo a migração e posterior atualização dos dados existentes na base do BIS2 para o BIS10.

Não é uma ferramenta de sincronização! A ferramenta permite migrar os dados do BIS2 para o BIS10 em uma base de dados limpa! Permite ainda que, se executada novamente, sincronize os dados fazendo alterações e completando com dados novos. Mas em hipótese alguma deve ser considerada uma ferramenta de sincronização contínua! Uma vez que dados sejam alterados ou criados diretamente no BIS10 esta ferramenta não deve ser utilizada ou pode causar inconsistências e/ou estragar dados existentes!

Limpeza da Base de Dados

A ferramenta importa os dados do BIS2 utilizando os mesmos IDs dos objetos atuais, permitindo assim identificar e mapear corretamente os novos objetos. Por isso é importante que a base atual esteja limpa ou só com dados já migrados.

Não é necessário limpar todo o sistema, apenas algumas tabelas devem ser limpas. Relacionar abaixo os comandos SQL necessários para "limpar" as tabelas que recebem dados migrados:

-- Limpas as NFs
DELETE FROM fiscal_nf;

-- Limpa os Cupons Fiscais (Dependentes: NFe)
DELETE FROM pdv_cupom;

-- Limpa a tabela de Itens (Dependentes: Cupons)
DELETE FROM item_item;

-- Limpa a Tabela de Categorias (Dependentes: Itens)
DELETE FROM item_itemcategory;

Migração de Objetos

Tipo de Itens

• Os tipos de itens não são sincronizados uma vez que no BIS10 eles pertencem ao domínio e não à empresa.

Categoria de Itens

• Faz a migração da Categoria de Itens mantendo os mesmos IDs dos objetos ItemCategoryVO.
• Mantém a estrutura hierárquica das categorias.
• No BIS 2 as categorias são associadas dentro de Tipo de Itens, no BIS 10 a estrutura é inversa e não é associado já que os tipos de itens não são migrados.

Itens

Dependência: Categoria de Itens

• Faz a migração do Item mantendo o mesmo ID dos objetos ItemVO e ItemCodeVO.
• Os objetos demais objetos filhos não tem os IDs mantidos!
• O item é migrado sem associação com Tipo de Item.
• Faz a conversão da régua de medida para o modelo do BIS10, incluindo medidas personalizadas.

Cupons

Dependência: Itens

• Faz o cadastro dos Checkouts associados, caso não existam, mantendo o mesmo ID. Os Checkouts são associados à Estação de Migração que é criada pela ferramenta de migração.
• Faz a migração do CupomVO utilizando o mesmo ID.
• Os objetos filhos não tem sei ID mantidos (como PDVCupomItem, etc.)
• Faz a conversão dos dados do BIS2 ao trocar a associação do ItemCodeVO para o ItemVO, calculando o Divider e unidades de medidas.
• Em caso de atualização, os arquivos de XML do SAT só são reenviados se não houver nenhum arquivo no VO. Evitando um reenvio de arquivos para o S3 da AWS.

NFe de Terceiros

• Faz a migração das NFes mantendo o ID do objeto. Decidido assim para garantir que teremos as relações corretas caso o ID seja usado em outros lugares, como por exemplo o SPED.
• Toda a importação é realizada pelo BIS10 a partir do conteúdo do XML, a sincronização apenas garante que o ID do objeto e a chave da NFe serão as mesmas que dos objetos do BIS2.

NFe de Emissão Própria

Dependências: Cupons

• Faz a migração das NFes mantendo o ID do objeto. Decidido assim para garantir que teremos as relações corretas caso o ID seja usado em outros lugares, como por exemplo o SPED.
• O Método de Sync deve procurar as NFes e Cupons Fiscais relacionados para compor o relacionamento, por isso a dependência com PDVCupom.

  Embora exista um relacionamento com NFe referenciadas, esse relacionamento é previsto ser nulo caso o objeto não esteja presente no momento da persistência do NFVO.