Saltar a contenido

TrxCobroCampo — fuerza_ventas.trx_cobros_campo

Registro de cobros y recaudaciones comerciales efectuadas directamente en campo por promotores o cobradores móviles. Conecta los ingresos recibidos en ruta con el módulo de tesorería y contabilidad del ERP.

from datetime import datetime
from typing import Optional
import uuid

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


class Base(DeclarativeBase):
    pass


class TrxCobroCampo(Base):
    __tablename__ = "trx_cobros_campo"
    __table_args__ = (
        UniqueConstraint(
            "empresa_id",
            "id",
            name="uq_trx_cobros_campo_empresa_id",
        ),
        UniqueConstraint(
            "empresa_id",
            "numero_recibo_campo",
            name="uq_trx_cobros_campo_empresa_recibo",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "metodo_pago_id"],
            ["fuerza_ventas.cat_metodos_pago.empresa_id", "fuerza_ventas.cat_metodos_pago.id"],
            ondelete="RESTRICT",
            name="fk_trx_cobros_campo_metodo",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "estado_cobro_id"],
            ["fuerza_ventas.cat_estados_cobro.empresa_id", "fuerza_ventas.cat_estados_cobro.id"],
            ondelete="RESTRICT",
            name="fk_trx_cobros_campo_estado",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "promotor_id"],
            ["fuerza_ventas.mae_promotores.empresa_id", "fuerza_ventas.mae_promotores.id"],
            ondelete="RESTRICT",
            name="fk_trx_cobros_campo_promotor",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "visita_id"],
            ["fuerza_ventas.trx_visitas.empresa_id", "fuerza_ventas.trx_visitas.id"],
            ondelete="RESTRICT",
            name="fk_trx_cobros_campo_visita",
        ),
        Index(
            "ix_trx_cobros_campo_empresa_cliente",
            "empresa_id",
            "cliente_id",
        ),
        Index(
            "ix_trx_cobros_campo_empresa_promotor",
            "empresa_id",
            "promotor_id",
        ),
        Index(
            "ix_trx_cobros_campo_empresa_visita",
            "empresa_id",
            "visita_id",
        ),
        Index(
            "ix_trx_cobros_campo_empresa_metodo",
            "empresa_id",
            "metodo_pago_id",
        ),
        Index(
            "ix_trx_cobros_campo_empresa_banco",
            "empresa_id",
            "banco_id",
        ),
        Index(
            "ix_trx_cobros_campo_empresa_estado",
            "empresa_id",
            "estado_cobro_id",
        ),
        Index(
            "ix_trx_cobros_campo_empresa_fecha",
            "empresa_id",
            "fecha_cobro",
        ),
        Index(
            "ix_trx_cobros_campo_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)",
    )

    cliente_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Correlación lógica con crm.clientes.mae_clientes (sin FK cross-DB)",
    )

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

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

    metodo_pago_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Identificador del método de pago (FK cat_metodos_pago)",
    )

    banco_id: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Identificador del banco emisor/receptor (Correlación lógica con core.identidad.cat_bancos)",
    )

    estado_cobro_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Identificador del estado de cobro (FK cat_estados_cobro)",
    )

    # Campos de Negocio
    numero_recibo_campo: Mapped[str] = mapped_column(
        String(30),
        nullable=False,
        comment="Número correlativo único del recibo móvil",
    )

    fecha_cobro: Mapped[datetime] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=False,
        server_default=text("now()"),
        comment="Fecha y hora del cobro en campo",
    )

    monto_total_recaudado: Mapped[float] = mapped_column(
        Numeric(12, 2),
        nullable=False,
        comment="Monto total monetario recaudado",
    )

    numero_documento_pago: Mapped[Optional[str]] = mapped_column(
        String(50),
        nullable=True,
        comment="Número de cheque o transferencia",
    )

    comprobante_imagen_url: Mapped[Optional[str]] = mapped_column(
        String(500),
        nullable=True,
        comment="URL del comprobante fotográfico",
    )

    latitud_cobro: Mapped[Optional[float]] = mapped_column(
        Float,
        nullable=True,
        comment="Latitud GPS de la recaudación",
    )

    longitud_cobro: Mapped[Optional[float]] = mapped_column(
        Float,
        nullable=True,
        comment="Longitud GPS de la recaudación",
    )

    observaciones: Mapped[Optional[str]] = mapped_column(
        Text,
        nullable=True,
        comment="Comentarios u observaciones de cobranza",
    )

    # 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",
    )