Introducción

Este documento describe la estructura, nomenclatura y reglas técnicas utilizadas en la definición de tablas y campos dentro del sistema _b first. Su objetivo es proporcionar una guía clara y estandarizada para consultores, desarrolladores y administradores encargados de la configuración o integración de datos en la plataforma.

Incluye reglas de prefijos, sufijos, áreas funcionales, tipos de datos y modelos relacionales utilizados para expedientes, partidas, dossiers, operaciones logísticas, facturación y otras entidades del sistema.

Prefijos, Restricciones y Excepciones

Prefijos genéricos de campos

Los nombres de los campos comienzan con un prefijo que identifica su naturaleza:

Nota: Un campo de tipo Número (n) puede ser alfanumérico. Ejemplo: número de factura del proveedor.

Restricciones en nomenclatura

Se eliminan de todos los códigos:

• Conjunciones
• Preposiciones
• Plurales
• Artículos

La primera posición del nombre del campo indica su tipo.

Excepciones

El campo cambio es una excepción:

• No debe repetirse en una misma tabla.

 

Nomenclatura de campos

_b first utiliza un catálogo estandarizado de abreviaturas para definir los campos. Algunos ejemplos representativos:

 

Nomenclatura de tablas

Cada tabla se forma con tres segmentos concatenados, siempre en minúsculas:

1. Área funcional (3 caracteres)
2. Concepto / entidad (3 caracteres)
3. Especialización / tipo (longitud variable)

Tablas principales:

* Código	* Descripción	* Grupo de tablas	Descripción grupo de tablas	Nombre de tabla
aetent	Cabecera de entidades	Entidades	Grupo de tablas de entidades	Entidades
aetentexciptt	Excepción de tipo de impuesto de la entidad	Entidades	Grupo de tablas de entidades	Excepción de tipo de impuesto de la entidad
aetriegru	Grupo de riesgo de la entidad	Entidades	Grupo de tablas de entidades	Grupo de riesgo de la entidad
aafbieamo	Bienes amortizables	Administración	Grupo de tablas de administración	Bienes amortizables
acocencst	Centros de coste	Administración	Grupo de tablas de administración	Centros de coste
acodepcta	Depósitos	Administración	Grupo de tablas de administración	Depósitos
trapda	Partidas	Transporte	Grupo de tablas de transporte	Partidas
traexp	Expedientes	Transporte	Grupo de tablas de transporte	Expedientes
acodepctacan	Cancelación de depósitos	Administración	Grupo de tablas de administración	Cancelación de depósitos
acoder	Derrames	Administración	Grupo de tablas de administración	Derrames
acodicori	Orígenes del diccionario	Administración	Grupo de tablas de administración	Orígenes del diccionario
acopagcta	Pagos a cuenta	Administración	Grupo de tablas de administración	Pagos a cuenta
acopagctacan	Cancelación de pagos a cuenta	Administración	Grupo de tablas de administración	Cancelación de pagos a cuenta
acopla	Planes contables	Administración	Grupo de tablas de administración	Planes contables
acopto	Presupuestos contables	Administración	Grupo de tablas de administración	Presupuestos contables
acoptopdol	Líneas de periodo de presupuestos	Administración	Grupo de tablas de administración	Líneas de periodo de presupuestos
acxefe	Cartera de efectos	Administración	Grupo de tablas de administración	Cartera de efectos
acxmed	Medios disponibles	Administración	Grupo de tablas de administración	Medios disponibles
ltctrn	Transacciones	Administración	Grupo de tablas de administración	Trasacciones
aebasu	Asuntos	Administración	Grupo de tablas de administración	Asuntos
atcmap	Mapas	Comercial	Grupo de tablas de comercial	Mapas
agdlocmer	Localización de la mercancía	Aduanas	Grupo de tablas de aduanas	agdlocmer
aebpry	Proyectos	Administración	Grupo de tablas de administración	Proyectos
agdgar	Garantias	Aduanas	Grupo de tablas de aduanas	Garantias
agddos	Dossier	Aduanas	Grupo de tablas de aduanas	Dossier
agdcas	Casillas	Aduanas	Grupo de tablas de aduanas	Casillas
aetemp	Empresas	Entidades	Grupo de tablas de entidades	Empresas
taemawstk	Stock del MAWB	Transporte	Grupo de tablas de transporte	Stock
tdialb	Albarares de distribución	Transporte	Grupo de tablas de transporte	Albarares de distribución
tdivia	Viajes de distribución	Transporte	Grupo de tablas de transporte	Viajes de distribución
atcofe	Ofertas comerciales	Comercial	Grupo de tablas de comercial	Ofertas comerciales
atcsallea	Documentos Sales Lead	Comercial	Grupo de tablas de comercial	Documentos Sales Lead
atcvis	Visitas comerciales	Comercial	Grupo de tablas de comercial	Visitas comerciales
atcvor	Vendedores comerciales	Comercial	Grupo de tablas de comercial	Vendedores comerciales
atpprvdpo	Previsiones por departamento	Administración	Grupo de tablas de administración	Previsiones por departamento
taemaw	Conocimientos aéreos	Transporte	Grupo de tablas de transporte	Conocimientos aéreos
taemawliq	Liquidaciones de conocimientos aéreos	Transporte	Grupo de tablas de transporte	Liquidaciones de conocimientos aéreos
acxdoct	Tipos de documentos	Administración	Grupo de tablas de administración	Tipos de documentos
aebzon	Zonas	Administración	Grupo de tablas de administración	Zonas
tmadbl	BL	Transporte	Grupo de tablas de transporte	BL
taemawdoc	MAWB	Transporte	Grupo de tablas de transporte	taemawdoc
taehawdoc	HAWB	Transporte	Grupo de tablas de transporte	taehawdoc
atcgruins	atcgruins	Comercial	Grupo de tablas de comercial	atcgruins
traexpuni	Expediente Unico	Transporte	Grupo de tablas de transporte	traexpuni
lomtrn	Logística Transacciones	Logística	Grupo de tablas de logística	lomtrn
tdahaw	Avisos/HAWB Distribución aérea	Transporte	Grupo de tablas de transporte	tdahaw
tdamaw	Asignación a MAWB Distribución aérea	Transporte	Grupo de tablas de transporte	tdamaw
tdavia	Asignación a mensajeros (viajes) Distribución aérea	Transporte	Grupo de tablas de transporte	tdavia
tdaentmen	Mensajeros Distribución aérea	Transporte	Grupo de tablas de transporte	tdavia

 

Ejemplos:

• trapda → Transporte (tra) + Partida (pda)
• ltctrn → Logística Transacciones (ltc) + Transacción (trn)
• agddua → Aduanas Gestión Despachos (agd) + DUA (dua)

Reglas adicionales:

• Se elimina el guion - en todos los nombres.
• Los grupos se segmentan cada 3 posiciones a partir del prefijo.

Áreas funcionales

Los primeros 3 caracteres de cada tabla representan su área.

 

Sufijos genéricos y tipos de tablas

Ejemplo correcto: ltctrnl (tabla de líneas)
Ejemplo incorrecto: ltcltrn (orden incorrecto)

Las tablas se ordenan siempre de lo más genérico a lo más específico.

De esta forma, en una lista, en orden alfabético, estarán juntas las tablas que están relacionadas. La nomenclatura será siempre en minúsculas.

 

Tipos de datos

Modelos relacionales por módulos

A continuación se resume la estructura principal de cada operación del sistema, indicando sus tablas principales y relaciones 1–N o 1–1.

Partidas de transporte

Tablas principales:

• trapda – Cabecera de partida
• trapdal – Valores
• trapdamer – Mercancía (1–1 con cabecera)
• trapdamerl – Líneas
• trapdactn – Contenedores
• trapdaser – Servicios

Relación principal: ipda

Las partidas están compuestas por varias tablas, siendo la principal la trapda (Área transporte tra y pda de Partida.

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n, excepto la tabla Mercancía trapdamer que solo es 1 a 1 (Ampliación de la tabla principal).

En todas las tablas de las partidas la relación se hace a través del campo ipda.

Expedientes de transporte

Tablas:

• traexp – Expediente
• traexpl – Valores
• traexpctn – Contenedores
• traexpser – Servicios

Relación principal: iexp

Las partidas almacenan su expediente mediante trapda.iexp.

Los expediente están compuestas por varias tablas, siendo la principal la traexp (Área transporte agd y exp de Expediente.

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n. En todas las tablas de los expediente la relación se hace a través del campo iexp.

Las partidas de transporte asignadas a un expediente tiene en la tabla de Partidas (trapda) el id del Expediente (trapda.iexp) guardado.

Dossiers de Aduanas

Tablas:

• agddos – Dossier
• agddua – DUA (1–1)
• agddosl – Valores
• agddosctn – Contenedores
• agddosser – Servicios

Relación principal: idos

Los dossiers están compuestas por varias tablas, siendo la principal la agddos (Área Aduanas Gestión Despachos agd y dos de Dossier.

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n, excepto la tabla DUA agddua que solo es 1 a 1 . En todas las tablas de los dossiers la relación se hace a través del campo idos.

 

Albaranes de distribución

Tablas:

• tdialb – Albarán
• tdialbl – Valores
• tdialbmerl – Líneas

Relación principal: itdialb

Los albaranes están compuestas por varias tablas, siendo la principal la tdialb (Área Transporte distribución tdi y alb de Albarán.

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n. En todas las tablas de los albaranes la relación se hace a través del campo itdialb.

 

Viajes de distribución

Tablas:

• tdivia – Viaje
• tdialb – Albaranes asociados
• tdialb.itdiviarem – Identificador de viaje en albaranes

Los albaranes están compuestas por varias tablas, siendo la principal la tdialb (Área Transporte distribución tdi y alb de Albarán.

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n. En todas las tablas de los albaranes la relación se hace a través del campo itdialb.

Los albaranes de distribución asignados a un viaje tienen en la tabla de Albaranes (tdialb) el id del Viaje (tdialb.itdiviarem) guardado

Entradas y salidas de almacén

Entradas:

• laxalment
• laxalmentl
• laxalmentubi
• laxalmentser

Relación: ialment

Las Entradas de almacén están compuestas por varias tablas, siendo la principal la laxalment (Área Logistica almacén lax y ent de Entradas.

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n. En todas las tablas de las Entradas de almacén la relación se hace a través del campo ialment.

Salidas:

• laxalmsal
• laxalmsall
• laxalmsalubi
• laxalmsalser

Relación: ialmsal

Las Salidas de almacén están compuestas por varias tablas, siendo la principal la laxalmsal (Área Logística almacén lax y sal de Salidas.

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n. En todas las tablas de las Salidas de almacén la relación se hace a través del campo ialmsal.

 

Facturas

Tablas:

• ltctrn – Cabecera
• ltctrnl – Líneas
• ltctrnimp / impuestos
• Servicios relacionados

Relación principal: itrn

Las Facturas están compuestas por varias tablas, siendo la principal la ltctrn (Área Logística Transacciones ltc y trn de Transacciones).

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n. En todas las tablas de las Facturas la relación se hace a través del campo itrn.

 

Hitos (Tracking)

Los Hitos o Tracking que se generan en las operaciones principales se guardan en una tabla propia aebtrk.

Los campos principales y conectores con las operaciones son:

Tabla principal:

• aebtrk

Campos clave:

 

Entidades

Tablas:

• aetent – Entidad
• aetentpto – Puntos de comunicación
• aetentrie – Riesgo
• aetentdir – Dirección
• aetentcla – Clasificación
• aetentcta – Cuentas
• aetentf – Condiciones de facturación
• aetentp – Pago
• aetentapl – Aplicaciones

Relación principal: ient

Las Entidades están compuestas por varias tablas, siendo la principal la aetent (Administración Entorno Terceros).

Con la tabla principal están relacionadas varias tablas que permiten una relación 1 a n (excepción Riesgo cliente). En todas las tablas de las Entidades la relación se hace a través del campo ient.

 

Vínculos / Comentarios

Tabla: aebcom

Los Vínculos o Comentarios (comparten tabla en _bfirst) que se generan en las operaciones principales se guardan en una
tabla propia aebcom.

Los campos principales y conectores con las operaciones son:

 

 

Relación de departamentos

Tabla: aebdprorel

Las relaciones de departamentos indican la relación entre una o varias operaciones, tanto de tráfico como de aduanas y almacén.

La relación dossier con partidas esta limitada a 1 a 1, pero partidas con dossiers se puede tener 1 a n. Con otras palabras se puede tener mas un dossier relacionado con una partida, pero un dossier solo puede estar relacionado con una partida.

Los campos principales y conectores con las operaciones son:

Campo	Descripción	Función dentro del sistema
idpotipori	Id del tipo de departamento origen	Identifica qué tipo de operación es el origen de la relación (p. ej. partida, dossier, expediente).
idpotipdes	Id del tipo de departamento destino	Identifica qué tipo de operación es el destino de la relación.
nrefori	Id de la operación origen	Es el identificador concreto de la operación origen (por ejemplo, ipda, iexp, idos).
nrefdes	Id de la operación destino	Es el identificador de la operación destino asociada.
tdporel	Tipo de relación	Código que define la relación: AD (relación entre operaciones) o CI (cargos internos).

 

Información adicional del sistema

Visualización de tablas en _b first

Desde cualquier pantalla es posible usar Exportar configuración para ver las tablas principales asociadas.

 

Visualizar campos / traducciones

Desde cualquier pantalla de _bfirst existe la opción de Traducir pantalla, que
permite ver las traducciones de las etiquetas de los campos que se están
utilizando en esa pantalla. Además de ver el nombre en base de datos.

Función: Traducir pantalla → muestra etiquetas y nombres en base de datos.

 

Dependencias entre campos

Desde cualquier pantalla y registro de _bfirst existe la opción de visualizar las dependencias de ese registro en la tablas y campos a través de la combinación de teclas CTRL+F8.

Atajo: CTRL + F8 → muestra dependencias del registro.