15 - Glosario de Términos del Dominio

Términos cuyo significado es aspiracional, no operacional

• PlanCredito, PlanCreditoService (app/Services/PlanCreditoService.php) y EstadoPlanCredito (app/Enum/Facturacion/EstadoPlanCredito.php) existen como código, pero no existe ningún modelo ni migración plan_credito. El enum y el servicio están inactivos; nada en el flujo activo escribe ni lee un registro de plan de crédito.
• El fallo terminal de una venta se expresa en el código como EstadoVenta::RECHAZADA y EstadoVenta::ABANDONADA (app/Enum/Facturacion/EstadoVenta.php). No existe un caso CANCELADA en el enum. La cadena 'cancelada' aparece en resources/js/pages/ally/ventas/Page.vue:88 como una rama de color en la UI y en VentaCanceladaListener como una referencia a un enum inexistente (código roto que lanzaría una excepción si el listener llegara a ejecutarse).
• Los casos EstadoVenta::LEGALIZADA, COMPLETADA y DEVUELTA existen, pero no hay ningún controlador, servicio, listener ni job en el código base que transicione una venta hacia ellos. Son estados aspiracionales para flujos futuros.
• cupo_vence_en se calcula en AprobarCupoController@aprobarCupo (app/Http/Controllers/AprobarCliente/AprobarCupoController.php:278) como Carbon::now()->addMonth()->startOfMonth()->addDays(5)->endOfDay(), lo que corresponde al día 6 del mes siguiente (día 1 + 5 días), no al día 5. Trátalo como “primera semana del mes siguiente” en lugar de un día preciso.

Este glosario cataloga todos los términos en español del dominio en el código base de MiPlante que un desarrollador no hispanohablante necesitaría comprender. Los términos están organizados por categoría.

---

1. Entidades de Negocio

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
persona / personas	Person / People	Registro de identidad legal que contiene la información del documento de identidad emitido por el gobierno. Una persona puede estar vinculada a un usuario.	app/Models/Persona.php, tabla personas
usuario / usuarios	User / Users	Cuenta de autenticación. Extendida desde la tabla users de Laravel con columnas en español. Incluye una columna guard (string, valor por defecto ‘web’) para autenticación de doble guard.	app/Models/User.php, tabla users
cliente / clientes	Customer / Customers	Un usuario que ha completado el registro y tiene una línea de crédito (cupo). Contiene datos de contrato, facturación y crédito.	app/Models/Cliente.php, tabla clientes
empresa / empresas	Company / Companies	Un negocio aliado que vende productos a través del marketplace.	app/Models/Empresa.php, tabla empresas
sucursal / sucursales	Branch / Branches	Una ubicación física de sucursal que pertenece a una empresa.	app/Models/Sucursal.php, tabla sucursales
empleado / empleados	Employee / Employees	Un usuario que trabaja para una empresa aliada. No es un modelo separado: es simplemente un User con rol empleado vinculado a través de tablas pivote.	app/Http/Controllers/Aliado/EmpleadoController.php, routes/ally/web.php
aliado / aliados	Ally / Partner	Un socio comercial que vende productos a través de MiPlante. Término usado para todo el portal de aliados.	routes/ally/web.php, valor de rol 'aliado'
producto / productos	Product / Products	Un artículo listado para la venta en el marketplace por una empresa.	app/Models/Producto.php, tabla productos
precio / precios	Price / Prices	Una variante de precio (SKU) de un producto, incluyendo el control de inventario. Un producto puede tener varios precios.	app/Models/Precio.php, tabla precios
marca / marcas	Brand / Brands	Marca del producto.	app/Models/Marca.php, tabla marcas
linea / lineas	Line / Product Line (Category)	Jerarquía de categorías de productos (máximo 2 niveles de profundidad mediante auto-referencia). También define los límites de plazo en cuotas.	app/Models/Linea.php, tabla lineas
carrito / carritos	Shopping Cart	Ítems del carrito de un usuario. Cada fila es un ítem (precio + cantidad).	app/Models/Carrito.php, tabla carritos
lista de deseos / lista_deseos	Wishlist	Productos guardados que un usuario quiere comprar más adelante.	app/Models/ListaDeseo.php, tabla lista_deseos
beneficiario	Beneficiary	Una persona designada como beneficiaria para una orden de compra (p. ej., beneficiario de seguro para compras a crédito).	app/Models/Facturacion/Beneficiario.php, tabla beneficiario
postulacion aliado / postulacion_aliados	Partner Application	Una solicitud enviada por un negocio que desea convertirse en aliado en el marketplace.	app/Models/PostulacionAliado.php, tabla postulacion_aliados
descontable descuento / descontable_descuento	Discountable Discount	Entidad polimórfica de descuento (modelo marcador de posición, no completamente implementado).	app/Models/DescontableDescuento.php, tabla descontable_descuento
precio imagen / precio_imagenes	Price Image	Imagen asociada a una variante de precio específica.	app/Models/PrecioImagene.php, tabla precio_imagenes

---

2. Términos Financieros / de Facturación

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
venta / ventas	Sale / Sales	Una transacción de venta, creada por empresa/sucursal dentro de una orden de compra. Entidad central de facturación.	app/Models/Facturacion/Venta.php, tabla ventas
venta detalle / venta_detalles	Sale Detail / Line Item	Ítem individual dentro de una venta (producto, cantidad, monto).	app/Models/Facturacion/VentaDetalle.php, tabla venta_detalles
orden de compra / orden_compras	Purchase Order	Agrupa una o más ventas de una sola sesión de checkout.	app/Models/Facturacion/OrdenCompra.php, tabla orden_compras
cuota / cuotas	Installment / Installments	Cuotas de pago mensuales para una venta. Cada venta genera N cuotas.	app/Models/Facturacion/Cuota.php, tabla cuotas
cupo	Credit Limit / Credit Line	El monto total de crédito asignado a un cliente.	clientes.cupo_asignado, clientes.cupo_disponible
cupo asignado	Assigned Credit Limit	Línea de crédito total asignada al cliente con base en el estrato + extensiones.	clientes.cupo_asignado
cupo disponible	Available Credit	Crédito restante que el cliente puede usar (se decrementa con cada venta aprobada).	clientes.cupo_disponible
cupo vence en	Credit Expires At	Fecha en la que vence la línea de crédito del cliente. Calculado como startOfMonth(siguiente mes) + 5 días, fin del día en AprobarCupoController::aprobarCupo, efectivamente el día 6 del mes siguiente.	clientes.cupo_vence_en
monto	Amount	Monto monetario, usado para los montos de cuotas y los totales de ítems.	cuotas.monto, venta_detalles.monto
monto pagado	Amount Paid	Cuánto se ha pagado de una cuota (acumulado para pagos parciales).	cuotas.monto_pagado
subtotal	Subtotal	Total antes de descuentos.	ventas.subtotal, orden_compras.subtotal
total	Total	Monto final después de descuentos.	ventas.total, orden_compras.total
descuento aplicado	Discount Applied	Porcentaje o monto de descuento aplicado a una venta o ítem.	ventas.descuento_aplicado, venta_detalles.descuento_aplicado
interes	Interest	Componente de interés calculado sobre el saldo de capital restante para una cuota.	cuotas.interes
monto seguro vida / monto_seguro_vida	Life Insurance Amount	Prima de seguro de vida por cuota, calculada como capital × factor seguro_vida.	cuotas.monto_seguro_vida
fianza	Bond / Surety Fee	Tarifa basada en un porcentaje, distribuida durante el primer trimestre de cuotas.	config('app.porcentaje_fianza'), VentaService
monto fianza	Bond Amount	Monto de fianza añadido a cada cuota aplicable.	VentaService::generarCuotas()
estudio de credito	Credit Study Fee	Tarifa única añadida a la primera cuota cuando se abre una línea de crédito.	config('app.monto_estudio_credito'), VentaService
numero cuotas / numero_cuotas	Number of Installments	En cuántas cuotas mensuales se divide una venta.	ventas.numero_cuotas
numero cuota / numero_cuota	Installment Number	Número secuencial de una cuota específica (1, 2, 3…).	cuotas.numero_cuota
fecha vencimiento / fecha_vencimiento	Due Date	Cuándo vence el pago de una cuota.	cuotas.fecha_vencimiento
fecha pago / fecha_pago	Payment Date	Cuándo se pagó realmente la cuota.	cuotas.fecha_pago
plan credito / plan de credito	Credit Plan	El plan general de cuotas para una venta. Se rastrea a través del enum EstadoPlanCredito.	app/Services/PlanCreditoService.php, app/Enum/Facturacion/EstadoPlanCredito.php
mora / presenta mora	Delinquency / Has Delinquency	Indica si un cliente tiene pagos vencidos. Bloquea el checkout si es verdadero.	middleware verificar_cliente_presenta_mora, ruta aliado.clientes.presenta-mora
inventario	Inventory	Cantidad de stock para una variante de precio.	precios.inventario
alerta inventario / alerta_inventario	Inventory Alert	Umbral en el que se dispara una alerta de bajo stock.	precios.alerta_inventario
es primario / es_primario	Is Primary	Indica si una variante de precio es la primaria/predeterminada para un producto.	precios.es_primario
es indeterminado / es_indeterminado	Is Indeterminate	Una venta sin referencias específicas a productos: el monto se establece directamente (p. ej., servicio personalizado).	ventas.es_indeterminado
porcentaje	Percentage	Usado para porcentajes de descuento, porcentajes de extensión de puntaje crediticio, umbrales de similitud de dirección.	app/Services/ExtenderCupoService.php, app/Services/ClienteService.php

---

3. Roles de Usuario

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
cliente	Customer	Consumidor final que compra en el marketplace. Rol por defecto en el registro.	users.rol = 'cliente', RegisteredUserController
aliado	Ally / Partner	Administrador del socio comercial que gestiona su empresa, productos y ventas.	users.rol = 'aliado', RegisteredUserController (registro de aliado)
empleado	Employee	Miembro del personal de una empresa aliada, puede procesar ventas y marcar entregas.	users.rol = 'empleado', comando UpdateUserRoles
activo	Active	Indica si una cuenta de usuario está activa.	users.activo
rol	Role	El rol del usuario en el sistema (cliente, aliado o empleado).	users.rol

---

4. Estados de Venta (EstadoVenta)

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
pendiente	Pending	Estado inicial. La venta espera la firma del pagaré y la aprobación del crédito.	EstadoVenta::PENDIENTE
aprobada	Approved	El crédito ha sido aprobado y el cupo decrementado. Listo para el despacho.	EstadoVenta::APROBADA
entregada	Delivered	El aliado ha confirmado la entrega del producto al cliente.	EstadoVenta::ENTREGADA
legalizada	Legalized	La venta ha sido formalizada legalmente. El caso del enum está definido; ningún controlador, servicio, listener o job establece este estado en el flujo activo (solo el comando de consola ImportarVentasDeCSV lo asigna).	EstadoVenta::LEGALIZADA
completada	Completed	Todas las cuotas pagadas, venta totalmente liquidada. El caso del enum está definido; ninguna transición activa escribe este valor actualmente.	EstadoVenta::COMPLETADA
devuelta	Returned	El producto ha sido devuelto. El caso del enum está definido; ninguna transición activa escribe este valor actualmente.	EstadoVenta::DEVUELTA
rechazada	Rejected	La aprobación del crédito falló o el pagaré fue bloqueado. Estado terminal.	EstadoVenta::RECHAZADA
abandonada	Abandoned	El cliente no completó la firma del pagaré dentro de los 60 minutos, o el pagaré expiró. Estado terminal.	EstadoVenta::ABANDONADA

Nota: No existe un estado CANCELADA en el enum EstadoVenta. El VentaCanceladaListener referencia un caso Estado::CANCELADA inexistente: este es código roto que fallaría si se llegara a disparar.

---

5. Estados de Orden (OrdenCompraEstado)

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
pendiente	Pending	Orden creada, esperando el procesamiento del pagaré y del crédito.	OrdenCompraEstado::PENDIENTE
procesada	Processed	Todas las ventas en la orden han sido aprobadas.	OrdenCompraEstado::PROCESADA
rechazada	Rejected	Pagaré bloqueado o la orden no tiene ventas.	OrdenCompraEstado::RECHAZADA
abandonada	Abandoned	Expiró por tiempo (60 min) o el pagaré venció.	OrdenCompraEstado::ABANDONADA

---

6. Estados de Cuota (EstadoCuota)

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
pendiente	Pending	Cuota aún no vencida o aún no pagada.	EstadoCuota::PENDIENTE
pagada	Paid	Cuota pagada en su totalidad.	EstadoCuota::PAGADA
vencida	Overdue / Past Due	La fecha de pago ha pasado sin un pago completo.	EstadoCuota::VENCIDA
parcial	Partial	Cuota pagada parcialmente (monto_pagado < monto).	EstadoCuota::PARCIAL

---

7. Estados del Plan de Crédito (EstadoPlanCredito)

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
activo	Active	Plan de crédito en curso con cuotas pendientes.	EstadoPlanCredito::ACTIVO
completado	Completed	Todas las cuotas pagadas.	EstadoPlanCredito::COMPLETADO
cancelado	Cancelled	El plan de crédito fue cancelado.	EstadoPlanCredito::CANCELADO
vencido	Expired / Delinquent	Una o más cuotas están vencidas.	EstadoPlanCredito::VENCIDO

Nota: El modelo PlanCredito (app/Models/Facturacion/PlanCredito.php) no existe y no hay una migración de base de datos correspondiente. PlanCreditoService y EstadoPlanCredito están definidos en el código pero actualmente no son operativos. El pago de cuotas y las transiciones del estado del plan descritas por estos estados no pueden funcionar actualmente como están diseñadas.

---

8. Términos de Aprobación de Crédito

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
aprobar cupo	Approve Credit Line	El flujo de trabajo de múltiples pasos para validar y activar la línea de crédito de un cliente.	app/Services/AprobarCupoService.php, AprobarCupoController
aprobar cupo evento / aprobar_cupo_eventos	Credit Approval Event	Entrada de registro de auditoría para cada paso del flujo de aprobación de crédito.	app/Models/AprobarCupoEvento.php, tabla aprobar_cupo_eventos
tipo proceso / tipo_proceso	Process Type	A qué paso del pipeline de aprobación de crédito pertenece un evento.	enum AprobarCupo\ProcessType
extender cupo	Extend Credit Line	Proceso post-aprobación que aumenta el cupo con base en los datos de EMCALI y el puntaje crediticio.	app/Services/ExtenderCupoService.php
estrato	Socioeconomic Stratum	Clasificación colombiana (1-6) del nivel económico de un hogar, determina la línea de crédito base. E1=2.5M, E2=3M, E3=3.5M, E4-6=4M COP.	clientes.estrato
numero contrato / numero_contrato	Contract Number	El número de contrato de servicios públicos de EMCALI del cliente, usado para verificar la identidad.	clientes.numero_contrato
registro completado en / registro_completado_en	Registration Completed At	Marca de tiempo en la que el cliente terminó el registro completo (Fase 0).	clientes.registro_completado_en
completar registro	Complete Registration	El paso de finalización del registro en el que el cliente proporciona la dirección y valida las facturas.	CompletarRegistroController, ruta /usuario/completar-registro
pagare / pagare digital	Promissory Note / Digital Promissory Note	Un pagaré digital legalmente vinculante firmado a través de Certicámara en el checkout.	VentaService, CerticamaraService
pagare firmado en / pagare_firmado_en	Promissory Note Signed At	Marca de tiempo en la que el cliente firmó su pagaré digital.	clientes.pagare_firmado_en
puede intentar firmar pagare en	Can Attempt Pagare Signing At	Marca de tiempo de enfriamiento después de un pagaré fallido (24 h por defecto).	clientes.puede_intentar_firmar_pagare_en
limite de intentos diarios	Daily Attempt Limit	Máximo de 2 intentos de aprobación de crédito por día por cliente.	middleware check_intentos_limite_diarios
verificacion legal / legal check	Legal Verification	Fase 1: verificación de TransUnion para hallazgos en listas legales y validez de documentos.	LegalCheckService, ruta /usuario/cupo/legal-check
validar identidad	Validate Identity	Fase 2: validación de identidad por Experian/Evidente.	IdentityValidationService::validarIdentidad()
cuestionario	Questionnaire	Fase 5: preguntas de autenticación basadas en conocimiento de Experian.	IdentityValidationService::generarCuestionario()
consultar cupo	Check Credit Line	Página pública donde un usuario puede consultar su crédito disponible por número de contrato.	Ruta /consultar-cupo, ConsultarCupoController
ciclo	Billing Cycle	Número del ciclo de facturación del cliente, enviado al sistema externo de crédito (por defecto: 15).	clientes.ciclo, CreditoService
dia pago / dia_pago	Payment Day	Día del mes para los pagos de cuotas (por defecto: día 5).	clientes.dia_pago, CreditoService
valor promedio / valor_promedio	Average Value	Valor promedio de transacción del cliente, enviado al sistema externo de crédito.	clientes.valor_promedio, CreditoService

---

9. Campos de Identidad / Documentos

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
tipo dni / tipo_dni	ID Document Type	Tipo de documento de identidad emitido por el gobierno (CC, CE, NIT, etc.).	personas.tipo_dni
dni	ID Document Number	El número real del documento.	personas.dni
expedido en / expedido_en	Issued At	Fecha en la que se expidió el documento de identidad.	personas.expedido_en
lugar expedicion / lugar_expedicion	Place of Issuance	Ciudad/municipio donde se expidió el documento.	personas.lugar_expedicion
nombres	First Names	Nombre(s) de pila del usuario.	users.nombres
apellidos	Last Names / Surnames	Apellido(s) del usuario.	users.apellidos
primer nombre / primer_nombre	First Name	Primer nombre del beneficiario.	beneficiario.primer_nombre
primer apellido / primer_apellido	First Surname	Primer apellido (paterno) del beneficiario.	beneficiario.primer_apellido
segundo apellido / segundo_apellido	Second Surname	Segundo apellido (materno) del beneficiario.	beneficiario.segundo_apellido
tipo identificacion / tipo_identificacion	Identification Type	Tipo de documento para empresas, beneficiarios y postulaciones.	empresas.tipo_identificacion, beneficiario.tipo_identificacion
numero identificacion / numero_identificacion	Identification Number	Número de documento para beneficiarios.	beneficiario.numero_identificacion
identificacion	Identification	Número de documento para empresas y postulaciones.	empresas.identificacion, postulacion_aliados.identificacion
telefono	Phone Number	Número telefónico de contacto.	users.telefono, empresas.telefono, sucursales.telefono
direccion	Address	Dirección física.	users.direccion, clientes.direccion, sucursales.direccion
fecha nacimiento / fecha_nacimiento	Date of Birth	Fecha de nacimiento del usuario.	users.fecha_nacimiento
correo electronico / correo_electronico	Email Address	Correo electrónico para los aspirantes a postulación.	postulacion_aliados.correo_electronico

---

10. Términos Geográficos / de Ubicación

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
barrio	Neighborhood	Barrio del cliente dentro de una ciudad.	clientes.barrio
ciudad	City	Nombre de la ciudad.	clientes.ciudad, sucursales.ciudad
departamento	Department (State/Province)	División administrativa colombiana (equivalente a estado/provincia).	clientes.departamento

---

11. Campos de Empresa / Aliado

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
razon social / razon_social	Legal Business Name	Nombre oficial registrado de la empresa (en contraste con el nombre comercial).	empresas.razon_social
nombre comercial / nombre_comercial	Trade Name	Nombre comercial visible al público.	postulacion_aliados.nombre_comercial
nombre oficial / nombre_oficial	Official Name	Nombre oficial de una sucursal.	sucursales.nombre_oficial
nombre interno / nombre_interno	Internal Name	Nombre interno/abreviado de una sucursal.	sucursales.nombre_interno
canal venta / canal_venta	Sales Channel	Cómo vende la empresa: 'fisico' (físico/en tienda) o 'digital' (en línea).	empresas.canal_venta
estado	Status/State	Campo genérico de estado usado en empresas, productos y postulaciones.	empresas.estado, productos.estado
imagen	Image	Logo/imagen de la empresa.	empresas.imagen
banner	Banner	Imagen de banner de la empresa para mostrar en el marketplace.	empresas.banner
id externo / id_externo	External ID	ID de un sistema externo (p. ej., fuente de importación).	empresas.id_externo, productos.id_externo
codigo shivam / codigo_shivam	SHIVAM Code	Identificador en el sistema core bancario SHIVAM.	empresas.codigo_shivam, postulacion_aliados.codigo_shivam
nombre completo solicitante / nombre_completo_solicitante	Applicant Full Name	Nombre completo de la persona que envía una solicitud de aliado.	postulacion_aliados.nombre_completo_solicitante
causal	Cause / Reason	Razón de un cambio de estado (motivo de rechazo, motivo de devolución, etc.).	ventas.causal, postulacion_aliados.causal

---

12. Términos del Catálogo de Productos

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
tipo producto / tipo_producto	Product Type	Clasificación: 'fisico' (bienes físicos) o 'digital' (digitales/servicios).	productos.tipo_producto
caracteristicas	Characteristics / Specs	Campo JSON para las especificaciones y atributos del producto.	productos.caracteristicas
descripcion	Description	Descripción de texto para productos, precios y líneas.	productos.descripcion, precios.descripcion, lineas.descripcion
nombre	Name	Campo de nombre en todas las entidades.	Múltiples tablas
slug	Slug	Identificador amigable para URLs.	productos.slug, lineas.slug, marcas.slug
sku	SKU	Identificador SKU (Stock Keeping Unit).	productos.sku
linea padre / linea_padre_id	Parent Line (Category)	Categoría padre en la jerarquía de 2 niveles.	lineas.linea_padre_id
lineas hijas	Child Lines (Subcategories)	Subcategorías bajo una línea padre.	Relación del modelo Linea
plazo minimo / plazo_minimo	Minimum Term	Número mínimo de cuotas permitidas para productos en esta categoría.	lineas.plazo_minimo
plazo maximo / plazo_maximo	Maximum Term	Número máximo de cuotas permitidas para productos en esta categoría.	lineas.plazo_maximo
carga masiva / carga_masiva	Bulk Upload / Mass Import	Carga de varios productos a la vez mediante hoja de cálculo.	ruta aliado.productos.carga-masiva, enum CargaMasivaProductoErrorType

---

13. Columnas de Marca de Tiempo y Metadatos

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
creado en / creado_en	Created At	Marca de tiempo de creación (nombre personalizado en español para el created_at de Laravel).	clase base Modelo, la mayoría de las tablas
actualizado en / actualizado_en	Updated At	Marca de tiempo de la última actualización (nombre personalizado en español para el updated_at de Laravel).	clase base Modelo, la mayoría de las tablas
eliminado en / eliminado_en	Deleted At	Marca de tiempo de soft delete (nombre personalizado en español para deleted_at).	precios.eliminado_en, descontable_descuento.eliminado_en
expira en / expira_en	Expires At	Marca de tiempo de expiración.	descontable_descuento.expira_en
observaciones	Notes / Observations	Notas de texto libre sobre órdenes, ventas y cuotas.	orden_compras.observaciones, ventas.observaciones, cuotas.observaciones
descriptor	Descriptor	Descripción de texto para ítems de venta indeterminados (cuando no hay referencia a un producto).	venta_detalles.descriptor
cantidad	Quantity	Número de unidades en un ítem del carrito o en un ítem de venta.	carritos.cantidad, venta_detalles.cantidad

---

14. Términos de Parentesco del Beneficiario (BeneficiarioParentescto)

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
parentesco	Kinship / Relationship	Relación familiar del beneficiario con el comprador.	beneficiario.parentesco
conyuge	Spouse	El beneficiario es el cónyuge del comprador.	BeneficiarioParentescto::CONYUGE
hijo	Son/Child	El beneficiario es el hijo del comprador.	BeneficiarioParentescto::HIJO
padre	Father/Parent	El beneficiario es el padre del comprador.	BeneficiarioParentescto::PADRE
otro	Other	Otra relación.	BeneficiarioParentescto::OTRO

---

15. Servicios Externos e Integraciones

Término / Nombre en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
EMCALI	Empresas Municipales de Cali	Empresa municipal de servicios públicos de Cali. Se usa para verificar la identidad del cliente mediante el contrato de servicios públicos y las facturas. También provee datos para la extensión del cupo.	app/Services/EmcaliMembresiaService.php
membresia / consultarMembresia	Membership / Query Membership	Llamada a la API de EMCALI para obtener la información de la cuenta de servicios públicos de un cliente y su historial de pagos.	EmcaliMembresiaService::consultarMembresia()
Certicamara	Certicámara	Autoridad de certificación digital colombiana. Gestiona la creación y firma del pagaré digital.	app/Services/CerticamaraService.php
certicamara_uuid	Certicamara UUID	Identificador único del documento de pagaré pendiente en el sistema de Certicámara.	clientes.certicamara_uuid
DataCredito	DataCrédito	Buró de crédito colombiano (parte de TransUnion). Provee el historial y los puntajes de crédito.	app/Services/DataCreditoService.php
HDC	Historia de Crédito	Reporte de historia de crédito de DataCrédito. HDC Plus es el producto específico utilizado.	app/Services/HDCValidationService.php
TransUnion	TransUnion	Buró de crédito internacional. Provee el servicio de verificación legal en Colombia.	LegalCheckService
Experian / Evidente	Experian / Evidente	Plataforma de validación de identidad de Experian en Colombia (nombre de marca: Evidente). Se usa para validación de identidad, OTP y preguntas basadas en conocimiento.	app/Services/IdentityValidationService.php
SHIVAM	SHIVAM	Sistema core bancario externo. Los clientes y las líneas de crédito se sincronizan con él.	empresas.codigo_shivam, app/Services/CoreCreditoService.php
Core Credito	Core Credit System	La API del core bancario SHIVAM para crear clientes y generar créditos.	app/Services/CoreCreditoService.php, app/Services/CreditoService.php
factura / facturas	Invoice / Invoices	Facturas de servicios públicos usadas para verificar la identidad del cliente durante el registro (últimos 6 meses).	CompletarRegistroController, ClienteService::validarFacturasDeUltimoSeisMeses()

---

16. Abreviaturas y Siglas

Abreviatura	Forma Completa (Español)	Inglés	Contexto de Negocio	Dónde se Usa
DNI	Documento Nacional de Identidad	National Identity Document	Término genérico para cualquier documento de identidad gubernamental.	personas.tipo_dni, personas.dni
CC	Cédula de Ciudadanía	Citizenship ID Card	El tipo de documento más común para adultos colombianos.	valores de tipo_dni, mapeos de TransUnion/Experian
CE	Cédula de Extranjería	Foreigner ID Card	Documento de identidad colombiano para nacionales extranjeros.	valores de tipo_dni
NIT	Número de Identificación Tributaria	Tax Identification Number	Identificación tributaria colombiana para empresas.	valor por defecto de postulacion_aliados.tipo_identificacion
OTP	One-Time Password	One-Time Password	Código de verificación enviado por SMS/correo durante las fases 3-4 de aprobación de crédito.	IdentityValidationService::generarOTP(), verificarOTP()
HDC	Historia de Crédito	Credit History	Reporte de historia de crédito de DataCrédito.	HDCValidationService, ProcessType::HDC_VALIDATION
SIC	Superintendencia de Industria y Comercio	Superintendent of Industry and Commerce	Agencia del gobierno colombiano; las listas legales se verifican contra las bases de datos de la SIC.	LegalCheckService (verificaciones de listas legales)
IV	Identity Validation	Identity Validation	Prefijo usado en los tipos de proceso de aprobación de crédito para los pasos de Experian/Evidente.	ProcessType::IV_OTP_GENERATION, etc.
SKU	Stock Keeping Unit	Stock Keeping Unit	Identificador de inventario del producto.	productos.sku

---

17. Tipos de Proceso de Aprobación de Crédito (AprobarCupo\ProcessType)

Valor del Enum	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
legal_check	Legal Check	Fase 1: validación de lista legal y de documentos por TransUnion.	ProcessType::LEGAL_CHECK
identity_validation	Identity Validation	Fase 2: verificación de identidad por Experian/Evidente.	ProcessType::IDENTITY_VALIDATION
iv_otp_generation	OTP Generation	Fase 3: generar y enviar la contraseña de un solo uso.	ProcessType::IV_OTP_GENERATION
iv_otp_verification	OTP Verification	Fase 4: verificar el código OTP enviado.	ProcessType::IV_OTP_VERIFICATION
iv_question_generation	Question Generation	Fase 5a: generar preguntas basadas en conocimiento (condicional).	ProcessType::IV_QUESTION_GENERATION
iv_question_verification	Question Verification	Fase 5b: verificar las respuestas a las preguntas basadas en conocimiento.	ProcessType::IV_QUESTION_VERIFICATION
hdc_validation	Credit History Validation	Fase 6: verificación de historia de crédito HDC Plus de DataCrédito.	ProcessType::HDC_VALIDATION

---

18. Tipos de Evento de Aprobación de Crédito (AprobarCupo\EventType)

Valor del Enum	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
validation_start	Validation Start	Se registra cuando comienza un paso de aprobación de crédito.	EventType::START
validation_finish_successfull	Validation Finish (Success)	Se registra cuando un paso se completa exitosamente.	EventType::FINISH_SUCCESS
validation_finish_unsuccessfull	Validation Finish (Failure)	Se registra cuando un paso falla.	EventType::FINISH_UNSUCCESS

---

19. Tipo de Empresa (EmpresaType)

Valor del Enum	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
master	Master	Empresa matriz / empresa administradora de la plataforma.	EmpresaType::MASTER
cliente	Client / Partner	Una empresa aliada regular que usa la plataforma.	EmpresaType::CLIENTE

---

20. Términos de UI / Navegación

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
perfil	Profile	Página del perfil del usuario.	resources/js/pages/user/Perfil.vue, ruta user.perfil
completar	Complete (Registration)	Formulario de finalización del registro.	resources/js/pages/user/Completar.vue
compras / mis compras	Purchases / My Purchases	Sección del historial de compras del cliente.	resources/js/pages/Compras/, prefijo de ruta mis-compras
checkout	Checkout	Página del checkout de compra.	resources/js/pages/Checkout/Index.vue
simulador / simulador de cuotas	Simulator / Installment Simulator	Herramienta para que los clientes previsualicen los planes de cuotas antes de comprar.	resources/js/pages/Simulator/Index.vue, ruta simulador.view
consultar cupo	Check Credit Line	Página pública para consultar el crédito disponible por número de contrato.	resources/js/pages/ConsultarCupo/Index.vue
ofertas	Offers / Deals	Sección de la página de inicio que muestra ofertas promocionales.	resources/js/pages/home/Ofertas.vue
mas vendidos	Best Sellers	Sección de la página de inicio que muestra los productos más vendidos.	resources/js/pages/home/MasVendidos.vue
encantar	Enchant / Delight	Sección de marketing de la página de inicio.	resources/js/pages/home/Encantar.vue
intereses	Interests	Sección de la página de inicio para los intereses/preferencias del cliente.	resources/js/pages/home/Intereses.vue
pedidos	Orders	Sección del portal del aliado para gestionar los pedidos entrantes de los clientes.	resources/js/pages/ally/pedidos/Page.vue, ruta aliado.pedidos.render
ventas	Sales	Sección del portal del aliado para gestionar las ventas.	resources/js/pages/ally/ventas/, rutas aliado.ventas.*
postulacion / postulaciones	Application(s)	Gestión de solicitudes de aliado (portal del aliado).	resources/js/pages/ally/postulaciones/Page.vue
revision	Review	Cola de revisión/aprobación para productos y solicitudes de aliado.	resources/js/pages/ally/productos/Revision.vue, ruta aliado.productos.revision
listado	List / Listing	Páginas de vista de lista en el portal del aliado (término genérico).	Rutas aliado.*.render (todas renderizan /listado)
crear / agregar	Create / Add	Acciones para crear una nueva entidad.	resources/js/pages/ally/ventas/create/, aliado.productos.crear
reporte comercial	Commercial Report	Reporte de ventas para los aliados.	Ruta aliado.ventas.reporte-comercial
estadisticas	Statistics	Tablero de estadísticas de ventas para los aliados.	Ruta aliado.ventas.estadisticas
resumen	Summary	Vista de resumen del tablero.	Ruta aliado.dashboard.resumen
rendimiento	Performance	Métricas de rendimiento del tablero.	Ruta aliado.dashboard.rendimiento
resultados	Results	Página de resultados de búsqueda de productos.	Prefijo de ruta resultados, ruta productos.search
contacto	Contact	Formulario de contacto/soporte.	Ruta contacto.store
lista deseos vista	Wishlist View	Página de lista de deseos para usuarios autenticados.	Ruta lista-deseos.view

---

21. Nombres de Middleware (en Español)

Alias del Middleware	Significado en Inglés	Contexto de Negocio	Dónde se Usa
cliente_registro_completo	Customer Registration Complete	Asegura que el cliente haya finalizado el registro completo antes del checkout.	bootstrap/app.php, ruta de checkout
consultar_cupo_cliente	Query Customer Credit	Carga/refresca la información de crédito del cliente en la página de inicio.	bootstrap/app.php, ruta de home
verificar_cliente_presenta_mora	Verify Customer Has Delinquency	Bloquea el checkout si el cliente tiene cuotas vencidas. Falla en modo abierto en caso de excepción.	bootstrap/app.php, ruta de checkout
check_intentos_limite_diarios	Check Daily Attempt Limit	Limita los intentos de aprobación de crédito a 2 por día.	bootstrap/app.php, rutas de aprobación de cupo

---

22. Términos Legales / de Validación

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
vigente	Valid / Current	Estado del documento que debe ser VIGENTE para pasar la verificación legal (TransUnion).	LegalCheckService
hallazgos legales	Legal Findings	Coincidencias encontradas en listas legales restringidas (p. ej., sanciones, lavado de dinero).	LegalCheckService
acepta terminos condiciones / acepta_terminos_condiciones	Accepts Terms and Conditions	Indica si el cliente aceptó los términos y condiciones durante el registro.	clientes.acepta_terminos_condiciones
acepta cobro factura / acepta_cobro_factura	Accepts Invoice Billing	Indica si el cliente aceptó que se le cobre a través de su factura de servicios públicos.	clientes.acepta_cobro_factura
estado cuenta / estado_cuenta	Account Status	Campo JSON que almacena la información del estado de cuenta del cliente.	clientes.estado_cuenta
vcard	vCard	Datos de la tarjeta de contacto del cliente.	clientes.vcard
similitud de direcciones	Address Similarity	Coincidencia difusa entre la dirección enviada por el cliente y la dirección de EMCALI (umbral por defecto: 70%).	ClienteService::validarSimilitudDeDirecciones()
porcentaje minimo similitud direccion	Minimum Address Similarity Percentage	Umbral de configuración para la coincidencia de direcciones.	config('app.porcentaje_minimo_similitud_direccion')

---

23. Términos Misceláneos / de Infraestructura

Término en Español	Traducción al Inglés	Contexto de Negocio	Dónde se Usa
modelo	Model	Clase base del modelo Eloquent que establece los nombres en español para las columnas de marca de tiempo.	app/Models/Modelo.php
facturacion	Billing	Namespace para los modelos y enums relacionados con la facturación.	app/Models/Facturacion/, app/Enum/Facturacion/
tipo descontable / tipo_descontable	Discountable Type	Columna de tipo polimórfico para las asociaciones de descuentos.	descontable_descuento.tipo_descontable
descontable id / descontable_id	Discountable ID	Columna de ID polimórfico para las asociaciones de descuentos.	descontable_descuento.descontable_id
importar empresas de CSV	Import Companies from CSV	Comando Artisan para la importación masiva de empresas desde una hoja de cálculo.	app/Console/Commands/ImportarEmpresasDeCSV.php
importar productos de CSV	Import Products from CSV	Comando Artisan para la importación masiva de productos desde una hoja de cálculo.	app/Console/Commands/ImportarProductosDeCSV.php
procesar ordenes abandonadas	Process Abandoned Orders	Job programado que marca las órdenes obsoletas (>60 min) como abandonadas.	job ProcesarOrdenesAbandonadas
generar credito de venta	Generate Sale Credit	Job encolado que crea el crédito en el sistema externo para una venta aprobada.	job GenerarCreditoDeVenta
validar pagare digital	Validate Digital Promissory Note	Job despachado en el webhook de Certicámara para manejar el resultado de la firma del pagaré.	job ValidarPagareDigital
procesar pagare digital	Process Digital Promissory Note	Job que genera las cuotas y despacha la creación del crédito para cada orden pendiente.	job ProcesarPagareDigital
masivos	Bulk / Mass	Operaciones masivas (p. ej., carga masiva de productos).	Ruta aliado.productos.carga-masiva