Migrate WS Hendelse from v5 to v6

What’s changed

The endpoint URLs are changed; where version 5 had a digit 5, version 6 has the digit 6

Enumerated data types changed to String

As the collaboration between banks and real estate brokers continue to evolve, Ambita must be able to add new values to enumeration. Changing the enumerated type can be regarded as a breaking change and can lead to parsing errors if the client code was generated based on an old enumerated type. Making the data types strings (xs:string) will allow us to add new values without breaking changes.

Two added document statuses

Document status in version 6 has two new statuses, both related to bank-broker collaboration. The new values are MOTTATT_AV_MEGLER and SAMHANDLING_FEILET.

Important

We will add new values to these types and the client (you) should not fail on receiving unknown values! We recommend to log unknown values and not fail the parsing on the client side.

Enumerated types changed to string

wsDocumentStatus and documentStatusCode

These two are now reduced to one value (of type string) and the same values are used both for input and response. See Document Status Codes for possible values.

hendelsesType

Event types changed from hendelsesType to string. Valid event types are:

  • STATUSOVERGANG

  • DOKUMENT_OPPRETTET

  • DOKUMENT_FJERNET

  • PREREQUISITE_OPPRETTET

  • PREREQUISITE_SLETTET

wsDokumentKilde

Query parameter kilde changed type from wsDokumentKilde to String. Valid sources are:

  • NETTLESER (actions performed in the UI)

  • INTEGRASJON (actions done through WebService)

  • ALLE