LogoLogo
StatusSupportCommunity
  • Welcome
  • Getting Started
    • Quickstart
      • General
      • Environments
      • Authentication and authorization
      • OpenAPI documentation
      • API change policy
      • Notification periods
      • Legal notices
  • OpenAPI
    • OpenAPI V2
      • About
      • API reference
        • Report package
        • Instance
          • Balance sheet
          • Pivot
          • Compare
          • Inline compare
        • Report chat
          • Upload
          • Chat
          • Delete
        • Customer corner
          • Users
          • Certificate
          • File
            • Download
            • History
            • Upload big file
            • Multiple
            • Chunk
          • Product files
            • Download
            • Release
          • Report package tree
          • Send
          • Accept
          • User role
          • Delivery
            • Messages
              • Get all with filter
              • Upload Excel
              • Upload JSON
          • Instance
            • Properties
          • PDF
            • PDF provider
        • Delivery
          • Digipoort
          • SBR Nexus
          • HMRC
        • Status
          • Digipoort
          • SBR Nexus
          • HMRC
        • HMRC
          • Build ct600
          • Retrieve ct600
          • Embed irmark
        • Input import
          • Hash creation
            • Single file
          • Instance
            • Generation
            • CSV import
            • Data
            • Reported facts AI
            • Generation AI
        • Taxonomy
          • Entrypoints
            • Schema set
            • Parameters
            • Table of content
            • Tables
              • Status
            • Presentation
              • Base set response
              • Base set concept
            • Calculation
            • Definition
            • CSV
            • CSV Zip
            • CSV placeholder Zip
          • Entrypoint
          • Package
          • Concepts
          • Link roles
          • Taxonomy extension
          • Report extension
          • Extension
            • Concepts
            • Linkroles
            • Pivot
        • Validation
          • Status
          • Filtered status
          • Report package
            • ESMA/ESEF
            • SBR 2.0
          • Hash codes
          • Instance
            • XBRL core
            • XBRL dimensions
            • Inline XBRL
            • XBRL calculation
            • Formula assertions
            • Uniform
            • Duplicates
            • UTR list
            • Full
            • Filing rules
            • Non present facts
        • Rendering
          • Instance
            • Render
            • XHTML
            • HTML to inline package
            • Consistent
            • Consistent plus
            • Convert inline to XBRL
            • Tax report SBR
            • Uniform
            • Merge
            • Allowed render options
      • Specification
Powered by GitBook

Semansys Technologies BV © 2025 All Rights Reserved

On this page

Was this helpful?

Export as PDF
  1. Getting Started
  2. Quickstart

Notification periods

In regard to changes Semansys Technologies BV will strive to adhere to the following notification periods per type of change. Due to our versioning strategy at resource level this API has the possibility to run multiple versions of the same resource at one time. This allows for a window in which both the old and new version are available. Allowing for a gradual move to the new version.

Type of change
Notification period
Support period (old version)

Non breaking change.

Two weeks.

No new version.

Breaking change.

Two weeks.

6 months.

Critical.

Due to the nature of these changes we might not be able to follow the normal procedure for change management.

Depends on the severity of the issue.

API change definitions

Non-Breaking Changes

A non-breaking change is defined as any modification to the APIs that maintains backward compatibility and does not cause failures in applications that consume those APIs.

Examples of non-breaking changes include:

  • Adding new optional fields to existing resources

  • Introducing new endpoints

  • Adding new operations (GET/PUT/POST/PATCH/DELETE)

  • Adding new optional parameters to existing endpoints

  • Introducing new versions of a resource

Breaking Changes

A breaking change is defined as any modification to an API that could potentially cause failures in applications that consume that API.

Examples of breaking changes include:

  • Modifying existing JSON elements (changing names, datatypes, patterns, min/max length requirements, etc.)

  • Removing JSON elements, endpoints, operations, or parameters

  • Adding new required JSON elements to existing structures

  • Adding new required parameters to existing endpoints

  • Passing the obsoleteDate of a version for a resource

PreviousAPI change policyNextLegal notices

Last updated 2 months ago

Was this helpful?