Files
CRM_AGENTES_CARGA/backend/api/v1/modules/fin/issuer/dto.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

72 lines
2.7 KiB
Python

"""Esquemas de los datos fiscales del emisor."""
import re
from datetime import datetime
from pydantic import BaseModel, ConfigDict, computed_field, Field, field_validator
from ..catalogs.dto import TaxRegimeResponse
# RFC de persona moral (3 letras) o física (4 letras) + fecha + homoclave.
RFC_PATTERN = re.compile(r"^[A-ZÑ&]{3,4}\d{6}[A-Z0-9]{3}$")
ZIP_PATTERN = re.compile(r"^\d{5}$")
class IssuerSettingsInput(BaseModel):
"""Alta o actualización de los datos fiscales del emisor."""
legal_name: str = Field(..., min_length=1, max_length=255, description="Razón social")
rfc: str = Field(..., max_length=13, description="RFC del emisor")
tax_regime_id: int = Field(..., description="Régimen fiscal (c_RegimenFiscal)")
zip_code: str | None = Field(None, max_length=5, description="CP del lugar de expedición")
# mode="before": la normalización corre antes que el max_length del campo, para que
# un RFC con espacios de sobra no se rechace por longitud antes de limpiarlo.
@field_validator("rfc", mode="before")
@classmethod
def _validate_rfc(cls, value: str) -> str:
"""Normaliza a mayúsculas sin espacios y valida el formato oficial del RFC."""
if not isinstance(value, str):
raise ValueError("El RFC debe ser texto")
normalized = value.replace(" ", "").replace("-", "").upper()
if not RFC_PATTERN.match(normalized):
raise ValueError("El RFC no tiene un formato válido (ej. XAXX010101000)")
return normalized
@field_validator("zip_code")
@classmethod
def _validate_zip(cls, value: str | None) -> str | None:
if value is None or value == "":
return None
normalized = value.strip()
if not ZIP_PATTERN.match(normalized):
raise ValueError("El código postal debe tener 5 dígitos")
return normalized
class IssuerSettingsResponse(BaseModel):
model_config = ConfigDict(from_attributes=True)
id: int
tenant_id: int
company_id: int
legal_name: str
rfc: str
tax_regime_id: int
tax_regime: TaxRegimeResponse | None = None
zip_code: str | None = None
updated_by: str | None = None
created_at: datetime
updated_at: datetime
# ----- Estado del CSD -----
# Se expone SI hay certificado cargado y cuál, nunca su contenido ni la contraseña: con el
# .key se puede firmar a nombre de la empresa ante el SAT.
csd_cert_number: str | None = None
csd_uploaded_at: datetime | None = None
@computed_field
@property
def has_csd(self) -> bool:
"""Hay par de archivos y contraseña guardados, o sea que ya se puede timbrar."""
return bool(self.csd_cert_number and self.csd_uploaded_at)