cetustek 0.1.0__py3-none-any.whl

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/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/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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,8 @@
+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,,

cetustek-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

cetustek-0.1.0.dist-info/licenses/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.