agentsclimarketplace

Tw einvoice guide

Skill charlieviettq/awesome-agent-skill/.claude/skills/tw-einvoice-guide

"Implement Taiwan's e-invoice (電子發票) system including platform integration, B2B vs B2C formats, carrier consolidation, and tax filing reconciliation. Use this skill when the user needs to set up e-invoicing for a Taiwan business, integrate with the MOF platform, understand carrier codes, or troubleshoot invoice issues — even if they say 'set up e-invoice', 'how does 電子發票 work', 'integrate with 財政部', or 'carrier barcode scanning'.".From its SKILL.md

Install
npx -y skills add charlieviettq/awesome-agent-skill --skill tw-einvoice-guide

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 24 stars24 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.6 KB, ~1.5k tokens by cl100k_base, as published. Nobody here has run it

Taiwan E-Invoice System (電子發票)

Framework

IRON LAW: E-Invoice Is Mandatory for Most B2C Businesses

Since 2019, businesses using 統一發票 must issue electronic invoices
through the 財政部電子發票整合服務平台. Paper invoices are being phased
out. Non-compliance triggers penalties and may affect 營業稅 filing.

System Architecture

Your System (POS/ERP/E-commerce)
    ↓ API / Turnkey
財政部電子發票整合服務平台 (einvoice.nat.gov.tw)
    ↓
Consumer (via 載具: 手機條碼 / 自然人憑證 / App)
    ↓
國稅局 (tax reconciliation)

Integration Methods

MethodHow It WorksBest ForComplexity
TurnkeyInstall MOF-provided software, batch upload invoicesTraditional businesses, low volumeMedium
API (加值服務中心)Connect via 加值中心 API (e.g., 綠界、藍新)E-commerce, SaaS, high volumeLow-Medium
Direct APIConnect directly to MOF platformLarge enterprises with IT teamHigh
POS integrationPOS vendor handles e-invoice nativelyRetail, F&BLow (vendor does it)

B2B vs B2C Invoice Differences

AspectB2B (營業人對營業人)B2C (營業人對消費者)
Buyer infoBuyer's 統編 requiredNo 統編 (consumer)
Format三聯式二聯式
Tax displayTax amount shown separatelyTax included in price
CarrierN/A手機條碼, 自然人憑證, or membership carrier
Prize eligibilityNoYes (中獎機制)

Carrier Types (載具)

CarrierCode FormatUse Case
手機條碼/XXXXXXX (slash + 7 chars)Most common consumer carrier
自然人憑證2 letters + 14 digitsGovernment ID-linked
會員載具 (membership)Defined by businessLoyalty program integration
捐贈碼3-7 digitsDonate invoice to charity

Implementation Steps

Phase 1: Registration

  1. Register on 財政部電子發票整合服務平台
  2. Apply for 加值服務中心 AppID (if using API method)
  3. Set up certificate and authentication

Phase 2: Development/Integration 4. Choose integration method (Turnkey vs API vs POS) 5. Implement invoice issuance: create, void, void-and-reissue 6. Implement carrier scanning (手機條碼 barcode) 7. Handle 捐贈碼 (donation codes)

Phase 3: Testing 8. Test in sandbox environment 9. Issue test invoices, verify on MOF platform 10. Test void/reissue flows

Phase 4: Go-Live 11. Switch to production environment 12. Monitor daily: match issued invoices vs MOF records 13. Bimonthly: reconcile with 營業稅 filing (401 form)

Common API Flows

Issue Invoice:

POST /invoice → { seller_id, buyer_id (optional), items[], amount, tax, carrier_type, carrier_id }
→ Response: { invoice_number, invoice_date, random_code }

Void Invoice:

POST /invoice/void → { invoice_number, invoice_date, void_reason }

Query Invoice:

GET /invoice/{number} → { status, items, amount, carrier }

Output Format

# E-Invoice Implementation Plan: {Business}

## Current State
- Business type: B2B / B2C / Both
- Current invoicing: Paper / Partial e-invoice / None
- Transaction volume: {N}/month

## Integration Method
- Method: {Turnkey / API / POS integration}
- Provider: {加值中心 name, if applicable}
- Rationale: {why this method}

## Implementation Checklist
- [ ] MOF platform registration
- [ ] AppID obtained
- [ ] Integration developed
- [ ] Sandbox testing passed
- [ ] Carrier scanning implemented
- [ ] Donation code support
- [ ] Production go-live
- [ ] Reconciliation process documented

## Timeline
| Phase | Duration | Milestone |
|-------|----------|-----------|
| Registration | 1-2 weeks | AppID obtained |
| Development | 2-4 weeks | Integration complete |
| Testing | 1-2 weeks | Sandbox verified |
| Go-live | 1 day | First production invoice |

Gotchas

  • Invoice number format is assigned by MOF: You don't generate invoice numbers. The MOF assigns number ranges (字軌) that you request in advance. Run out of numbers = can't issue invoices. Request well ahead of time.
  • Void window is limited: Invoices can be voided within the same bimonthly period. After the period closes, voiding requires a more complex process (折讓).
  • 手機條碼 scanning: The barcode is a slash + 7 characters. Many POS scanners need configuration to read this format correctly. Test with real 手機條碼 barcodes.
  • Prize drawing (中獎): B2C e-invoices are automatically entered into the government lottery (統一發票兌獎). Your system must support winner notification if the invoice was stored in a membership carrier.
  • Reconciliation is critical: The MOF platform is the source of truth. If your system's invoice records don't match the platform, your 營業稅 filing will have discrepancies. Reconcile daily.

References

  • For 加值服務中心 API documentation, see references/einvoice-api.md
  • For 營業稅 filing reconciliation, see the tw-tax-basics skill

What ships with it: 2 files

18.4 KB alongside SKILL.md

examples/

references/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.