Files
CRM_AGENTES_CARGA/backend/api/v1/modules/fin/issuer/models.py
Jair Cedillo 6e208876f7 feat(fin): timbrado de CFDI 4.0 de ingreso con Comercio Digital
Cierra el ciclo de la factura: construcción del comprobante, sellado con el CSD de la
empresa emisora y transmisión al PAC.

- cfdi_builder: XML 4.0 de ingreso en el orden de atributos del XSD, del que depende la
  cadena original y con ella el sello. Todo el dinero con Decimal.
- sealer: cadena original vía el XSLT oficial del SAT y firma con la llave del CSD.
- pac_comercio_digital: cliente de timbrarV5. Conserva el código y el saldo de folios que
  el legado leía en una variable que descartaba (CFDI.cs:19324-19336).
- csd_service y core/crypto: CSD por empresa, con la contraseña cifrada en la base. Antes
  el certificado había que dejarlo a mano en el almacenamiento y su contraseña era una
  variable de entorno global, lo que no funciona con varias empresas emisoras.
- Cada intento —también los rechazados— guarda el XML que se transmitió y el que contestó
  el PAC: sin ese par no hay forma de reconstruir un rechazo cuando termina la petición.

La declaración XML se escribe a mano con comillas dobles. lxml la emite con comillas
simples, que es XML válido, pero Comercio Digital compara la cadena literal version="1.0"
y responde 642 "la versión del XML no es 1.0".

El modo (pruebas o producción) sale de invoices.stamping_mode y no se puede pasar por la
API: es lo único que separa un timbre de prueba de un CFDI con validez fiscal.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-11 09:07:05 -05:00

58 lines
2.7 KiB
Python

"""Datos fiscales del emisor — ``fin.issuer_settings``.
Es la identidad fiscal con la que la empresa emite CFDI: razón social, RFC, régimen
fiscal y código postal del lugar de expedición. Hay **una sola configuración vigente
por empresa**, garantizada con un índice único parcial.
"""
from datetime import datetime
from sqlalchemy import DateTime, ForeignKey, Index, Integer, String, Text, text
from sqlalchemy.orm import Mapped, mapped_column, relationship
from api.v1.common.base_models import TenantScopedMixin, TimestampMixin
from core.database import Base
from ..catalogs.models import TaxRegime # noqa: F401 (resuelve la relación)
_ALIVE = text("deleted_at IS NULL")
class IssuerSettings(Base, TenantScopedMixin, TimestampMixin):
"""Configuración fiscal del emisor de la empresa."""
__tablename__ = "issuer_settings"
__table_args__ = (
Index(
"uq_fin_issuer_settings_company",
"tenant_id", "company_id",
unique=True, postgresql_where=_ALIVE, sqlite_where=_ALIVE,
),
{"schema": "fin"},
)
id: Mapped[int] = mapped_column(Integer, primary_key=True, index=True)
legal_name: Mapped[str] = mapped_column(String(255), nullable=False) # razón social
rfc: Mapped[str] = mapped_column(String(13), nullable=False)
tax_regime_id: Mapped[int] = mapped_column(
Integer, ForeignKey("sat.tax_regimes.id"), nullable=False, index=True
)
# CP del lugar de expedición del comprobante
zip_code: Mapped[str | None] = mapped_column(String(5), nullable=True)
updated_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
# ----- CSD (Certificado de Sello Digital) de la empresa -----
# Los archivos viven en MinIO; aquí sólo su clave. El .key es material con el que se puede
# firmar a nombre de la empresa: no se expone nunca por la API, ni siquiera su contenido en
# base64. Sólo se sube y se usa del lado del servidor.
csd_cer_file_key: Mapped[str | None] = mapped_column(String(512), nullable=True)
csd_key_file_key: Mapped[str | None] = mapped_column(String(512), nullable=True)
# Contraseña de la llave privada, cifrada con la clave maestra del entorno (core.crypto).
# Nunca se devuelve en una respuesta; sólo se sabe si está puesta o no.
csd_password_enc: Mapped[str | None] = mapped_column(Text, nullable=True)
# Informativo, para mostrar en la pantalla qué certificado está cargado.
csd_cert_number: Mapped[str | None] = mapped_column(String(20), nullable=True)
csd_uploaded_at: Mapped[datetime | None] = mapped_column(DateTime, nullable=True)
tax_regime: Mapped["TaxRegime"] = relationship("TaxRegime", lazy="selectin")