rpa-erpnext 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

RPA/ERPNext.py

@@ -4,13 +4,77 @@ 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):
+    def __init__(self, base_url=None, api_key=None, api_secret=None):
+        self.base_url = None
+        self.session = None
+        if base_url and api_key and api_secret:
+            self.connect(base_url, api_key, api_secret)
+
+    def connect(self, base_url, api_key=None, api_secret=None, access_token=None):
+        """
+        Kết nối tới ERPNext server.
+        
+        Args:
+            base_url: URL của ERPNext server
+            api_key: API Key (cho Token Auth)
+            api_secret: API Secret (cho Token Auth)
+            access_token: OAuth2 Access Token (Bearer Auth)
+        """
         self.base_url = base_url.rstrip("/")
         self.session = requests.Session()
-        self.session.auth = (api_key, api_secret)
+        
+        headers = {
+            "Accept": "application/json",
+            "Content-Type": "application/json"
+        }
+
+        if access_token:
+            headers["Authorization"] = f"Bearer {access_token}"
+        elif api_key and api_secret:
+            headers["Authorization"] = f"token {api_key}:{api_secret}"
+            
+        self.session.headers.update(headers)
+        return {"status": "connected", "base_url": self.base_url}
+
+    @keyword("Setup ERPNext Connection")
+    def setup_erpnext_connection(self, token_file_path: str):
+        """
+        Thiết lập kết nối với ERPNext từ file credential JSON.
+        
+        Hỗ trợ 2 format:
+        1. Token Auth (API Key/Secret):
+        {
+            "base_url": "...",
+            "api_key": "...",
+            "api_secret": "..."
+        }
+        
+        2. OAuth2 (Access Token):
+        {
+            "base_url": "...",
+            "access_token": "..."
+        }
+        """
+        with open(token_file_path, 'r', encoding='utf-8') as f:
+            data = json.load(f)
+            
+        base_url = data.get("base_url")
+        api_key = data.get("api_key")
+        api_secret = data.get("api_secret")
+        access_token = data.get("access_token")
+        
+        if not base_url:
+             raise Exception("Token file must contain base_url")
+
+        if access_token:
+            return self.connect(base_url, access_token=access_token)
+        elif api_key and api_secret:
+            return self.connect(base_url, api_key=api_key, api_secret=api_secret)
+        else:
+             raise Exception("Token file must contain credentials (api_key+api_secret OR access_token)")
 
     # ===========================================================
-    #  Utility
+    #  Utility Methods
     # ===========================================================
 
     def create_resource(self, doctype, data):
@@ -29,8 +93,90 @@ class ERPNextLibrary:
         res = self.session.get(f"{self.base_url}/api/resource/{doctype}/{name}")
         return res.ok
 
+    @keyword("Get Document")
+    def get_document(self, doctype, name):
+        """
+        Lấy thông tin chi tiết của một document.
+        
+        Args:
+            doctype: Loại document (Item, Customer, Sales Order, etc.)
+            name: Tên/ID của document
+            
+        Example:
+            | ${doc}= | Get Document | Customer | CUST-00001 |
+        """
+        return self.get_doc(doctype, name)
+
+    @keyword("List Documents")
+    def list_documents(self, doctype, filters=None, fields=None, limit=20):
+        """
+        Lấy danh sách documents với filters.
+        
+        Args:
+            doctype: Loại document
+            filters: Điều kiện lọc (dict hoặc JSON string)
+            fields: Các trường cần lấy (list hoặc JSON string)
+            limit: Số lượng kết quả tối đa
+            
+        Example:
+            | ${items}= | List Documents | Item | {"item_group": "Products"} | ["item_code", "item_name"] | 10 |
+        """
+        params = {"limit_page_length": limit}
+        
+        if filters:
+            if isinstance(filters, str):
+                filters = json.loads(filters)
+            params["filters"] = json.dumps(filters)
+        
+        if fields:
+            if isinstance(fields, str):
+                fields = json.loads(fields)
+            params["fields"] = json.dumps(fields)
+        
+        res = self.session.get(f"{self.base_url}/api/resource/{doctype}", params=params)
+        res.raise_for_status()
+        return res.json().get("data", [])
+
+    @keyword("Update Document")
+    def update_document(self, doctype, name, data):
+        """
+        Cập nhật một document.
+        
+        Args:
+            doctype: Loại document
+            name: Tên/ID của document
+            data: Dữ liệu cần cập nhật (dict hoặc JSON string)
+            
+        Example:
+            | Update Document | Item | ITEM-001 | {"description": "New description"} |
+        """
+        if isinstance(data, str):
+            data = json.loads(data)
+        
+        res = self.session.put(f"{self.base_url}/api/resource/{doctype}/{name}", json=data)
+        if not res.ok:
+            raise Exception(f"HTTP {res.status_code}: {res.text}")
+        return res.json().get("data", res.json())
+
+    @keyword("Delete Document")
+    def delete_document(self, doctype, name):
+        """
+        Xóa một document.
+        
+        Args:
+            doctype: Loại document
+            name: Tên/ID của document
+            
+        Example:
+            | Delete Document | Item | ITEM-001 |
+        """
+        res = self.session.delete(f"{self.base_url}/api/resource/{doctype}/{name}")
+        if not res.ok:
+            raise Exception(f"HTTP {res.status_code}: {res.text}")
+        return {"status": "deleted", "doctype": doctype, "name": name}
+
     # ===========================================================
-    #  Ensure Hàm nền tảng
+    #  Ensure Functions - Master Data
     # ===========================================================
 
     @keyword("Ensure Company Exist")
@@ -104,8 +250,305 @@ class ERPNextLibrary:
             created_items.append(res)
         return created_items
 
+    @keyword("Ensure Customer Exist")
+    def ensure_customer_exist(self, customer_name: str, customer_group="Commercial", territory="Vietnam"):
+        """
+        Đảm bảo Customer tồn tại.
+        
+        API: /api/resource/Customer
+        
+        Args:
+            customer_name: Tên khách hàng
+            customer_group: Nhóm khách hàng (mặc định: Commercial)
+            territory: Khu vực (mặc định: Vietnam)
+        """
+        if self.exists("Customer", customer_name):
+            return {"status": "exists", "name": customer_name}
+
+        data = {
+            "doctype": "Customer",
+            "customer_name": customer_name,
+            "customer_type": "Company",
+            "customer_group": customer_group,
+            "territory": territory,
+        }
+        return self.create_resource("Customer", data)
+
+    # ===========================================================
+    #  Sales APIs - Quy trình bán hàng
+    # ===========================================================
+
+    @keyword("Create Sales Order")
+    def create_sales_order(self, customer: str, items: list, delivery_date: str, company: str):
+        """
+        Tạo Sales Order (Đơn hàng bán).
+        
+        API: /api/resource/Sales Order
+        
+        Args:
+            customer: Tên khách hàng
+            items: Danh sách items [{"item_code": "ITEM-001", "qty": 10, "rate": 1000}]
+            delivery_date: Ngày giao hàng (format: YYYY-MM-DD)
+            company: Tên công ty
+            
+        Example:
+            | ${items}= | Create List | {"item_code": "ITEM-001", "qty": 10, "rate": 1000} |
+            | Create Sales Order | Customer A | ${items} | 2025-12-01 | My Company |
+        """
+        self.ensure_customer_exist(customer)
+        
+        order_items = []
+        for item in items:
+            order_items.append({
+                "item_code": item["item_code"],
+                "qty": item["qty"],
+                "rate": item.get("rate", 0),
+                "delivery_date": delivery_date,
+                "uom": item.get("uom", "Nos"),
+            })
+
+        data = {
+            "doctype": "Sales Order",
+            "customer": customer,
+            "company": company,
+            "delivery_date": delivery_date,
+            "items": order_items
+        }
+        return self.create_resource("Sales Order", data)
+
+    @keyword("Create Sales Invoice")
+    def create_sales_invoice(self, customer: str, items: list, company: str, posting_date=None):
+        """
+        Tạo Sales Invoice (Hóa đơn bán hàng).
+        
+        API: /api/resource/Sales Invoice
+        
+        Args:
+            customer: Tên khách hàng
+            items: Danh sách items [{"item_code": "ITEM-001", "qty": 10, "rate": 1000}]
+            company: Tên công ty
+            posting_date: Ngày lập hóa đơn (mặc định: ngày hiện tại)
+        """
+        self.ensure_customer_exist(customer)
+        
+        invoice_items = []
+        for item in items:
+            invoice_items.append({
+                "item_code": item["item_code"],
+                "qty": item["qty"],
+                "rate": item.get("rate", 0),
+                "uom": item.get("uom", "Nos"),
+            })
+
+        data = {
+            "doctype": "Sales Invoice",
+            "customer": customer,
+            "company": company,
+            "items": invoice_items
+        }
+        if posting_date:
+            data["posting_date"] = posting_date
+            
+        return self.create_resource("Sales Invoice", data)
+
+    # ===========================================================
+    #  Stock/Inventory APIs - Quản lý kho
+    # ===========================================================
+
+    @keyword("Create Stock Entry")
+    def create_stock_entry(self, purpose: str, items: list, company: str, posting_date=None):
+        """
+        Tạo Stock Entry (Phiếu nhập/xuất kho).
+        
+        API: /api/resource/Stock Entry
+        
+        Args:
+            purpose: Mục đích (Material Receipt, Material Issue, Material Transfer, etc.)
+            items: Danh sách items với warehouse
+            company: Tên công ty
+            posting_date: Ngày lập phiếu
+            
+        Purpose types:
+            - Material Receipt: Nhập kho
+            - Material Issue: Xuất kho
+            - Material Transfer: Chuyển kho
+            - Manufacture: Sản xuất
+            - Repack: Đóng gói lại
+            
+        Example:
+            | ${items}= | Create List | {"item_code": "ITEM-001", "qty": 100, "t_warehouse": "Stores - EDU"} |
+            | Create Stock Entry | Material Receipt | ${items} | My Company |
+        """
+        stock_items = []
+        for item in items:
+            stock_items.append({
+                "item_code": item["item_code"],
+                "qty": item["qty"],
+                "s_warehouse": item.get("s_warehouse"),  # Source warehouse
+                "t_warehouse": item.get("t_warehouse"),  # Target warehouse
+                "uom": item.get("uom", "Nos"),
+                "stock_uom": item.get("stock_uom", "Nos"),
+                "conversion_factor": item.get("conversion_factor", 1.0),
+            })
+
+        data = {
+            "doctype": "Stock Entry",
+            "purpose": purpose,
+            "company": company,
+            "items": stock_items
+        }
+        if posting_date:
+            data["posting_date"] = posting_date
+            
+        return self.create_resource("Stock Entry", data)
+
+    @keyword("Create Purchase Receipt")
+    def create_purchase_receipt(self, supplier: str, items: list, company: str, posting_date=None):
+        """
+        Tạo Purchase Receipt (Phiếu nhận hàng mua).
+        
+        API: /api/resource/Purchase Receipt
+        
+        Args:
+            supplier: Tên nhà cung cấp
+            items: Danh sách items [{"item_code": "ITEM-001", "qty": 100, "rate": 1000, "warehouse": "Stores - EDU"}]
+            company: Tên công ty
+            posting_date: Ngày nhận hàng
+        """
+        self.ensure_supplier_exist(supplier)
+        
+        receipt_items = []
+        for item in items:
+            receipt_items.append({
+                "item_code": item["item_code"],
+                "qty": item["qty"],
+                "rate": item.get("rate", 0),
+                "warehouse": item.get("warehouse"),
+                "uom": item.get("uom", "Nos"),
+            })
+
+        data = {
+            "doctype": "Purchase Receipt",
+            "supplier": supplier,
+            "company": company,
+            "items": receipt_items
+        }
+        if posting_date:
+            data["posting_date"] = posting_date
+            
+        return self.create_resource("Purchase Receipt", data)
+
+    @keyword("Create Purchase Order")
+    def create_purchase_order(self, supplier: str, items: list, company: str, schedule_date=None):
+        """
+        Tạo Purchase Order (Đơn hàng mua).
+        
+        API: /api/resource/Purchase Order
+        
+        Args:
+            supplier: Tên nhà cung cấp
+            items: Danh sách items [{"item_code": "ITEM-001", "qty": 100, "rate": 1000}]
+            company: Tên công ty
+            schedule_date: Ngày cần hàng
+        """
+        self.ensure_supplier_exist(supplier)
+        
+        po_items = []
+        for item in items:
+            po_items.append({
+                "item_code": item["item_code"],
+                "qty": item["qty"],
+                "rate": item.get("rate", 0),
+                "schedule_date": item.get("schedule_date", schedule_date),
+                "warehouse": item.get("warehouse"),
+                "uom": item.get("uom", "Nos"),
+            })
+
+        data = {
+            "doctype": "Purchase Order",
+            "supplier": supplier,
+            "company": company,
+            "items": po_items,
+            "schedule_date": schedule_date
+        }
+            
+        return self.create_resource("Purchase Order", data)
+
+    # ===========================================================
+    #  Accounting APIs - Kế toán
+    # ===========================================================
+
+    @keyword("Create Purchase Invoice")
+    def create_purchase_invoice(self, supplier: str, items: list, company: str, posting_date=None):
+        """
+        Tạo Purchase Invoice (Hóa đơn mua hàng).
+        
+        API: /api/resource/Purchase Invoice
+        
+        Args:
+            supplier: Tên nhà cung cấp
+            items: Danh sách items [{"item_code": "ITEM-001", "qty": 100, "rate": 1000}]
+            company: Tên công ty
+            posting_date: Ngày lập hóa đơn
+        """
+        self.ensure_supplier_exist(supplier)
+        
+        invoice_items = []
+        for item in items:
+            invoice_items.append({
+                "item_code": item["item_code"],
+                "qty": item["qty"],
+                "rate": item.get("rate", 0),
+                "uom": item.get("uom", "Nos"),
+            })
+
+        data = {
+            "doctype": "Purchase Invoice",
+            "supplier": supplier,
+            "company": company,
+            "items": invoice_items
+        }
+        if posting_date:
+            data["posting_date"] = posting_date
+            
+        return self.create_resource("Purchase Invoice", data)
+
+    @keyword("Create Payment Entry")
+    def create_payment_entry(self, payment_type: str, party_type: str, party: str, 
+                            paid_amount: float, company: str, posting_date=None):
+        """
+        Tạo Payment Entry (Phiếu thanh toán).
+        
+        API: /api/resource/Payment Entry
+        
+        Args:
+            payment_type: Loại thanh toán (Receive, Pay, Internal Transfer)
+            party_type: Loại đối tác (Customer, Supplier, Employee)
+            party: Tên đối tác
+            paid_amount: Số tiền thanh toán
+            company: Tên công ty
+            posting_date: Ngày thanh toán
+            
+        Example:
+            | Create Payment Entry | Receive | Customer | Customer A | 10000000 | My Company |
+            | Create Payment Entry | Pay | Supplier | Supplier B | 5000000 | My Company |
+        """
+        data = {
+            "doctype": "Payment Entry",
+            "payment_type": payment_type,
+            "party_type": party_type,
+            "party": party,
+            "paid_amount": paid_amount,
+            "received_amount": paid_amount if payment_type == "Receive" else 0,
+            "company": company,
+        }
+        if posting_date:
+            data["posting_date"] = posting_date
+            
+        return self.create_resource("Payment Entry", data)
+
     # ===========================================================
-    #  Step 1: Đọc file Excel & tạo Material Request
+    #  Procurement - Quy trình mua hàng (đã có sẵn)
     # ===========================================================
 
     @keyword("Load Excel Request")
@@ -178,7 +621,7 @@ class ERPNextLibrary:
         rfq_data = {
             "doctype": "Request for Quotation",
             "company": company,
-            "transaction_date": "2025-10-28",
+            "transaction_date": mr_doc["schedule_date"],
             "suppliers": [{"supplier": s} for s in suppliers],
             "items": items,
             "message_for_supplier": "Xin vui lòng gửi báo giá."
@@ -199,7 +642,7 @@ class ERPNextLibrary:
             "doctype": "Supplier Quotation",
             "supplier": supplier_name,
             "company": company,
-            "transaction_date": "2025-10-28",
+            "transaction_date": "2026-01-28",
             "items": [],
         }
 
@@ -235,7 +678,7 @@ class ERPNextLibrary:
                 "item_code": d["item_code"],
                 "qty": d["qty"],
                 "rate": d["rate"],
-                "schedule_date": "2025-11-05",
+                "schedule_date": "2026-02-28",
                 "warehouse": f"Stores - EDU",
                 "uom": d.get("uom", "Nos"),
                 "conversion_factor": 1.0
@@ -245,7 +688,7 @@ class ERPNextLibrary:
             "doctype": "Purchase Order",
             "supplier": supplier,
             "company": company,
-            "schedule_date": "2025-11-05",
+            "schedule_date": "2026-02-28",
             "items": items
         }
         return self.create_resource("Purchase Order", po_data)

RPA/__init__.py

@@ -0,0 +1,5 @@
+from .ERPNext import ERPNextLibrary
+
+__version__ = "1.0.0"
+__author__ = "Mahara"
+__all__ = ["ERPNextLibrary"]

{rpa_erpnext-1.0.0.dist-info → rpa_erpnext-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rpa-erpnext
-Version: 1.0.0
+Version: 1.0.1
 Summary: Robot Framework library for automating ERPNext using REST API
 Author-email: Your Name <youremail@example.com>
 License: MIT
@@ -12,4 +12,16 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests>=2.28.0
 Requires-Dist: robotframework>=6.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: openpyxl>=3.1.0
 Dynamic: license-file
+
+# RPA.ERPNext
+
+Library for automating [ERPNext](https://erpnext.com/) using REST API, built for [Robot Framework](https://robotframework.org/).
+
+## Installation
+
+```bash
+pip install rpa-erpnext
+```

rpa_erpnext-1.0.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+RPA/ERPNext.py,sha256=OGunPSMxX9jdsfqi0wpwfcncSBQuekHsSOa_SZc-vhg,24914
+RPA/__init__.py,sha256=doHeY54VPWzBDnkSMGvGGSYfkpxt4dFXAV8YOi-Ebig,110
+rpa_erpnext-1.0.1.dist-info/licenses/LICENSE,sha256=sexHbU6pNlqsmC_TQZJLdZ59qC_Bym7mQ0HrNeHHQ3Y,1063
+rpa_erpnext-1.0.1.dist-info/METADATA,sha256=xRXJi0s8br9c0FbCtksyHZESnkpNofLz4iyen5HE8NY,800
+rpa_erpnext-1.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+rpa_erpnext-1.0.1.dist-info/top_level.txt,sha256=s4yaEXbcdPUcIyAxSvrLKKIMD62cqoNPsOGmdx94U5k,4
+rpa_erpnext-1.0.1.dist-info/RECORD,,

{rpa_erpnext-1.0.0.dist-info → rpa_erpnext-1.0.1.dist-info}/WHEEL

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

RPA/init.py

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

rpa_erpnext-1.0.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-RPA/ERPNext.py,sha256=2xeclyrQiKgPnEgnqWe1ijmuxASsSejoaWKBcgNqkqk,9129
-RPA/init.py,sha256=hhB7KVQqlO3Yo3ScIulQMQ-obZbdGBPe0YIgtVyqSt8,118
-rpa_erpnext-1.0.0.dist-info/licenses/LICENSE,sha256=sexHbU6pNlqsmC_TQZJLdZ59qC_Bym7mQ0HrNeHHQ3Y,1063
-rpa_erpnext-1.0.0.dist-info/METADATA,sha256=HKy1L1P-k7bIixS1dQk7BllIDEABSXDNGDRWaBHCcaM,541
-rpa_erpnext-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-rpa_erpnext-1.0.0.dist-info/top_level.txt,sha256=s4yaEXbcdPUcIyAxSvrLKKIMD62cqoNPsOGmdx94U5k,4
-rpa_erpnext-1.0.0.dist-info/RECORD,,