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>
72 lines
2.7 KiB
Python
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)
|