Register a tax-portal account

Store a business's tax-portal account (tax code + password) so the system can log in on its behalf and synchronize invoices. The tax code is hashed and the password is encrypted — neither is stored in raw form.

POST /tax-accounts

Request body

Field	Type	Required	Meaning
mst	string	✅	Tax code / tax-portal login name
password	string	✅	Tax-portal password
triggerInitialSync	boolean		Immediately create an initial sync request (default true)
initialSync	object		Initial sync parameters (dateFrom, dateTo, fetchDetails)

Example request

{
  "mst": "0319074775",
  "password": "••••••••",
  "triggerInitialSync": true,
  "initialSync": { "dateFrom": "2025-03-01", "dateTo": "2025-03-31", "fetchDetails": true }
}

Example response (201)

{
  "id": "cf00eea0-af08-4e84-9aa3-e12d23b3a568",
  "maskedMst": "03•••••775",
  "status": "active",
  "initialJob": { "id": "b6bf6a2a-9082-4882-b798-b35fc5985894", "status": "queued" }
}

id is the accountId used in the following steps.

Account management

Function	Method	Endpoint
View	GET	/tax-accounts/{accountId}
List	GET	/tax-accounts
Change password	PATCH	/tax-accounts/{accountId}
Delete	DELETE	/tax-accounts/{accountId}

Updating the password

Changing the password via PATCH automatically unlocks the account if it was previously flagged with an invalid password (INVALID_CREDENTIALS).