T-VAN Integration
Overview
T-VAN (Tax Value Added Network) interaction is delegated and read-only. Issuance, signing and submission to the General Department of Taxation (GDT) all go through VNPAY via @nx/iiapi (see Issuance).
The @nx/t-van adapter is a thin typed Axios REST client that wraps VNPAY's T-VAN gateway. @nx/invoice uses it only for status and taxpayer (MST) queries. @nx/invoice does not hand-roll any T-VAN REST calls, does not submit invoices to T-VAN, and runs no custom webhook / retry / polling stack for it.
What @nx/invoice Does
| Concern | Owner |
|---|---|
| Issue / sign / submit to GDT | VNPAY via @nx/iiapi |
| T-VAN status / taxpayer (MST) query | @nx/t-van adapter (read-only) |
| Client registration | TVanConnectionComponent from TVAN_DEFAULT_CONNECTION (core Configuration row) |
The @nx/t-van Adapter
| Aspect | Detail |
|---|---|
| Base class | BaseTVanRequest extends AxiosNetworkRequest |
| Transport | typed Axios REST |
| Auth | API key (config.apiKey) |
| Provider | VNPAY T-VAN gateway |
| Usage | status / taxpayer (MST) queries - read-only |