Cliente — clientes.mae_clientes¶
Identidad comercial y fiscal básica del cliente.
"""``clientes.mae_clientes``: identidad comercial y fiscal básica del cliente."""
import uuid
from datetime import date
from sqlalchemy import BigInteger, Date, ForeignKeyConstraint, Index, String, UniqueConstraint, text
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import Mapped, mapped_column
from app.db.base import Base
from app.models.mixins import AuditMixin
class Cliente(AuditMixin, Base):
__tablename__ = "mae_clientes"
__table_args__ = (
UniqueConstraint("empresa_id", "id", name="uq_mae_clientes_empresa_id"),
UniqueConstraint(
"empresa_id", "codigo", name="uq_mae_clientes_empresa_codigo"
),
UniqueConstraint(
"empresa_id",
"tipo_identificacion_id",
"numero_documento",
name="uq_mae_clientes_empresa_documento",
),
ForeignKeyConstraint(
["empresa_id", "tipo_cliente_id"],
[
"clientes.cat_tipos_clientes.empresa_id",
"clientes.cat_tipos_clientes.id",
],
name="fk_mae_clientes_tipo_cliente",
),
ForeignKeyConstraint(
["empresa_id", "tipo_canal_id"],
[
"clientes.cat_tipos_canal_comercial.empresa_id",
"clientes.cat_tipos_canal_comercial.id",
],
name="fk_mae_clientes_tipo_canal",
),
ForeignKeyConstraint(
["empresa_id", "clase_cliente_id"],
[
"clientes.cat_clases_cliente.empresa_id",
"clientes.cat_clases_cliente.id",
],
name="fk_mae_clientes_clase",
),
ForeignKeyConstraint(
["empresa_id", "modelo_comercial_id"],
[
"clientes.cat_modelos_comerciales.empresa_id",
"clientes.cat_modelos_comerciales.id",
],
name="fk_mae_clientes_modelo",
),
ForeignKeyConstraint(
["empresa_id", "grupo_economico_id"],
[
"clientes.mae_grupos_economicos.empresa_id",
"clientes.mae_grupos_economicos.id",
],
name="fk_mae_clientes_grupo_economico",
),
ForeignKeyConstraint(
["empresa_id", "unidad_comercial_id"],
[
"clientes.cat_unidades_comerciales.empresa_id",
"clientes.cat_unidades_comerciales.id",
],
name="fk_mae_clientes_unidad_comercial",
),
ForeignKeyConstraint(
["empresa_id", "termino_pago_id"],
[
"clientes.cat_terminos_pago.empresa_id",
"clientes.cat_terminos_pago.id",
],
name="fk_mae_clientes_termino_pago",
),
# Referencia circular con rel_clientes_contactos: solo puede crearse
# una vez que esa tabla exista, por lo que se declara con
# use_alter=True (ALTER TABLE ... ADD CONSTRAINT posterior), igual
# que en el script SQL de rel_clientes_contactos.md.
ForeignKeyConstraint(
["empresa_id", "id", "contacto_principal_id"],
[
"clientes.rel_clientes_contactos.empresa_id",
"clientes.rel_clientes_contactos.cliente_id",
"clientes.rel_clientes_contactos.contacto_id",
],
name="fk_mae_clientes_contacto_principal",
use_alter=True,
),
Index("ix_mae_clientes_empresa_tipo_canal", "empresa_id", "tipo_canal_id"),
Index("ix_mae_clientes_empresa_clase", "empresa_id", "clase_cliente_id"),
Index(
"ix_mae_clientes_empresa_grupo_economico",
"empresa_id",
"grupo_economico_id",
),
Index(
"ix_mae_clientes_empresa_unidad_comercial",
"empresa_id",
"unidad_comercial_id",
),
Index(
"ix_mae_clientes_empresa_termino_pago",
"empresa_id",
"termino_pago_id",
),
{"schema": "clientes"},
)
id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True),
primary_key=True,
server_default=text("gen_random_uuid()"),
)
empresa_id: Mapped[int] = mapped_column(BigInteger, nullable=False)
codigo: Mapped[str] = mapped_column(String(30), nullable=False)
razon_social: Mapped[str] = mapped_column(String(200), nullable=False)
nombre_comercial: Mapped[str | None] = mapped_column(String(200), nullable=True)
tipo_identificacion_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), nullable=False
)
numero_documento: Mapped[str] = mapped_column(String(30), nullable=False)
tipo_cliente_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), nullable=False
)
tipo_canal_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True), nullable=False
)
clase_cliente_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
modelo_comercial_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
grupo_economico_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
unidad_comercial_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
termino_pago_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
contacto_principal_id: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True), nullable=True
)
fecha_registro: Mapped[date] = mapped_column(Date, nullable=False)