TrxPedidos — fuerza_ventas.trx_pedidos¶
Órdenes de Pedido de Ventas (Cabecera ERP).
import uuid
from datetime import date, datetime
from decimal import Decimal
from typing import Optional
from sqlalchemy import (
BigInteger,
ForeignKeyConstraint,
Boolean,
Date,
Index,
Numeric,
String,
Text,
UniqueConstraint,
text,
)
from sqlalchemy.dialects.postgresql import TIMESTAMP, UUID
from sqlalchemy.orm import Mapped, mapped_column
from app.db.base import Base
class TrxPedidos(Base):
"""
Órdenes de Pedido de Ventas (Cabecera ERP).
Cabecera de pedidos generados desde la aplicación móvil de promotores
hacia el dominio de pedidos del ERP. Aplica integración desacoplada
mediante UUIDs de correlación hacia CRM y Core.
Legacy:
c067t_pedido (42 col)
"""
__tablename__ = "trx_pedidos"
__table_args__ = (
UniqueConstraint(
"empresa_id",
"id",
name="uq_trx_pedidos_empresa_id",
),
UniqueConstraint(
"empresa_id",
"numero_pedido",
name="uq_trx_pedidos_empresa_numero",
),
ForeignKeyConstraint(
["empresa_id", "promotor_id"],
["fuerza_ventas.mae_promotores.empresa_id", "fuerza_ventas.mae_promotores.id"],
ondelete="RESTRICT",
name="fk_trx_pedidos_promotor",
),
ForeignKeyConstraint(
["empresa_id", "visita_id"],
["fuerza_ventas.trx_visitas.empresa_id", "fuerza_ventas.trx_visitas.id"],
ondelete="RESTRICT",
name="fk_trx_pedidos_visita",
),
Index(
"ix_trx_pedidos_empresa_activo",
"empresa_id",
"is_activo",
),
Index(
"ix_trx_pedidos_empresa_cliente_fecha",
"empresa_id",
"cliente_id",
"fecha_pedido",
),
Index(
"ix_trx_pedidos_empresa_promotor_fecha",
"empresa_id",
"promotor_id",
"fecha_pedido",
),
Index(
"ix_trx_pedidos_empresa_estado",
"empresa_id",
"estado_pedido",
),
{
"schema": "fuerza_ventas",
"comment": "Órdenes de Pedido de Ventas (Cabecera ERP)",
},
)
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 física)",
)
local_entrega_id: Mapped[Optional[uuid.UUID]] = mapped_column(
UUID(as_uuid=True),
nullable=True,
comment="Correlación lógica con crm.clientes.mae_locales_cliente (sin FK física)",
)
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)",
)
sucursal_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True),
nullable=False,
comment="Correlación lógica con core.identidad.mae_sucursales (sin FK física)",
)
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)",
)
numero_pedido: Mapped[str] = mapped_column(
String(30),
nullable=False,
comment="Número correlativo comercial del pedido",
)
fecha_pedido: Mapped[datetime] = mapped_column(
TIMESTAMP(timezone=True),
nullable=False,
server_default=text("now()"),
comment="Fecha y hora de emisión",
)
fecha_entrega_estimada: Mapped[date] = mapped_column(
Date,
nullable=False,
comment="Fecha comprometida de despacho",
)
canal_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True),
nullable=False,
comment="Correlación lógica con crm.clientes.cat_canales_comerciales",
)
termino_pago_id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True),
nullable=False,
comment="Correlación lógica con crm.clientes.cat_terminos_pago",
)
tipo_envio_id: Mapped[Optional[uuid.UUID]] = mapped_column(
UUID(as_uuid=True),
nullable=True,
comment="Correlación lógica con crm.clientes.cat_tipos_envio",
)
monto_subtotal: Mapped[Decimal] = mapped_column(
Numeric(12, 2),
nullable=False,
server_default=text("0.00"),
comment="Subtotal antes de descuentos e impuestos",
)
monto_descuento: Mapped[Decimal] = mapped_column(
Numeric(12, 2),
nullable=False,
server_default=text("0.00"),
comment="Descuento comercial global",
)
monto_impuestos: Mapped[Decimal] = mapped_column(
Numeric(12, 2),
nullable=False,
server_default=text("0.00"),
comment="Total de tributos (IVA)",
)
monto_total: Mapped[Decimal] = mapped_column(
Numeric(12, 2),
nullable=False,
server_default=text("0.00"),
comment="Monto neto final del pedido",
)
estado_pedido: Mapped[str] = mapped_column(
String(30),
nullable=False,
server_default=text("'BORRADOR'"),
comment="BORRADOR, ENVIADO, APROBADO_CREDITO, FACTURADO, DESPACHADO, ENTREGADO, CANCELADO",
)
observaciones: Mapped[Optional[str]] = mapped_column(
Text,
nullable=True,
comment="Instrucciones de entrega o notas comerciales",
)
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()"),
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",
)