asgard-ai-platform / tw-ecom-invoice-void

Name: asgard-ai-platform/tw-ecom-invoice-void
Author: asgard-ai-platform

Void Taiwan e-invoices within the same bimonthly window, or issue allowances (折讓) for cross-period corrections. Use when handling returns / refunds that affect invoice state. Do NOT use for initial issuance — see the 加值中心-specific skills. STATUS: SKELETON — body pending.

Version

SKILL.md

2.0 KB

Invoice Void & Allowance (作廢 / 折讓)

STATUS: SKELETON — body pending.

When to use this skill

A return / refund occurs within same bimonthly → void
A return / refund crosses bimonthly boundary → 折讓
Debugging invoice state inconsistency post-refund
Building void / allowance SOP

Do NOT use when

Initial issuance → issuance-layer skill
Tax filing impact → tw-tax-basics

Core concepts

TODO: void vs 折讓, bimonthly boundary, accounting implications.
NOTE (填充時): 此 skill 只寫「選哪條路」的決策邏輯，不重複 API 呼叫細節。
tw-ecom-invoice-ezpay 已有完整的 voidinvoice / issueallowance / trigger_allowance 步驟；
tw-ecom-invoice-universalec 同理。此 skill 的 Implementation guidance 應只提供判斷框架，
並用 "→ see tw-ecom-invoice-ezpay / -universalec" 指向 API 層。

Decision tree

TODO: given refund date vs issuance date → void or 折讓.

Implementation guidance

TODO: 決策路徑後的 SOP（accounting entries, customer notification, 字軌影響）。
不重複 voidinvoice / issueallowance / trigger_allowance 的 API 參數 — 那些在 ezpay/universalec skill。

Gotchas

TODO: 5-6 pitfalls (boundary off-by-one, 字軌 reservation, lottery invalidation, allowance numbering).

IRON LAW

TODO.

Output Format