Prepará tu personalización

Letras individuales · Texto personalizado · Casos avanzados y errores

Cómo preparar tu catálogo para LETTERS

LETTERS convierte una palabra o frase en piezas físicas. Cada carácter compra una variante real del catálogo y usa su precio y disponibilidad actuales. Los espacios se conservan en el texto, pero no agregan piezas. No hay formato distinto para cada letra.

1. Elegí la opción que identifica cada carácter

Creá un producto en Tiendanube con un atributo que identifique la pieza: por ejemplo Carácter, Pieza o Letra. En Product Personalizer elegí ese atributo en “Opción que identifica cada carácter”. Ese es el único rol especial obligatorio; el nombre del atributo puede variar.

Para letras normales, creá los valores A, B, C y los demás caracteres que vendés. Cada valor representa una pieza completa. No hace falta crear un alias para una letra que ya existe literalmente.

El SKU sirve para tu logística. Puede ser LET-MON-AAC-05-NEG; la app busca por el valor de la opción que identifica cada carácter, nunca interpreta el SKU como letra.

2. Completá las variantes y sus opciones

Podés tener solamente la opción Carácter, o agregar Altura, Color, Material, Espesor, Terminación y otras opciones reales. La app detecta todos los atributos adicionales. No requiere Tamaño ni Color.

Cada combinación debe identificar exactamente una variante: por ejemplo A + 10 cm + Negro + Mate. Cargá su precio y stock en Tiendanube. Si una combinación no existe, no tiene stock o es ambigua, la compra se bloquea. No se inventan variantes ni precios.

La selección se aplica a la palabra completa. Con Material=Madera y Texto=HOLA, todas las piezas son de madera.

3. Elegí cómo presentar los productos

Podés habilitar un producto LETTERS independiente, sin agregar vínculos. También podés agregar un selector opcional de productos vinculados: nombralo Tipografía, Material o Estilo, y elegí productos reales para cada opción.

Ejemplo: Tipografía → Montserrat / Bebas / Bodoni. O Material → Madera / Acrílico / Metal. El producto elegido aporta todas las variantes, precios y stock de la composición; nunca se mezclan fuentes dentro de la misma palabra.

Si vinculás productos, todos deben tener la opción que identifica cada carácter. Las otras opciones se detectan en cada producto y pueden ser distintas. Al cambiar el producto vinculado se seleccionan sus opciones iniciales y se conserva el texto.

En Presentación en la tienda podés conservar Orden automático o elegir Personalizar orden. Texto forma parte de la secuencia. Si un producto vinculado tiene menos opciones, su ubicación se ajusta a los controles disponibles.

4. Agregá caracteres especiales mediante aliases

Si Tiendanube permite crear Á literalmente, podés usarlo directamente. LAB78 reportó que el editor manual rechaza Á y acepta A_ACENTO. La prueba con importación CSV UTF-8 sigue pendiente; no es necesaria para utilizar aliases.

Creá primero una variante cuyo valor de carácter sea A_ACENTO. Debe representar una pieza física Á completa. Luego, en “Equivalencias de caracteres (aliases)”, agregá: carácter escrito Á → valor del catálogo A_ACENTO. El destino se elige de los valores existentes.

El cliente escribe ÁRBOL. La app conserva ÁRBOL como texto y compra A_ACENTO, R, B, O y L. A_ACENTO es UNA pieza; nunca A más un acento suelto.

La app normaliza Unicode a NFC y usa mayúsculas en LETTERS. Crêpe se convierte en CRÊPE: Ê puede apuntar a E_CIRCUNFLEJO. PINGÜINO puede resolver Ü mediante U_DIERESIS. También se admiten símbolos como ♥ → CORAZON y ★ → ESTRELLA.

Se aplica primero el alias explícito; si no existe, se busca el carácter directamente. Si falla, se informa el carácter visible y se bloquea la compra. No se quitan acentos, no se translitera y no se sustituye una pieza por otra.

5. Convenciones recomendadas, no obligatorias

Á → A_ACENTO; É → E_ACENTO; Í → I_ACENTO; Ó → O_ACENTO; Ú → U_ACENTO.
Ü → U_DIERESIS; Ñ → N_ENIE; Ê → E_CIRCUNFLEJO.
Ç → C_CEDILLA; Ø → O_BARRADA; ♥ → CORAZON; ★ → ESTRELLA.

Podés usar cualquier otro valor interno existente si configurás su alias. Estas palabras son ejemplos; no están programadas como reglas del sistema.

El editor muestra únicamente excepciones. Podés agregar, modificar o quitar filas. Dos aliases que representan el mismo carácter, incluso con Unicode equivalente, se rechazan por duplicados. Un alias cuyo destino desapareció también se rechaza.

6. Alias común y excepciones por producto

Usá “Todos (común)” cuando los productos vinculados compartan la convención. Por ejemplo, Á apunta a A_ACENTO en cualquiera de las tipografías.

Si un producto usa otro valor, agregá una segunda fila para ese mismo carácter y seleccioná ese producto en “Aplicar a”. Ejemplo: el alias común es Á → A_ACENTO, pero Acrílico usa Á → SPECIAL_A. La excepción reemplaza el destino solamente en ese producto. No duplica piezas ni cambia el texto visible. El destino efectivo debe existir en cada fuente.

7. Probá cada incorporación

Guardá la variante y verificá que tenga el carácter y las opciones correctas en Tiendanube.
Actualizá el catálogo en el panel, configurá el alias si hace falta y guardá.
Probá el carácter solo, repetido y dentro de una palabra, por ejemplo Á, ÁÁ y ÁRBOL.
Probá cada producto vinculado y cada combinación que ofrecés; verificá cantidades, precio y stock.
Comprobá el texto completo y las variantes en el carrito. En la instalación real, completá además un pedido controlado para verificar checkout y administración.

Evitá estos errores

No uses acentos sueltos como recetas para construir otra letra. Podés excluir esos caracteres del formulario sin borrar sus variantes del catálogo. No crees variantes duplicadas con idénticas opciones. No asumas que crear un alias crea stock o una nueva variante. No cambies las opciones para cada carácter.

Cuando el formulario está operativo, los controles nativos redundantes pueden ocultarse con la integración revisada para tu tema. Si la app no carga, está deshabilitada o su configuración no es válida, quedan disponibles los controles nativos. No agregues CSS global que oculte las opciones nativas permanentemente.

Presentación del formulario y vista tipográfica

En Presentación en la tienda, Orden automático respeta las opciones del producto y conserva la ubicación del texto. No necesitás ordenar nada para empezar. Si querés otro recorrido, elegí Personalizar orden: Texto aparece en la misma lista y podés mover cada elemento con Subir/Bajar. En LAB78 se conserva Tipografía → Texto → Tamaño → Color. No hace falta editar CSS.

Abrí Vista tipográfica (opcional), elegí la opción que controla la letra y asociá cada valor comercial a la fuente visual correspondiente. Por ejemplo, Bebas Neue → Bebas Neue o Montserrat Semibold → Montserrat Semibold. No asocies Material a una fuente si no representa una tipografía. La asociación es explícita; el nombre del selector no activa nada por sí solo.

La palabra se ve dentro del mismo campo; no hay una segunda copia debajo. Si no hay fuente asociada o no está disponible, se muestra la letra habitual de la interfaz y la compra no se bloquea por ese motivo. El placeholder mantiene una letra neutra. El contador sigue contando el texto del cliente.

La vista es aproximada: ayuda a elegir el estilo, pero no representa escala física, espesor, kerning de fabricación, profundidad, material ni acabado. Las fotos del producto siguen mostrando volumen, terminación y proporciones reales.

El campo siempre muestra el carácter humano: ÁRBOL, aunque el catálogo resuelva Á mediante A_ACENTO. Cambiar la fuente visual no cambia las piezas, el precio ni el stock.

CUSTOM_TEXT: un producto con texto personalizado

CUSTOM_TEXT asocia el texto exacto a una unidad de una variante real. Conserva mayúsculas, minúsculas, acentos, espacios y Unicode original. Su precio corresponde a la variante y no cambia por el largo de la frase.

Preparar el producto

Creá el producto en Tiendanube con sus precios, stock y opciones habituales. Puede tener Material + Forma + Terminación; Talle + Color + Modelo; Tipografía + Ancho total + Color; o ninguna opción adicional, con una sola variante predeterminada.

En el panel elegí el producto, habilitá “Texto personalizado completo”, usá Orden automático o personalizá la secuencia completa, incluido Texto. No requiere una opción que identifique cada carácter ni productos vinculados. Todas las dimensiones reales se muestran; no se pueden omitir para dejar una compra ambigua.

Texto y caracteres

El máximo configurable es de 1 a 50 grafemas. Por defecto admite texto Unicode visible sin caracteres de control o invisibles. Podés indicar una lista de caracteres permitidos, incluyendo expresamente espacios y signos necesarios. Esa lista no crea variantes.

Confirmá con fabricación qué caracteres soporta tu proceso. Tiendanube no informa qué glifos puede fabricar una tipografía. Los aliases de LETTERS no se aplican aquí: el texto se conserva exactamente.

Ejemplos y validación

Una tarjeta sin opciones con “María & José 2026” compra una tarjeta. Una placa de Metal, Redonda y Mate compra una variante de placa con esa selección. No compra una unidad por letra.

Probá un texto con acentos y espacios; cambiá cada opción; verificá una unidad, el precio de la variante, el stock y el texto exacto en el carrito. Probá también el límite de caracteres y una combinación no disponible. En producción confirmá que el texto llega completo al pedido real.

Presentación del formulario y vista tipográfica

En texto personalizado, elegí una opción real como Tipografía para controlar la vista. Allura y Montserrat Semibold son ejemplos. Mayúsculas, minúsculas, acentos, espacios, símbolos y Unicode original se conservan exactamente al cambiar la fuente.

Casos avanzados y resolución de errores

Adaptar LETTERS a tu catálogo

Combiná atributos dinámicos, aliases, productos vinculados, exclusiones y ubicación del texto. Por ejemplo, una tienda puede usar Pieza + Espesor + Material + Terminación; otra puede tener solamente Pieza. Podés ofrecer estrellas o corazones como piezas completas configurando aliases hacia los valores internos reales.

Elegí la opción que identifica cada carácter y mantené ese rol en todas las fuentes vinculadas. Las otras dimensiones permanecen globales. Reordená controles para acercarlos al proceso de decisión de tu comprador. Usá un producto independiente si no necesitás un selector entre productos.

No uses dos variantes indistinguibles para una misma pieza/opciones. La flexibilidad no permite recetas de varias piezas, precios manuales, mezclas de estilos por carácter ni sustituciones automáticas.

Resolver errores

“El carácter no está disponible”: comprobá la opción que identifica cada carácter, alias y exclusiones. Revisá también la combinación elegida: el destino puede existir en otra altura o color.
“El alias está duplicado”: revisá filas del mismo ámbito. Á y A más acento combinado representan el mismo carácter al normalizar Unicode. Una excepción específica puede reemplazar un alias común.
“El destino no existe”: creá primero el valor real en Tiendanube, actualizá el catálogo y elegilo en el panel.
“Opciones ambiguas”: dos variantes tienen los mismos valores. Corregí el catálogo para identificar una sola variante.
“Stock insuficiente”: se cuenta la cantidad de piezas repetidas y lo que ya está en el carrito. Revisá el stock real.
“Otra sesión cambió la configuración”: recargá para revisar la versión guardada antes de editar nuevamente.
“Composición incompleta”: no repitas el clic. Revisá las líneas del carrito, quitá las de ese intento y utilizá la recuperación explícita cuando esté disponible.
“Personalización no disponible”: los controles nativos quedan disponibles. Revisá configuración, conexión y almacenamiento del navegador antes de reactivar la experiencia personalizada.

Ayuda y feedback

En el panel, abrí “Ayuda y feedback”. Elegí problema, sugerencia, caso de uso, pedido de función o consulta de configuración. Incluí pasos y el resultado esperado. No incluyas tokens, contraseñas ni datos personales de compradores.

La app agrega tienda, versión, producto seleccionado, comportamiento guardado, revisión de configuración, navegador y fecha. Por ahora prepara un borrador local de respuesta que podés seleccionar y copiar; no lo guarda en un sistema de soporte ni lo envía a terceros. El resultado indica “NO ENVIADO”. El contexto refiere a la configuración guardada; aclaralo en el mensaje si estás editando cambios pendientes.

Presentación y fuentes

El orden normal se configura en el panel, sin editar el tema: Orden automático para empezar; Personalizar orden para mover Texto y las opciones en una sola lista. Las configuraciones anteriores conservan su secuencia. Si distintos productos vinculados tienen distintas opciones, cada uno muestra solamente las que realmente necesita.

Para ver la letra del producto dentro del campo, configurá Vista tipográfica: elegí el selector comercial y después una fuente visual exacta para cada valor. Productos vinculados puede representar Material u otra decisión; no se interpreta automáticamente como Tipografía. Elegir “Letra habitual de la interfaz” deja ese valor sin preview especial.

Si no cambia la letra, revisá la asociación seleccionada y que corresponda al valor actual. Si falta la fuente, la compra sigue funcionando con letra normal. No uses una fuente parecida para representar otra. Soporte puede ampliar la biblioteca con fuentes autorizadas. El preview orienta sobre estilo; las medidas, material y acabado se evalúan con las fotos y datos del producto.

Si un tema no ubica o presenta correctamente el formulario, enviá feedback con el producto y pasos. La integración del tema se revisa en staging por soporte/desarrollo. No ocultes controles nativos permanentemente: ante fallos deben continuar disponibles.