Introduction

E-Invoice Hub is a gateway that lets a Merchant Platform integrate once with many e-invoice providers through a single gateway — instead of integrating separately with each provider. This reduces cost, shortens development time and standardizes connectivity.

This documentation guides developers on how to connect their application (Client) to e-invoice services through the E-Invoice Hub.

For AI / Agents

👉 Download the full API spec (single-file for Vibe coding)

About e-invoices & 1Invoice

An electronic invoice (e-invoice) is an invoice that is created, digitally signed and stored entirely electronically, connected directly to the Tax Authority to ensure validity and transparency.

1Invoice is an e-invoice provider for SME businesses (trusted by 10,000+ businesses) — and one of the providers the E-Invoice Hub can connect to. Highlights:

• Fast issuance — issue an invoice with a single click, cutting processing time by up to 85%.
• 100% compliant — connects directly to the Tax Authority, ensuring valid invoices.
• Multi-device & secure — runs on Mobile, Web and Desktop; PCI DSS / ISO 27001 certified.

API Endpoints

Environment	Base URL
Staging	https://stag-invoice-hub.1invoice.vn
Production	https://invoice-hub.1invoice.vn

Note

Only run tests on the Staging environment; do not test on Production.

Conventions

• When calling an API on the E-Invoice Hub, you must specify which provider you want to use. A request URL has the structure: <base_url>/<provider>/<endpoint>.
• Field naming conventions in the request body:
  • a.x: field x of object a
  • a.n[]: field n is an array in object a
  • a.n[].x: field x in each element of array n
  • a[n]: the (n+1)-th element of object a
  • a[n].x: field x in the (n+1)-th element of object a