cetustek 0.1.0

Python SDK for Cetustek Taiwan e-invoice API

Cetustek

Python SDK for Cetustek Taiwan e-invoice API.

Installation

pip install cetustek

Usage

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="[e-mail]",
    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

from cetustek import QueryInvoiceInput

query_input = QueryInvoiceInput(
    invoice_number="AA12345678",
    invoice_year="2026",
)

result = client.queryInvoice(query_input)

Cancel an Invoice

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