Este instructivo tiene como objetivo explicar qué son los Sinónimos en Deals, cómo se configuran y cómo el sistema los aplica al procesar transacciones.
15 min
¿Para qué sirven los Sinónimos?
Cuando un documento llega a Deals con valores que no coinciden con los maestros del ERP (por ejemplo, una categoría fiscal que llega como “IVA Responsable Inscripto” en lugar del código “RI” que usa el sistema), los sinónimos permiten que Deals traduzca automáticamente ese valor antes de enviarlo al ERP.
Esto evita errores de integración y elimina la necesidad de intervención manual para corregir datos campo por campo.
Antes de empezar
El documento debe tener al menos un campo marcado como sinonimizable en su Schema dentro del Catálogo de Documentos. Si el documento no tiene schema configurado, la pantalla de Sinónimos no mostrará ese documento ni permitirá crear reglas para él.
Menú → Deals → Catálogo de Documentos → Schema → activar la opción Sinónimo en los campos deseados.
Cómo acceder
Menú → Deals → Sinónimos
Pantalla principal: lista de documentos
Al ingresar a Sinónimos se muestra una grilla con todos los documentos de la empresa que tienen al menos un campo sinonimizable configurado.
| Columna | Qué muestra |
|---|---|
| Documento | Nombre del documento según el Catálogo de Documentos |
| Términos | Cantidad total de sinónimos y constantes configurados para ese documento |
| Términos sin sinonimizar | Indica si llegaron valores para campos sinonimizables que aún no tienen una regla configurada |
Al hacer clic en una fila se accede al detalle de ese documento.
Pantalla de detalle: reglas del documento
Muestra todas las reglas de sinónimos y constantes configuradas para el documento seleccionado.
Columnas de la grilla
| Columna | Qué muestra |
|---|---|
| Origen | Tipo de filtro del sinónimo: Campo de JSON, Código del método o Sin origen |
| Nombre del método | Código del método de publicación asociado. Solo se completa cuando el Origen es Código del método |
| Atributo del schema | Atributo del JSON del documento que actúa como condición de filtro. Solo se completa cuando el Origen es Campo de JSON |
| Valor condicional | Valor que debe tener el Atributo del schema para que se aplique la regla. Solo aplica con Origen Campo de JSON |
| Campo | Campo sinonimizable del documento al que aplica la regla |
| Función | Tipo de comparación: Igual, Contiene, Empieza o Termina |
| Valor | Valor recibido en la transacción que dispara la transformación |
| Sinónimo | Valor que reemplaza al recibido cuando se cumple la regla |
| Estado | Estado de configuración de la regla: Completo, Pendiente o Incompleto |
| Constante | Valor fijo que se asigna al campo sin evaluar el valor recibido (solo en filas de tipo Constante) |
Estados de una regla
| Estado | Color | Cuándo aparece |
|---|---|---|
| Completo | Verde | La regla tiene Sinónimo y Función configurados |
| Pendiente | Amarillo | Llegó un dato al sistema pero aún no se definió cómo traducirlo (falta Sinónimo o Función) |
| Incompleto | Rojo | No llegó ningún dato y la regla no tiene Sinónimo ni Función |
Las filas de tipo Constante no muestran estado.
Acciones disponibles
| Acción | Dónde está | Qué hace |
|---|---|---|
| Nuevo Sinónimo | Botón principal de la grilla | Abre el formulario para crear una regla de sinónimo |
| Nueva Constante | Menú “más acciones” | Abre el formulario para crear una constante |
| Importar | Menú “más acciones” | Permite cargar sinónimos en forma masiva desde un archivo Excel |
| Exportar | Menú “más acciones” | Descarga el contenido de la grilla como archivo Excel (sinonimos.xlsx) |
| Eliminar | Acción por fila | Elimina el sinónimo o la constante seleccionada |
Al hacer clic en una fila de sinónimo se abre el formulario en modo edición. Al hacer clic en una fila de constante se abre el formulario de constante en modo edición.
Formulario: Nuevo Sinónimo / Editar Sinónimo
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Origen | Selector | Sí | Determina cuándo aplica la regla: Campo de JSON, Código del método o Sin origen |
| Atributo del schema | Selector | Solo con Origen = Campo de JSON | Atributo del JSON cuyo valor se evalúa como condición |
| Valor condicional | Texto | Solo con Origen = Campo de JSON | Valor que debe tener el Atributo del schema para activar la regla |
| Código del método | Selector | Solo con Origen = Código del método | Método de publicación al que queda restringida la regla |
| Campo | Selector | Sí | Campo sinonimizable del documento; se carga desde el schema |
| Valor | Texto | Sí | Texto que llega en la transacción y que se quiere traducir |
| Función | Selector | Sí | Cómo comparar el Valor recibido: Igual, Contiene, Empieza o Termina |
| Sinónimo | Texto | Sí | Valor que reemplaza al recibido cuando se cumple la condición |
El sistema no permite guardar dos reglas con la misma combinación de Origen, Campo y Valor.
Formulario: Nueva Constante / Editar Constante
Una constante asigna un valor fijo a un campo sin importar el valor que llegue en la transacción.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Origen | Selector | Sí | Determina cuándo aplica la constante: Campo de JSON, Código del método o Sin origen |
| Atributo del schema | Selector | Solo con Origen = Campo de JSON | Atributo del JSON que actúa como condición |
| Valor condicional | Texto | Solo con Origen = Campo de JSON | Valor esperado del Atributo del schema |
| Código del método | Selector | Solo con Origen = Código del método | Método de publicación al que queda restringida la constante |
| Campo | Selector | Sí | Campo del documento al que se asignará el valor fijo |
| Constante | Texto | No | Valor fijo que se asignará al campo |
Solo puede existir una constante por campo para la misma combinación de Origen y filtros.
Tipos de Origen y jerarquía de aplicación
El Origen define bajo qué condición aplica una regla. Cuando Deals procesa un documento, evalúa las reglas en el siguiente orden de prioridad:
-
Campo de JSON (prioridad alta): aplica solo cuando un atributo específico del JSON del documento tiene exactamente el valor condicional indicado. Permite configurar traducciones distintas para documentos que comparten el mismo campo pero provienen de contextos diferentes.
-
Código del método (prioridad media): aplica solo cuando el documento llegó a través de un método de publicación específico.
-
Sin origen (prioridad baja): aplica a cualquier documento que llegue, sin importar su origen. Es la configuración más general.
Si existen reglas de nivel superior que coincidan con el valor del campo, las reglas de niveles inferiores no se evalúan para ese campo. Si ningún sinónimo coincide con el valor recibido y el campo tiene una constante aplicable, el sistema usa el valor de la constante.
Funciones de coincidencia
| Función | Cuándo aplica |
|---|---|
| Igual | El valor recibido es exactamente igual al Valor configurado |
| Contiene | El valor recibido incluye el texto del Valor configurado como subcadena |
| Empieza | El valor recibido comienza con el texto del Valor configurado |
| Termina | El valor recibido termina con el texto del Valor configurado |
Importación masiva
Desde el menú “más acciones” → Importar, se puede cargar un archivo Excel con múltiples reglas en una sola operación. El archivo debe respetar las columnas de la grilla: Origen, Nombre del método, Atributo del schema, Valor condicional, Campo, Función, Valor, Sinónimo y Constante.
Durante la importación el sistema valida cada fila:
- El Origen debe ser uno de los tres valores válidos (Campo de JSON, Código del método, Sin origen).
- Si el Origen es Código del método, el nombre del método debe existir en los métodos de publicación del documento.
- Si el Origen es Campo de JSON, el Atributo del schema y el Valor condicional son obligatorios, y el atributo debe existir en el schema del documento.
Las filas que no pasan la validación se rechazan y se muestran en un popup de detalle de errores. Las filas válidas se importan aunque haya rechazos parciales.
Qué hace y qué no hace
Los sinónimos se aplican automáticamente al momento en que Deals procesa el documento hacia el ERP; no requieren intervención manual por cada transacción.
Si un campo sinonimizable llega con un valor que no tiene ninguna regla configurada, el sistema lo deja sin traducir y lo registra como Pendiente en la grilla.
Si un campo tiene una Constante configurada para el origen activo, esa constante se aplica aunque no haya llegado ningún valor en el documento. Los sinónimos del mismo campo no se crean automáticamente para campos que ya tienen una constante aplicable.
La configuración de sinónimos es por empresa: cada espacio de trabajo gestiona sus propias reglas, independientemente de otras empresas.