Visma

Visma Other Addition Deduction API

Operations for managing other addition and deduction shortcuts for employees. Other addition and deduction shortcuts allow tracking of employee additions and/or deductions based on supplied pay code numbers.

GitHub OpenAPI

Operations 9

POST /v1/shortcuts/otheradditiondeduction Create an other addition deduction shortcut #
GET /v1/shortcuts/otheradditiondeduction/{otheradditiondeductionId} Get an other addition deduction shortcut by id #
GET /v1/shortcuts/otheradditiondeduction/{startDate}/{endDate} Get other addition deduction shortcuts between dates #
PUT /v1/shortcuts/otherAdditionDeduction/{id} Update an other addition deduction shortcut #
POST /v2/shortcuts/otheradditiondeduction Create other addition and deduction shortcut #
GET /v2/shortcuts/otheradditiondeduction/{shortcutId} Get other addition and deduction shortcut by id #
PUT /v2/shortcuts/otheradditiondeduction/{shortcutId} Update other addition and deduction shortcut #
DELETE /v2/shortcuts/otheradditiondeduction/{shortcutId} Delete other addition and deduction shortcut #
GET /v2/shortcuts/otheradditiondeduction/{startDate}/{endDate} Get other addition and deduction shortcuts between dates #

Documentation

📖
Documentation
https://docs.vismasoftware.no/vismanetapi/
📖
APIReference
https://docs.vismasoftware.no/vismanetapi/api-reference/
📖
GettingStarted
https://docs.vismasoftware.no/vismanetapi/introduction/getting-started-with-visma-net-api/
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/visma/refs/heads/main/rate-limits/visma-rate-limits.yml
📖
Documentation
https://developer.vismaonline.com/docs/spiris-eaccounting-api-documentation
📖
APIReference
https://eaccountingapi.vismaonline.com/swagger/ui/index
📖
Documentation
https://developer.vismaonline.com/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/visma/refs/heads/main/openapi/visma-otheradditiondeduction-api-openapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/visma/refs/heads/main/asyncapi/visma-net-erp-webhooks.yml
🔗
Support
https://docs.vismasoftware.no/vismanetapi/support/
🔗
Deprecation
https://docs.vismasoftware.no/vismanetapi/end-of-life-notices/
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/visma/refs/heads/main/conventions/visma-conventions.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/visma/refs/heads/main/llms/visma-eaccounting-llms.txt
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/visma/refs/heads/main/errors/visma-problem-types.yml
🔗
ChangeLog
https://developer.vismaonline.com/changelog

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/visma-otheradditiondeduction-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

visma-otheradditiondeduction-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Visma Other Addition Deduction API
  contact:
    email: api@spiris.se
  version: '1.0'
  description: 'Operations tagged OtherAdditionDeduction across 2 of this provider''s published API definitions: visma-payroll-api-v1-openapi-original.json, visma-payroll-api-v2-openapi-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://vlsapi.vismaonline.com/
tags:
- name: OtherAdditionDeduction
  description: Operations for managing other addition and deduction shortcuts for employees. Other addition and deduction shortcuts allow tracking of employee additions and/or deductions based on supplied pay code numbers.
paths:
  /v1/shortcuts/otheradditiondeduction:
    post:
      tags:
      - OtherAdditionDeduction
      summary: Create an other addition deduction shortcut
      description: Create a new other addition and deduction shortcut for an employee. The shortcut will be registered for specified date based on provided rows.
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/OtherAdditionDeductionApi'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OtherAdditionDeductionApi'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: postV1ShortcutsOtheradditiondeduction
      x-operation-id-source: derived
    servers:
    - url: https://vlsapi.vismaonline.com/
  /v1/shortcuts/otheradditiondeduction/{otheradditiondeductionId}:
    get:
      tags:
      - OtherAdditionDeduction
      summary: Get an other addition deduction shortcut by id
      description: Get a specific other addition and deduction shortcut by its unique identifier. Use query parameters to select specific properties in the response.
      parameters:
      - name: otherAdditionDeductionId
        in: path
        description: The other addition deduction shortcut id
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OtherAdditionDeductionApi'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: getV1ShortcutsOtheradditiondeductionByOtheradditiondeductionId
      x-operation-id-source: derived
    servers:
    - url: https://vlsapi.vismaonline.com/
  /v1/shortcuts/otheradditiondeduction/{startDate}/{endDate}:
    get:
      tags:
      - OtherAdditionDeduction
      summary: Get other addition deduction shortcuts between dates
      description: Get all other addition and deduction shortcuts within a specified date range. Use query parameters to filter the results or include only shortcuts created by the same client.
      parameters:
      - name: startDate
        in: path
        description: Start date in format yyyy-MM-dd
        required: true
        schema:
          type: string
          format: date-time
      - name: endDate
        in: path
        description: End date in format yyyy-MM-dd
        required: true
        schema:
          type: string
          format: date-time
      - name: includeOnlySameClientShortcuts
        in: query
        description: If true, only includes shortcuts created by the same client
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OtherAdditionDeductionApi'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: getV1ShortcutsOtheradditiondeductionByStartDateByEndDate
      x-operation-id-source: derived
    servers:
    - url: https://vlsapi.vismaonline.com/
  /v1/shortcuts/otherAdditionDeduction/{id}:
    put:
      tags:
      - OtherAdditionDeduction
      summary: Update an other addition deduction shortcut
      description: Update an existing other addition and deduction shortcut by replacing its content. Only shortcuts that have not been read (imported by a payroll administrator) can be updated. The shortcut must belong to the same third-party client that created it.
      parameters:
      - name: id
        in: path
        description: The shortcut id
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/OtherAdditionDeductionApi'
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OtherAdditionDeductionApi'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: putV1ShortcutsOtherAdditionDeductionById
      x-operation-id-source: derived
    servers:
    - url: https://vlsapi.vismaonline.com/
  /v2/shortcuts/otheradditiondeduction:
    post:
      tags:
      - OtherAdditionDeduction
      summary: Create other addition and deduction shortcut
      description: Create a new other addition and deduction shortcut for an employee. The shortcut will be registered for specified date based on provided rows.
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/OtherAdditionDeductionRequest'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OtherAdditionDeductionResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: postV2ShortcutsOtheradditiondeduction
      x-operation-id-source: derived
    servers:
    - url: https://vlsapi.vismaonline.com/
  /v2/shortcuts/otheradditiondeduction/{shortcutId}:
    get:
      tags:
      - OtherAdditionDeduction
      summary: Get other addition and deduction shortcut by id
      description: Get a specific other addition and deduction shortcut by its unique identifier. Use query parameters to select specific properties in the response.
      parameters:
      - name: shortcutId
        in: path
        description: The other addition and deduction shortcut id
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OtherAdditionDeductionResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: getV2ShortcutsOtheradditiondeductionByShortcutId
      x-operation-id-source: derived
    put:
      tags:
      - OtherAdditionDeduction
      summary: Update other addition and deduction shortcut
      description: Update an existing other addition and deduction shortcut by replacing its content. Only shortcuts that have not been read (imported by a payroll administrator) can be updated. The shortcut must belong to the same third-party client that created it.
      parameters:
      - name: shortcutId
        in: path
        description: The shortcut id
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/OtherAdditionDeductionRequest'
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OtherAdditionDeductionResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: putV2ShortcutsOtheradditiondeductionByShortcutId
      x-operation-id-source: derived
    delete:
      tags:
      - OtherAdditionDeduction
      summary: Delete other addition and deduction shortcut
      description: Delete other addition and deduction shortcut by its unique identifier. Only shortcuts that have not been read (imported by a payroll administrator) can be deleted. The shortcut must belong to the same third-party client that created it.
      parameters:
      - name: shortcutId
        in: path
        description: The shortcut id
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Request successful
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: deleteV2ShortcutsOtheradditiondeductionByShortcutId
      x-operation-id-source: derived
    servers:
    - url: https://vlsapi.vismaonline.com/
  /v2/shortcuts/otheradditiondeduction/{startDate}/{endDate}:
    get:
      tags:
      - OtherAdditionDeduction
      summary: Get other addition and deduction shortcuts between dates
      description: Get all other addition and deduction shortcuts within a specified date range. Use query parameters to filter the results or include only shortcuts created by the same client.
      parameters:
      - name: startDate
        in: path
        description: Start date in format yyyy-MM-dd
        required: true
        schema:
          type: string
          format: date-time
      - name: endDate
        in: path
        description: End date in format yyyy-MM-dd
        required: true
        schema:
          type: string
          format: date-time
      - name: includeOnlySameClientShortcuts
        in: query
        description: If true, only includes shortcuts created by the same client
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Request successful
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OtherAdditionDeductionResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CommonExtendedBadRequest'
      operationId: getV2ShortcutsOtheradditiondeductionByStartDateByEndDate
      x-operation-id-source: derived
    servers:
    - url: https://vlsapi.vismaonline.com/
components:
  schemas:
    CommonExtendedBadRequest:
      type: object
      properties:
        ErrorCode:
          type: integer
          format: int32
        DeveloperErrorMessage:
          type:
          - string
          - 'null'
        ErrorId:
          type: string
          format: uuid
        Errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/CommonError'
      additionalProperties: false
    CommonError:
      type: object
      properties:
        Field:
          type:
          - string
          - 'null'
        ErrorCode:
          type:
          - string
          - 'null'
        Message:
          type:
          - string
          - 'null'
        Key:
          type:
          - string
          - 'null'
      additionalProperties: false
    OtherAdditionDeductionRowApi:
      required:
      - PaycodeNumber
      type: object
      properties:
        PaycodeNumber:
          minLength: 1
          type: string
          description: 'Pay code number. Source: Get from /v1/paycodes'
        Quantity:
          type: number
          description: Addition/deduction quantity. Only required for allowance, mile compensation and benefit paycodes. Must be left empty otherwise. Max 2 decimals.
          format: double
        UnitPrice:
          type: number
          description: Addition/deduction unit price. Only for allowance and benefit paycodes, if not mile compensation and the paycode doesn't have a formula set. Must be left empty otherwise. If paycode is mile compensation, unit price can be overridden. Max 2 decimals.
          format: double
        Amount:
          type: number
          description: Addition/deduction amount. Only required for reimbursement paycodes. Must be left empty otherwise. Max 2 decimals.
          format: double
        VatAmount:
          maximum: 1000000000
          minimum: 0
          type: number
          description: Value-added tax amount. Only for reimbursement paycodes when the company uses VAT on outlay. Max 2 decimals.
          format: double
        CostCenterItemId1:
          type:
          - string
          - 'null'
          description: 'Cost center item ID 1. Source: Get from eAccounting API, /v2/costcenters'
          format: uuid
        CostCenterItemId2:
          type:
          - string
          - 'null'
          description: 'Cost center item ID 2. Source: Get from eAccounting API, /v2/costcenters'
          format: uuid
        CostCenterItemId3:
          type:
          - string
          - 'null'
          description: 'Cost center item ID 3. Source: Get from eAccounting API, /v2/costcenters'
          format: uuid
        ProjectId:
          type:
          - string
          - 'null'
          description: 'Project ID. Source: Get from eAccounting API, /v2/projects'
          format: uuid
      additionalProperties: false
    OtherAdditionDeductionApi:
      required:
      - Date
      - EmployeeId
      - Rows
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier provided by VLS
          format: uuid
          readOnly: true
        EmployeeId:
          type: string
          description: 'The ID of the employee that the shortcut is registered for. Source: Get from /v1/employees'
          format: uuid
        Date:
          type: string
          description: The date for the shortcut
          format: date-time
        Comment:
          maxLength: 2000
          minLength: 0
          type:
          - string
          - 'null'
          description: Optional comment for the shortcut
        Rows:
          type: array
          items:
            $ref: '#/components/schemas/OtherAdditionDeductionRowApi'
          description: Additions and/or deductions
      additionalProperties: false
    OtherAdditionDeductionRowRequest:
      required:
      - PaycodeNumber
      type: object
      properties:
        PaycodeNumber:
          minLength: 1
          type: string
          description: 'Pay code number. Source: get from /v2/paycodes.'
        Quantity:
          type: number
          description: 'Addition/deduction quantity (format: max 2 decimals). Required only for allowance, mile compensation and benefit paycodes.'
          format: double
        UnitPrice:
          type: number
          description: 'Addition/deduction unit price (format: max 2 decimals). Required only for allowance and benefit paycodes, if not mile compensation and the paycode doesn''t have a formula set. If paycode is mile compensation it''s possible to override unit price.'
          format: double
        Amount:
          type: number
          description: 'Addition/deduction amount (format: max 2 decimals). Required only for reimbursement paycodes.'
          format: double
        VatAmount:
          maximum: 1000000000
          minimum: 0
          type: number
          description: 'Value-added tax amount (format: max 2 decimals). Required only for reimbursement paycodes and when the company uses vat on outlay.'
          format: double
        ProjectId:
          type:
          - string
          - 'null'
          description: 'Project ID. Source: get from eAccounting API, /v2/projects.'
          format: uuid
        CostCenterItemId1:
          type:
          - string
          - 'null'
          description: 'Cost center item ID 1. Source: get from eAccounting API, /v2/costcenters.'
          format: uuid
        CostCenterItemId2:
          type:
          - string
          - 'null'
          description: 'Cost center item ID 2. Source: get from eAccounting API, /v2/costcenters.'
          format: uuid
        CostCenterItemId3:
          type:
          - string
          - 'null'
          description: 'Cost center item ID 3. Source: get from eAccounting API, /v2/costcenters.'
          format: uuid
      additionalProperties: false
    OtherAdditionDeductionRowResponse:
      required:
      - PaycodeNumber
      type: object
      properties:
        PaycodeNumber:
          type:
          - string
          - 'null'
          description: Pay code number
        Quantity:
          type: number
          description: Addition/deduction quantity
          format: double
        UnitPrice:
          type: number
          description: Addition/deduction unit price
          format: double
        Amount:
          type: number
          description: Addition/deduction amount
          format: double
        VatAmount:
          type: number
          description: Value-added tax amount
          format: double
        ProjectId:
          type:
          - string
          - 'null'
          description: Project ID
          format: uuid
        CostCenterItemId1:
          type:
          - string
          - 'null'
          description: Cost center item ID 1
          format: uuid
        CostCenterItemId2:
          type:
          - string
          - 'null'
          description: Cost center item ID 2
          format: uuid
        CostCenterItemId3:
          type:
          - string
          - 'null'
          description: Cost center item ID 3
          format: uuid
      additionalProperties: false
    OtherAdditionDeductionRequest:
      required:
      - Date
      - EmployeeId
      - Rows
      type: object
      properties:
        EmployeeId:
          type: string
          description: 'The ID of the employee that the shortcut should be registered for. Source: get from /v2/employees.'
          format: uuid
        Date:
          type: string
          description: 'The date for the shortcut (format: yyyy-MM-dd)'
          format: date-time
        Comment:
          maxLength: 2000
          minLength: 0
          type:
          - string
          - 'null'
          description: Optional comment for the shortcut
        Rows:
          type: array
          items:
            $ref: '#/components/schemas/OtherAdditionDeductionRowRequest'
          description: Additions and/or deductions
      additionalProperties: false
    OtherAdditionDeductionResponse:
      required:
      - Rows
      type: object
      properties:
        Id:
          type: string
          description: Unique identifier provided by VLS
          format: uuid
        EmployeeId:
          type: string
          description: The ID of the employee that the shortcut is registered for
          format: uuid
        Date:
          type: string
          description: The date for the shortcut
          format: date-time
        Comment:
          type:
          - string
          - 'null'
          description: Optional comment for the shortcut
        Rows:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/OtherAdditionDeductionRowResponse'
          description: Additions and/or deductions
      additionalProperties: false
x-refined-from:
- visma-payroll-api-v1-openapi-original.json
- visma-payroll-api-v2-openapi-original.json
x-tagGroups:
- name: Sales
  tags:
  - ArticleLabels
  - Articles
  - CustomerInvoiceDrafts
  - CustomerInvoiceOffsets
  - CustomerInvoices
  - CustomerInvoiceValuationHistories
  - CustomerLabels
  - CustomerLedgerItems
  - Customers
  - DeliveryMethods
  - DeliveryTerms
  - DiscountAgreements
  - Orders
  - QuoteDrafts
  - Quotes
  - SalesPriceLists
  - TermsOfPayment
  - WebshopOrders
- name: Purchase
  tags:
  - BankAccounts
  - ForeignPaymentCodes
  - PurchaseReceiptDrafts
  - SupplierInvoiceDrafts
  - SupplierInvoices
  - SupplierInvoiceValuationHistories
  - SupplierLedgerItems
  - Suppliers
- name: Common
  tags:
  - Approval
  - AppStoreActivationStatus
  - AttachmentLinks
  - Attachments
  - AutoInvoice
  - Bank
  - Charts
  - CompanySettings
  - Company
  - Countries
  - Currencies
  - Documents
  - IdentityLookup
  - MessageThreads
  - Mobile
  - Notes
  - PartnerResourceLinks
  - SalesDocumentAttachments
  - Trials
  - Units
  - Users
  - VoTokenValidation
  - WebHooks
  - Zapier
- name: Accounting
  tags:
  - AccountBalance
  - Accounts
  - AccountTypes
  - AllocationPeriods
  - ArticleAccountCodings
  - BankTransactions
  - CostCenterItems
  - CostCenters
  - FiscalYears
  - InventoryItems
  - PaymentVoucher
  - Projects
  - SieFileImportExport
  - VatCode
  - VatReport
  - VoucherDrafts
  - Vouchers
  - VoucherWithOverunderPayment