The new eTaxGo

Etaxgo V2 Partner API

Default module
Etaxgo V2 Partner API

Authentication
- Get access token (OAuth 2.0 Client Credentials)
Documents
- Create tax document with generation pipeline
- Create multiple tax documents in one request
- Generate PDF preview (no DB write)
- Full document detail + line items + linked docs
- Import multiple documents from pre-parsed Excel
- Download Excel import template with company branches
- Advanced document search with date range
- Create Debit Note (80) or Credit Note (81)
- Create Cancellation Note (T07)
- Create Replacement Tax Invoice (388)
- Stream signed PDF from blob storage
- Generate PDF preview for existing document
- Stream signed XML from blob storage
- Download PDF as attachment (password-protected if enabled)
Auth
- Register new company + admin user
- Exchange credentials for JWT tokens
- Refresh expired access token
- Initiate password reset email
- Set initial password using invite token (pwset:)
- Reset password using forgot-password token (pwreset:)
- Get current user context
- Revoke Keycloak sessions
Invite
- Invite staff user to current company
- Cancel pending invitation
- Resend set-password email to pending invite
- Disable user in auth provider (internal)
Users
- List active users for caller's company
- Update user name/role/status
- Soft delete user
- Get caller's signature info
- Upload or replace caller's signature image
- Delete caller's signature image
- Stream caller's signature image binary
Customers
- List customers (cursor-paginated)
- Create customer
- Update customer
- Soft delete customer
- Validate import data without writing DB
- Bulk insert validated customers
- Download XLSX import template
Products
- List products
- Create product
- Update product
- Soft delete product
- Download product Excel import template
- Validate product rows before import
- Commit validated product rows to database
Branches
- List all branches for company
- Create branch
- Update branch
- Soft delete branch
- Get branch settings
- Save branch settings
- List all branches across the tenant (admin only)
Company
- Get company details
- Update company name and PDF password setting
- Get seller branding for LINE LIFF
- Create new company + HQ branch under caller's tenant
- List all active companies in the tenant
- Stream company logo
- Upload company logo
- Delete company logo
- Resolve branchToken → company context for LINE LIFF
- Resolve default (HQ) branch token for a company
- Link existing CPT clientId to a company + optionally subscribe
Dashboard
- Get current company + branch info for header
- Document counts per tab
- Current month/year financial summary
- Current month document counts by type
- Current month sales totals
- Current year sales totals
- List documents (cursor-paginated)
- Distinct creator emails for branch
- Daily aggregates for a month
- All documents for a specific date
- Export monthly document summary as Excel
Deliveries
- Customer delivery records (cursor-paginated)
- Customer delivery status counts
- RD delivery records (cursor-paginated)
- RD delivery status counts
- Bulk resend email for documents
Locations
- Search Thai address data
Generator
- [Internal] Trigger document generation pipeline
Settings
- Get document running number configuration
- Save document running number configuration
DBD
- Proxy DBD company info lookup by tax ID
- DBD company search proxy
HSM
- [Internal] Sign XML with XAdES-BES (SHA-512)
- [Internal] Sign PDF with CAdES (SHA-512)
Subscription
- List CPT plan groups
- List CPT plans
- CPT subscription state change webhook
- Current active plan + items (flattened from CPT items[])
- Preview pricing before checkout
- Create invoice + switch plan — returns embedUrl
- Invoice list (page-based, NOT cursor)
- Invoice detail by invoiceId (integer)
- Returns CPT-hosted invoice PDF URL
- Invoice document download
Payments
- Initiate QR PromptPay payment
- Submit bank transfer notification
- Payment result by invoiceId
TIV Requests
- List TIV requests (cursor-paginated)
- Get TIV request detail by ID
- Reject a TIV request
- Issue document from TIV request → enqueues pdf.single pipeline
DocOne
- List years with archived documents
- List months with data for a given year
- List days with data for a given year+month
- List files for a date. Query: year, month, day
- Download single file (PDF or XML)
- Download multiple files as ZIP archive
Internal
- Update document RD status (called by notifier service)
- Get current RD status for a document
- Trigger CPT client creation for newly registered company
- Delete user from Keycloak (called by core-api on staff deletion)
Health
- Service health check
Schemas
- UserSignatureResponse
- SuccessResponse
- BuyerAddress
- SuccessEnvelope
- DocumentLineItem
- SuccessNull
- CreateDocumentRequest
- ErrorResponse
- ValidationErrorResponse
- DocumentSearchRequest
- PaginatedResponse
- DocumentSearchResponse
- PaginationMeta
- RegisterRequest
- TokenRequest
- OAuthTokenResponse
- TokenResponse
- PasswordTokenRequest
- EmailResponse
- MeResponse
- InviteRequest
- User
- CompanyOptionItem
- UpdateUserRequest
- CustomerRequest
- CompanyDetailsResponse
- UpdateCompanyInfoRequest
- BrandingResponse
- CreateCompanyRequest
- SequencePrefixItem
- SequenceSettingsResponse
- SaveSequenceSettingsRequest
- BranchItem
- ImportProductRow
- ImportProductPreviewRequest
- ImportProductPreviewResult
- ImportProductConfirmRequest
- ImportProductConfirmResult
- ProductRequest
- BranchRequest
- BranchSettingsRequest
- SubmitDocumentRequest
- CreateDocumentResponse
- AdjustmentDocRequest
- CancelDocRequest
- ReplacementDocRequest
- BatchDocumentRequest
- ImportExcelResponse
- GenerateRequest
- CptAddonDto
- CptPackageDto
- SignRequest
- SignResponse

AdjustmentDocRequest

{
    "referenceDocumentId": "62b3ae25-6839-46bc-87a7-4f7c1681cf0b",
    "purpose": "string",
    "purposeCode": "string",
    "items": [
        {}
    ]
}