Technical documentation (English)
Start here — Swagger UI
Product.EInvoice.WebApi — Swagger UI (stage)
For onboarding, signing, environments, and field rules, see the API integration guide below.
Audience
This section is for non–Chinese-speaking integrators (engineering, ERP vendors, overseas partners) who need stable URLs and English explanations for API integration and field semantics.
Legal notice
Authoritative terms (contracts, application forms, and regulatory wording) are defined in Chinese on the official e首發票 channels and in your service agreement. This English material is a working translation for technical integration only. If anything conflicts with the Chinese SSOT or your contract, the Chinese version and contract prevail.
Privacy (bilingual ZH/EN): Privacy policy (member carrier & personal data).
Recommended reading order
| Step | Topic | Description | Link |
|---|---|---|---|
| 1 | API integration guide | Swagger-first onboarding, signing (SHA256), environments, audit rules, endpoint overview, JSON field glossary | API integration guide |
| 2 | F0401 field mapping (full table) | Full expanded XML table: field paths, English descriptions, types, validation | F0401 field mapping (English) |
| 3 | Invoice issuance validation | Tax type, B/C class, totals, GUI check digit, carriers, upload windows | Invoice issuance validation (English) |
| 4 | F0401 key fields (short list) | Mandatory / high-use fields only | F0401 key fields (English) |
Chinese documentation (same site)
| Topic | Link |
|---|---|
| Technical hub (Chinese) | Technical overview (中文) |
| API guide (Chinese) | API notes (中文) |
| F0401 full table (Chinese) | F0401 field mapping (中文) |
| Invoice validation (Chinese) | 發票開立檢核作業 (中文) |
Version history
| Version | Date | Author | Changes |
|---|---|---|---|
| v1.0 | 2026-05-15 | SystemLead | Initial English technical hub; links to API guide and F0401 reference. |
| v1.1 | 2026-05-15 | SystemLead | Full F0401 mapping (EN) and invoice validation (EN); nav entries. |
| v1.2 | 2026-05-15 | SystemLead | Legal notice: link to bilingual privacy policy. |
| v1.3 | 2026-06-08 | SystemLead | Swagger-first hub; recommended reading order; OpenAPI JSON via API guide Advanced block. |