Appearance
Import
Controller for mass imports.
Salaxy API v03, Finland only. 8 operations. Interactive version: REST API reference. Machine-readable: OpenAPI document.
The reference wins
These pages are generated from the OpenAPI document. If a guide and this reference disagree about a field, follow the reference. Error responses are not in the document — see Errors.
POST /v03/api/import/companies
Creates or assures the posted customer companies in the system. Checks required authorizations for the calling account. Please note that this method is only for TRUSTED partners.
Request body: CompanyImport[] (required)
Response: CompanyImport[]
Try it: interactive reference
POST /v03/api/import/workers
Creates or assures the posted worker employment relations in the system.
Request body: WorkerImport[] (required)
Response: WorkerImport[]
Try it: interactive reference
POST /v03/api/import/calculations
Adds posted calculations to a new or existing payroll object. The existing payroll object is search by company official id, salary date and source id
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
isMerge | query | boolean | If true, the included calculations should be merged into the existing calculations. | |
rowMergeOption | query | RowMergeOption | Merging option for the rows. | |
sourceId | query | string | Source id for the merged rows. Please note that if the RowMergeOption is RemoveImportedRows and the source ID is set, only the rows with the given source ID will be removed, otherwise if the source ID is not set, all rows with any source ID will be removed. | |
applyEmploymentDefaultRows | query | boolean | If true, any calculation should be added with the default rows from the employment. | |
applyWorktime | query | boolean | If true, resolves, recalculates and updates holidays and absences to the given calculations. |
Request body: CalculationImport[] (required)
Response: CalculationImport[]
Try it: interactive reference
POST /v03/api/import/invoicing/{channel}
Creates invoices for given payroll objects.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
channel | path | PaymentChannel | yes | Payment channel to use. |
Request body: InvoicingRequest[] (required)
Response: InvoicingRequest[]
Try it: interactive reference
POST /v03/api/import/einvoicing
Sends the invoices as einvoices.
Request body: EInvoicingRequest[] (required)
Response: EInvoicingRequest[]
Try it: interactive reference
POST /v03/api/import/invoice-settings-check/{type}
Checks the invoice settings for the company.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
type | path | string | yes | Check target: "sepa" for sepa-payments, or "eInvoice" for eInvoice -payments. |
Request body: InvoiceSettingsCheck[] (required)
Response: InvoiceSettingsCheck[]
Try it: interactive reference
POST /v03/api/import/workers-check
Checks the existence of given workers. The id for worker can be worker ID, social security number of employment ID.
Request body: WorkerCheck[] (required)
Response: WorkerCheck[]
Try it: interactive reference
GET /v03/api/import/einvoice/receiver
Queries the eInvoice address for the given official id (Y-tunnus).
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
officialId | query | string | The official identifier of the company (Y-tunnus). |
Response: EInvoiceAddress[]
Try it: interactive reference

