Praxsuite

Tipos de Dato en Praxsuite

Camila Escobar · 17 de junio de 2026

Cuando agregás una columna hay dos decisiones, y solo una es fácil de deshacer. El nombre lo podés cambiar cuando quieras. El tipo, muchas veces no — una vez que la columna tiene datos, Praxsuite solo permite los cambios de tipo donde cada valor existente se convierte sin perder nada. Todo el resto exige vaciar la columna primero.

Así que elegí el tipo por lo que el campo es, no por lo que resulta cómodo de escribir hoy. Un teléfono guardado como Texto Corto nunca va a poder convertirse en columna Teléfono mientras tenga datos.

Praxsuite tiene 38 tipos de dato, agrupados en diez categorías en el selector de columna. Esta página es la referencia de todos.

El selector de columna, agrupado en diez categorías, con una vista previa del tipo elegido.

Texto

Tipo

Guarda

Límite

Texto Corto

Una línea de texto

255 caracteres

Texto Largo

Texto de varias líneas

100.000 caracteres

Email

Una dirección validada

320 caracteres

Teléfono

Un teléfono tal como se escribe

20 caracteres

Etiquetas

Una lista de rótulos cortos

—

URL

Un enlace más un texto visible opcional

—

Texto Corto es el tipo por defecto y el que corresponde a nombres, títulos, códigos y referencias. Texto Largo es para todo lo que se lea como un párrafo.

Email se valida de verdad. Un valor que no sea una dirección bien formada se rechaza al escribir, no se guarda en silencio. No es un chequeo de "tiene una @" — direcciones mal formadas que igual contienen una son rechazadas.

Teléfono no se valida. Acepta cualquier texto de hasta 20 caracteres. Si necesitás un formato garantizado, validalo en un formulario o en una automatización antes de que llegue a la tabla. El tipo te da la celda y el teclado correctos, no una garantía.

Las Etiquetas son una lista, no un texto separado por comas. Cada rótulo es un valor aparte, y eso es lo que las hace filtrables y agrupables. Usá Etiquetas cuando vayas a filtrar por ellas; usá Texto Corto cuando solo las vayas a leer.

URL guarda el enlace y, opcionalmente, el texto a mostrar en lugar de la dirección cruda — así una celda puede decir "Contrato" y seguir resolviendo al enlace completo.

La trampa de Texto Corto

Una columna clave — la que identifica las filas de una tabla — nunca puede ampliarse más allá de los 255 caracteres de Texto Corto. Si un campo algún día podría contener un párrafo, no lo hagas la clave. Agregá una columna hermana de Texto Largo y dejá la clave corta.

Texto Largo no vuelve a convertirse en Texto Corto mientras tenga datos. El cambio se rechaza directamente, en vez de truncarte el texto.

Numéricos

Tipo

Guarda

Entero

Números enteros

Entero Grande

Enteros muy grandes

Decimal

Decimales de alta precisión

Moneda

Un monto, con su moneda

Porcentaje

Una proporción

Existe un sexto tipo numérico, Número, que acepta valores enteros y decimales. No aparece en el selector de columna — existe para datos que entran por la API y para tablas antiguas. Las columnas nuevas deberían usar Entero o Decimal.

Usá Decimal, no Entero, en todo lugar donde redondear cambie la respuesta: conversión de moneda, tasas, medidas científicas. Entero es para lo que se cuenta.

La trampa de Porcentaje

La interfaz muestra 15%. La API guarda 0,15.

Porcentaje se almacena como fracción, no como un número sobre 100. Si escribís en una columna Porcentaje desde una automatización, una integración o un SDK, mandá 0.15 para quince por ciento. Mandar 15 guarda mil quinientos por ciento, y la celda va a mostrar 1500%.

Esto agarra sobre todo a quien escribe importadores, porque la planilla de origen casi siempre trae 15.

Fecha y Hora

Tipo

Guarda

Fecha

Un día de calendario, sin hora

Fecha y Hora

Un instante exacto

Período

Un intervalo entre dos instantes

Rango de Fechas

Un día de inicio y uno de fin

Hora

Una hora del día, sin fecha

Rango de Horas

Una hora de inicio y una de fin

Fecha y Fecha y Hora no son intercambiables, y la diferencia son las zonas horarias. Una columna Fecha guarda el día de calendario tal cual se lo diste y nunca lo corre. Una columna Fecha y Hora se convierte a una referencia común usando la zona horaria de tu workspace, para que el mismo instante se lea bien para todo el mundo.

Es deliberado. Un contrato que empieza el 1 de enero tiene que decir 1 de enero para cualquier lector en cualquier país — eso es Fecha. Un pago que llegó a las 14:02 ocurrió en un único instante, que distintos lectores ven en distintas horas locales — eso es Fecha y Hora.

Elegir Fecha y Hora para algo que conceptualmente es un día es la causa más común de los reportes de "la fecha está corrida un día".

Período, Rango de Fechas y Rango de Horas guardan dos valores en una sola celda en vez de obligarte a usar dos columnas. Usá Período cuando los extremos son instantes, Rango de Fechas cuando son días, y Rango de Horas cuando son horas de reloj sin fecha.

Lógica

Tipo

Guarda

Booleano

Verdadero o falso

Estado

Una opción de un conjunto definido

Booleano es para una bandera sin tercera respuesta. En el momento en que querés "sí, no, y todavía no se decidió", lo que querés es un Estado.

Estado es el tipo que convierte una tabla en un proceso. Sus opciones salen de un Grupo de Estados que definís vos — las etapas de un pipeline, los estados de un ticket — y la columna solo acepta esas opciones.

La trampa de Estado

Una celda de Estado no devuelve su nombre. Cuando leés una fila, la columna Estado vuelve como el identificador de la opción, no como el texto que ves en la interfaz. Comparar ese valor contra "Aprobado" no va a coincidir nunca.

Donde más duele es dentro de las automatizaciones: un script que compara un estado contra un nombre legible falla en silencio — la comparación simplemente da falso, siempre, sin ningún error. Comparás contra el identificador de la opción, o ramificá en un nodo que resuelva la opción por vos.

Convertir una columna Estado a texto es el único caso en que la plataforma sí te resuelve el nombre: la opción guardada pasa a ser su rótulo legible, no su identificador.

Relaciones

Tipo

Apunta a

Tabla

Filas de otra tabla

Usuario Final

Tus clientes

Usuario del Sistema

Gente de tu workspace

Agente IA

Un agente de IA configurado

Estos cuatro son lo que hace que Praxsuite sea una base de datos y no un conjunto de planillas. Una columna de relación guarda una referencia, no una copia — renombrás la fila destino y todas las celdas que la apuntan la siguen.

Los cuatro guardan una lista, no un valor único. Incluso una relación que pensás como uno-a-uno se guarda como una lista de un elemento. El código que lee una celda de relación tiene que esperar una colección.

Una columna Tabla necesita una tabla destino, que elegís al crearla, y no puede apuntar a su propia tabla. También lleva una cardinalidad — uno a uno o uno a muchos — que controla cómo se comporta la celda al elegir valores.

Usuario Final y Usuario del Sistema son poblaciones distintas, y la diferencia no es cosmética. Usuario del Sistema es alguien que entra a tu workspace: un dueño, un aprobador, un responsable. Usuario Final es un cliente del producto que construiste — alguien que se autentica contra tu app a través del gateway, y que nunca ve tu workspace. Asignar un ticket va a un Usuario del Sistema; registrar quién hizo un pedido va a un Usuario Final.

Medios y Archivos

Tipo

Guarda

Archivo

Uno o más archivos guardados

Documento

Un documento generado

Una columna Archivo guarda una lista de archivos, así que una sola celda puede llevar un contrato y sus tres anexos. Los archivos viven en el almacenamiento de archivos del workspace y la celda guarda referencias a ellos — desasociar un archivo de una fila no borra el archivo.

Documento vincula una fila a un documento generado desde una plantilla, para que una fila pueda llevar su propia cotización, contrato o informe en vez de un adjunto estático.

Identidad

Tipo

Guarda

GUID

Un identificador único externo

Secreto

Un valor cifrado

Cada fila de Praxsuite ya tiene su propio identificador interno permanente. No necesitás una columna GUID para tener uno. Usá GUID solamente para guardar un identificador que le pertenece a otro sistema — un id de registro en un CRM, la referencia de cliente de una pasarela de pago — para poder cruzar registros a través del límite.

Secreto es para valores que nunca deben ser legibles en un listado: tokens, contraseñas, claves de proveedores. El valor se guarda cifrado y solo se expone a lectores autorizados y a las operaciones que lo necesitan. No es una "columna oculta" — ocultar una columna es una decisión de visualización, mientras que Secreto es almacenamiento.

Avanzados

Tipo

Guarda

Fórmula

Un valor calculado

JSON

Datos estructurados arbitrarios

Una columna Fórmula no tiene valor guardado. Lleva una expresión que se evalúa al leer la fila, sobre las otras columnas de esa misma fila. Cambiás un valor de origen y el resultado de la fórmula cambia con él, sin nada que recalcular.

Justamente porque es calculada, una columna Fórmula no se puede escribir, ni importar, ni setear desde una automatización — y no puede ser clave.

JSON es la vía de escape: una celda que guarda una estructura que definís vos. Es la respuesta correcta para un payload de un sistema externo que querés conservar intacto. Es la respuesta equivocada para datos que vas a filtrar o agrupar, porque la plataforma no puede indexar lo que hay adentro. Si te encontrás filtrando por un campo dentro de un JSON, ese campo quiere ser su propia columna.

Visuales

Tipo

Guarda

Color

Un color hexadecimal

País

Un país

Punto Geográfico

Una latitud y una longitud

Color acepta un valor hexadecimal con transparencia opcional y le da a la celda un selector en vez de una caja de texto. País guarda el código de país estándar de dos letras y muestra la bandera y el nombre, lo que evita que "EEUU", "EE.UU." y "Estados Unidos" terminen siendo tres valores distintos en la misma columna.

Punto Geográfico guarda un par de coordenadas como un solo valor. Usalo para todo lo que vayas a poner en un mapa; usá dos columnas Decimal solo si necesitás calcular sobre las partes por separado.

Agenda

Tipo

Guarda

Día de la Semana

Uno o más días de semana

Rango de Días

Un tramo continuo de días de semana

Mes del Año

Uno o más meses

Rango de Meses

Un tramo continuo de meses

Duración

Un lapso de tiempo

Existen porque los horarios de atención, los turnos y la disponibilidad estacional son genuinamente incómodos en una columna de fecha genérica. "Lunes, miércoles y viernes" no es una fecha, y guardarlo como texto lo vuelve imposible de filtrar.

Día de la Semana y Mes del Año tienen cada uno un ajuste que decide si la celda acepta un valor o varios. Definilo al crear la columna — cambia lo que la celda es.

La semana arranca el lunes. Los días se numeran del 1 al 7, con 1 = lunes y 7 = domingo, y un valor fuera de ese rango se rechaza. Si estás importando desde un sistema que numera el domingo como 0, remapeá antes de escribir.

Los meses se numeran del 1 al 12, como es obvio.

Duración es un lapso, no un momento — tres horas, noventa minutos, cuarenta y cinco segundos. La columna tiene un ajuste de formato que decide cómo se escribe ese lapso en la celda.

Rango de Días y Rango de Meses guardan un par desde/hasta, que es la forma correcta para "lunes a viernes" o "marzo a noviembre". Son un solo valor, no dos columnas.

Lo que un tipo NO es

Un tipo no es un permiso. Ocultar una columna, restringirla por rol y hacer que un valor sea secreto son tres mecanismos distintos, y solo el último es un tipo de dato.

Un tipo no es un campo obligatorio. Todos los tipos aceptan una celda vacía salvo que la columna esté marcada aparte como requerida.

Un tipo no es una regla de unicidad. La unicidad es una regla que activás sobre una columna — y se pierde cada vez que esa columna cambia de tipo.

Siguientes

  • Cambiar el tipo de una columna

  • Trabajar con Tipos de Datos en Tablas

  • Formulas en Tablas Praxsuite

  • Creando un estado desde cero en Praxsuite

  • Componentes de una Tabla: Filas y Columnas