rpa-erpnext 1.0.0__tar.gz

rpa_erpnext-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mahara
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

rpa_erpnext-1.0.0/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: rpa-erpnext
+Version: 1.0.0
+Summary: Robot Framework library for automating ERPNext using REST API
+Author-email: Your Name <youremail@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/rpa-erpnext
+Project-URL: Source, https://github.com/yourusername/rpa-erpnext
+Keywords: robotframework,erpnext,rpa,automation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: robotframework>=6.0
+Dynamic: license-file

rpa_erpnext-1.0.0/RPA/ERPNext.py

@@ -0,0 +1,253 @@
+import json
+import pandas as pd
+import requests
+from robot.api.deco import keyword, library
+@library(scope='GLOBAL', auto_keywords=False)
+class ERPNextLibrary:
+    def __init__(self, base_url, api_key, api_secret):
+        self.base_url = base_url.rstrip("/")
+        self.session = requests.Session()
+        self.session.auth = (api_key, api_secret)
+
+    # ===========================================================
+    #  Utility
+    # ===========================================================
+
+    def create_resource(self, doctype, data):
+        res = self.session.post(f"{self.base_url}/api/resource/{doctype}", json=data)
+        if not res.ok:
+            raise Exception(f"HTTP {res.status_code}: {res.text}")
+        return res.json().get("data", res.json())
+
+    def get_doc(self, doctype, name):
+        res = self.session.get(f"{self.base_url}/api/resource/{doctype}/{name}")
+        res.raise_for_status()
+        return res.json().get("data")
+
+    def exists(self, doctype, name):
+        """Kiểm tra xem tài nguyên có tồn tại hay không."""
+        res = self.session.get(f"{self.base_url}/api/resource/{doctype}/{name}")
+        return res.ok
+
+    # ===========================================================
+    #  Ensure Hàm nền tảng
+    # ===========================================================
+
+    @keyword("Ensure Company Exist")
+    def ensure_company_exist(self, company: str, abbr: str):
+        """Đảm bảo Company tồn tại."""
+        if self.exists("Company", company):
+            return {"status": "exists", "name": company}
+
+        data = {
+            "doctype": "Company",
+            "company_name": company,
+            "abbr": abbr,
+            "default_currency": "VND",
+            "country": "Vietnam",
+            "company_logo": None
+        }
+        return self.create_resource("Company", data)
+
+    @keyword("Ensure Warehouse Exist")
+    def ensure_warehouse_exist(self, warehouse: str, company: str):
+        """Đảm bảo Warehouse tồn tại."""
+        if self.exists("Warehouse", warehouse):
+            return {"status": "exists", "name": warehouse}
+
+        data = {
+            "doctype": "Warehouse",
+            "warehouse_name": warehouse,
+            "company": company,
+        }
+        return self.create_resource("Warehouse", data)
+
+    @keyword("Ensure Supplier Exist")
+    def ensure_supplier_exist(self, supplier_name: str):
+        """Đảm bảo Supplier tồn tại."""
+        if self.exists("Supplier", supplier_name):
+            return {"status": "exists", "name": supplier_name}
+
+        data = {
+            "doctype": "Supplier",
+            "supplier_name": supplier_name,
+            "supplier_type": "Company",
+            "country": "Vietnam",
+        }
+        return self.create_resource("Supplier", data)
+
+    @keyword("Ensure Items Exist")
+    def ensure_items_exist(self, items_json):
+        """Đảm bảo tất cả item tồn tại."""
+        if isinstance(items_json, str):
+            items = json.loads(items_json)
+        else:
+            items = items_json
+
+        created_items = []
+        for i in items:
+            code = i["item_code"]
+            if self.exists("Item", code):
+                created_items.append({"status": "exists", "item_code": code})
+                continue
+
+            data = {
+                "doctype": "Item",
+                "item_code": code,
+                "item_name": code,
+                "description": i.get("description", code),
+                "stock_uom": "Nos",
+                "is_stock_item": 1,
+                "item_group": "All Item Groups",
+            }
+            res = self.create_resource("Item", data)
+            created_items.append(res)
+        return created_items
+
+    # ===========================================================
+    #  Step 1: Đọc file Excel & tạo Material Request
+    # ===========================================================
+
+    @keyword("Load Excel Request")
+    def load_excel_request(self, path: str):
+        """Đọc file Excel chứa company, itemcode, quantity."""
+        df = pd.read_excel(path)
+        return df.to_dict(orient="records")
+
+    @keyword("Create Material Request From Excel")
+    def create_material_request_from_excel(self, path: str, schedule_date: str):
+        """Tạo Material Request từ file Excel."""
+        rows = self.load_excel_request(path)
+        if not rows:
+            raise Exception("Excel file không có dữ liệu.")
+
+        company = rows[0]["company"]
+        self.ensure_company_exist(company, "EDU")
+        self.ensure_warehouse_exist(f"Stores - EDU", company)
+
+        items = []
+        for row in rows:
+            self.ensure_items_exist([{
+                "item_code": row["itemcode"],
+                "description": row["itemcode"]
+            }])
+            items.append({
+                "item_code": row["itemcode"],
+                "description": row["itemcode"],
+                "qty": float(row["quantity"]),
+                "schedule_date": schedule_date,
+                "warehouse": f"Stores - EDU",
+                "uom": "Nos",
+                "stock_uom": "Nos",
+                "conversion_factor": 1.0
+            })
+
+        data = {
+            "doctype": "Material Request",
+            "material_request_type": "Purchase",
+            "company": company,
+            "schedule_date": schedule_date,
+            "items": items
+        }
+        return self.create_resource("Material Request", data)
+
+    # ===========================================================
+    #  Step 2: Gửi RFQ
+    # ===========================================================
+
+    @keyword("Send RFQ From Material Request")
+    def send_rfq_from_mr(self, mr_name: str, suppliers: list):
+        """Tạo RFQ dựa trên Material Request."""
+        mr_doc = self.get_doc("Material Request", mr_name)
+        company = mr_doc["company"]
+        self.ensure_warehouse_exist(f"Stores - EDU", company)
+        for s in suppliers:
+            self.ensure_supplier_exist(s)
+
+        items = []
+        for d in mr_doc["items"]:
+            items.append({
+                "item_code": d["item_code"],
+                "qty": d["qty"],
+                "uom": d.get("uom", "Nos"),
+                "stock_uom": d.get("stock_uom", "Nos"),
+                "conversion_factor": 1.0,
+                "warehouse": d["warehouse"],
+            })
+
+        rfq_data = {
+            "doctype": "Request for Quotation",
+            "company": company,
+            "transaction_date": "2025-10-28",
+            "suppliers": [{"supplier": s} for s in suppliers],
+            "items": items,
+            "message_for_supplier": "Xin vui lòng gửi báo giá."
+        }
+        return self.create_resource("Request for Quotation", rfq_data)
+
+    # ===========================================================
+    #  Step 3: Supplier gửi báo giá
+    # ===========================================================
+
+    @keyword("Receive Supplier Quotation")
+    def receive_supplier_quotation(self, rfq_name: str, supplier_name: str, quotation_data: list):
+        rfq_doc = self.get_doc("Request for Quotation", rfq_name)
+        company = rfq_doc["company"]
+        self.ensure_supplier_exist(supplier_name)
+
+        sq_data = {
+            "doctype": "Supplier Quotation",
+            "supplier": supplier_name,
+            "company": company,
+            "transaction_date": "2025-10-28",
+            "items": [],
+        }
+
+        for q in quotation_data:
+            sq_data["items"].append({
+                "item_code": q["item_code"],
+                "qty": q["qty"],
+                "rate": q["rate"],
+                "uom": "Nos",
+                "stock_uom": "Nos",
+                "conversion_factor": 1.0,
+                "warehouse": f"Stores - EDU"
+            })
+
+        return self.create_resource("Supplier Quotation", sq_data)
+
+    # ===========================================================
+    #  Step 4: Tạo Purchase Order
+    # ===========================================================
+
+    @keyword("Create Purchase Order From Quotation")
+    def create_purchase_order_from_quotation(self, quotation_name: str):
+        sq_doc = self.get_doc("Supplier Quotation", quotation_name)
+        supplier = sq_doc["supplier"]
+        company = sq_doc["company"]
+
+        self.ensure_supplier_exist(supplier)
+        self.ensure_warehouse_exist(f"Stores - EDU", company)
+
+        items = []
+        for d in sq_doc["items"]:
+            items.append({
+                "item_code": d["item_code"],
+                "qty": d["qty"],
+                "rate": d["rate"],
+                "schedule_date": "2025-11-05",
+                "warehouse": f"Stores - EDU",
+                "uom": d.get("uom", "Nos"),
+                "conversion_factor": 1.0
+            })
+
+        po_data = {
+            "doctype": "Purchase Order",
+            "supplier": supplier,
+            "company": company,
+            "schedule_date": "2025-11-05",
+            "items": items
+        }
+        return self.create_resource("Purchase Order", po_data)
+
+        

rpa_erpnext-1.0.0/RPA/init.py

@@ -0,0 +1,6 @@
+# src/RPA/__init__.py
+from .ERPNext import ERPNext
+
+__version__ = "1.0.0"
+__author__ = "Mahara"
+__all__ = ["ERPNext"]

rpa_erpnext-1.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rpa-erpnext"
+version = "1.0.0"
+description = "Robot Framework library for automating ERPNext using REST API"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+  { name="Your Name", email="youremail@example.com" }
+]
+keywords = ["robotframework", "erpnext", "rpa", "automation"]
+dependencies = [
+  "requests>=2.28.0",
+  "robotframework>=6.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/yourusername/rpa-erpnext"
+Source = "https://github.com/yourusername/rpa-erpnext"

rpa_erpnext-1.0.0/rpa_erpnext.egg-info/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: rpa-erpnext
+Version: 1.0.0
+Summary: Robot Framework library for automating ERPNext using REST API
+Author-email: Your Name <youremail@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/rpa-erpnext
+Project-URL: Source, https://github.com/yourusername/rpa-erpnext
+Keywords: robotframework,erpnext,rpa,automation
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: robotframework>=6.0
+Dynamic: license-file

rpa_erpnext-1.0.0/rpa_erpnext.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+pyproject.toml
+RPA/ERPNext.py
+RPA/init.py
+rpa_erpnext.egg-info/PKG-INFO
+rpa_erpnext.egg-info/SOURCES.txt
+rpa_erpnext.egg-info/dependency_links.txt
+rpa_erpnext.egg-info/requires.txt
+rpa_erpnext.egg-info/top_level.txt

rpa_erpnext-1.0.0/rpa_erpnext.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

rpa_erpnext-1.0.0/rpa_erpnext.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.28.0
+robotframework>=6.0

rpa_erpnext-1.0.0/rpa_erpnext.egg-info/top_level.txt

@@ -0,0 +1 @@
+RPA

rpa_erpnext-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+