10 · Migració des de programari legacy
Factuzam inclou una eina independent, Factuzam Migrator
(FactuzamMigrator.exe), que trasllada les dades de l'ERP anterior (base de
dades SQL Server) a la base de dades factuzam (MariaDB). Aquest
capítol explica què migra, com es prepara la base de dades de destinació i com
s'executa i es verifica la migració.
És una operació d'administrador, que normalment es fa una sola vegada durant la posada en marxa. Requereix accés a totes dues bases de dades (l'antiga i la nova).
1. Què és i què necessita
- Programa separat de
fzam.exe: només s'executa durant la migració i no forma part del treball diari. - Es connecta alhora amb:
- Origen: la base de dades SQL Server del programari anterior.
- Destinació: la base de dades
factuzama MariaDB.
- Desa la configuració de les connexions (sense contrasenyes) a
%USERPROFILE%\Factuzam\migrator.ini.
2. Quines dades migra
El migrador trasllada, respectant l'ordre de dependències, els dominis següents:
| Domini | Què es migra |
|---|---|
| Formes de pagament, grups d'IVA, IVA | Catàlegs base. |
| Empreses | Empreses emissores. |
| Magatzems | Magatzems (i les seves caixes, sèries i comptadors). |
| Clients | Fitxa completa dels clients. |
| Proveïdors | Fitxa completa dels proveïdors. |
| Famílies | Seccions i famílies d'articles (amb la jerarquia). |
| Colors i talles | Catàlegs mestres d'atributs. |
| Articles | Catàleg d'articles. |
| Colors/talles per article, tallatges | Assignacions de variació per article. |
| SKU | Variants vendibles + codis de barres. |
| Inventaris | Inventaris i les seves línies. |
| Moviments | Moviments de magatzem (i reconstrueix l'estoc actual). |
| Vendes (caixa) | Operacions de caixa, pagaments i dipòsits de client. |
| Factures | Factures i les seves línies. |
| Compres | Comandes, albarans, devolucions a proveïdor i factures de compra. |
| Cartera de pagaments | Efectes de compra i remeses de pagament a proveïdor. |
| Empleats | Operadors de caixa, traspassos i arqueigs, separats dels usuaris d'inici de sessió. |
La migració s'executa en paral·lel per onades: els dominis que no tenen dependències entre si es processen alhora, i cada onada espera que acabi l'anterior (catàlegs → mestres → variants → documents).
3. Preparar la base de dades de destinació
El mateix Migrator inclou una secció «Preparar BBDD destino» amb tres botons, pensada per crear la base nova sense dependre de fitxers externs:
- Extraer esqueleto de BBDD viva… — es connecta a una base
factuzamde referència i genera un.sqlamb tota l'estructura (taules, vistes, procediments) i les dades de les taules de sistema (països, tipus d'IVA, finestres, metadades…). Les taules de negoci (articles, clients, factures…) queden buides perquè les emplenarà la migració. - Crear BBDD destino — crea la base de dades indicada al panell Destino amb el joc de caràcters
utf8mb4i la intercalacióutf8mb4_spanish_ci. - Cargar esqueleto en destino… — aboca l'
.sqldel pas 1 a la base acabada de crear.
Alternativa: crear la base de destinació des de
factuzam_original.sqlcom a la instal·lació. En aquest cas, assegura't d'aplicar també els scripts d'esquema requerits pel migrador si el teu dump és anterior (ampliacions de codis de client, nom de proveïdor, jerarquia de famílies, línies d'inventari, empleats, compres, factures de compra i cartera de pagaments).
4. Executar la migració pas a pas
- Fes una còpia de seguretat de totes dues bases de dades (origen i destinació).
- Obre
FactuzamMigrator.exe. - Configura el panell Origen (SQL Server): host, port, base de dades, usuari i contrasenya. Prem Probar conexión.
- Configura igualment el panell Destino (MariaDB) i prova la connexió.
- Marca les migracions que cal executar. La llista ja respecta l'ordre de dependències; per a una migració completa, marca-les totes. En compres, els dominis entren després dels mestres i els SKU: comandes, albarans, devolucions a proveïdor, factures de compra, efectes i remeses de pagament.
- Prem Ejecutar migraciones. Durant el procés:
- El panell de progrés mostra una línia per domini actiu amb el comptador
X / Y (Z %)en temps real. - El botó canvia a Cancelar: si el prems, acaba el domini en curs i s'atura (allò que ja s'ha migrat queda fet).
- El panell de progrés mostra una línia per domini actiu amb el comptador
- En acabar, revisa el resum i el panell d'errors.
Reexecució segura (idempotència)
Les migracions són idempotents: si un registre ja existeix a la destinació se salta (es comptabilitza com a «saltat») i es continua. Cada domini s'executa dins d'una transacció: si alguna cosa falla, es desfà tot aquell domini (els altres continuen). Per tant, davant d'una fallada puntual es pot corregir la causa i tornar a executar sense duplicar dades.
Registre d'errors
Cada execució deixa registre en tres llocs:
- El registre general de la pantalla (tot el detall).
- El panell vermell d'errors (només errors i avisos).
- Un fitxer
migrator_errores_AAAAMMDD_HHMMSS.loga%USERPROFILE%\Factuzam\, per revisar-lo després (la ruta exacta s'imprimeix al registre en iniciar).
5. Ajustos manuals després de migrar
La primera versió del migrador aplica algunes heurístiques que convé repassar manualment un cop acabada la migració:
| Dada | Què fa el migrador | Què cal revisar després |
|---|---|---|
| Tipus d'IVA | El legacy desa l'històric per dates; es pren el percentatge més alt com a IVA normal i es deixen a 0 el reduït/súper/exempt. | Completar els percentatges reduït, superreduït i exempt a Otros ▸ Impuesto IVA. |
| Codi de magatzem | El legacy indexa per (empresa, magatzem); la destinació exigeix un codi únic global. Es genera E<empresa>-A<almacén>. | Canviar el nom dels codis si es prefereix una altra nomenclatura. |
| Tipus d'IVA per article | El legacy desa un enter; tot es migra com a IVA Normal (N). | Marcar els articles amb IVA reduït/súper/exempt. |
| Forma de pagament del client | S'utilitza el codi d'efecte del legacy com a codi de forma de pagament. | Verificar que les formes de pagament migrades tinguin la descripció i el comportament desitjats. |
| Famílies | Les seccions i famílies del legacy van a la mateixa taula, conservant la jerarquia secció → família. | Revisar l'arbre de famílies resultant. |
| Conjunts de talles per article | Es migren els catàlegs i les assignacions de color/talla, però no el conjunt concret de talles de cada article. | Assignar el conjunt d'atributs als articles que ho necessitin (Archivo ▸ Tablas Auxiliares ▸ Colecciones de Atributos). |
| Compres històriques | Les comandes, els albarans, les devolucions i les factures es reconstrueixen amb una línia per SKU i el tallatge pivotat. | Obrir mostres a Compras i revisar el proveïdor, el magatzem, l'estat, els totals i els impostos. |
| Efectes de compra | Els venciments legacy s'importen i es concilien quan ja consten com a pagats. | Revisar els efectes pendents, pagats i les remeses abans de començar a operar. |
6. Verificació final
Abans de donar la migració per bona:
- Quadra els totals: nombre de clients, proveïdors, articles, SKU i factures entre l'origen i la destinació (el resum del migrador mostra els comptadors d'inserits/saltats/errors per domini).
- Estoc: compara l'estoc d'una mostra d'articles amb el sistema antic (Almacén ▸ Informes). El migrador reconstrueix l'estoc a partir dels moviments.
- Documents: obre algunes factures, operacions de caixa i compres migrades i comprova'n els imports i impostos.
- Vendes de prova: fes un tiquet de prova al TPV i una factura de prova a Ventas Mayor.
- Cartera: revisa els efectes i les remeses de compra per comprovar els venciments, els estats i els bancs.
- Aplica els ajustos manuals de la secció anterior.
- Fes una còpia de seguretat de la base ja migrada: és el teu punt de partida oficial.
Fins que no s'acabi la verificació, conserva el programari i la base de dades antics en només lectura com a referència històrica.
◀ Instal·lació a Windows · Índex · Següent ▶ Verifactu (AEAT)