cetustek 0.1.0__tar.gz

cetustek-0.1.0/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(pip install:*)",
+      "Bash(python -m build:*)",
+      "Bash(pytest:*)"
+    ]
+  }
+}

cetustek-0.1.0/.gitignore

@@ -0,0 +1,212 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be added to the global gitignore or merged into this project gitignore.  For a PyCharm
+#  project, it is recommended to include the following files:
+#  .idea/
+#  .idea_modules/
+#  *.iml
+#  *.ipr
+#  *.iws
+
+# VS Code
+.vscode/
+*.code-workspace
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# Linux
+*~
+
+# IDEs
+.idea/
+*.swp
+*.swo
+*~
+
+# Database files
+*.db
+*.sqlite
+*.sqlite3
+
+# Log files
+*.log
+logs/
+
+# Temporary files
+*.tmp
+*.temp
+tmp/
+temp/
+
+# Environment variables
+.env.local
+.env.*.local
+.env.development
+.env.production
+
+# Local configuration
+config.local.py
+settings.local.py

cetustek-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vince Lee
+
+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.

cetustek-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+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/README.md

@@ -0,0 +1,81 @@
+# 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/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cetustek"
+version = "0.1.0"
+description = "Python SDK for Cetustek Taiwan e-invoice API"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Vince Lee" }
+]
+keywords = ["taiwan", "invoice", "e-invoice", "cetustek", "einvoice"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial",
+    "Typing :: Typed",
+]
+requires-python = ">=3.9"
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/vincelee888/cetustek"
+Repository = "https://github.com/vincelee888/cetustek"
+Issues = "https://github.com/vincelee888/cetustek/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cetustek"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

cetustek-0.1.0/src/cetustek/__init__.py

@@ -0,0 +1,19 @@
+"""Cetustek Taiwan e-invoice SDK."""
+
+from cetustek.client import Cetustek
+from cetustek.models import (
+    CancelInvoiceInput,
+    CreateInvoiceInput,
+    InvoiceItem,
+    QueryInvoiceInput,
+)
+
+__all__ = [
+    "Cetustek",
+    "CreateInvoiceInput",
+    "CancelInvoiceInput",
+    "QueryInvoiceInput",
+    "InvoiceItem",
+]
+
+__version__ = "0.1.0"

cetustek-0.1.0/src/cetustek/client.py

@@ -0,0 +1,124 @@
+import requests
+from xml.sax.saxutils import escape
+
+from cetustek.models import (
+    CreateInvoiceInput,
+    CancelInvoiceInput,
+    QueryInvoiceInput,
+)
+
+
+class Cetustek:
+    def __init__(self, *, endpoint: str, rent_id: str, api_password: str, site_code: str):
+        self.endpoint = endpoint
+        self.rent_id = rent_id
+        self.source = f"{site_code}{api_password}"
+
+    # -------------------------
+    # API methods
+    # -------------------------
+
+    def createInvoice(self, data: CreateInvoiceInput) -> str:
+        items_xml = ""
+        for item in data.items:
+            items_xml += f"""
+<ProductItem>
+  <ProductionCode>{escape(item.production_code)}</ProductionCode>
+  <Description>{escape(item.description)}</Description>
+  <Quantity>{item.quantity}</Quantity>
+  {f"<Unit>{escape(item.unit)}</Unit>" if item.unit else ""}
+  <UnitPrice>{item.unit_price}</UnitPrice>
+</ProductItem>
+"""
+
+        invoice_xml = f"""
+<Invoice XSDVersion="2.8">
+<OrderId>{escape(data.order_id)}</OrderId>
+<OrderDate>{data.order_date}</OrderDate>
+<BuyerIdentifier>{data.buyer_identifier or ""}</BuyerIdentifier>
+<BuyerName>{escape(data.buyer_name or "")}</BuyerName>
+<BuyerAddress>{escape(data.buyer_address or "")}</BuyerAddress>
+<BuyerEmailAddress>{escape(data.buyer_email or "")}</BuyerEmailAddress>
+<DonateMark>{data.donate_mark}</DonateMark>
+<InvoiceType>{data.invoice_type}</InvoiceType>
+<CarrierType>{data.carrier_type or ""}</CarrierType>
+<CarrierId1>{data.carrier_id1 or ""}</CarrierId1>
+<CarrierId2>{data.carrier_id2 or ""}</CarrierId2>
+<NPOBAN>{data.npoban or ""}</NPOBAN>
+<PayWay>{data.pay_way}</PayWay>
+<TaxType>{data.tax_type}</TaxType>
+<TaxRate>{data.tax_rate}</TaxRate>
+<Remark>{escape(data.remark or "")}</Remark>
+<Details>
+{items_xml}
+</Details>
+</Invoice>
+"""
+
+        inner = f"""
+<invoicexml><![CDATA[{invoice_xml}]]></invoicexml>
+<rentid>{self.rent_id}</rentid>
+<source>{self.source}</source>
+"""
+
+        return self._post_soap(self._wrap_soap("CreateInvoiceV3", inner))
+
+
+    def cancelInvoice(self, data: CancelInvoiceInput, no_check: bool = False) -> str:
+        invoice_xml = f"""
+<Invoice XSDVersion="2.8">
+<InvoiceNumber>{data.invoice_number}</InvoiceNumber>
+<InvoiceYear>{data.invoice_year}</InvoiceYear>
+<ReturnTaxDocumentNumber>{data.return_tax_document_number or ""}</ReturnTaxDocumentNumber>
+<Remark>{escape(data.remark)}</Remark>
+</Invoice>
+"""
+
+        inner = f"""
+<invoicexml><![CDATA[{invoice_xml}]]></invoicexml>
+<rentid>{self.rent_id}</rentid>
+<source>{self.source}</source>
+"""
+
+        action = "CancelInvoiceNoCheck" if no_check else "CancelInvoice"
+
+        return self._post_soap(self._wrap_soap(action, inner))
+
+    def queryInvoice(self, data: QueryInvoiceInput) -> str:
+        """
+        Query invoice by invoice number and year.
+        Returns XML string with invoice details.
+        """
+        inner = f"""
+<invoicenumber>{data.invoice_number}</invoicenumber>
+<invoiceyear>{data.invoice_year}</invoiceyear>
+<rentid>{self.rent_id}</rentid>
+<source>{self.source}</source>
+"""
+        return self._post_soap(self._wrap_soap("QueryInvoice", inner))
+
+
+    # -------------------------
+    # Internal helpers
+    # -------------------------
+    def _post_soap(self, body: str) -> str:
+        headers = {
+            "Content-Type": "text/xml; charset=utf-8",
+            "Accept": "text/xml",
+            "User-Agent": "Cetustek-Python-SDK/1.0",
+        }
+        resp = requests.post(self.endpoint, data=body.encode("utf-8"), headers=headers)
+        resp.raise_for_status()
+        return resp.text
+
+    def _wrap_soap(self, action: str, inner_xml: str) -> str:
+        return f"""<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
+               xmlns:tns="http://webservice.cetustek.com/">
+  <soap:Body>
+    <tns:{action}>
+      {inner_xml}
+    </tns:{action}>
+  </soap:Body>
+</soap:Envelope>
+"""

cetustek-0.1.0/src/cetustek/models.py

@@ -0,0 +1,57 @@
+from dataclasses import dataclass
+from typing import Optional, List
+
+
+@dataclass
+class InvoiceItem:
+    production_code: str      # ProductionCode
+    description: str           # Description
+    quantity: float            # Quantity
+    unit_price: float          # UnitPrice
+    unit: Optional[str] = None # Unit
+
+
+@dataclass
+class CreateInvoiceInput:
+    order_id: str
+    order_date: str                  # yyyy/MM/dd
+    donate_mark: str                 # 0 / 1 / 2
+    invoice_type: str                # 07 / 08
+    pay_way: str                     # Table 4
+    tax_type: str                    # 1 / 2 / 3 / 4 / 5 / 9
+
+    items: List[InvoiceItem]
+
+    # Optional buyer fields
+    buyer_identifier: Optional[str] = None
+    buyer_name: Optional[str] = None
+    buyer_address: Optional[str] = None
+    buyer_email: Optional[str] = None
+    buyer_person_in_charge: Optional[str] = None
+    buyer_tel: Optional[str] = None
+    buyer_fax: Optional[str] = None
+    buyer_customer_number: Optional[str] = None
+
+    # Carrier / donation
+    carrier_type: Optional[str] = None
+    carrier_id1: Optional[str] = None
+    carrier_id2: Optional[str] = None
+    npoban: Optional[str] = None
+
+    # Tax
+    tax_rate: Optional[float] = 0.05
+    remark: Optional[str] = None
+
+
+@dataclass
+class CancelInvoiceInput:
+    invoice_number: str      # AA12345678
+    invoice_year: str        # yyyy
+    remark: str              # 作廢原因
+    return_tax_document_number: Optional[str] = None
+
+
+@dataclass
+class QueryInvoiceInput:
+    invoice_number: str
+    invoice_year: str

cetustek-0.1.0/tests/test_cetustek.py

@@ -0,0 +1,191 @@
+"""
+pytest tests for the Cetustek SDK.
+
+Run:
+  pip install -e ".[dev]"
+  pytest -q
+"""
+
+from __future__ import annotations
+
+import html
+import random
+import re
+import time
+from datetime import datetime
+
+import pytest
+
+from cetustek import (
+    Cetustek,
+    CreateInvoiceInput,
+    CancelInvoiceInput,
+    QueryInvoiceInput,
+    InvoiceItem,
+)
+
+
+@pytest.fixture()
+def sdk() -> Cetustek:
+    return Cetustek(
+        endpoint="https://invoice.cetustek.com.tw/InvoiceMultiWeb/InvoiceAPI",
+        rent_id="89011917",
+        site_code="ball888",
+        api_password="CACBFF1E1",
+    )
+
+@pytest.fixture()
+def create_invoice_input() -> CreateInvoiceInput:
+    # Generate random order ID
+    order_id = str(random.randint(10000000, 99999999))
+
+    # Get current date in yyyy/MM/dd format
+    order_date = datetime.fromtimestamp(time.time()).strftime("%Y/%m/%d")
+
+    return CreateInvoiceInput(
+        order_id=order_id,
+        order_date=order_date,
+        buyer_identifier="53118823",
+        buyer_name="鯨躍科技有限公司",
+        buyer_email="test@cetustek.com.tw",
+        donate_mark="0",
+        invoice_type="07",
+        tax_type="1",
+        tax_rate=0.05,
+        pay_way="1",
+        remark="",
+        items=[
+            InvoiceItem(
+                production_code="AA783456",
+                description="DESCAA7890123456",
+                quantity=1,
+                unit="月",
+                unit_price=50000,
+            )
+        ],
+    )
+
+
+@pytest.fixture()
+def created_invoice(sdk: Cetustek, create_invoice_input: CreateInvoiceInput) -> tuple[str, str]:
+    """Create an invoice and return (invoice_number, invoice_year)."""
+    result = sdk.createInvoice(create_invoice_input)
+
+    # Extract return value from <return> tag
+    return_match = re.search(r"<return>(.*?)</return>", result)
+    assert return_match is not None, "Response should contain <return> tag"
+
+    return_value = return_match.group(1).strip()
+    assert ";" in return_value, f"Success response should contain ';' separator, got: {return_value}"
+
+    invoice_number, _ = return_value.split(";")
+
+    # Extract year from invoice number (format: WP20260002 -> year is 2026)
+    # Invoice number format: 2 letters + 4 digits (year) + 4 digits (sequence)
+    assert len(invoice_number) == 10, f"Invoice number should be 10 characters, got: {invoice_number}"
+    invoice_year = invoice_number[2:6]  # Extract year from position 2-5 (e.g., "2026")
+
+    return invoice_number, invoice_year
+
+
+def test_create_invoice(sdk: Cetustek, create_invoice_input: CreateInvoiceInput):
+    """Test createInvoice makes a real API call and returns success response."""
+    result = sdk.createInvoice(create_invoice_input)
+
+    # Verify response is not empty
+    assert result is not None
+    assert len(result) > 0
+
+    # Verify SOAP envelope structure
+    assert "<S:Envelope" in result or "<soap:Envelope" in result
+    assert "<S:Body>" in result or "<soap:Body>" in result
+    assert "CreateInvoiceV3Response" in result
+
+    # Extract return value from <return> tag
+    return_match = re.search(r"<return>(.*?)</return>", result)
+    assert return_match is not None, "Response should contain <return> tag"
+
+    return_value = return_match.group(1).strip()
+    assert len(return_value) > 0, "Return value should not be empty"
+
+    # Verify success format: "INVOICE_NUMBER;RANDOM_NUMBER" (e.g., "WP20260002;6827")
+    assert ";" in return_value, f"Success response should contain ';' separator, got: {return_value}"
+    parts = return_value.split(";")
+    assert len(parts) == 2, f"Return value should have format 'INVOICE;RANDOM', got: {return_value}"
+
+    invoice_number, random_number = parts
+    assert len(invoice_number) == 10, "Invoice number should be 10 characters"
+    assert len(random_number) == 4, "Random number should be 4 characters"
+    assert invoice_number[0:2].isalpha(), f"Invoice number should start with two alphabets, got: {invoice_number}"
+    assert invoice_number[2:10].isdigit(), f"Invoice number should be 8 digits, got: {invoice_number}"
+
+def test_query_invoice(sdk: Cetustek, created_invoice: tuple[str, str]):
+    """Test queryInvoice makes a real API call and returns invoice details."""
+    invoice_number, invoice_year = created_invoice
+
+    query_input = QueryInvoiceInput(
+        invoice_number=invoice_number,
+        invoice_year=invoice_year,
+    )
+    result = sdk.queryInvoice(query_input)
+
+    # Verify response is not empty
+    assert result is not None
+    assert len(result) > 0
+
+    # Verify SOAP envelope structure
+    assert "<S:Envelope" in result or "<soap:Envelope" in result
+    assert "<S:Body>" in result or "<soap:Body>" in result
+    assert "QueryInvoiceResponse" in result
+
+    # Extract return value from <return> tag
+    return_match = re.search(r"<return>(.*?)</return>", result, re.DOTALL)
+    assert return_match is not None, "Response should contain <return> tag"
+
+    return_xml_escaped = return_match.group(1).strip()
+    assert len(return_xml_escaped) > 0, "Return XML should not be empty"
+
+    # Unescape HTML entities (e.g., &lt; becomes <, &gt; becomes >, &#13; becomes carriage return)
+    return_xml = html.unescape(return_xml_escaped)
+
+    # Verify return contains XML invoice data
+    assert return_xml.startswith("<"), "Return value should be XML after unescaping"
+    assert "<Invoice" in return_xml or "<invoice" in return_xml, "Return should contain invoice data"
+    assert invoice_number in return_xml, f"Return should contain invoice number {invoice_number}"
+
+    # Verify key invoice fields are present
+    assert "<InvoiceNumber>" in return_xml or "<invoicenumber>" in return_xml, "Return should contain InvoiceNumber"
+    assert "<OrderID>" in return_xml or "<orderid>" in return_xml, "Return should contain OrderID"
+    assert "<RandomNumber>" in return_xml or "<randomnumber>" in return_xml, "Return should contain RandomNumber"
+
+
+def test_cancel_invoice(sdk: Cetustek, created_invoice: tuple[str, str]):
+    """Test cancelInvoice makes a real API call and returns success response."""
+    invoice_number, invoice_year = created_invoice
+
+    cancel_input = CancelInvoiceInput(
+        invoice_number=invoice_number,
+        invoice_year=invoice_year,
+        remark="測試作廢",
+    )
+
+    result = sdk.cancelInvoice(cancel_input, no_check=True)
+
+    # Verify response is not empty
+    assert result is not None
+    assert len(result) > 0
+
+    # Verify SOAP envelope structure
+    assert "<S:Envelope" in result or "<soap:Envelope" in result
+    assert "<S:Body>" in result or "<soap:Body>" in result
+    assert "CancelInvoiceNoCheckResponse" in result
+
+    # Extract return value from <return> tag
+    return_match = re.search(r"<return>(.*?)</return>", result)
+    assert return_match is not None, "Response should contain <return> tag"
+
+    return_value = return_match.group(1).strip()
+    assert len(return_value) > 0, "Return value should not be empty"
+
+    # Verify success code format: "C0" for success
+    assert return_value == "C0", f"Success response should be 'C0', got: {return_value}"