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