Campos
Los campos dicen qué tiene cada registro de una entidad — referencia, valor, vencimiento, situación. Al crear la entidad, la plataforma lee una muestra del origen y sugiere los campos, con nombre, tipo y rol. Ajustas lo que quieras.
Para ver los campos, abre la entidad en Datos › Entidades y ve a la pestaña Campos. Para cambiarlos, haz clic en Editar.
Qué tiene cada campo
| Columna | Qué es |
|---|---|
| Clave | El nombre técnico del campo, que usan los bloques (vencimento). Solo letras minúsculas, números y _ |
| Nombre | El nombre que aparece en el dashboard y en el portal (Vencimento) |
| Tipo | Cómo se trata y se muestra el valor (consulta abajo) |
| Rol | Qué significa el campo para el negocio (consulta abajo) |
| Ruta en el origen | Dónde está el valor en el registro que envía el origen, como cliente.nome |
| Visible | Si el campo aparece en las listas de registros |
En la pantalla de edición, cada campo muestra la ruta en el origen y algunos valores de la muestra, para que reconozcas qué es. Desmarca un campo para dejarlo fuera.
Tipos
| Tipo | Ejemplo |
|---|---|
| texto | Conta de setembro |
| entero y decimal | 312 kWh, 12,5 |
| dinero | Se muestra como R$ 284,90 |
| sí/no | Se muestra como ✓ o ✗ |
| fecha y fecha y hora | Se muestran en el formato brasileño |
| correo, teléfono y CPF/CNPJ | cliente@exemplo.com.br, 11 98765-4321, 367.909.817-05 |
| lista | Un valor entre pocas opciones, como la situación: em_aberto, pago, vencido |
| enlace | La dirección del boleto en PDF |
| archivo | Un documento para descargar |
| lista de elementos y objeto | Valores con estructura (una lista, un objeto JSON) |
Roles
El rol les dice a los bloques del portal para qué sirve cada campo. Por él un bloque de indicadores sabe sumar el valor de las facturas abiertas, y un calendario sabe cuál fecha es el vencimiento.
| Rol | Para qué sirve |
|---|---|
| identificador | Identifica el registro en el origen |
| referencia | Un código que une el registro con otro, como la unidad consumidora de la factura |
| título | El nombre del registro en las listas |
| estado | La situación del registro |
| vencimiento | La fecha de vencimiento |
| valor | El valor en dinero |
| creado el y actualizado el | Las fechas del registro |
| correo, documento, teléfono y enlace | Datos de contacto, documentos y direcciones |
Un campo puede quedar sin rol. En la entidad Fatura de Aurora Energia, Referência no tiene rol; Valor es valor, Vencimento es vencimiento y Situação es estado. Conoce más en Datos en los bloques.
El campo del titular
El ID del titular es el campo que dice de qué cliente es cada registro. Se elige en la edición de la entidad, junto con el Identificador y el Título, y aparece en la pestaña Campos con el rol titular ↔ usuario.
Justo debajo, eliges cómo se compara el valor con el tenant ID del usuario del portal:
| Comparación | Cuándo usarla |
|---|---|
| Tenant ID (texto exacto) | El titular es un código de tu sistema, como la matrícula del responsable |
| Tenant ID como CPF/CNPJ (solo los dígitos) | El titular es un CPF o un CNPJ. Las máscaras no importan: solo se comparan los dígitos |
En Fatura, el titular es el campo CPF/CNPJ do titular (documento_titular), comparado como CPF/CNPJ. Ese campo no es visible: decide quién ve el registro, pero no necesita aparecer. Entiende la regla en Titular y tenant ID.
Campos calculados
Un campo calculado arma el valor a partir de los otros campos del registro, sin existir en el origen. Úsalo para unir textos, formatear un código o hacer una cuenta.
- En la edición de la entidad, haz clic en Campo calculado.
- Dale nombre, clave y tipo al campo.
- En Expresión, escribe el valor. Lo que queda entre
{{ }}se calcula; el resto es texto fijo.
Ejemplos:
| Expresión | Resultado |
|---|---|
P-{{ $resource.numero.length }} | P-6 |
{{ $resource.valor * 0.1 }} | Diez por ciento del valor |
{{ $resource.consumo_kwh }} kWh | 312 kWh |
$resource.<clave> lee un campo del registro. La sintaxis es la misma de las expresiones de n8n — la pantalla tiene un enlace a la referencia. Justo debajo de la expresión, la pantalla muestra el resultado en el primer registro de la muestra (o el error, si la expresión no funciona).
Un campo calculado ve los campos del origen y los calculados que vienen antes que él. Cuando la expresión falla en un registro, el campo queda vacío en ese registro.
Editar los campos después
En Editar renombras campos, cambias tipo y rol, incluyes o quitas campos y creas campos calculados. Cuando el cambio afecta a los registros (campos, tipos, roles, expresiones, titular, filtros o paginación), una sincronización entra en la cola para leer los registros de nuevo con los campos actualizados.
Si cambias la Clave de la entidad, la pantalla avisa qué páginas del portal usan la clave anterior.