Download OpenAPI specification:Download
Assignment API allows an agent to manage an assignment for realty. Assignment is required to purchase, sell or rent a realty. Assignments are divided into different types:
Each assignment type has its own endpoint with POST
, PUT
, GET
and DELETE
methods.
Assignment can be continued to extend its validity period. This can be achieved by creating a continuation agreement with /assignments/{assignmentId}/continuationAgreements
endpoint.
In addition, there is an endpoint /assignments
to query assignments with different search criteria.
If you have any questions, comments or feedback regarding our APIs, please contact developer@ovipro.fi.
Fetch assignments by using different search criteria. You can combine the search criteria, for example to search for active sales assignments for a specified agent office.
partyId | string <uuid> Search by the party identifier to fetch the specified assignment. |
realtyId | string <uuid> Search by the realty identifier to fetch the specified assignment. |
assetRequirementId | string <uuid> Search by the asset requirement identifier to fetch the specified assignment. |
assignmentTypeCode | Array of strings (AssignmentTypeCode) Items Enum: "SALES" "PURCHASE" "RENTAL" Example: assignmentTypeCode=PURCHASE Search by the assignment type to fetch the specified types of assignments. |
assignmentStatusCode | Array of strings (AssignmentStatusCode) Items Enum: "DRAFT" "READY_FOR_SIGNING" "ACTIVE" "FINISHED" "REJECTED" Example: assignmentStatusCode=ACTIVE Search by the assignment status to fetch assignments with a particular status. |
agentId | Array of strings <uuid> (AgentId) [^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8...] Example: agentId=5d2a6d47-da73-4b11-8940-27cffabb6de5 Search by the agent ids to fetch assignments associated with specific agents. |
responsibleAgentId | Array of strings <uuid> (AgentId) [^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8...] Example: responsibleAgentId=5d2a6d47-da73-4b11-8940-27cffabb6de5 Search by the responsible agent ids to fetch assignments where the agent is responsible. |
agencyOfficeId | Array of strings <uuid> (AgencyOfficeId) [^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8...] Example: agencyOfficeId=212114ec-819e-483c-a8e0-f82289ac6e19 Search by the agency office identifiers to get a list of assignment that belong to certain agency offices. |
endDateAfter | string <date> Search by the agreement validity endDate to fetch assignments that have an end date after or equal to the specified date. |
endDateBefore | string <date> Search by the agreement validity endDate to fetch assignments that have an end date before or equal to the specified date. |
startIndex | integer <int32> >= 0 Default: 0 Example: startIndex=20 Paginate returned assignments starting from this index. Index starts from 0. |
size | integer <int32> [ 1 .. 100 ] Default: 50 Example: size=40 Assignments returned per page. |
sort | Array of strings Example: sort=validAfter|desc Sort assignments based on the specified fields. Each fields must also include a sort order as follows:
|
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "totalCount": 3,
- "assignments": [
- {
- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "officialAssignmentId": "201252021",
- "assignmentStatusCode": "ACTIVE",
- "assignmentTypeCode": "PURCHASE",
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT",
- "firstName": "Veikko",
- "lastName": "Viljanen"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT",
- "firstName": "Tiina",
- "lastName": "Tuppurainen"
}
], - "agreementValidity": {
- "agreementTypeCode": "FIXED_TERM",
- "validityPeriod": {
- "startDate": "2021-02-04",
- "endDate": "2021-04-04",
- "actualEndDate": "2021-03-02"
}
}, - "customerParties": [
- {
- "partyId": "62701576-2621-4a27-8d2b-63cea492abb6",
- "partyTypeCode": "PERSON_PARTY"
}
], - "modificationTime": "2021-08-31T10:19:34Z"
}, - {
- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "officialAssignmentId": "201757023",
- "assignmentStatusCode": "ACTIVE",
- "assignmentTypeCode": "SALES",
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT",
- "firstName": "Veikko",
- "lastName": "Viljanen"
}
], - "agreementValidity": {
- "agreementTypeCode": "INDEFINITE_TERM",
- "validityPeriod": {
- "startDate": "2021-06-04",
- "periodCount": 1
}
}, - "assets": [
- {
- "realtyId": "191a5c7c-d4d6-49f0-8cfc-4fa5ec168fb0",
- "subcategoryCode": "SHARE",
- "address": {
- "addressLine1": "Yliopistonkatu 55",
- "stairwell": "C",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityName": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}
}
], - "customerParties": [
- {
- "partyId": "62701576-2621-4a27-8d2b-63cea492abb6",
- "partyTypeCode": "PERSON_PARTY"
}
], - "modificationTime": "2021-08-31T10:19:34Z"
}, - {
- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "officialAssignmentId": "201764027",
- "assignmentStatusCode": "ACTIVE",
- "assignmentTypeCode": "RENTAL",
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT",
- "firstName": "Veikko",
- "lastName": "Viljanen"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT",
- "firstName": "Tiina",
- "lastName": "Tuppurainen"
}
], - "agreementValidity": {
- "agreementTypeCode": "FIXED_TERM",
- "validityPeriod": {
- "startDate": "2022-03-01",
- "endDate": "2022-04-30",
- "actualEndDate": "2022-03-28"
}
}, - "assets": [
- {
- "realtyId": "191a5c7c-d4d6-49f0-8cfc-4fa5ec168fb0",
- "subcategoryCode": "SHARE",
- "address": {
- "addressLine1": "Yliopistonkatu 55",
- "stairwell": "C",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityName": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}
}
], - "customerParties": [
- {
- "partyId": "62701576-2621-4a27-8d2b-63cea492abb6",
- "partyTypeCode": "PERSON_PARTY"
}
], - "modificationTime": "2021-08-31T10:19:34Z"
}
]
}
Execute assignment action.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the action to be executed for the assignment.
actionCode required | string Enum: "REJECT" "LOCK" "UNLOCK" "ACTIVATE" "FINISH" Action to be executed. The actions can be used to trigger the following status transitions:
|
{- "actionCode": "LOCK"
}
{ }
Sets official assignment identifier for the specified assignment. This method can be used in data migrations to set official assignment identifier for assignments that don't have existing official assignment identifier and are in DRAFT status.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the updated official assignment identifier.
officialAssignmentId required | string (OfficialAssignmentId) Official identifier for the assignment. This identifier is defined by transaction platform, usually OviPro. |
{- "officialAssignmentId": "3762024"
}
{ }
Purchase Assignment API allows you to create, update and fetch purchase assignments.
Asset requirements can be linked to the purchase assignment upon creation or update of the assignment.
Create a new purchase assignment.
The asset requirements entity is defined separately and can be linked to the purchase assignment by providing value for the assetRequirementId
field.
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the details for the purchase assignment.
required | object (Assignment) Assignment details |
required | Array of objects (BuyerParty) Specifies the buyer customers which are associated with this assignment. |
assetRequirementId | string <uuid> (AssetRequirementId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the asset requirement in the UUID format. |
object (AgreementValidity) Contains details about agreement validity. | |
object (Costs) Contains details about the agreement costs. | |
object (OtherConditions) Contains details about the other conditions for this assignment. | |
creationTime | string <date-time> (Timestamp) Timestamp as defined by ISO 8601 with time offset. |
{- "assignment": {
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "lead": {
- "contactMethodCode": "BANKING_COOPERATION"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "exclusivityTypeCode": "EXCLUSIVE_BASIS",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}, - "supplierAssignedIdentifiers": [
- {
- "supplierAssignedId": "a12456789",
- "schemeId": "CCS_ID"
}
]
}, - "buyerCustomerParties": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "isFirstTimeBuyer": false
}
], - "assetRequirementId": "45221bb8-2deb-47c4-b5e4-155a8f1770dd",
- "agreementValidity": {
- "agreementTypeCode": "INDEFINITE_TERM",
- "validityPeriod": {
- "startDate": "2021-06-04",
- "periodCount": 1
}, - "validityContinuedAfterRedemption": false
}, - "costs": {
- "commission": {
- "commissionBasisCode": "DEBT_FREE_PRICE",
- "commissionTypeCode": "OTHER_COMMISSION",
- "otherCommissionDescription": "Toteutuma asunnon toteutuneesta velattomasta kauppahinnasta",
- "vatIncluded": true,
- "commissionPercentage": 5.5,
- "minimumCommissionAmount": 9900,
- "fixedCommissionAmount": 15000,
- "baseCommissionAmount": 3000,
- "commissionAmountUponRedemptionByOtherParty": 2000,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "otherExpensesPaidUponRedemption": true,
- "otherExpensesWillBePaidUponRightOfFirst": true,
- "commissionAmountUponRightOfFirst": 13000,
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan lisäksi matkakulut"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Matkakulut maksetaan kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{- "assignmentId": "7fe90453-0dea-4da8-9b42-d707704490e7"
}
Fetch details for the specified purchase assignment.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "officialAssignmentId": "201252021",
- "assignmentStatusCode": "ACTIVE",
- "assignmentTypeCode": "PURCHASE",
- "assignment": {
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "lead": {
- "contactMethodCode": "BANKING_COOPERATION"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "exclusivityTypeCode": "EXCLUSIVE_BASIS",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}, - "supplierAssignedIdentifiers": [
- {
- "supplierAssignedId": "a12456789",
- "schemeId": "CCS_ID"
}
]
}, - "buyerCustomerParties": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "isFirstTimeBuyer": false
}
], - "assetRequirementId": "45221bb8-2deb-47c4-b5e4-155a8f1770dd",
- "agreementValidity": {
- "agreementTypeCode": "INDEFINITE_TERM",
- "validityPeriod": {
- "startDate": "2021-06-04",
- "periodCount": 1
}, - "validityContinuedAfterRedemption": false
}, - "contractDocumentId": "1e51dace-9004-48ea-84d8-23657476c1c5",
- "costs": {
- "commission": {
- "commissionBasisCode": "DEBT_FREE_PRICE",
- "commissionTypeCode": "OTHER_COMMISSION",
- "otherCommissionDescription": "Toteutuma asunnon toteutuneesta velattomasta kauppahinnasta",
- "vatIncluded": true,
- "commissionPercentage": 5.5,
- "minimumCommissionAmount": 9900,
- "fixedCommissionAmount": 15000,
- "baseCommissionAmount": 3000,
- "commissionAmountUponRedemptionByOtherParty": 2000,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "otherExpensesPaidUponRedemption": true,
- "otherExpensesWillBePaidUponRightOfFirst": true,
- "commissionAmountUponRightOfFirst": 13000,
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan lisäksi matkakulut"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Matkakulut maksetaan kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}, - "creationTime": "2021-03-13T12:07:23.000Z",
- "modificationTime": "2021-08-15T08:04:44.000Z"
}
Update the details of the purchase assignment whose id is given as a path variable.
The asset requirements entity is defined separately and can be linked to the purchase assignment by providing value for the assetRequirementId
field.
A purchase assignment can be updated only when its status is DRAFT
.
The associated asset requirements can be updated also when assignment in ACTIVE
state, if the customer permission has been acquired for the updates.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the updated purchase assignment.
assignmentId required | string <uuid> (AssignmentId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the assignment in the UUID format. |
required | object (Assignment) Assignment details |
required | Array of objects (BuyerParty) Specifies the buyer customers which are associated with this assignment. |
assetRequirementId | string <uuid> (AssetRequirementId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the asset requirement in the UUID format. |
object (AgreementValidity) Contains details about agreement validity. | |
object (Costs) Contains details about the agreement costs. | |
object (OtherConditions) Contains details about the other conditions for this assignment. |
{- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "assignment": {
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "lead": {
- "contactMethodCode": "BANKING_COOPERATION"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "exclusivityTypeCode": "EXCLUSIVE_BASIS",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}, - "supplierAssignedIdentifiers": [
- {
- "supplierAssignedId": "a12456789",
- "schemeId": "CCS_ID"
}
]
}, - "buyerCustomerParties": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "isFirstTimeBuyer": false
}
], - "assetRequirementId": "45221bb8-2deb-47c4-b5e4-155a8f1770dd",
- "agreementValidity": {
- "agreementTypeCode": "INDEFINITE_TERM",
- "validityPeriod": {
- "startDate": "2021-06-04",
- "periodCount": 1
}, - "validityContinuedAfterRedemption": false
}, - "costs": {
- "commission": {
- "commissionBasisCode": "DEBT_FREE_PRICE",
- "commissionTypeCode": "OTHER_COMMISSION",
- "otherCommissionDescription": "Toteutuma asunnon toteutuneesta velattomasta kauppahinnasta",
- "vatIncluded": true,
- "commissionPercentage": 5.5,
- "minimumCommissionAmount": 9900,
- "fixedCommissionAmount": 15000,
- "baseCommissionAmount": 3000,
- "commissionAmountUponRedemptionByOtherParty": 2000,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "otherExpensesPaidUponRedemption": true,
- "otherExpensesWillBePaidUponRightOfFirst": true,
- "commissionAmountUponRightOfFirst": 13000,
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan lisäksi matkakulut"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Matkakulut maksetaan kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{ }
Deletes the specified purchase assignment whose id is given as a path variable.
A purchase assignment can be deleted only if its status is: DRAFT
.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "errorCode": "BAD_REQUEST_PARAMETERS",
- "message": "Invalid request parameters",
- "description": "Request parameters are missing or have invalid type.",
- "errors": [
- {
- "target": "assignmentId",
- "errorCode": "VALUE_REQUIRED",
- "message": "Mandatory request parameter assignmentId is missing"
}, - {
- "target": "authorId",
- "errorCode": "INVALID_TYPE",
- "message": "Request parameter authorId must be a string"
}
]
}
Create a new sales assignment.
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the details for the sales assignment.
required | object (Assignment) Assignment details |
object (AgreementValidity) Contains details about agreement validity. | |
required | Array of objects (SellerParty) Specifies the seller customers which are associated with this assignment. |
Array of objects (ConsentorParty) Specifies the consentor parties which are associated with this assignment. | |
required | Array of objects (AssetsWrite) Assets to be sold in this assignment. A sales assignment typically includes one asset. However, there are situations when a sales assignment may include several assets:
|
object (Costs) Contains details about the agreement costs. | |
object (OtherConditions) Contains details about the other conditions for this assignment. | |
creationTime | string <date-time> (Timestamp) Timestamp as defined by ISO 8601 with time offset. |
{- "assignment": {
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "lead": {
- "contactMethodCode": "BANKING_COOPERATION"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}, - "supplierAssignedIdentifiers": [
- {
- "supplierAssignedId": "a12456789",
- "schemeId": "CCS_ID"
}
]
}, - "agreementValidity": {
- "agreementTypeCode": "INDEFINITE_TERM",
- "validityPeriod": {
- "startDate": "2021-06-04",
- "periodCount": 1
}, - "validityContinuedAfterRedemption": false
}, - "sellerCustomerParties": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": true,
- "hasBeenMarried": true,
- "hasLegalPartitioningOfAssets": true,
- "isDivorceLegallyBinding": true,
- "isResponsibleForObtainingConsent": true,
- "wasAdvisedOfTaxConsequences": true
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": false
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "ESTATE_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": false
}
}
], - "consentorParties": [
- {
- "partyId": "b7a58e6c-7c2d-47e2-bd33-0c76c504f533",
- "partyTypeCode": "PERSON_PARTY"
}
], - "assets": [
- {
- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0",
- "subcategoryCode": "PROPERTY",
- "realtyTypeCode": "RESIDENTIAL_SHARE",
- "plotHoldingTypeCode": "LEASEHOLD",
- "facilityId": "323-123-5423-8234-L1",
- "sellerDeclarationAboutEnergyCertificate": true,
- "availability": {
- "availabilityCode": "DATE",
- "date": "2021-05-25",
- "description": [
- {
- "languageCode": "fi",
- "text": "Saatavissa kahden kuukauden sisällä."
}, - {
- "languageCode": "sv",
- "text": "Tillgänglig inom två månader."
}
]
}, - "address": {
- "addressLine1": "Hämeenkatu 24",
- "stairwell": "B",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}, - "price": {
- "priceRequestTypeCode": "DEBT_FREE_PRICE",
- "sharesIncludeLoan": false,
- "debtFreePriceAmount": 240000,
- "salesPriceAmount": 210000,
- "currencyCode": "EUR",
- "auctionAllowed": true,
- "auction": {
- "startingPriceAmountWithoutLoan": 149000,
- "startingPriceAmount": 180000
}, - "requestedPriceChange": {
- "salesPriceAmount": 189000,
- "debtFreePriceAmount": 200000,
- "date": "2021-07-01"
}, - "estimatedSalesPriceAmount": "2000000"
}, - "termsAndConditions": {
- "estimatedAverageSellingTimeDescription": "Keskimäärin 2 kuukautta kesäaikana",
- "paymentTermsCodes": [
- "CASH"
], - "paymentTermsDescription": "Tilisiirto pankin kautta",
- "sellingStrengthsAndWeaknesses": "Erinomainen sijainti ja hyvät liikenneyhteydet. Keittiö kaipaa remontointia.",
- "outstandingMaintenanceCharges": true,
- "outstandingMaintenanceChargesAmount": 480,
- "currencyCode": "EUR",
- "wasAnotherAgencyPreviouslyAssigned": true,
- "contactDetailsForPreviouslyAssignedAgency": "Pirkanmaan Välitys LKV",
- "restrictiveRightOfUse": {
- "hasRestrictiveRightOfUse": true,
- "restrictiveRightOfUseDescription": "Leskellä testamentin perusteella oikeus asua asunnossa.",
- "consentToSaleAcquired": true
}
}, - "leaseAgreement": {
- "tenantName": "Matti Virtanen",
- "tenantContacts": [
- {
- "contactTypeCode": "PHONE",
- "value": "+358501235678"
}, - {
- "contactTypeCode": "EMAIL",
- "value": "matti.virtanen@example.com"
}
], - "leaseAgreementTypeCode": "WRITTEN_AGREEMENT",
- "leaseTermCode": "FIXED_TERM",
- "leasePeriod": {
- "startDate": "2017-01-01",
- "endDate": "2021-12-31"
}, - "hasLeaseBeenTerminated": true,
- "noticePeriod": "2 viikkoa",
- "leaseExpirationDate": "2021-10-30",
- "deposit": {
- "depositRequired": true,
- "depositAmount": 1800,
- "depositRepository": "Nordean tili",
- "depositDescription": "Vakuus vuokranantajan erillisellä tilillä"
}, - "rentAmount": 900,
- "currencyCode": "EUR",
- "tenantPaidRentOnTime": false,
- "tenantPaidRentOnTimeDescription": "Vuokra on kerran viivästynyt viikon verran.",
- "additionalDescription": "Pitkäaikainen vuokralainen"
}, - "acquisitionBySellers": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "ADVICED_TO_CONTACT_TAX_AUTHORITIES",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "TESTAMENT",
- "acquisitionDate": "2010-10-02"
}, - {
- "acquisitionMethodCode": "PURCHASE",
- "acquisitionDate": "2014-02-26",
- "acquisitionCost": 154000,
- "currencyCode": "EUR"
}
], - "residencePeriod": {
- "startDate": "2014-03-01",
- "endDate": "2021-05-31"
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "TAX_ON_CAPITAL_GAIN_NOT_PAYABLE",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "GIFT",
- "acquisitionDate": "2015-01-15"
}
]
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "ESTATE_PARTY",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "GIFT",
- "acquisitionDate": "2015-01-15"
}
]
}
]
}
], - "costs": {
- "commission": {
- "commissionBasisCode": "DEBT_FREE_PRICE",
- "commissionTypeCode": "OTHER_COMMISSION",
- "otherCommissionDescription": "Toteutuma asunnon toteutuneesta velattomasta kauppahinnasta",
- "vatIncluded": true,
- "commissionPercentage": 5.5,
- "minimumCommissionAmount": 9900,
- "fixedCommissionAmount": 15000,
- "baseCommissionAmount": 3000,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan lisäksi matkakulut"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Matkakulut maksetaan kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{- "assignmentId": "7fe90453-0dea-4da8-9b42-d707704490e7"
}
Fetch details for a specified sales assignment.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "officialAssignmentId": "202132021",
- "assignmentStatusCode": "ACTIVE",
- "assignmentTypeCode": "SALES",
- "assignment": {
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}, - "supplierAssignedIdentifiers": [
- {
- "supplierAssignedId": "a12456789",
- "schemeId": "CCS_ID"
}
]
}, - "agreementValidity": {
- "agreementTypeCode": "INDEFINITE_TERM",
- "validityPeriod": {
- "startDate": "2021-06-04",
- "periodCount": 1
}, - "validityContinuedAfterRedemption": false
}, - "contractDocumentId": "1e51dace-9004-48ea-84d8-23657476c1c5",
- "sellerCustomerParties": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": true,
- "hasBeenMarried": true,
- "hasLegalPartitioningOfAssets": true,
- "isDivorceLegallyBinding": true,
- "isResponsibleForObtainingConsent": true,
- "wasAdvisedOfTaxConsequences": true
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": false
}
}
], - "consentorParties": [
- {
- "partyId": "b7a58e6c-7c2d-47e2-bd33-0c76c504f533",
- "partyTypeCode": "PERSON_PARTY"
}
], - "assets": [
- {
- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0",
- "subcategoryCode": "SHARE",
- "realtyTypeCode": "RESIDENTIAL_SHARE",
- "plotHoldingTypeCode": "LEASEHOLD",
- "facilityId": "323-123-5423-8234-L1",
- "sellerDeclarationAboutEnergyCertificate": true,
- "availability": {
- "availabilityCode": "DATE",
- "date": "2021-05-25",
- "description": [
- {
- "languageCode": "fi",
- "text": "Vapautuu kahden kuukauden sisällä."
}, - {
- "languageCode": "sv",
- "text": "Tillgänglig inom två månader."
}
]
}, - "address": {
- "addressLine1": "Hämeenkatu 24",
- "stairwell": "B",
- "apartmentNumber": "56",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}, - "price": {
- "priceRequestTypeCode": "DEBT_FREE_PRICE",
- "sharesIncludeLoan": false,
- "debtFreePriceAmount": 240000,
- "salesPriceAmount": 150000,
- "currencyCode": "EUR",
- "auctionAllowed": false,
- "estimatedDebtFreePriceAmount": "250000"
}, - "termsAndConditions": {
- "estimatedAverageSellingTimeDescription": "Keskimäärin 2 kuukautta kesäaikana",
- "paymentTermsCodes": [
- "CASH"
], - "paymentTermsDescription": "Tilisiirto pankin kautta",
- "sellingStrengthsAndWeaknesses": "Erinomainen sijainti ja hyvät liikenneyhteydet. Keittiö kaipaa remontointia.",
- "outstandingMaintenanceCharges": true,
- "outstandingMaintenanceChargesAmount": 480,
- "currencyCode": "EUR",
- "wasAnotherAgencyPreviouslyAssigned": true,
- "contactDetailsForPreviouslyAssignedAgency": "Pirkanmaan Välitys LKV",
- "restrictiveRightOfUse": {
- "hasRestrictiveRightOfUse": true,
- "restrictiveRightOfUseDescription": "Leskellä testamentin perusteella oikeus asua asunnossa.",
- "consentToSaleAcquired": true
}
}, - "acquisitionBySellers": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "ADVICED_TO_CONTACT_TAX_AUTHORITIES",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "TESTAMENT",
- "acquisitionDate": "2010-10-02"
}, - {
- "acquisitionMethodCode": "PURCHASE",
- "acquisitionDate": "2014-02-26",
- "acquisitionCost": 154000,
- "currencyCode": "EUR"
}
], - "residencePeriod": {
- "startDate": "2014-03-01",
- "endDate": "2021-05-31"
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "TAX_ON_CAPITAL_GAIN_NOT_PAYABLE",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "GIFT",
- "acquisitionDate": "2015-01-15"
}
]
}
], - "explanatoryAppendix": {
- "explanatoryAppendixDocumentId": "d4540af3-4257-4401-be41-292e377fbfb5",
- "modificationTime": "2021-09-14T09:12:43.000Z"
}
}, - {
- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0",
- "subcategoryCode": "SHARE",
- "realtyTypeCode": "RESIDENTIAL_SHARE",
- "plotHoldingTypeCode": "LEASEHOLD",
- "facilityId": "323-123-5423-8234-L1",
- "sellerDeclarationAboutEnergyCertificate": true,
- "availability": {
- "availabilityCode": "DATE",
- "date": "2021-05-25",
- "description": [
- {
- "languageCode": "fi",
- "text": "Vapautuu kahden kuukauden sisällä."
}, - {
- "languageCode": "sv",
- "text": "Tillgänglig inom två månader."
}
]
}, - "address": {
- "addressLine1": "Hämeenkatu 24",
- "stairwell": "B",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}, - "price": {
- "priceRequestTypeCode": "DEBT_FREE_PRICE",
- "sharesIncludeLoan": false,
- "debtFreePriceAmount": 360000,
- "salesPriceAmount": 200000,
- "currencyCode": "EUR",
- "auctionAllowed": false,
- "estimatedDebtFreePriceAmount": "370000"
}, - "termsAndConditions": {
- "estimatedAverageSellingTimeDescription": "Keskimäärin 2 kuukautta kesäaikana",
- "paymentTermsCodes": [
- "CASH"
], - "paymentTermsDescription": "Tilisiirto pankin kautta",
- "sellingStrengthsAndWeaknesses": "Erinomainen sijainti ja hyvät liikenneyhteydet. Keittiö kaipaa remontointia.",
- "outstandingMaintenanceCharges": true,
- "outstandingMaintenanceChargesAmount": 480,
- "currencyCode": "EUR",
- "wasAnotherAgencyPreviouslyAssigned": true,
- "contactDetailsForPreviouslyAssignedAgency": "Pirkanmaan Välitys LKV"
}, - "acquisitionBySellers": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "ADVICED_TO_CONTACT_TAX_AUTHORITIES",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "TESTAMENT",
- "acquisitionDate": "2010-10-02"
}, - {
- "acquisitionMethodCode": "PURCHASE",
- "acquisitionDate": "2014-02-26",
- "acquisitionCost": 154000,
- "currencyCode": "EUR"
}
], - "residencePeriod": {
- "startDate": "2014-03-01",
- "endDate": "2021-05-31"
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "TAX_ON_CAPITAL_GAIN_NOT_PAYABLE",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "GIFT",
- "acquisitionDate": "2015-01-15"
}
]
}
]
}
], - "costs": {
- "commission": {
- "commissionBasisCode": "DEBT_FREE_PRICE",
- "commissionTypeCode": "OTHER_COMMISSION",
- "otherCommissionDescription": "Toteutuma asunnon toteutuneesta velattomasta kauppahinnasta",
- "vatIncluded": true,
- "commissionPercentage": 5.5,
- "minimumCommissionAmount": 9900,
- "fixedCommissionAmount": 15000,
- "baseCommissionAmount": 3000,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan lisäksi matkakulut"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Matkakulut maksetaan kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}, - "creationTime": "2021-09-11T13:16:23.000Z",
- "modificationTime": "2021-09-14T09:07:44.000Z"
}
Update the details of the sales assignment whose id is given as a path variable.
A sales assignment can be updated only when its status is DRAFT
.
The associated assets can be updated also when assignment in ACTIVE
state, if the customer permission has been acquired for the updates.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the updated sales assignment.
assignmentId required | string <uuid> (AssignmentId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the assignment in the UUID format. |
required | object (Assignment) Assignment details |
object (AgreementValidity) Contains details about agreement validity. | |
required | Array of objects (SellerParty) Specifies the seller customers which are associated with this assignment. |
Array of objects (ConsentorParty) Specifies the consentor parties which are associated with this assignment. | |
required | Array of objects (AssetsWrite) Assets to be sold in this assignment. A sales assignment typically includes one asset. However, there are situations when a sales assignment may include several assets:
|
object (Costs) Contains details about the agreement costs. | |
object (OtherConditions) Contains details about the other conditions for this assignment. |
{- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "assignment": {
- "agencyOfficeId": "212114ec-819e-483c-a8e0-f82289ac6e19",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "lead": {
- "contactMethodCode": "BANKING_COOPERATION"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}, - "supplierAssignedIdentifiers": [
- {
- "supplierAssignedId": "a12456789",
- "schemeId": "CCS_ID"
}
]
}, - "agreementValidity": {
- "agreementTypeCode": "INDEFINITE_TERM",
- "validityPeriod": {
- "startDate": "2021-06-04",
- "periodCount": 1
}, - "validityContinuedAfterRedemption": false
}, - "sellerCustomerParties": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": true,
- "hasBeenMarried": true,
- "hasLegalPartitioningOfAssets": true,
- "isDivorceLegallyBinding": true,
- "isResponsibleForObtainingConsent": true,
- "wasAdvisedOfTaxConsequences": true
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": false
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "ESTATE_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": false
}
}
], - "consentorParties": [
- {
- "partyId": "b7a58e6c-7c2d-47e2-bd33-0c76c504f533",
- "partyTypeCode": "PERSON_PARTY"
}
], - "assets": [
- {
- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0",
- "subcategoryCode": "PROPERTY",
- "realtyTypeCode": "RESIDENTIAL_SHARE",
- "plotHoldingTypeCode": "LEASEHOLD",
- "propertyId": "323-123-5423-8234-L2",
- "facilityId": "323-123-5423-8234-L1",
- "sellerDeclarationAboutEnergyCertificate": true,
- "availability": {
- "availabilityCode": "DATE",
- "date": "2021-05-25",
- "description": [
- {
- "languageCode": "fi",
- "text": "Saatavissa kahden kuukauden sisällä."
}, - {
- "languageCode": "sv",
- "text": "Tillgänglig inom två månader."
}
]
}, - "address": {
- "addressLine1": "Hämeenkatu 24",
- "stairwell": "B",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}, - "price": {
- "priceRequestTypeCode": "DEBT_FREE_PRICE",
- "sharesIncludeLoan": false,
- "debtFreePriceAmount": 240000,
- "salesPriceAmount": 210000,
- "currencyCode": "EUR",
- "auctionAllowed": true,
- "auction": {
- "startingPriceAmountWithoutLoan": 149000,
- "startingPriceAmount": 180000
}, - "requestedPriceChange": {
- "salesPriceAmount": 189000,
- "debtFreePriceAmount": 200000,
- "date": "2021-07-01"
}, - "estimatedSalesPriceAmount": "2000000"
}, - "termsAndConditions": {
- "estimatedAverageSellingTimeDescription": "Keskimäärin 2 kuukautta kesäaikana",
- "paymentTermsCodes": [
- "CASH"
], - "paymentTermsDescription": "Tilisiirto pankin kautta",
- "sellingStrengthsAndWeaknesses": "Erinomainen sijainti ja hyvät liikenneyhteydet. Keittiö kaipaa remontointia.",
- "outstandingMaintenanceCharges": true,
- "outstandingMaintenanceChargesAmount": 480,
- "currencyCode": "EUR",
- "wasAnotherAgencyPreviouslyAssigned": true,
- "contactDetailsForPreviouslyAssignedAgency": "Pirkanmaan Välitys LKV",
- "restrictiveRightOfUse": {
- "hasRestrictiveRightOfUse": true,
- "restrictiveRightOfUseDescription": "Leskellä testamentin perusteella oikeus asua asunnossa.",
- "consentToSaleAcquired": true
}
}, - "leaseAgreement": {
- "tenantName": "Matti Virtanen",
- "tenantContacts": [
- {
- "contactTypeCode": "PHONE",
- "value": "+358501235678"
}, - {
- "contactTypeCode": "EMAIL",
- "value": "matti.virtanen@example.com"
}
], - "leaseAgreementTypeCode": "WRITTEN_AGREEMENT",
- "leaseTermCode": "FIXED_TERM",
- "leasePeriod": {
- "startDate": "2017-01-01",
- "endDate": "2021-12-31"
}, - "hasLeaseBeenTerminated": true,
- "noticePeriod": "2 viikkoa",
- "leaseExpirationDate": "2021-10-30",
- "deposit": {
- "depositRequired": true,
- "depositAmount": 1800,
- "depositRepository": "Nordean tili",
- "depositDescription": "Vakuus vuokranantajan erillisellä tilillä"
}, - "rentAmount": 900,
- "currencyCode": "EUR",
- "tenantPaidRentOnTime": false,
- "tenantPaidRentOnTimeDescription": "Vuokra on kerran viivästynyt viikon verran.",
- "additionalDescription": "Pitkäaikainen vuokralainen"
}, - "acquisitionBySellers": [
- {
- "partyId": "13974667-a0dd-4ee3-b2b1-8d28248b1f6e",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "ADVICED_TO_CONTACT_TAX_AUTHORITIES",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "TESTAMENT",
- "acquisitionDate": "2010-10-02"
}, - {
- "acquisitionMethodCode": "PURCHASE",
- "acquisitionDate": "2014-02-26",
- "acquisitionCost": 154000,
- "currencyCode": "EUR"
}
], - "residencePeriod": {
- "startDate": "2014-03-01",
- "endDate": "2021-05-31"
}
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "PERSON_PARTY",
- "taxConsequenceCode": "TAX_ON_CAPITAL_GAIN_NOT_PAYABLE",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "GIFT",
- "acquisitionDate": "2015-01-15"
}
]
}, - {
- "partyId": "aa83f668-0092-407d-b133-384841a5ab2f",
- "partyTypeCode": "ESTATE_PARTY",
- "acquisitionMethods": [
- {
- "acquisitionMethodCode": "GIFT",
- "acquisitionDate": "2015-01-15"
}
]
}
]
}
], - "costs": {
- "commission": {
- "commissionBasisCode": "DEBT_FREE_PRICE",
- "commissionTypeCode": "OTHER_COMMISSION",
- "otherCommissionDescription": "Toteutuma asunnon toteutuneesta velattomasta kauppahinnasta",
- "vatIncluded": true,
- "commissionPercentage": 5.5,
- "minimumCommissionAmount": 9900,
- "fixedCommissionAmount": 15000,
- "baseCommissionAmount": 3000,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan lisäksi matkakulut"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 1500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 500,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Matkakulut maksetaan kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{ }
Deletes the specified sales assignment whose id is given as a path variable.
A sales assignment can be deleted only if its status is: DRAFT
.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "errorCode": "BAD_REQUEST_PARAMETERS",
- "message": "Invalid request parameters",
- "description": "Request parameters are missing or have invalid type.",
- "errors": [
- {
- "target": "assignmentId",
- "errorCode": "VALUE_REQUIRED",
- "message": "Mandatory request parameter assignmentId is missing"
}, - {
- "target": "authorId",
- "errorCode": "INVALID_TYPE",
- "message": "Request parameter authorId must be a string"
}
]
}
Generates and saves explanatory appendix PDF for asset of assignment. If explanatory appendix for given asset already exists it will be replaced.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains information that is needed to generate the explanatory appendix.
realtyId required | string <uuid> RealtyId for asset whose explanatory appendix is generated. |
{- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0"
}
{ }
Create a new rental assignment.
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the details for the rental assignment.
required | object (Assignment) Assignment details |
object (AgreementValidity) Contains details about agreement validity. | |
required | Array of objects (LessorParty) Specifies the lessors which are associated with this assignment. |
required | Array of objects (RentalAssets) Assets to be rented in this assignment. A rental assignment typically includes one asset. However, there are situations when a rental assignment may include several assets:
|
object (RentalCosts) Contains details about the agreement costs. | |
object (OtherConditions) Contains details about the other conditions for this assignment. | |
creationTime | string <date-time> (Timestamp) Timestamp as defined by ISO 8601 with time offset. |
{- "assignment": {
- "agencyOfficeId": "7bdffe48-0077-4de0-acd4-d9b9b1ab49f8",
- "agents": [
- {
- "agentId": "5d2a6d47-da73-4b11-8940-27cffabb6de5",
- "roleCode": "RESPONSIBLE_AGENT"
}
], - "lead": {
- "contactMethodCode": "EXISTING_CUSTOMER"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "exclusivityTypeCode": "EXCLUSIVE_BASIS",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}
}, - "agreementValidity": {
- "agreementTypeCode": "FIXED_TERM",
- "validityPeriod": {
- "startDate": "2022-10-01",
- "endDate": "2022-12-31"
}
}, - "lessorParties": [
- {
- "partyId": "62701576-2621-4a27-8d2b-63cea492abb6",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": true,
- "hasLegalPartitioningOfAssets": true,
- "isDivorceLegallyBinding": true,
- "isResponsibleForObtainingConsent": false,
- "wasAdvisedOfTaxConsequences": true
}, - "financialAccount": {
- "financialAccountId": "F12180000012345678",
- "financialInstitutionName": "Danske Bank A/S",
- "financialInstitutionId": "DABAFIHH"
}
}
], - "assets": [
- {
- "realtyId": "191a5c7c-d4d6-49f0-8cfc-4fa5ec168fb0",
- "subcategoryCode": "SHARE",
- "realtyTypeCode": "RESIDENTIAL_SHARE",
- "availability": {
- "availabilityCode": "AVAILABLE",
- "date": "2022-12-31",
- "description": [
- {
- "languageCode": "fi",
- "text": "Suomeksi"
}
]
}, - "address": {
- "addressLine1": "Yliopistonkatu 55",
- "stairwell": "C",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityName": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}, - "rentalPrice": {
- "monthlyRent": 690,
- "estimatedRentRange": "Arvio 600-700 €",
- "currencyCode": "EUR"
}, - "termsAndConditions": {
- "paymentTermsCodes": [
- "CASH"
], - "paymentTermsDescription": "Tilisiirto pankin kautta",
- "wasAnotherAgencyPreviouslyAssigned": true,
- "contactDetailsForPreviouslyAssignedAgency": "Pirkanmaan Välitys LKV",
- "estimatedTimePeriod": "Noin 1-3 kk"
}
}
], - "costs": {
- "commission": {
- "commissionTypeCode": "MONTHLY_RENT_WITH_MINIMUM_FEE",
- "otherCommissionDescription": "Kolmen kuukauden vuokra, vähintään 1400 €",
- "vatIncluded": true,
- "months": 3,
- "minimumCommissionAmount": 1400,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 700,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 400,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan myös matkakulut kuittien perusteella"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 400,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan myös matkakulut kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": true,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{- "assignmentId": "7fe90453-0dea-4da8-9b42-d707704490e7"
}
Fetch details for a specified rental assignment.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "assignmentId": "ecbc2c7a-6687-448c-acf1-05b613bae7d4",
- "officialAssignmentId": "201712025",
- "assignmentStatusCode": "ACTIVE",
- "assignmentTypeCode": "RENTAL",
- "assignment": {
- "agencyOfficeId": "7bdffe48-0077-4de0-acd4-d9b9b1ab49f8",
- "agents": [
- {
- "agentId": "5d2a6d47-da73-4b11-8940-27cffabb6de5",
- "roleCode": "RESPONSIBLE_AGENT"
}
], - "lead": {
- "contactMethodCode": "EXISTING_CUSTOMER"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "exclusivityTypeCode": "EXCLUSIVE_BASIS",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}
}, - "agreementValidity": {
- "agreementTypeCode": "FIXED_TERM",
- "validityPeriod": {
- "startDate": "2022-10-01",
- "endDate": "2022-12-31"
}
}, - "contractDocumentId": "1e51dace-9004-48ea-84d8-23657476c1c5",
- "lessorParties": [
- {
- "partyId": "62701576-2621-4a27-8d2b-63cea492abb6",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": true,
- "hasLegalPartitioningOfAssets": true,
- "isDivorceLegallyBinding": true,
- "isResponsibleForObtainingConsent": false,
- "wasAdvisedOfTaxConsequences": true
}, - "financialAccount": {
- "financialAccountId": "F12180000012345678",
- "financialInstitutionName": "Danske Bank A/S",
- "financialInstitutionId": "DABAFIHH"
}
}
], - "assets": [
- {
- "realtyId": "191a5c7c-d4d6-49f0-8cfc-4fa5ec168fb0",
- "subcategoryCode": "SHARE",
- "realtyTypeCode": "RESIDENTIAL_SHARE",
- "availability": {
- "availabilityCode": "AVAILABLE",
- "date": "2022-12-31",
- "description": [
- {
- "languageCode": "fi",
- "text": "Suomeksi"
}
]
}, - "address": {
- "addressLine1": "Yliopistonkatu 55",
- "stairwell": "C",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityName": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}, - "rentalPrice": {
- "monthlyRent": 690,
- "estimatedRentRange": "Arvio 600-700 €",
- "currencyCode": "EUR"
}, - "termsAndConditions": {
- "paymentTermsCodes": [
- "CASH"
], - "paymentTermsDescription": "Tilisiirto pankin kautta",
- "wasAnotherAgencyPreviouslyAssigned": true,
- "contactDetailsForPreviouslyAssignedAgency": "Pirkanmaan Välitys LKV",
- "estimatedTimePeriod": "Noin 1-3 kk"
}
}
], - "costs": {
- "commission": {
- "commissionTypeCode": "MONTHLY_RENT_WITH_MINIMUM_FEE",
- "otherCommissionDescription": "Kolmen kuukauden vuokra, vähintään 1400 €",
- "vatIncluded": true,
- "months": 3,
- "minimumCommissionAmount": 1400,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 700,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 400,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan myös matkakulut kuittien perusteella"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 400,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan myös matkakulut kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": true,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}, - "creationTime": "2022-09-21T17:32:28Z",
- "modificationTime": "2022-09-21T17:32:28Z"
}
Update the details of the rental assignment whose id is given as a path variable.
A rental assignment can be updated only when its status is DRAFT
.
The associated assets can be updated also when assignment in ACTIVE
state, if the permission has been acquired for the updates from the lessor.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the updated rental assignment.
assignmentId required | string <uuid> (AssignmentId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the assignment in the UUID format. |
required | object (Assignment) Assignment details |
object (AgreementValidity) Contains details about agreement validity. | |
required | Array of objects (LessorParty) Specifies the lessors which are associated with this assignment. |
required | Array of objects (RentalAssets) Assets to be rented in this assignment. A rental assignment typically includes one asset. However, there are situations when a rental assignment may include several assets:
|
object (RentalCosts) Contains details about the agreement costs. | |
object (OtherConditions) Contains details about the other conditions for this assignment. |
{- "assignmentId": "ecbc2c7a-6687-448c-acf1-05b613bae7d4",
- "assignment": {
- "agencyOfficeId": "7bdffe48-0077-4de0-acd4-d9b9b1ab49f8",
- "agents": [
- {
- "agentId": "5d2a6d47-da73-4b11-8940-27cffabb6de5",
- "roleCode": "RESPONSIBLE_AGENT"
}
], - "lead": {
- "contactMethodCode": "EXISTING_CUSTOMER"
}, - "realtyBelongsToCustomerBusinessActivities": false,
- "specialDetailsProvidedToCustomer": "Sopimus allekirjoitetaan ainoastaan sähköisesti.",
- "exclusivityTypeCode": "EXCLUSIVE_BASIS",
- "marketing": {
- "agreedMarketingMethodsDescription": "Markkinointi kaikilla markkinapaikoilla",
- "marketingConditionsAsAppendix": true
}
}, - "agreementValidity": {
- "agreementTypeCode": "FIXED_TERM",
- "validityPeriod": {
- "startDate": "2022-10-01",
- "endDate": "2022-12-31"
}
}, - "lessorParties": [
- {
- "partyId": "62701576-2621-4a27-8d2b-63cea492abb6",
- "partyTypeCode": "PERSON_PARTY",
- "declarationByParty": {
- "isMarried": false,
- "hasBeenMarried": true,
- "hasLegalPartitioningOfAssets": true,
- "isDivorceLegallyBinding": true,
- "isResponsibleForObtainingConsent": false,
- "wasAdvisedOfTaxConsequences": true
}, - "financialAccount": {
- "financialAccountId": "F12180000012345678",
- "financialInstitutionName": "Danske Bank A/S",
- "financialInstitutionId": "DABAFIHH"
}
}
], - "assets": [
- {
- "realtyId": "191a5c7c-d4d6-49f0-8cfc-4fa5ec168fb0",
- "subcategoryCode": "SHARE",
- "realtyTypeCode": "RESIDENTIAL_SHARE",
- "availability": {
- "availabilityCode": "AVAILABLE",
- "date": "2022-12-31",
- "description": [
- {
- "languageCode": "fi",
- "text": "Suomeksi"
}
]
}, - "address": {
- "addressLine1": "Yliopistonkatu 55",
- "stairwell": "C",
- "apartmentNumber": "55",
- "postcode": "33100",
- "postalArea": "Tampere",
- "localityName": "Tampere",
- "localityCode": "FI_PIRKANMAA_TAMPERE",
- "regionCode": "FI_PIRKANMAA",
- "countryCode": "FI"
}, - "rentalPrice": {
- "monthlyRent": 690,
- "estimatedRentRange": "Arvio 600-700 €",
- "currencyCode": "EUR"
}, - "termsAndConditions": {
- "paymentTermsCodes": [
- "CASH"
], - "paymentTermsDescription": "Tilisiirto pankin kautta",
- "wasAnotherAgencyPreviouslyAssigned": true,
- "contactDetailsForPreviouslyAssignedAgency": "Pirkanmaan Välitys LKV",
- "estimatedTimePeriod": "Noin 1-3 kk"
}
}
], - "costs": {
- "commission": {
- "commissionTypeCode": "MONTHLY_RENT_WITH_MINIMUM_FEE",
- "otherCommissionDescription": "Kolmen kuukauden vuokra, vähintään 1400 €",
- "vatIncluded": true,
- "months": 3,
- "minimumCommissionAmount": 1400,
- "latePaymentInterest": 3
}, - "otherExpenses": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 700,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 400,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan myös matkakulut kuittien perusteella"
}, - "expensesUponAssignmentTermination": {
- "marketingExpensesIncluded": true,
- "maximumMarketingExpenses": 500,
- "documentAcquisitionExpensesIncluded": true,
- "maximumDocumentAcquisitionExpenses": 400,
- "otherExpensesIncluded": true,
- "otherExpensesDescription": "Maksetaan myös matkakulut kuittien perusteella"
}, - "currencyCode": "EUR"
}, - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": true,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{- "errorCode": "BAD_REQUEST_PARAMETERS",
- "message": "Invalid request parameters",
- "description": "Request parameters are missing or have invalid type.",
- "errors": [
- {
- "target": "assignmentId",
- "errorCode": "VALUE_REQUIRED",
- "message": "Mandatory request parameter assignmentId is missing"
}, - {
- "target": "authorId",
- "errorCode": "INVALID_TYPE",
- "message": "Request parameter authorId must be a string"
}
]
}
Deletes the specified rental assignment whose id is given as a path variable.
A rental assignment can be deleted only if its status is: DRAFT
.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "errorCode": "BAD_REQUEST_PARAMETERS",
- "message": "Invalid request parameters",
- "description": "Request parameters are missing or have invalid type.",
- "errors": [
- {
- "target": "assignmentId",
- "errorCode": "VALUE_REQUIRED",
- "message": "Mandatory request parameter assignmentId is missing"
}, - {
- "target": "authorId",
- "errorCode": "INVALID_TYPE",
- "message": "Request parameter authorId must be a string"
}
]
}
Continuation Agreement API allows you to create, update and fetch continuation agreements. A continuation agreement is an extension to a sales assignment, a purchase assignment or a rental assignment.
A continuation agreement needs to be created when an existing, but to be expired agreement needs to be continued.
Create a new continuation agreement to continue an existing assignment.
Note! Upon creation of the continuation agreement, the existing assignment will be updated accordingly.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the details for the continuation agreement.
required | Array of objects (Agent) Specifies the agents who are associated with this assignment. |
required | object (WriteContinuationAgreementValidity) Contains details about continuation agreement validity. |
required | Array of objects (AssetReference) Specifies the assets associated with this assignment with updated prices. This element applies only when the |
object (OtherConditions) Contains details about the other conditions for this assignment. |
{- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "agreementValidity": {
- "validityPeriod": {
- "endDate": "2021-10-04"
}
}, - "assets": [
- {
- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0",
- "price": {
- "priceRequestTypeCode": "DEBT_FREE_PRICE",
- "sharesIncludeLoan": false,
- "debtFreePriceAmount": 230000,
- "salesPriceAmount": 200000,
- "currencyCode": "EUR",
- "auctionAllowed": true,
- "auction": {
- "startingPriceAmountWithoutLoan": 149000,
- "startingPriceAmount": 180000
}, - "requestedPriceChange": {
- "salesPriceAmount": 189000,
- "debtFreePriceAmount": 200000,
- "date": "2021-07-01"
}, - "estimatedDebtFreePriceAmount": "2000000"
}
}
], - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{- "continuationAgreementId": "cea5c260-f2bc-4d17-8876-f3efbbac9d69"
}
Fetch all the continuation agreements for a specific assignment.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "totalCount": 1,
- "agreements": [
- {
- "continuationAgreementId": "cea5c260-f2bc-4d17-8876-f3efbbac9d69",
- "statusCode": "SIGNED",
- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "agreementValidity": {
- "validityPeriod": {
- "startDate": "2021-06-04",
- "endDate": "2021-10-04"
}
}
}
]
}
Fetch details for a specified continuation agreement.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
continuationAgreementId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 122aec5c-66fa-4d48-a6f0-4ede37a60a30 Unique continuation agreement identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "continuationAgreementId": "cea5c260-f2bc-4d17-8876-f3efbbac9d69",
- "statusCode": "SIGNED",
- "assignmentId": "d265a413-a83e-40f1-b185-a3b1fb74c905",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "contractDocumentId": "3e77454a-9078-4f0f-b0d9-b37a89811a6c",
- "agreementValidity": {
- "validityPeriod": {
- "startDate": "2021-06-04",
- "endDate": "2021-10-04"
}
}, - "assets": [
- {
- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0",
- "price": {
- "priceRequestTypeCode": "DEBT_FREE_PRICE",
- "sharesIncludeLoan": false,
- "debtFreePriceAmount": 230000,
- "salesPriceAmount": 200000,
- "currencyCode": "EUR",
- "auctionAllowed": true,
- "auction": {
- "startingPriceAmountWithoutLoan": 149000,
- "startingPriceAmount": 180000
}, - "requestedPriceChange": {
- "salesPriceAmount": 189000,
- "debtFreePriceAmount": 200000,
- "date": "2021-07-01"
}, - "estimatedDebtFreePriceAmount": "2000000"
}
}
], - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}, - "creationTime": "2021-08-12T13:07:23.000Z",
- "modificationTime": "2021-08-15T09:04:44.000Z"
}
Update the continuation agreement whose id is given as a path variable.
A continuation agreement can be updated only when its status is DRAFT
.
The customer permission needs to be acquired for the updates.
Note! Upon updating the continuation agreement, the existing assignment will also be updated accordingly.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
continuationAgreementId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 122aec5c-66fa-4d48-a6f0-4ede37a60a30 Unique continuation agreement identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the updated continuation agreement.
continuationAgreementId required | string <uuid> (ContinuationAgreementId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the continuation agreement in the UUID format. |
required | Array of objects (Agent) Specifies the agents who are associated with this assignment. |
required | object (WriteContinuationAgreementValidity) Contains details about continuation agreement validity. |
required | Array of objects (AssetReference) Specifies the assets associated with this assignment with updated prices. This element applies only when the |
object (OtherConditions) Contains details about the other conditions for this assignment. |
{- "continuationAgreementId": "cea5c260-f2bc-4d17-8876-f3efbbac9d69",
- "agents": [
- {
- "agentId": "da3a543e-4220-4c1f-8cda-2ae0b2e596e0",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "386654b2-882f-442e-9ffe-7d6b6e367715",
- "roleCode": "ACQUISITION_AGENT"
}
], - "agreementValidity": {
- "validityPeriod": {
- "endDate": "2021-10-04"
}
}, - "assets": [
- {
- "realtyId": "0e1e2539-c177-46cd-9fcf-47b1af5df8e0",
- "price": {
- "priceRequestTypeCode": "DEBT_FREE_PRICE",
- "sharesIncludeLoan": false,
- "debtFreePriceAmount": 230000,
- "salesPriceAmount": 200000,
- "currencyCode": "EUR",
- "auctionAllowed": true,
- "auction": {
- "startingPriceAmountWithoutLoan": 149000,
- "startingPriceAmount": 180000
}, - "requestedPriceChange": {
- "salesPriceAmount": 189000,
- "debtFreePriceAmount": 200000,
- "date": "2021-07-01"
}, - "estimatedDebtFreePriceAmount": "2000000"
}
}
], - "otherConditions": {
- "digitalTradingAllowed": true,
- "privacyStatementDeliveryCode": "INCLUDED_AS_APPENDIX",
- "distanceSelling": false,
- "startAssignmentImmediately": true,
- "startMarketingAfterCancellationPeriod": true,
- "deliveryMethodForCancellationInstructionsCode": "DELIVERED_BY_EMAIL",
- "additionalDetails": "Vapautuminen neuvoteltavissa."
}
}
{ }
Deletes the specified continuation agreement whose id is given as a path variable.
A continuation agreement can be deleted only if its status is: DRAFT
.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
continuationAgreementId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 122aec5c-66fa-4d48-a6f0-4ede37a60a30 Unique continuation agreement identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "errorCode": "BAD_REQUEST_PARAMETERS",
- "message": "Invalid request parameters",
- "description": "Request parameters are missing or have invalid type.",
- "errors": [
- {
- "target": "assignmentId",
- "errorCode": "VALUE_REQUIRED",
- "message": "Mandatory request parameter assignmentId is missing"
}, - {
- "target": "authorId",
- "errorCode": "INVALID_TYPE",
- "message": "Request parameter authorId must be a string"
}
]
}
Execute continuation agreement action.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
continuationAgreementId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 122aec5c-66fa-4d48-a6f0-4ede37a60a30 Unique continuation agreement identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the action to be executed for the continuation agreement.
actionCode required | string Enum: "LOCK" "UNLOCK" "ACTIVATE" Action to be executed. The actions can be used to trigger the following status transitions:
|
{- "actionCode": "LOCK"
}
{ }
Fetch assignment diary.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "assignmentId": "13dd3499-26e7-48bb-89b0-1ac0ebffa6e6",
- "assignmentIdentification": {
- "officialAssignmentId": "201252021",
- "allocationTime": "2023-07-01T14:15:06Z",
- "actorAgentId": "d7ed169c-9f67-4162-9892-5c3a40b9df53"
}, - "assignmentActivation": {
- "activationTime": "2023-07-03T15:03:22Z",
- "agencyOfficeId": "9f7c9e7e-9fb9-44f8-b96b-9f22532fd106",
- "assignmentTypeCode": "SALES",
- "validity": {
- "agreementTypeCode": "FIXED_TERM",
- "startDate": "2023-07-03",
- "endDate": "2023-11-03"
}, - "assets": [
- {
- "realtyId": "b3dfa2b1-2f79-45b3-b780-68c5fd87002c",
- "address": {
- "addressLine1": "Maatilantie 14",
- "postcode": "00100",
- "postalArea": "Helsinki",
- "countryCode": "FI"
}
}
], - "agents": [
- {
- "agentId": "d7ed169c-9f67-4162-9892-5c3a40b9df53",
- "roleCode": "RESPONSIBLE_AGENT"
}, - {
- "agentId": "c6981902-cded-45ae-9258-3fc713d3cb47",
- "roleCode": "ACQUISITION_AGENT"
}
], - "customerParties": [
- {
- "name": "Seppo Myrskylahti",
- "partyId": "56383ee0-32b0-47a9-9ce2-1a39a2e0e96b",
- "partyTypeCode": "PERSON_PARTY",
- "address": {
- "addressLine1": "Yleistie 32 A 4",
- "postcode": "00200",
- "postalArea": "Helsinki",
- "countryCode": "FI"
}
}, - {
- "name": "Markku Laaksolahden kuolinpesä",
- "partyId": "8ed5af00-2d78-438e-a3ce-905295d42abf",
- "partyTypeCode": "ESTATE_PARTY"
}
]
}, - "continuationAgreements": [
- {
- "validity": {
- "startDate": "2023-11-03",
- "endDate": "2024-02-03"
}, - "assets": [
- {
- "realtyId": "b3dfa2b1-2f79-45b3-b780-68c5fd87002c"
}
], - "agents": [
- {
- "agentId": "d7ed169c-9f67-4162-9892-5c3a40b9df53",
- "roleCode": "RESPONSIBLE_AGENT"
}
], - "activationTime": "2023-11-02T15:03:22Z"
}
]
}
Marketing Plan API contains the details about sales and marketing conditions for the assignment. There can only be one marketing plan per assignment.
Saves marketing plan for a sales assignment. If no marketing plan exists for sales assignment new marketing plan is created.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains the details about sales and marketing conditions for the assignment.
required | object (MarketingConditions) Marketing conditions that apply for sale. |
{- "marketingConditions": {
- "objectivesOfSale": [
- {
- "objectiveOfSale": "Sekä yksityis-, että yleisnäyttöjä"
}
], - "services": [
- {
- "typeCode": "PERSONAL_AGENT",
- "description": "Arnold G. Hiltunen LKV"
}, - {
- "typeCode": "JOINT_SALES",
- "description": "60 Välittäjää pääkaupunkiseudulla"
}, - {
- "typeCode": "BANK_CONTACT_FOR_BUYERS",
- "description": "Pikakaista"
}, - {
- "typeCode": "DOCUMENTS",
- "description": "Välittäjä hankkii tarvittavat asiakirjat"
}, - {
- "typeCode": "BROCHURE",
- "description": "Toimitetaan tarkastettavaksi ennen julkaisua"
}
], - "additionalServices": [
- {
- "typeCode": "PHOTOGRAPHY",
- "description": "Ammattikuvaaja"
}, - {
- "typeCode": "VIDEO",
- "description": "Ammattikuvaaja"
}, - {
- "typeCode": "STYLING",
- "description": "Valokuvausjärjestely"
}, - {
- "typeCode": "RESEARCH",
- "description": "Asunto-osakeselvitys"
}
], - "salesMethods": [
- {
- "typeCode": "BUYER_CONTACTING",
- "description": "Kotihakuasiakkaat"
}, - {
- "typeCode": "PUBLIC_SHOWING"
}, - {
- "typeCode": "PRIVATE_SHOWING"
}, - {
- "typeCode": "COMMUNICATION",
- "description": "Viikoittain ja tapahtumakohtaisesti"
}, - {
- "typeCode": "SERVICE_MESSAGES",
- "description": "Joka keskiviikko koosteviesti sähköpostiin"
}, - {
- "typeCode": "AGENCY_WEBSITE"
}
], - "marketingMethods": [
- {
- "typeCode": "PORTALS",
- "description": "Etuovi, Oikotie"
}, - {
- "typeCode": "EXTRA_VISIBILITIES",
- "description": "Retargetointi"
}, - {
- "typeCode": "SOCIAL_MEDIA",
- "description": "FB, IG"
}
], - "salesProcesses": [
- {
- "typeCode": "NEGOTIATIONS",
- "description": "Kirjalliset tarjoukset"
}, - {
- "typeCode": "SALES_DEED",
- "description": "Välittäjän vastuulla"
}, - {
- "typeCode": "NOTIFICATIONS_FOR_THIRD_PARTIES",
- "description": "Välittäjän vastuulla"
}
], - "benefits": [
- {
- "typeCode": "BANK_CONTACT_FOR_SELLERS"
}, - {
- "typeCode": "WATCHDOG",
- "description": "Tehdään tarvittaessa"
}, - {
- "typeCode": "DIGITAL_TRADING"
}
]
}
}
{ }
Fetch marketing plan.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "marketingPlanDocumentId": "28574a7b-7eee-48c7-845d-dbb8cd8646d8",
- "marketingPlanDocumentCreationTime": "2021-09-21T13:14:02+00:00",
- "marketingConditions": {
- "objectivesOfSale": [
- {
- "objectiveOfSale": "Sekä yksityis-, että yleisnäyttöjä"
}
], - "services": [
- {
- "typeCode": "PERSONAL_AGENT",
- "description": "Arnold G. Hiltunen LKV"
}, - {
- "typeCode": "JOINT_SALES",
- "description": "60 Välittäjää pääkaupunkiseudulla"
}, - {
- "typeCode": "BANK_CONTACT_FOR_BUYERS",
- "description": "Pikakaista"
}, - {
- "typeCode": "DOCUMENTS",
- "description": "Välittäjä hankkii tarvittavat asiakirjat"
}, - {
- "typeCode": "BROCHURE",
- "description": "Toimitetaan tarkastettavaksi ennen julkaisua"
}
], - "additionalServices": [
- {
- "typeCode": "PHOTOGRAPHY",
- "description": "Ammattikuvaaja"
}, - {
- "typeCode": "VIDEO",
- "description": "Ammattikuvaaja"
}, - {
- "typeCode": "STYLING",
- "description": "Valokuvausjärjestely"
}, - {
- "typeCode": "RESEARCH",
- "description": "Asunto-osakeselvitys"
}
], - "salesMethods": [
- {
- "typeCode": "BUYER_CONTACTING",
- "description": "Kotihakuasiakkaat"
}, - {
- "typeCode": "PUBLIC_SHOWING"
}, - {
- "typeCode": "PRIVATE_SHOWING"
}, - {
- "typeCode": "COMMUNICATION",
- "description": "Viikoittain ja tapahtumakohtaisesti"
}, - {
- "typeCode": "SERVICE_MESSAGES",
- "description": "Joka keskiviikko koosteviesti sähköpostiin"
}, - {
- "typeCode": "AGENCY_WEBSITE"
}
], - "marketingMethods": [
- {
- "typeCode": "PORTALS",
- "description": "Etuovi, Oikotie"
}, - {
- "typeCode": "EXTRA_VISIBILITIES",
- "description": "Retargetointi"
}, - {
- "typeCode": "SOCIAL_MEDIA",
- "description": "FB, IG"
}
], - "salesProcesses": [
- {
- "typeCode": "NEGOTIATIONS",
- "description": "Kirjalliset tarjoukset"
}, - {
- "typeCode": "SALES_DEED",
- "description": "Välittäjän vastuulla"
}, - {
- "typeCode": "NOTIFICATIONS_FOR_THIRD_PARTIES",
- "description": "Välittäjän vastuulla"
}
], - "benefits": [
- {
- "typeCode": "BANK_CONTACT_FOR_SELLERS"
}, - {
- "typeCode": "WATCHDOG",
- "description": "Tehdään tarvittaessa"
}, - {
- "typeCode": "DIGITAL_TRADING"
}
]
}, - "creationTime": "2021-08-15T08:04:44+00:00",
- "modificationTime": "2021-09-21T12:02:36+00:00"
}
Generates a PDF document using marketing plan content.
assignmentId required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: ddc25849-7bc7-43c0-9c3b-602cb03f7806 Unique assignment identifier in UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Empty body
{ }
{- "marketingPlanDocumentId": "5afe78c0-729f-4cd9-bbfe-5ac6cf77924d"
}
Official Assignment Identifier Settings API can be used by main users of the agency or agency office to define how official assignment identifiers are generated.
Fetch official assignment identifier settings for given agency office.
agencyOfficeId required | string <uuid> (AgencyOfficeId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: agencyOfficeId=7bdffe48-0077-4de0-acd4-d9b9b1ab49f8 Unique identifier for the agency office in the UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "agencyOfficeId": "7bdffe48-0077-4de0-acd4-d9b9b1ab49f8",
- "officeIdentifier": "00020",
- "nextSequenceNumberToBeIssued": 98
}
Save official assignment identifier settings for given agency office.
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains assignment identifier settings for office.
agencyOfficeId required | string <uuid> (AgencyOfficeId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the agency office in the UUID format. |
officeIdentifier required | string (OfficeIdentifier) ^\d*$ If office identifier is set it is used as a first part of officialAssignmentId. Value should be unique to all company's offices. |
{- "agencyOfficeId": "7bdffe48-0077-4de0-acd4-d9b9b1ab49f8",
- "officeIdentifier": "00020"
}
{ }
Reset assignment identifier sequence number for given agency office.
agencyOfficeId required | string <uuid> (AgencyOfficeId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: agencyOfficeId=7bdffe48-0077-4de0-acd4-d9b9b1ab49f8 Unique identifier for the agency office in the UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{ }
Integration Settings API can be used by main users of the agency or agency office to configure behaviour of various 3rd party integrations.
Fetch integration settings for given agency office.
agencyOfficeId required | string <uuid> (AgencyOfficeId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: agencyOfficeId=7bdffe48-0077-4de0-acd4-d9b9b1ab49f8 Unique identifier for the agency office in the UUID format. |
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
{- "agencyOfficeId": "7bdffe48-0077-4de0-acd4-d9b9b1ab49f8",
- "hspTransferEnabled": true,
- "surveypalTransferEnabled": true,
- "externalSurveyTransferEnabled": false,
- "surveypalSurveySettings": [
- {
- "surveypalSurveyId": 1489,
- "surveypalSurveyName": "Assignment ended NPS survey",
- "surveyTypeCode": "ASSIGNMENT_ENDED",
- "enabled": true,
- "sendDelayHours": 48
}, - {
- "surveypalSurveyId": 2301,
- "surveypalSurveyName": "Trade completed NPS survey",
- "surveyTypeCode": "TRADE_COMPLETED",
- "enabled": true,
- "sendDelayHours": 48
}
]
}
Create or update integration settings for given agency office. All individual integration settings must be able to be set undefined and therefore are not required.
Request-ID required | string <uuid> ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Example: 9031d1c5-7d40-41dd-b2b8-7919a2fc4fe9 A unique id which identifies the HTTP request. The value of this header must be created by the client. This identifier is used for troubleshooting purposes. |
Contains integration settings for office.
agencyOfficeId required | string <uuid> (AgencyOfficeId) ^([0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8... Unique identifier for the agency office in the UUID format. |
hspTransferEnabled | boolean (HspTransferEnabled) Indicates whether HSP integration is enabled for agencyOffice and the completed trades are sent to HSP. |
surveypalTransferEnabled | boolean (SurveypalTransferEnabled) Indicates whether Surveypal integration is enabled for agencyOffice. |
externalSurveyTransferEnabled | boolean (ExternalSurveyTransferEnabled) Indicates whether external customer feedback integration is enabled for agencyOffice. |
Array of objects (SurveypalSurveySettings) Surveypal survey configurations. |
{- "agencyOfficeId": "7bdffe48-0077-4de0-acd4-d9b9b1ab49f8",
- "hspTransferEnabled": true,
- "surveypalTransferEnabled": true,
- "externalSurveyTransferEnabled": false,
- "surveypalSurveySettings": [
- {
- "surveypalSurveyId": 1489,
- "surveypalSurveyName": "Assignment ended NPS survey",
- "surveyTypeCode": "ASSIGNMENT_ENDED",
- "enabled": true,
- "sendDelayHours": 48
}, - {
- "surveypalSurveyId": 2301,
- "surveypalSurveyName": "Trade completed NPS survey",
- "surveyTypeCode": "TRADE_COMPLETED",
- "enabled": true,
- "sendDelayHours": 48
}
]
}
{ }