Sage100-ws/utils/documents/validations.py

272 lines
8.8 KiB
Python

from typing import Dict
import win32com.client
import logging
logger = logging.getLogger(__name__)
# ============================================================
# FONCTIONS SQL (LECTURE)
# ============================================================
def get_statut_validation(connector, numero_facture: str) -> Dict:
"""
Retourne le statut de validation d'une facture (SQL)
"""
with connector._get_sql_connection() as conn:
cursor = conn.cursor()
cursor.execute(
"""
SELECT
DO_Valide, DO_Statut, DO_TotalHT, DO_TotalTTC,
DO_MontantRegle, CT_NumPayeur, DO_Date, DO_Ref
FROM F_DOCENTETE
WHERE DO_Piece = ? AND DO_Type = 6
""",
(numero_facture,),
)
row = cursor.fetchone()
if not row:
raise ValueError(f"Facture {numero_facture} introuvable")
valide = int(row[0]) if row[0] is not None else 0
statut = int(row[1]) if row[1] is not None else 0
total_ht = float(row[2]) if row[2] else 0.0
total_ttc = float(row[3]) if row[3] else 0.0
montant_regle = float(row[4]) if row[4] else 0.0
client_code = row[5].strip() if row[5] else ""
date_facture = row[6]
reference = row[7].strip() if row[7] else ""
solde = max(0.0, total_ttc - montant_regle)
return {
"numero_facture": numero_facture,
"est_validee": valide == 1,
"statut": statut,
"statut_libelle": _get_statut_libelle(statut),
"peut_etre_modifiee": valide == 0 and statut not in (5, 6),
"peut_etre_devalidee": valide == 1
and montant_regle < 0.01
and statut not in (5, 6),
"total_ht": total_ht,
"total_ttc": total_ttc,
"montant_regle": montant_regle,
"solde_restant": solde,
"client_code": client_code,
"date_facture": date_facture.strftime("%Y-%m-%d") if date_facture else None,
"reference": reference,
}
def _get_facture_info_sql(connector, numero_facture: str) -> Dict:
"""
Récupère les infos d'une facture via SQL (pour vérifications préalables)
"""
with connector._get_sql_connection() as conn:
cursor = conn.cursor()
cursor.execute(
"""
SELECT
DO_Valide, DO_Statut, DO_TotalHT, DO_TotalTTC,
ISNULL((SELECT SUM(DR_MontantRegle) FROM F_REGLECH
WHERE DO_Piece = d.DO_Piece AND DO_Type = 6), 0) as MontantRegle,
CT_NumPayeur
FROM F_DOCENTETE d
WHERE DO_Piece = ? AND DO_Type = 6
""",
(numero_facture,),
)
row = cursor.fetchone()
if not row:
return None
return {
"valide": int(row[0]) if row[0] is not None else 0,
"statut": int(row[1]) if row[1] is not None else 0,
"total_ht": float(row[2]) if row[2] else 0.0,
"total_ttc": float(row[3]) if row[3] else 0.0,
"montant_regle": float(row[4]) if row[4] else 0.0,
"client_code": row[5].strip() if row[5] else "",
}
def valider_facture(connector, numero_facture: str) -> Dict:
if not connector.cial:
raise RuntimeError("Connexion Sage non établie")
logger.info(f"🔒 Validation facture {numero_facture}")
# 1. Vérifications préalables via SQL
info = _get_facture_info_sql(connector, numero_facture)
if not info:
raise ValueError(f"Facture {numero_facture} introuvable")
if info["statut"] == 6:
raise ValueError(f"Facture {numero_facture} annulée, validation impossible")
if info["valide"] == 1:
logger.info(f"Facture {numero_facture} déjà validée")
return _build_response_sql(
connector, numero_facture, deja_valide=True, action="validation"
)
# 2. Modification via COM
try:
with connector._com_context(), connector._lock_com:
factory = connector.cial.FactoryDocumentVente
persist = factory.ReadPiece(60, numero_facture)
if not persist:
raise ValueError(f"Impossible de lire la facture {numero_facture}")
doc = win32com.client.CastTo(persist, "IBODocumentVente3")
doc.Read()
doc.DO_Valide = 1
doc.Write()
logger.info(f"✅ Facture {numero_facture} validée")
except ValueError:
raise
except Exception as e:
logger.error(f"❌ Erreur COM validation {numero_facture}: {e}", exc_info=True)
raise RuntimeError(f"Échec validation: {str(e)}")
# 3. Vérification et réponse via SQL
info_apres = _get_facture_info_sql(connector, numero_facture)
if info_apres and info_apres["valide"] != 1:
raise RuntimeError("Échec validation: DO_Valide non modifié")
return _build_response_sql(
connector, numero_facture, deja_valide=False, action="validation"
)
def devalider_facture(connector, numero_facture: str) -> Dict:
"""
Dévalide une facture (retire le cadenas)
- Vérifications: SQL
- Modification DO_Valide: COM
- Réponse: SQL
"""
if not connector.cial:
raise RuntimeError("Connexion Sage non établie")
logger.info(f"🔓 Dévalidation facture {numero_facture}")
# 1. Vérifications préalables via SQL
info = _get_facture_info_sql(connector, numero_facture)
if not info:
raise ValueError(f"Facture {numero_facture} introuvable")
if info["statut"] == 6:
raise ValueError(f"Facture {numero_facture} annulée")
if info["statut"] == 5:
raise ValueError(
f"Facture {numero_facture} transformée, dévalidation impossible"
)
if info["montant_regle"] > 0.01:
raise ValueError(
f"Facture {numero_facture} partiellement réglée ({info['montant_regle']:.2f}€), "
"dévalidation impossible"
)
if info["valide"] == 0:
logger.info(f"Facture {numero_facture} déjà non validée")
return _build_response_sql(
connector, numero_facture, deja_valide=True, action="devalidation"
)
# 2. Modification via COM
try:
with connector._com_context(), connector._lock_com:
factory = connector.cial.FactoryDocumentVente
persist = factory.ReadPiece(60, numero_facture)
if not persist:
raise ValueError(f"Impossible de lire la facture {numero_facture}")
doc = win32com.client.CastTo(persist, "IBODocumentVente3")
doc.Read()
doc.DO_Valide = 0
doc.Write()
logger.info(f"✅ Facture {numero_facture} dévalidée")
except ValueError:
raise
except Exception as e:
logger.error(f"❌ Erreur COM dévalidation {numero_facture}: {e}", exc_info=True)
raise RuntimeError(f"Échec dévalidation: {str(e)}")
# 3. Vérification et réponse via SQL
info_apres = _get_facture_info_sql(connector, numero_facture)
if info_apres and info_apres["valide"] != 0:
raise RuntimeError("Échec dévalidation: DO_Valide non modifié")
return _build_response_sql(
connector, numero_facture, deja_valide=False, action="devalidation"
)
# ============================================================
# FONCTIONS UTILITAIRES
# ============================================================
def _build_response_sql(
connector, numero_facture: str, deja_valide: bool, action: str
) -> Dict:
"""Construit la réponse via SQL (pas COM)"""
info = _get_facture_info_sql(connector, numero_facture)
if action == "validation":
message = (
"Facture déjà validée" if deja_valide else "Facture validée avec succès"
)
else:
message = (
"Facture déjà non validée"
if deja_valide
else "Facture dévalidée avec succès"
)
return {
"numero_facture": numero_facture,
"est_validee": info["valide"] == 1 if info else False,
"statut": info["statut"] if info else 0,
"statut_libelle": _get_statut_libelle(info["statut"]) if info else "Inconnu",
"total_ht": info["total_ht"] if info else 0.0,
"total_ttc": info["total_ttc"] if info else 0.0,
"client_code": info["client_code"] if info else "",
"message": message,
"action_effectuee": not deja_valide,
}
def _get_statut_libelle(statut: int) -> str:
"""Retourne le libellé d'un statut de document"""
statuts = {
0: "Brouillon",
1: "Confirmé",
2: "En cours",
3: "Imprimé",
4: "Suspendu",
5: "Transformé",
6: "Annulé",
}
return statuts.get(statut, f"Statut {statut}")
__all__ = [
"valider_facture",
"devalider_facture",
"get_statut_validation",
]