cetustek 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

cetustek/__init__.py

@@ -1,19 +1,33 @@
 """Cetustek Taiwan e-invoice SDK."""
 
-from cetustek.client import Cetustek
+from cetustek.client import Cetustek, CetustekError, CetustekAPIError
 from cetustek.models import (
+    # Input models
     CancelInvoiceInput,
     CreateInvoiceInput,
     InvoiceItem,
     QueryInvoiceInput,
+    # Response models
+    CancelInvoiceResponse,
+    CreateInvoiceResponse,
+    QueryInvoiceResponse,
 )
 
 __all__ = [
+    # Client
     "Cetustek",
+    # Exceptions
+    "CetustekError",
+    "CetustekAPIError",
+    # Input models
     "CreateInvoiceInput",
     "CancelInvoiceInput",
     "QueryInvoiceInput",
     "InvoiceItem",
+    # Response models
+    "CreateInvoiceResponse",
+    "CancelInvoiceResponse",
+    "QueryInvoiceResponse",
 ]
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

cetustek/client.py

@@ -1,13 +1,33 @@
-import requests
+import html
+import re
+from typing import Optional
 from xml.sax.saxutils import escape
 
+import requests
+
 from cetustek.models import (
     CreateInvoiceInput,
+    CreateInvoiceResponse,
     CancelInvoiceInput,
+    CancelInvoiceResponse,
     QueryInvoiceInput,
+    QueryInvoiceResponse,
 )
 
 
+class CetustekError(Exception):
+    """Base exception for Cetustek API errors."""
+    pass
+
+
+class CetustekAPIError(CetustekError):
+    """API returned an error response."""
+    def __init__(self, code: str, message: Optional[str] = None):
+        self.code = code
+        self.message = message
+        super().__init__(f"API Error: {code}" + (f" - {message}" if message else ""))
+
+
 class Cetustek:
     def __init__(self, *, endpoint: str, rent_id: str, api_password: str, site_code: str):
         self.endpoint = endpoint
@@ -18,7 +38,16 @@ class Cetustek:
     # API methods
     # -------------------------
 
-    def createInvoice(self, data: CreateInvoiceInput) -> str:
+    def createInvoice(self, data: CreateInvoiceInput) -> CreateInvoiceResponse:
+        """
+        Create a new e-invoice.
+
+        Returns:
+            CreateInvoiceResponse with invoice_number and random_code.
+
+        Raises:
+            CetustekAPIError: If the API returns an error.
+        """
         items_xml = ""
         for item in data.items:
             items_xml += f"""
@@ -61,10 +90,20 @@ class Cetustek:
 <source>{self.source}</source>
 """
 
-        return self._post_soap(self._wrap_soap("CreateInvoiceV3", inner))
+        response_xml = self._post_soap(self._wrap_soap("CreateInvoiceV3", inner))
+        return self._parse_create_response(response_xml)
+
+    def cancelInvoice(self, data: CancelInvoiceInput, no_check: bool = False) -> CancelInvoiceResponse:
+        """
+        Cancel (void) an existing invoice.
 
+        Args:
+            data: CancelInvoiceInput with invoice details.
+            no_check: If True, skip validation checks.
 
-    def cancelInvoice(self, data: CancelInvoiceInput, no_check: bool = False) -> str:
+        Returns:
+            CancelInvoiceResponse with success status and code.
+        """
         invoice_xml = f"""
 <Invoice XSDVersion="2.8">
 <InvoiceNumber>{data.invoice_number}</InvoiceNumber>
@@ -81,13 +120,18 @@ class Cetustek:
 """
 
         action = "CancelInvoiceNoCheck" if no_check else "CancelInvoice"
+        response_xml = self._post_soap(self._wrap_soap(action, inner))
+        return self._parse_cancel_response(response_xml)
 
-        return self._post_soap(self._wrap_soap(action, inner))
-
-    def queryInvoice(self, data: QueryInvoiceInput) -> str:
+    def queryInvoice(self, data: QueryInvoiceInput) -> QueryInvoiceResponse:
         """
         Query invoice by invoice number and year.
-        Returns XML string with invoice details.
+
+        Returns:
+            QueryInvoiceResponse with invoice details.
+
+        Raises:
+            CetustekAPIError: If the API returns an error.
         """
         inner = f"""
 <invoicenumber>{data.invoice_number}</invoicenumber>
@@ -95,12 +139,106 @@ class Cetustek:
 <rentid>{self.rent_id}</rentid>
 <source>{self.source}</source>
 """
-        return self._post_soap(self._wrap_soap("QueryInvoice", inner))
+        response_xml = self._post_soap(self._wrap_soap("QueryInvoice", inner))
+        return self._parse_query_response(response_xml, data.invoice_number)
 
+    # -------------------------
+    # Response parsers
+    # -------------------------
+
+    def _parse_create_response(self, response_xml: str) -> CreateInvoiceResponse:
+        """Parse createInvoice response XML."""
+        return_value = self._extract_return_value(response_xml)
+
+        if ";" not in return_value:
+            raise CetustekAPIError(return_value)
+
+        parts = return_value.split(";")
+        if len(parts) != 2:
+            raise CetustekAPIError(return_value, "Unexpected response format")
+
+        invoice_number, random_code = parts
+        return CreateInvoiceResponse(
+            invoice_number=invoice_number,
+            random_code=random_code,
+        )
+
+    def _parse_cancel_response(self, response_xml: str) -> CancelInvoiceResponse:
+        """Parse cancelInvoice response XML."""
+        return_value = self._extract_return_value(response_xml)
+
+        success = return_value == "C0"
+        return CancelInvoiceResponse(
+            success=success,
+            code=return_value,
+            message=None if success else return_value,
+        )
+
+    def _parse_query_response(self, response_xml: str, invoice_number: str) -> QueryInvoiceResponse:
+        """Parse queryInvoice response XML."""
+        return_value = self._extract_return_value(response_xml, dotall=True)
+
+        # Unescape HTML entities
+        invoice_xml = html.unescape(return_value)
+
+        # Check if response is an error (not XML)
+        if not invoice_xml.strip().startswith("<"):
+            raise CetustekAPIError(invoice_xml)
+
+        # Parse invoice fields from XML
+        return QueryInvoiceResponse(
+            invoice_number=invoice_number,
+            invoice_date=self._extract_xml_value(invoice_xml, "InvoiceDate"),
+            invoice_time=self._extract_xml_value(invoice_xml, "InvoiceTime"),
+            order_id=self._extract_xml_value(invoice_xml, "OrderID"),
+            random_code=self._extract_xml_value(invoice_xml, "RandomNumber"),
+            buyer_identifier=self._extract_xml_value(invoice_xml, "BuyerIdentifier"),
+            buyer_name=self._extract_xml_value(invoice_xml, "BuyerName"),
+            seller_identifier=self._extract_xml_value(invoice_xml, "SellerIdentifier"),
+            seller_name=self._extract_xml_value(invoice_xml, "SellerName"),
+            invoice_status=self._extract_xml_value(invoice_xml, "InvoiceStatus"),
+            donate_mark=self._extract_xml_value(invoice_xml, "DonateMark"),
+            carrier_type=self._extract_xml_value(invoice_xml, "CarrierType"),
+            carrier_id=self._extract_xml_value(invoice_xml, "CarrierId1"),
+            npoban=self._extract_xml_value(invoice_xml, "NPOBAN"),
+            tax_type=self._extract_xml_value(invoice_xml, "TaxType"),
+            sales_amount=self._extract_xml_float(invoice_xml, "SalesAmount"),
+            tax_amount=self._extract_xml_float(invoice_xml, "TaxAmount"),
+            total_amount=self._extract_xml_float(invoice_xml, "TotalAmount"),
+            raw_xml=invoice_xml,
+        )
+
+    def _extract_return_value(self, response_xml: str, dotall: bool = False) -> str:
+        """Extract the <return> value from SOAP response."""
+        flags = re.DOTALL if dotall else 0
+        match = re.search(r"<return>(.*?)</return>", response_xml, flags)
+        if not match:
+            raise CetustekError(f"Invalid response: missing <return> tag")
+        return match.group(1).strip()
+
+    def _extract_xml_value(self, xml: str, tag: str) -> Optional[str]:
+        """Extract value from XML tag (case-insensitive)."""
+        pattern = rf"<{tag}>(.*?)</{tag}>"
+        match = re.search(pattern, xml, re.IGNORECASE | re.DOTALL)
+        if match:
+            value = match.group(1).strip()
+            return value if value else None
+        return None
+
+    def _extract_xml_float(self, xml: str, tag: str) -> Optional[float]:
+        """Extract float value from XML tag."""
+        value = self._extract_xml_value(xml, tag)
+        if value:
+            try:
+                return float(value)
+            except ValueError:
+                return None
+        return None
 
     # -------------------------
     # Internal helpers
     # -------------------------
+
     def _post_soap(self, body: str) -> str:
         headers = {
             "Content-Type": "text/xml; charset=utf-8",

cetustek/models.py

@@ -2,6 +2,10 @@ from dataclasses import dataclass
 from typing import Optional, List
 
 
+# -------------------------
+# Input Models
+# -------------------------
+
 @dataclass
 class InvoiceItem:
     production_code: str      # ProductionCode
@@ -55,3 +59,51 @@ class CancelInvoiceInput:
 class QueryInvoiceInput:
     invoice_number: str
     invoice_year: str
+
+
+# -------------------------
+# Response Models
+# -------------------------
+
+@dataclass
+class CreateInvoiceResponse:
+    """Response from createInvoice API."""
+    invoice_number: str  # 10-character invoice number (e.g., "WP20260002")
+    random_code: str     # 4-digit random code (e.g., "6827")
+
+    @property
+    def invoice_year(self) -> str:
+        """Extract year from invoice number (positions 2-5)."""
+        return self.invoice_number[2:6]
+
+
+@dataclass
+class QueryInvoiceResponse:
+    """Response from queryInvoice API."""
+    invoice_number: str
+    invoice_date: Optional[str] = None
+    invoice_time: Optional[str] = None
+    order_id: Optional[str] = None
+    random_code: Optional[str] = None
+    buyer_identifier: Optional[str] = None
+    buyer_name: Optional[str] = None
+    seller_identifier: Optional[str] = None
+    seller_name: Optional[str] = None
+    invoice_status: Optional[str] = None
+    donate_mark: Optional[str] = None
+    carrier_type: Optional[str] = None
+    carrier_id: Optional[str] = None
+    npoban: Optional[str] = None
+    tax_type: Optional[str] = None
+    sales_amount: Optional[float] = None
+    tax_amount: Optional[float] = None
+    total_amount: Optional[float] = None
+    raw_xml: Optional[str] = None  # Original XML for additional parsing
+
+
+@dataclass
+class CancelInvoiceResponse:
+    """Response from cancelInvoice API."""
+    success: bool
+    code: str  # "C0" for success, error code otherwise
+    message: Optional[str] = None

cetustek-0.2.0.dist-info/METADATA

@@ -0,0 +1,315 @@
+Metadata-Version: 2.4
+Name: cetustek
+Version: 0.2.0
+Summary: Python SDK for Cetustek Taiwan e-invoice API
+Project-URL: Homepage, https://github.com/vincelee888/cetustek
+Project-URL: Repository, https://github.com/vincelee888/cetustek
+Project-URL: Issues, https://github.com/vincelee888/cetustek/issues
+Author: Vince Lee
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cetustek,e-invoice,einvoice,invoice,taiwan
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Cetustek
+
+Python SDK for [Cetustek](https://www.cetustek.com.tw/) Taiwan e-invoice API.
+
+## Installation
+
+```bash
+pip install cetustek
+```
+
+## Quick Start
+
+```python
+from cetustek import Cetustek, CreateInvoiceInput, InvoiceItem
+
+# Initialize the client
+client = Cetustek(
+    endpoint="https://invoice.cetustek.com.tw/InvoiceMultiWeb/InvoiceAPI",
+    rent_id="YOUR_RENT_ID",
+    site_code="YOUR_SITE_CODE",
+    api_password="YOUR_API_PASSWORD",
+)
+
+# Create an invoice
+result = client.createInvoice(CreateInvoiceInput(
+    order_id="12345678",
+    order_date="2026/01/15",
+    buyer_identifier="12345678",
+    buyer_name="Company Name",
+    donate_mark="0",
+    invoice_type="07",
+    tax_type="1",
+    pay_way="1",
+    items=[
+        InvoiceItem(
+            production_code="PROD001",
+            description="Product",
+            quantity=1,
+            unit_price=1000,
+        )
+    ],
+))
+
+# Access response as dataclass
+print(f"Invoice Number: {result.invoice_number}")
+print(f"Random Code: {result.random_code}")
+print(f"Invoice Year: {result.invoice_year}")
+```
+
+## API Reference
+
+### Cetustek Client
+
+```python
+from cetustek import Cetustek
+
+client = Cetustek(
+    endpoint="https://invoice.cetustek.com.tw/InvoiceMultiWeb/InvoiceAPI",
+    rent_id="YOUR_RENT_ID",
+    site_code="YOUR_SITE_CODE",
+    api_password="YOUR_API_PASSWORD",
+)
+```
+
+| Parameter | Description |
+|-----------|-------------|
+| `endpoint` | Cetustek API endpoint URL |
+| `rent_id` | Your Cetustek rent ID (統一編號) |
+| `site_code` | Your site code |
+| `api_password` | Your API password |
+
+### Create Invoice
+
+Create a new e-invoice. Returns `CreateInvoiceResponse`.
+
+```python
+from cetustek import CreateInvoiceInput, InvoiceItem, CetustekAPIError
+
+invoice_input = CreateInvoiceInput(
+    order_id="12345678",              # Unique order ID
+    order_date="2026/01/15",          # Format: yyyy/MM/dd
+    donate_mark="0",                  # 0: No donation, 1: Donate, 2: Donate to specific org
+    invoice_type="07",                # 07: B2B, 08: B2C
+    tax_type="1",                     # 1: Taxable, 2: Zero-rated, 3: Tax-free, 9: Mixed
+    pay_way="1",                      # Payment method code
+    items=[
+        InvoiceItem(
+            production_code="PROD001",
+            description="Product description",
+            quantity=1,
+            unit_price=1000,
+            unit="件",                # Optional: unit name
+        )
+    ],
+    # Optional fields
+    buyer_identifier="12345678",      # Buyer's tax ID (統一編號)
+    buyer_name="Company Name",
+    buyer_address="Address",
+    buyer_email="email@example.com",
+    tax_rate=0.05,                    # Default: 0.05 (5%)
+    carrier_type="3J0002",            # Carrier type code
+    carrier_id1="/ABC1234",           # Carrier ID
+    carrier_id2="/ABC1234",           # Carrier ID confirmation
+    npoban="12345",                   # NPO code for donation
+    remark="備註",                     # Remark
+)
+
+try:
+    result = client.createInvoice(invoice_input)
+    print(f"Invoice Number: {result.invoice_number}")  # e.g., "WP20260002"
+    print(f"Random Code: {result.random_code}")        # e.g., "6827"
+    print(f"Invoice Year: {result.invoice_year}")      # e.g., "2026"
+except CetustekAPIError as e:
+    print(f"Error: {e.code} - {e.message}")
+```
+
+### Query Invoice
+
+Query an existing invoice by number and year. Returns `QueryInvoiceResponse`.
+
+```python
+from cetustek import QueryInvoiceInput
+
+query_input = QueryInvoiceInput(
+    invoice_number="AA12345678",      # 10-character invoice number
+    invoice_year="2026",              # 4-digit year
+)
+
+result = client.queryInvoice(query_input)
+
+# Access invoice details
+print(f"Invoice Number: {result.invoice_number}")
+print(f"Order ID: {result.order_id}")
+print(f"Random Code: {result.random_code}")
+print(f"Buyer Name: {result.buyer_name}")
+print(f"Seller Name: {result.seller_name}")
+print(f"Total Amount: {result.total_amount}")
+print(f"Invoice Status: {result.invoice_status}")
+
+# Access raw XML for additional parsing
+print(result.raw_xml)
+```
+
+### Cancel Invoice
+
+Cancel (void) an existing invoice. Returns `CancelInvoiceResponse`.
+
+```python
+from cetustek import CancelInvoiceInput
+
+cancel_input = CancelInvoiceInput(
+    invoice_number="AA12345678",
+    invoice_year="2026",
+    remark="Cancellation reason",
+    return_tax_document_number=None,  # Optional: tax document number
+)
+
+# Standard cancellation (with validation)
+result = client.cancelInvoice(cancel_input)
+
+# Skip validation checks
+result = client.cancelInvoice(cancel_input, no_check=True)
+
+if result.success:
+    print("Invoice cancelled successfully")
+else:
+    print(f"Failed with code: {result.code}")
+```
+
+## Response Models
+
+### CreateInvoiceResponse
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `invoice_number` | str | 10-character invoice number (e.g., "WP20260002") |
+| `random_code` | str | 4-digit random code (e.g., "6827") |
+| `invoice_year` | str | Year extracted from invoice number (property) |
+
+### QueryInvoiceResponse
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `invoice_number` | str | Invoice number |
+| `invoice_date` | str | Invoice date |
+| `invoice_time` | str | Invoice time |
+| `order_id` | str | Order ID |
+| `random_code` | str | Random code |
+| `buyer_identifier` | str | Buyer tax ID |
+| `buyer_name` | str | Buyer name |
+| `seller_identifier` | str | Seller tax ID |
+| `seller_name` | str | Seller name |
+| `invoice_status` | str | Invoice status |
+| `donate_mark` | str | Donation mark |
+| `carrier_type` | str | Carrier type |
+| `carrier_id` | str | Carrier ID |
+| `npoban` | str | NPO code |
+| `tax_type` | str | Tax type |
+| `sales_amount` | float | Sales amount |
+| `tax_amount` | float | Tax amount |
+| `total_amount` | float | Total amount |
+| `raw_xml` | str | Original XML response |
+
+### CancelInvoiceResponse
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `success` | bool | Whether cancellation succeeded |
+| `code` | str | Response code ("C0" for success) |
+| `message` | str | Error message (if failed) |
+
+## Input Models
+
+### InvoiceItem
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `production_code` | str | Yes | Product code |
+| `description` | str | Yes | Product description |
+| `quantity` | float | Yes | Quantity |
+| `unit_price` | float | Yes | Unit price |
+| `unit` | str | No | Unit name (e.g., "件", "個") |
+
+### CreateInvoiceInput
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `order_id` | str | Yes | Unique order ID |
+| `order_date` | str | Yes | Order date (yyyy/MM/dd) |
+| `donate_mark` | str | Yes | Donation mark: 0/1/2 |
+| `invoice_type` | str | Yes | Invoice type: 07 (B2B) / 08 (B2C) |
+| `pay_way` | str | Yes | Payment method code |
+| `tax_type` | str | Yes | Tax type: 1/2/3/4/5/9 |
+| `items` | List[InvoiceItem] | Yes | Invoice items |
+| `buyer_identifier` | str | No | Buyer tax ID |
+| `buyer_name` | str | No | Buyer name |
+| `buyer_address` | str | No | Buyer address |
+| `buyer_email` | str | No | Buyer email |
+| `tax_rate` | float | No | Tax rate (default: 0.05) |
+| `carrier_type` | str | No | Carrier type code |
+| `carrier_id1` | str | No | Carrier ID |
+| `carrier_id2` | str | No | Carrier ID confirmation |
+| `npoban` | str | No | NPO code for donation |
+| `remark` | str | No | Remark |
+
+## Exception Handling
+
+```python
+from cetustek import CetustekError, CetustekAPIError
+
+try:
+    result = client.createInvoice(invoice_input)
+except CetustekAPIError as e:
+    # API returned an error response
+    print(f"API Error Code: {e.code}")
+    print(f"API Error Message: {e.message}")
+except CetustekError as e:
+    # General SDK error (e.g., invalid response format)
+    print(f"SDK Error: {e}")
+except Exception as e:
+    # Network or other errors
+    print(f"Error: {e}")
+```
+
+## Example
+
+See [example.py](example.py) for a complete working example.
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/vincelee888/cetustek.git
+cd cetustek
+
+# Install in development mode
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

cetustek-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+cetustek/__init__.py,sha256=IWKld6QIm0OW-Dx4MTuY8H4n3hvjnuXMS2521x0d1hE,701
+cetustek/client.py,sha256=S56MgkTvXJV0yfRDF98m9Q5hinhLtwenFdqNlv8MWUw,9399
+cetustek/models.py,sha256=ZXm8-EonV2bB2R7M3FHVXRbl6bg0si7a7JlL1JKXuIo,3119
+cetustek/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cetustek-0.2.0.dist-info/METADATA,sha256=GzAAKfR72vNCdlymyvtYpCf_gKwCBniri6_9tKmLMAw,9426
+cetustek-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+cetustek-0.2.0.dist-info/licenses/LICENSE,sha256=3Zyxxlid2vbpfK2L93sfxat307kl3auQ32KXigeRGiE,1066
+cetustek-0.2.0.dist-info/RECORD,,

cetustek-0.1.0.dist-info/METADATA

@@ -1,111 +0,0 @@
-Metadata-Version: 2.4
-Name: cetustek
-Version: 0.1.0
-Summary: Python SDK for Cetustek Taiwan e-invoice API
-Project-URL: Homepage, https://github.com/vincelee888/cetustek
-Project-URL: Repository, https://github.com/vincelee888/cetustek
-Project-URL: Issues, https://github.com/vincelee888/cetustek/issues
-Author: Vince Lee
-License-Expression: MIT
-License-File: LICENSE
-Keywords: cetustek,e-invoice,einvoice,invoice,taiwan
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Office/Business :: Financial
-Classifier: Typing :: Typed
-Requires-Python: >=3.9
-Requires-Dist: requests>=2.25.0
-Provides-Extra: dev
-Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
-Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# Cetustek
-
-Python SDK for Cetustek Taiwan e-invoice API.
-
-## Installation
-
-```bash
-pip install cetustek
-```
-
-## Usage
-
-```python
-from cetustek import Cetustek, CreateInvoiceInput, InvoiceItem
-
-# Initialize the client
-client = Cetustek(
-    endpoint="https://invoice.cetustek.com.tw/InvoiceMultiWeb/InvoiceAPI",
-    rent_id="YOUR_RENT_ID",
-    site_code="YOUR_SITE_CODE",
-    api_password="YOUR_API_PASSWORD",
-)
-
-# Create an invoice
-invoice_input = CreateInvoiceInput(
-    order_id="12345678",
-    order_date="2026/01/15",
-    buyer_identifier="12345678",
-    buyer_name="Company Name",
-    buyer_email="email@example.com",
-    donate_mark="0",
-    invoice_type="07",
-    tax_type="1",
-    tax_rate=0.05,
-    pay_way="1",
-    items=[
-        InvoiceItem(
-            production_code="PROD001",
-            description="Product description",
-            quantity=1,
-            unit_price=1000,
-            unit="件",
-        )
-    ],
-)
-
-result = client.createInvoice(invoice_input)
-```
-
-### Query an Invoice
-
-```python
-from cetustek import QueryInvoiceInput
-
-query_input = QueryInvoiceInput(
-    invoice_number="AA12345678",
-    invoice_year="2026",
-)
-
-result = client.queryInvoice(query_input)
-```
-
-### Cancel an Invoice
-
-```python
-from cetustek import CancelInvoiceInput
-
-cancel_input = CancelInvoiceInput(
-    invoice_number="AA12345678",
-    invoice_year="2026",
-    remark="Cancellation reason",
-)
-
-result = client.cancelInvoice(cancel_input)
-# Or use no_check=True to skip validation
-result = client.cancelInvoice(cancel_input, no_check=True)
-```
-
-## License
-
-MIT

cetustek-0.1.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-cetustek/__init__.py,sha256=IDmudJOsB1z-P6kdq3AXlAldzq5ycUrjiFViZmpZnYM,345
-cetustek/client.py,sha256=dpY7SO4PudPe3O8hgHXvEk9iD5eExc260W2wrkeOxqw,3911
-cetustek/models.py,sha256=Z0Pd9ujiF7fmkMMLHZgnxekvDZYdxE3IbxAiWjVrM3s,1565
-cetustek/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cetustek-0.1.0.dist-info/METADATA,sha256=5S3FSlwCAuxHiv493w1R7mJcm-ez8hdk5-fo8rG_VoU,2765
-cetustek-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-cetustek-0.1.0.dist-info/licenses/LICENSE,sha256=3Zyxxlid2vbpfK2L93sfxat307kl3auQ32KXigeRGiE,1066
-cetustek-0.1.0.dist-info/RECORD,,