pySwivells 1.0.2__py3-none-any.whl

pySwivells/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.2"

pySwivells/accounting/__init__.py

@@ -0,0 +1,3 @@
+from .tags import read_tags
+from .cleaning import clean_sales
+from .reconciliation import reconcile

pySwivells/accounting/cleaning.py

@@ -0,0 +1,150 @@
+import pandas as pd
+import math
+import numpy as np
+import pickle
+import os
+
+from pySwivells import iomix
+from pySwivells.accounting.tva import TVA_RATES
+
+
+def nullify(row):
+    for col in [
+        "Ventes brutes",
+        "Réductions",
+        "Retours",
+        "Ventes nettes",
+        "Frais d’expédition",
+        "Taxes",
+        "Ventes totales",
+    ]:
+        row[col] = 0
+
+
+RULES = [
+    {
+        "tag": "lesbienfaiteurs",
+        "comment": "Vente les bien faiteurs",
+        "action": nullify,
+    },
+    {"tag": "Etsy", "comment": "Commande Etsy", "action": lambda r: r},
+]
+
+
+def __load_tags():
+    if not os.path.exists("tags.pkl"):
+        iomix.warning("Aucun fichier de balises trouvé.")
+        rep = iomix.yes_or_no("Voulez-vous continuer sans balises ?")
+        if rep is False:
+            iomix.log("Opération terminée par l'utilisateur.")
+            iomix.log(
+                "Veuillez d'abord exécuter 'pyswivells compta tags <FICHIER.csv>'"
+            )
+            exit(1)
+        else:
+            return {}
+
+    with open("tags.pkl", "rb") as f:
+        return pickle.load(f)
+
+
+def __apply_rules(df):
+    tag_map = __load_tags()
+    modified_rows = []
+    for _, row in df.iterrows():
+        order = row["Nom de la commande"]
+        tags = tag_map.get(order)
+        row["Comment"] = ""
+        if tags:
+            for rule in RULES:
+                if rule["tag"] in tags:
+                    row["Comment"] += rule["comment"] + "; "
+                    rule["action"](row)
+        modified_rows.append(row)
+
+    df = pd.DataFrame(modified_rows)
+    return df
+
+
+def __calculate_tva(df) -> float:
+    df["TVA"] = df["Pays d’expédition"].map(TVA_RATES)
+    df["Taxes calculées"] = round(
+        round(df["Ventes totales"] / (1 + df["TVA"] / 100), 2) * df["TVA"] / 100,
+        2,
+    )
+    df["Différence"] = df["Taxes"] - df["Taxes calculées"]
+    df["Erreur de TVA"] = df["Différence"].apply(
+        lambda x: "ERREUR" if abs(x) > 0.01 else ""
+    )
+
+
+def __clean_lines(df):
+    rows_to_keep = []
+    orders = df["Nom de la commande"].unique()
+    for order in orders:
+        order_df_all_days = df[df["Nom de la commande"] == order]
+        for day in order_df_all_days["Jour"].unique():
+            order_df = order_df_all_days[order_df_all_days["Jour"] == day]
+            values = list(
+                set([math.fabs(v) for v in order_df["Ventes totales"].unique()])
+            )
+            d = {v: {"+": 0, "-": 0} for v in values}
+            for _, row in order_df.iterrows():
+                sign = "+" if row["Ventes totales"] > 0 else "-"
+                d[math.fabs(row["Ventes totales"])][sign] += 1
+            for k, v in d.items():
+                if v["+"] > v["-"]:
+                    value_to_keep = float(k)
+                elif v["+"] < v["-"]:
+                    value_to_keep = -float(k)
+                else:
+                    continue
+                sub_df = order_df[
+                    order_df["Ventes totales"] == value_to_keep
+                ].reset_index(drop=True)
+                if len(sub_df) > 1:
+                    sub_df = order_df[
+                        (order_df["Ventes totales"] == value_to_keep)
+                        & (order_df["Titre de produit au moment de la vente"])
+                    ].reset_index(drop=True)
+                    if len(sub_df) > 1:
+                        counter = 0
+                        for _, r in sub_df.iterrows():
+                            counter += 1
+                            rows_to_keep.append(r)
+                            if counter == abs(v["+"] - v["-"]):
+                                break
+                    elif len(sub_df) == 1:
+                        rows_to_keep.append(sub_df.iloc[0])
+                    else:
+                        sub_df = order_df[
+                            (order_df["Ventes totales"] == value_to_keep)
+                        ].reset_index(drop=True)
+                        rows_to_keep.append(sub_df.iloc[0])
+
+                else:
+                    rows_to_keep.append(sub_df.iloc[0])
+    return pd.DataFrame(rows_to_keep)
+
+
+def clean_file(sales_file: str) -> pd.DataFrame:
+    df = pd.read_csv(sales_file)
+    df = df.replace({np.nan: None})
+    df = __apply_rules(df)
+    __calculate_tva(df)
+
+    cleaned_df = __clean_lines(df)
+    cleaned_df = cleaned_df[
+        cleaned_df["Titre de produit au moment de la vente"] != "Tote bag noir Swivells"
+    ].reset_index(drop=True)
+    return cleaned_df
+
+
+def clean_sales(sales_file: str):
+    final_df = clean_file(sales_file)
+    final_df.to_excel("Ventes-nettoyées.xlsx", index=False)
+
+
+def clean_sales_to_csv(sales_file: str, output_file: str):
+    final_df = clean_file(sales_file)
+    final_df.to_csv(output_file, index=False)

pySwivells/accounting/reconciliation.py

@@ -0,0 +1,136 @@
+import pandas as pd
+import numpy as np
+import os
+
+from pySwivells.iomix import error
+
+
+def __get_files(directory: str):
+    files = []
+    for filename in os.listdir(directory):
+        if filename.endswith(".csv") or filename.endswith(".xlsx"):
+            files.append(os.path.join(directory, filename))
+    return files
+
+
+def __get_sales():
+    if not os.path.exists("Ventes-nettoyées.xlsx"):
+        error(
+            "Le fichier 'Ventes-nettoyées.xlsx' est introuvable. Veuillez exécuter d'abord le nettoyage des ventes."
+        )
+    df = pd.read_excel("Ventes-nettoyées.xlsx")
+    df = df.replace({np.nan: None})
+    return df
+
+
+def __process_payment_file(file_path: str, payments: dict):
+    if file_path.endswith(".csv"):
+        df = pd.read_csv(file_path)
+    elif file_path.endswith(".xlsx"):
+        df = pd.read_excel(file_path)
+    else:
+        error(f"Format de fichier non pris en charge : {file_path}")
+    df = df.replace({np.nan: None})
+    payouts = df["Payout Date"].unique()
+    for payout in payouts:
+        payout_df = df[df["Payout Date"] == payout]
+        for _, row in payout_df.iterrows():
+            order = row["Order"]
+            amount = row["Amount"]
+            fee = row["Fee"]
+            net = row["Net"]
+            if order not in payments:
+                payments[order] = []
+            payments[order].append(
+                {
+                    "payout_date": payout,
+                    "amount": amount,
+                    "fee": fee,
+                    "net": net,
+                    "source_file": os.path.basename(file_path),
+                }
+            )
+
+
+def reconcile(payments_dir: str):
+    df = __get_sales()
+    df["Date du paiement"] = ""
+    df["Relevé"] = ""
+    df["CA"] = ""
+    df["SHP Payment fee"] = ""
+    df["Net reçu"] = ""
+    payment_files = __get_files(payments_dir)
+    payments = {}
+    final_df = []
+    for p in payment_files:
+        __process_payment_file(p, payments)
+    df = pd.read_excel("Ventes-nettoyées.xlsx")
+    order_without_payment = set()
+    order_to_check = set()
+    for _, row in df.iterrows():
+        row["Réconciliation"] = "✅"
+        order = row["Nom de la commande"]
+        payouts = payments.get(order, [])
+        if len(payouts) == 0:
+            row["Réconciliation"] = "❌"
+            row["Commentaire"] = "Pas de paiement trouvé"
+            order_without_payment.add(order)
+        elif len(payouts) == 1:
+            order_df = df[df["Nom de la commande"] == order]
+            total_amount = order_df["Ventes totales"].sum()
+            row["Date du paiement"] = payouts[0]["payout_date"]
+            row["Relevé"] = payouts[0]["source_file"]
+            row["CA"] = payouts[0]["amount"]
+            row["SHP Payment fee"] = payouts[0]["fee"]
+            row["Net reçu"] = payouts[0]["net"]
+            if abs(payouts[0]["amount"] - total_amount) > 0.01:
+                row["Réconciliation"] = "❌"
+                row["Commentaire"] = "Montant du paiement incorrect"
+                order_to_check.add(order)
+        else:
+            order_df = df[df["Nom de la commande"] == order]
+            for d in order_df["Jour"].unique():
+                sub_order_df = order_df[order_df["Jour"] == d]
+                total_amount = sub_order_df["Ventes totales"].sum()
+                matched = __find_matching_payment(total_amount, payouts, row)
+                if not matched:
+                    payout_df = pd.DataFrame(payouts)
+                    grouped = (
+                        payout_df.groupby("payout_date")
+                        .agg(
+                            {
+                                "amount": "sum",
+                                "fee": "sum",
+                                "net": "sum",
+                                "source_file": lambda x: ",".join(
+                                    x.unique()
+                                ),  # optional: combine unique source files
+                            }
+                        )
+                        .reset_index()
+                    )
+                    payouts = grouped.to_dict(orient="records")
+                    matched = __find_matching_payment(total_amount, payouts, row)
+                    if not matched:
+                        print("no match after grouping...")
+                        row["Réconciliation"] = "❌"
+                        row["Commentaire"] = "Montant du paiement incorrect"
+                        order_to_check.add(order)
+        final_df.append(row)
+    print(f"{len(order_without_payment)} commandes sans paiement trouvé")
+    print(f"{len(order_to_check)} commandes avec des montants à vérifier")
+    print("Fichier Excel sauvegardé sous 'Reconciliation.xlsx'")
+    final_df = pd.DataFrame(final_df)
+    final_df.to_excel("Reconciliation.xlsx", index=False)
+
+
+def __find_matching_payment(total_amount: float, payouts: list, row) -> bool:
+    for p in payouts:
+        if abs(p["amount"] - total_amount) < 0.01:
+            row["Date du paiement"] = p["payout_date"]
+            row["Relevé"] = p["source_file"]
+            row["CA"] = p["amount"]
+            row["SHP Payment fee"] = p["fee"]
+            row["Net reçu"] = p["net"]
+            return True
+    return False

pySwivells/accounting/tags.py

@@ -0,0 +1,19 @@
+import pandas as pd
+import numpy as np
+import pickle
+
+
+def read_tags(tag_file: str):
+    tags = pd.read_csv(tag_file)
+    tags = tags.replace({np.nan: None})
+    TAGS = {}
+    for _, row in tags.iterrows():
+        order = row["Nom de la commande"]
+        if row["Balises de commande"]:
+            if TAGS.get(order):
+                TAGS[order].append(row["Balises de commande"])
+            else:
+                TAGS[order] = [row["Balises de commande"]]
+
+    with open("tags.pkl", "wb") as f:
+        pickle.dump(TAGS, f)

pySwivells/accounting/tva.py

@@ -0,0 +1,49 @@
+TVA_RATES = {
+    "Malta": 18.00,
+    "Netherlands": 21.00,
+    "Greece": 24.00,
+    "Bulgaria": 20.00,
+    "Australia": 0.00,
+    "Italy": 22.00,
+    "New Zealand": 0.00,
+    "Lithuania": 21.00,
+    "Hong Kong": 0.00,
+    "Austria": 20.00,
+    "Hong Kong": 0.00,
+    "Czech Republic": 21.00,
+    "Belgium": 21.00,
+    "Switzerland": 0.00,
+    "Portugal": 22.00,
+    "Slovakia": 20.00,
+    "Slovenia": 22.00,
+    "United States": 0.00,
+    "Canada": 0.00,
+    "Thailand": 0.00,
+    "Spain": 21.00,
+    "France": 20.00,
+    "Ireland": 23.00,
+    "Luxembourg": 17.00,
+    "Cyprus": 19.00,
+    "Poland": 23.00,
+    "Croatia": 25.00,
+    "Norway": 0.00,
+    "Denmark": 25.00,
+    "Hungary": 27.00,
+    "Romania": 19.00,
+    "Estonia": 24.00,
+    "Sweden": 25.00,
+    "Serbia": 0.00,
+    "Finland": 25.50,
+    "Japan": 0.00,
+    "United Kingdom": 0.00,
+    "Latvia": 21.00,
+    "Reunion": 0.00,
+    "Germany": 19.00,
+    "Israel": 0.00,
+    "Taiwan": 0.00,
+    "South Korea": 0.00,
+    "New Caledonia": 0.00,
+    "Singapore": 0.00,
+    "Iceland": 0.00,
+    "Belarus": 0.00,
+}

pySwivells/cli.py

@@ -0,0 +1,58 @@
+import fire
+
+from pySwivells import accounting
+
+from pySwivells.iomix import log, Colors
+
+
+class PySwivellsCLI:
+    """PySwivells command-line interface."""
+
+    class compta:
+        """Fonctions de comptabilité.
+
+        Étapes :
+        1. Récupérer le tableau des balises des commandes
+        2. Lancer le script de lecture des balises : pyswivells compta tags <TABLEAU-DES-BALISES.csv>
+        3. Récupérer du tableau des ventes Shopify.
+        4. Lancer le nettoyage : pyswivells compta clean <TABLEAU-DES-VENTES.csv>
+        5. Vérifier le tableau nettoyé pour d'éventuelles erreurs de TVA.
+        6. Exporter les relevés d'encaissement Shopify.
+        7. Placer tous les relevés d'encaissement Shopify dans un seul dossier <DOSSIER>.
+        8. Vérifier la correspondance entre les ventes et les encaissements : pyswivells compta reconcile <DOSSIER>
+        """
+
+        def tags(self, TABLEAU_DES_BALISES_CSV: str):
+            """Lit les balises des commandes depuis un fichier CSV.
+
+            Args:
+                TABLEAU_DES_BALISES_CSV: Chemin vers le fichier CSV des balises des commandes.
+            """
+            accounting.read_tags(TABLEAU_DES_BALISES_CSV)
+            log(
+                f"Balises lues et enregistrées depuis {TABLEAU_DES_BALISES_CSV} ✅",
+            )
+
+        def clean(self, TABLEAU_DES_VENTES_EXCEL: str):
+            """Nettoie le tableau des ventes Shopify.
+
+            Args:
+                TABLEAU_DES_VENTES: Chemin vers le fichier Excel des ventes Shopify.
+            """
+            accounting.clean_sales(TABLEAU_DES_VENTES_EXCEL)
+
+        def reconcile(self, DOSSIER: str):
+            """Vérifie la correspondance entre les ventes et les encaissements.
+
+            Args:
+
+                DOSSIER: Chemin vers le dossier contenant les relevés d'encaissement.
+            """
+            accounting.reconcile(
+                DOSSIER,
+            )
+
+
+def main():
+    # Fire automatically exposes all methods as CLI commands
+    fire.Fire(PySwivellsCLI)

pySwivells/iomix.py

@@ -0,0 +1,35 @@
+class Colors:
+    HEADER = "\033[95m"
+    OKBLUE = "\033[94m"
+    OKCYAN = "\033[96m"
+    OKGREEN = "\033[92m"
+    WARNING = "\033[93m"
+    FAIL = "\033[91m"
+    ENDC = "\033[0m"
+    BOLD = "\033[1m"
+    UNDERLINE = "\033[4m"
+
+
+def log(message: str, color: str = Colors.ENDC):
+    print(f"{color}{message}{Colors.ENDC}")
+
+
+def error(message: str, exit_app: bool = True):
+    log(f"===  ERREUR  ===\n{message}", Colors.FAIL)
+    if exit_app:
+        exit(-1)
+
+
+def warning(message: str):
+    log(f"===  AVERTISSEMENT  ===\n{message}", Colors.WARNING)
+
+
+def yes_or_no(prompt: str) -> bool:
+    while True:
+        response = input(f"{prompt} (y/n): ").strip().lower()
+        if response in ["y", "yes"]:
+            return True
+        elif response in ["n", "no"]:
+            return False
+        else:
+            print("Veuillez répondre par 'y' ou 'n'.")

pyswivells-1.0.2.dist-info/METADATA

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: pySwivells
+Version: 1.0.2
+Summary: python utilities for Swivells
+Author-email: Arnaud Hoffmann <info@css23.fr>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: openpyxl
+Requires-Dist: requests
+Requires-Dist: rich
+Requires-Dist: fire

pyswivells-1.0.2.dist-info/RECORD

@@ -0,0 +1,13 @@
+pySwivells/__init__.py,sha256=Y3LSfRioSl2xch70pq_ULlvyECXyEtN3krVaWeGyaxk,22
+pySwivells/cli.py,sha256=Ca4HhDSjGPsLq7Kb4rB_qFSQCz_oPdQ_cN6Ksbk4xTU,2032
+pySwivells/iomix.py,sha256=dBO_9ZT1N3bROvfxi9eOUUsqDtXF0ha7N-zl2BRzKjM,860
+pySwivells/accounting/__init__.py,sha256=L0DD2QiBy5pdsYn1U91rkqEpEczkQgDxfMY8psLOM8k,100
+pySwivells/accounting/cleaning.py,sha256=CUZAXQd2a2YtbRVNAOqN55QuEmkSeRW1EjpzwmcXwQc,4783
+pySwivells/accounting/reconciliation.py,sha256=qaoyP8cs0FdOdQDC7SNMeTbWYrjN7BqxZNDqUHGypls,5251
+pySwivells/accounting/tags.py,sha256=RnbXni6Z92rVAYCn0RUGRyJF01pUi2ebE182wqyskUg,528
+pySwivells/accounting/tva.py,sha256=5L93bneRDRWobnGhvcl1Wr1B0eMkFV89DcQb9GtWkrs,1071
+pyswivells-1.0.2.dist-info/METADATA,sha256=TVUHytQCvnDYXj1o-Fx0ix_ed0B8ZyzCl33jGAcx0KI,492
+pyswivells-1.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pyswivells-1.0.2.dist-info/entry_points.txt,sha256=GTS7Ok58WR4iqF9B7aHU0KjgQTC7BOS4VaIZ50YGrNo,51
+pyswivells-1.0.2.dist-info/top_level.txt,sha256=NFYTwTiUdwLbCA-3LZrEc7YBg8W-MnxhkSofr_BQoJQ,11
+pyswivells-1.0.2.dist-info/RECORD,,

pyswivells-1.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pyswivells-1.0.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pyswivells = pySwivells.cli:main

pyswivells-1.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+pySwivells