Referencia revisada o heredada

El contenido está versionado, pero conviene contrastarlo con la guía operativa y la versión actual del ERP.

PUBLIC_UNIFICAR_CLIENTES

Introduccion

La funcionalidad Unificar cliente permite consolidar un cliente duplicado dentro de un cliente original, para que la operacion quede concentrada en un unico registro correcto.

Este documento explica el uso completo para cliente final:

• que datos cargar;
• que revisiones exige el sistema;
• que validaciones bloquean la unificacion;
• que resultado final produce.

Alcance funcional:

• seleccion del cliente original y del cliente duplicado;
• deteccion de impactos en otras funcionalidades;
• revision y confirmacion de esos impactos en la solapa Detalles (DETALLE_DE_CLIENTE);
• ejecucion de la unificacion y cierre del proceso.

Resultado esperado:

• la informacion asociada al cliente duplicado pasa al cliente original en las funcionalidades detectadas;
• el cliente duplicado se elimina al finalizar correctamente.

Mapa de estados

Estado	Tipo (operativo/transicion/final)	Objetivo	Editable por usuario
Ingresado	operativo	Cargar los clientes a analizar y preparar la revision de impacto.	SI
Revision de Origen	operativo	Revisar los impactos detectados y confirmar los detalles antes de unificar.	SI
Unificado	transicion	Ejecutar la unificacion y cerrar el proceso tecnico.	NO

Transiciones relevantes del flujo:

• Iniciar: entrada al estado Ingresado.
• Revision de Origen: avance de Ingresado a Revision de Origen.
• No apto (sys): retorno del sistema desde Revision de Origen a Ingresado cuando no se cumplen condiciones.
• Unificar: avance de Revision de Origen a Unificado.
• vuelve (sys): retorno automatico del sistema desde Unificado a Revision de Origen en el diagrama de estados.

Estados detalle

Ingresado

• Para que sirve: Iniciar el proceso de unificacion y definir que cliente queda como original y cual se considera duplicado.
• Como se llega (accion): Por la accion inicial Iniciar.
• Que hace el sistema: Habilita el punto de partida para pasar a la revision funcional.
• Que puede editar el usuario: Cliente original y cliente duplicado.
• Que no puede editar el usuario: No corresponde ejecutar la unificacion final en este estado.
• Validaciones visibles: El proceso exige que ambos clientes esten informados para continuar.
• Recomendaciones: Validar que el cliente original sea efectivamente el registro correcto antes de avanzar.

Revision de Origen

• Para que sirve: Controlar los impactos de la unificacion y confirmar que cada funcionalidad afectada fue revisada.
• Como se llega (accion): Desde Ingresado por la accion Revision de Origen.
• Que hace el sistema: Detecta donde se usa el cliente duplicado y genera la solapa Detalles (DETALLE_DE_CLIENTE) con los impactos a revisar.
• Que puede editar el usuario: Revisar y confirmar los detalles pendientes en la solapa Detalles, y corregir la seleccion de clientes si corresponde.
• Que no puede editar el usuario: No puede completar la unificacion si quedan detalles sin confirmar.
• Validaciones visibles: No se permite continuar si cliente original y duplicado son el mismo.
• Recomendaciones: Confirmar cada item de la solapa Detalles antes de usar la accion Unificar.

Unificado

• Para que sirve: Ejecutar la consolidacion final del cliente duplicado en el cliente original.
• Como se llega (accion): Desde Revision de Origen por la accion Unificar.
• Que hace el sistema: Aplica la unificacion sobre los impactos confirmados, deja trazabilidad informativa del resultado y elimina el cliente duplicado.
• Que puede editar el usuario: No hay edicion funcional manual durante esta transicion.
• Que no puede editar el usuario: No puede omitir controles previos ni forzar la unificacion con detalles pendientes.
• Validaciones visibles: Solo permite completar si todos los detalles estan en estado revisado.
• Recomendaciones: Usar este paso recien cuando toda la solapa Detalles este revisada y confirmada.

Papel de la solapa Detalles (DETALLE_DE_CLIENTE)

• Para que sirve dentro del proceso: Es la lista de funcionalidades impactadas por la unificacion del cliente duplicado.
• Por que es clave: Funciona como control previo obligatorio; sin esta revision el proceso no permite unificar.
• Como se usa: Cada item debe pasar por confirmacion (estado revisado) antes de la accion final.
• Beneficio para el cliente: Evita cambios masivos sin control, mejora trazabilidad y da confianza operativa antes de ejecutar la unificacion.

Solapas o children relacionados

Child/Solapa	Para que sirve	Impacto en el flujo	Es precondicion para avanzar
DETALLE_DE_CLIENTE (solapa Detalles)	Mostrar las funcionalidades impactadas por la unificacion y su revision.	Permite controlar y confirmar impactos antes de aplicar la unificacion final.	SI

Campos requeridos y filtros

Requeridos iniciales

Campo	Cuando aplica	Motivo funcional
Cliente original	Inicio del proceso	Definir el cliente correcto que se conservara.
Cliente duplicado	Inicio del proceso	Definir el cliente que sera absorbido en la unificacion.

Requeridos por estado o accion

Estado/Accion	Campo requerido	Regla
Revision de Origen	Cliente original y cliente duplicado	Ambos deben estar informados para continuar el proceso.
Revision de Origen	Cliente original y cliente duplicado	No pueden ser el mismo cliente.
Unificar	Detalles (DETALLE_DE_CLIENTE)	Todos los detalles deben estar confirmados/revisados.

Filtros y precondiciones

Campo	Filtro/Precondicion (explicado para cliente)
Cliente duplicado	Si posee comprobantes emitidos con CAE, la unificacion se bloquea para resguardar integridad fiscal y operativa.
Solapa Detalles (DETALLE_DE_CLIENTE)	Debe completarse la revision de todos los impactos antes de ejecutar la accion de unificacion.

Validaciones por estado

Estado	Validacion	Que debe revisar el usuario
Revision de Origen	El cliente original, no puede ser igual al cliente duplicado	Verificar que sean dos clientes distintos y corregir la seleccion si coincide.
Unificado	Debe confirmar todos los cambios antes de unificar.	Confirmar que todos los items de la solapa Detalles esten revisados.

FAQ errores frecuentes

Mensaje o situacion	Causa probable	Como resolver
No es posible unificar este cliente debido a que presenta comprobantes emitidos con CAE	El cliente duplicado tiene documentos emitidos que no deben alterarse por este proceso.	Elegir otro cliente duplicado o revisar estrategia administrativa antes de unificar.
Debe confirmar todos los cambios antes de unificar	Quedan items de DETALLE_DE_CLIENTE sin estado revisado.	Ingresar a la solapa Detalles y confirmar todos los impactos pendientes.
No avanza o vuelve al estado anterior durante la revision	Falta completar algun dato clave o hay una condicion de control no cumplida.	Revisar cliente original, cliente duplicado y confirmar que la revision de impactos este completa.
El cliente original y el duplicado son iguales	Se selecciono el mismo cliente en ambos campos.	Cambiar uno de los dos campos para que sean clientes distintos.

Bloqueos y diferencias

Registrar diferencias entre drawio/json/scripts. Si existe al menos una diferencia abierta, completeness_status debe ser BLOCKED.

Tipo de diferencia	Hallazgo	Fuente A	Fuente B	Estado
ESTADOS	El estado Ingresado figura en drawio y no aparece en events, validations ni mandatoryStateName del JSON. Se clasifica como estado del flujo sin logica JSON asociada (no bloqueante por si mismo).	UNIFICAR_CLIENTES.drawio	UNIFICAR_CLIENTES.json	RESUELTO
ESTADOS	Diferencia de acento reconciliable: Revision de Origen (transicion en drawio) vs Revision de Origen (stateName en json).	UNIFICAR_CLIENTES.drawio	UNIFICAR_CLIENTES.json	RESUELTO