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:

-- Limpa os ECFs
DELETE FROM pdv_ecf;

-- 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.

ECF (equipamentos)

• Faz a migração dos equipamentos de ECF preservando o ID.
• O objeto do BIS10 não inclui as informação de autenticação no site da receita, apenas as informações sobre o equipamento.

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 a sincronização dos Checkouts associados mantendo o mesmo ID. Os Checkouts são associados à Estação de Migração que é criada pela ferramenta de migração. Ou seja, a informação da estação original (Checkout Origianl) não é transferida..
• 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

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ência: Cupons, ECFs

• 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.

• Ao importar NFes de emissão própria que tenham um documento referenciado do tipo Cupom Fiscal de ECF, é necessário ter o cadastro dos ECFs para encontrar o número serial do equipamento já que esta informação não está disponível no XML.