Integration

The wec360° integration engine is a machine to machine application (M2M) used to collect and transform your unit data into the wec360° ecosystem. It’s based on fetching new data from the source endpoint at fixed intervals.

For an easy integration process we need you to have a JSON api openly available or be using any of the supported authentication methods below. It’s important that each unit has an immutable unique identifier (id/guid) so it can be identified and updated after the initial synchronization.

Your data model is easily transformed into ours using a configuration that contains a mapping table of sorts.

Each field in wec360°:s domain model gets mapped to a field in the endpoints response object using this transform configuration.

Once you have connected your fields to ours the integration configuration is completed and the data will be pulled from your api at the designated interval and update the units in the wec360° ecosystem.

This is a list of currently supported authentication methods. Custom authentication methods can be implemented on request.

• Basic authentication
• Static header key/values
• Static query string key/values
• OpenID Connect (OAuth 2)
• Mom-Api key (Momentum real estate system)

To establish an integration with the unit finder, the minimum information required for each unit is:

• Guid - A unique id for the specific unit
• Name - the name of the unit
• Status - for sale, sold, reserved etc.

json
{
  "guid": "abc-123",
  "name": "Unit abc-123",
  "status": "for_sale"
}

The unit finder has support for a lot of unit information, and we recommend that you add as much information as possible. Here's a list of the most commonly displayed information:

• Description - A selling description about the apartment or the project in general
• Access date - When is the apartment's move-in date?
• Sales start date - When will you start selling the apartments?
• Size - How big is the apartment?
• Rooms - How many rooms does the apartment have?
• Price - How much does the apartment cost?
• Monthly fee - How much is the monthly fee of the apartment?
• Latitude/longitude - Will show the apartments position on google maps
• External URL - If you have a special page for bidding or a real estate contact you wish to promote

json
{
  "guid": "abc-123",
  "name": "Unit abc-123",
  "status": "for_sale",
  "description": "A lovely apartment in a calm neighborhood",
  "accessDate": "2022-10-10",
  "salesStartDate": "2021-04-01",
  "size": "75",
  "rooms": "3",
  "price": "450000",
  "monthlyFee": "450",
  "latitude": "59.243756",
  "longitide": "15.199185",
  "extUrl": "https://www.wec360.com/project/units/abc-123"
}