Saltar a contenido

TrxCobroCampoImputacion — fuerza_ventas.trx_cobros_campo_imputaciones

Desglose de amortizaciones e imputaciones aplicadas por cada cobro en campo hacia facturas pendientes de cobro u órdenes de cobranza vinculadas.

from datetime import datetime
from typing import Optional
import uuid

from sqlalchemy import (
    BigInteger,
    Boolean,
    ForeignKeyConstraint,
    Index,
    Numeric,
    UniqueConstraint,
    text,
)
from sqlalchemy.dialects.postgresql import TIMESTAMP, UUID
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, relationship


class Base(DeclarativeBase):
    pass


class TrxCobroCampoImputacion(Base):
    __tablename__ = "trx_cobros_campo_imputaciones"
    __table_args__ = (
        UniqueConstraint(
            "empresa_id",
            "id",
            name="uq_trx_cobros_campo_imp_empresa_id",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "cobro_campo_id"],
            ["fuerza_ventas.trx_cobros_campo.empresa_id", "fuerza_ventas.trx_cobros_campo.id"],
            ondelete="CASCADE",
            name="fk_trx_cobros_campo_imp_cobro",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "aviso_cobro_id"],
            ["fuerza_ventas.trx_avisos_cobro.empresa_id", "fuerza_ventas.trx_avisos_cobro.id"],
            ondelete="RESTRICT",
            name="fk_trx_cobros_campo_imp_aviso",
        ),
        Index(
            "ix_trx_cobros_imp_empresa_cobro",
            "empresa_id",
            "cobro_campo_id",
        ),
        Index(
            "ix_trx_cobros_imp_empresa_factura",
            "empresa_id",
            "factura_erp_id",
        ),
        Index(
            "ix_trx_cobros_imp_empresa_aviso",
            "empresa_id",
            "aviso_cobro_id",
        ),
        Index(
            "ix_trx_cobros_imp_empresa_activo",
            "empresa_id",
            "is_activo",
        ),
        {"schema": "fuerza_ventas"},
    )

    # Identificadores y Claves
    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        primary_key=True,
        server_default=text("gen_random_uuid()"),
        comment="Identificador único UUID",
    )

    empresa_id: Mapped[int] = mapped_column(
        BigInteger,
        nullable=False,
        comment="Identificador BIGINT de la empresa en core.identidad (RLS)",
    )

    cobro_campo_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Cabecera del cobro en campo asociado",
    )

    factura_erp_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Identificador de la factura en fuerza_ventas.doc_facturas",
    )

    aviso_cobro_id: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Referencia a fuerza_ventas.trx_avisos_cobro (FK compuesta por empresa_id)",
    )

    # Importes Financieros
    monto_imputado: Mapped[float] = mapped_column(
        Numeric(12, 2),
        nullable=False,
        comment="Monto monetario amortizado a la factura",
    )

    monto_saldo_anterior: Mapped[float] = mapped_column(
        Numeric(12, 2),
        nullable=False,
        comment="Saldo exigible de la factura previo a la imputación",
    )

    monto_saldo_posterior: Mapped[float] = mapped_column(
        Numeric(12, 2),
        nullable=False,
        comment="Saldo exigible resultante de la factura tras la imputación",
    )

    # Auditoría General
    is_activo: Mapped[bool] = mapped_column(
        Boolean,
        nullable=False,
        server_default=text("true"),
        comment="Estado lógico del registro",
    )

    created_at: Mapped[datetime] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=False,
        server_default=text("now()"),
        comment="Fecha de creación",
    )

    updated_at: Mapped[datetime] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=False,
        server_default=text("now()"),
        onupdate=datetime.utcnow,
        comment="Fecha de última actualización",
    )

    deleted_at: Mapped[Optional[datetime]] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=True,
        comment="Fecha de eliminación lógica",
    )

    created_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario creador",
    )

    updated_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario modificador",
    )