Vorgeschlagene Vertragsnehmer

Die Endpunkte dieser Endpunktberechtigung finden Sie im Controller "SuggestedContractor".

Um auf die Daten der vorgeschlagenen Vertragsnehmer über die API zugreifen zu können, muss die Endpunktberechtigung "Vorgeschlagene Vertragsnehmer lesen/bearbeiten" aktiviert werden.

Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.

Hinweise zur Funktion

Um einen neuen Vertragsnehmer anzulegen, müssen zuerst die Personendaten des neuen Vertragsnehmers in WOWIPORT erfasst werden. Sie können hierzu den Endpunkt für die verwenden.

Die Logik von WOWIPORT sieht vor, dass ein vermietetes Objekt nicht ohne Vertrag bestehen kann. Ist kein aktives Mietverhältnis hinterlegt, wird der Vertrag zu einem "Leerstandsvertrag".

Aus diesem Grund werden vorgeschlagene Vertragsnehmer nicht mit einzelnen Objekten verknüpft, sondern mit dem Vertrag, welchen diese durch einen neuen Vertrag ablösen sollen.

Sollte mehr als ein Vertragsnehmer in den Vertrag übernommen werden, reicht die Übermittlung der Vertragsdaten im "Ersten Vertragsnehmer" aus. Für weitere Vertragsnehmer benötigen Sie dann nur noch die "LicenceAgreementId", "PersonId" und "TypeOfUserId".

Abruf aller vorgeschlagenen Vertragsnehmer

Version 1.2

Abruf einzelner vorgeschlagener Vertragsnehmer

Version 1.0

Version 1.2

Neuen vorgeschlagenen Vertragsnehmer anlegen

Version 1.0

Version 1.2

Vorgeschlagenen Vertragsnehmer ändern

Version 1.0

Version 1.2

Vorgeschlagenen Vertragsnehmer löschen

Version 1.0

Version 1.2

Enumerationen für "LiveOfContractId"

Type

Unlimited

Limited

Duration4Years

Duration5Years

Duration10Years

LimitedWithOption

Duration2Years

Duration3Years

Duration6Years

Duration7Years

Duration8Years

Duration9Years

Duration15Years

PreviousVerkehrssicherung NextBeispiel Workflow

Last updated 1 year ago

[ { "Id": 1, "LicenseAgreement": { "Id": 1, "UseUnit": { "Id": 1, "UseUnitNumber": "text", "BuildingLandId": 1, "EconomicUnitId": 1, "EconomicUnit": "text" }, "RestrictionsOfUse": { "Id": 1, "NodeId": 1, "Name": "text", "IsVacancy": true }, "ContractStatus": { "Id": 1, "Name": "text" }, "IdNum": "text", "StartContract": "2025-04-26", "EndOfContract": "2025-04-26" }, "ContractorType": { "Id": 1, "Name": "text", "Classification": "text" }, "EstimatedContractData": { "EstimatedColdRent": 1, "EstimatedPrepaymentHeating": 1, "EstimatedRunningCost": 1, "EstimatedTotalRent": 1, "EstimatedContractSecurity": 1, "EstimatedStartContract": "2025-04-26", "ContractSignedAt": "2025-04-26", "CommonSetEndOfContract": "2025-04-26", "TaxSlimAgreementVatRate": { "Id": 1, "Code": "text" }, "LifeOfAContract": { "Id": 1, "Code": "text" }, "Address1": "text", "Address2": "text", "Address3": "text", "Address4": "text", "Address5": "text", "Address6": "text", "Title": "text", "FutureUpdateRecipientAddress": true }, "HasLicenseAgreementHandled": true, "HasContractPositionHandled": true, "SuggestedContractPositions": [ { "Id": 1, "ContractPositionContractPositionTypeObsolete": { "Id": 1, "Name": "text", "ShortCode": "text", "IsPartOfNetRentCensus": true, "IsPartOfNetRent": true, "ReportAsSinkingFund": true, "IsBasisCalculationReminderChargeInterest": true, "IsPrepaymentHeating": true, "IsPrepaymentRunningCost": true, "IsGrossRentWithoutHeating": true }, "Amount": 1, "NetAmount": 1, "Currency": { "Id": 1, "Code": "text" }, "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "VatRate": { "Id": 1, "Code": "text" }, "Info": "text" } ], "Person": { "Id": 1, "IdNum": "text", "Shortname": "text", "Name": "text", "NodeId": 1, "TaxNumber": "text", "TaxIdentificationNumber": "text", "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "IsNaturalPerson": true, "NaturalPerson": { "Title": "text", "FirstName": "text", "LastName": "text", "BirthName": "text", "CareOf": "text", "BirthDate": "2025-04-26", "DeathDate": "2025-04-26T11:12:13.635Z", "Gender": { "Id": 1, "Name": "text" }, "MaritalType": { "Id": 1, "Name": "text" }, "Nationality": { "Id": 1, "Name": "text", "Code": "text" }, "ContactPreference": { "Id": 1, "Name": "text" }, "PersonInCare": { "Id": 1, "IdNum": "text" } }, "LegalPerson": { "LongName1": "text", "LongName2": "text", "VatId": "text", "CommercialRegisterNumber": "text", "CommercialRegisterTown": "text" }, "Addresses": [ { "Id": 1, "Zip": "text", "Town": "text", "Street": "text", "HouseNumber": "text", "HouseNumberAddition": "text", "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "StreetComplete": "text", "HouseNumberComplete": "text", "MainAddress": true, "AddressType": { "Id": 1, "Name": "text" }, "Country": { "Id": 1, "Name": "text", "Code": "text" } } ], "Communications": [ { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } } ], "BankAccounts": [ { "Id": 1, "BankAccountId": 1, "Iban": "text", "Bic": "text", "AccountHolder": "text", "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "BankAccountType": { "Id": 1, "Code": "text" }, "BankAccountUsageType": { "Id": 1, "Code": "text" } } ], "FirstEmailCommunication": { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } }, "FirstLandlinePhoneCommunication": { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } }, "FirstMobilePhoneCommunication": { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } } } } ]

{ "Id": 1, "LicenseAgreement": { "Id": 1, "UseUnit": { "Id": 1, "UseUnitNumber": "text", "BuildingLandId": 1, "EconomicUnitId": 1, "EconomicUnit": "text" }, "RestrictionsOfUse": { "Id": 1, "NodeId": 1, "Name": "text", "IsVacancy": true }, "ContractStatus": { "Id": 1, "Name": "text" }, "IdNum": "text", "StartContract": "2025-04-26", "EndOfContract": "2025-04-26" }, "ContractorType": { "Id": 1, "Name": "text", "Classification": "text" }, "EstimatedContractData": { "EstimatedColdRent": 1, "EstimatedPrepaymentHeating": 1, "EstimatedRunningCost": 1, "EstimatedTotalRent": 1, "EstimatedContractSecurity": 1, "EstimatedStartContract": "2025-04-26", "ContractSignedAt": "2025-04-26", "CommonSetEndOfContract": "2025-04-26", "TaxSlimAgreementVatRate": { "Id": 1, "Code": "text" }, "LifeOfAContract": { "Id": 1, "Code": "text" }, "Address1": "text", "Address2": "text", "Address3": "text", "Address4": "text", "Address5": "text", "Address6": "text", "Title": "text", "FutureUpdateRecipientAddress": true }, "HasLicenseAgreementHandled": true, "HasContractPositionHandled": true, "SuggestedContractPositions": [ { "Id": 1, "ContractPositionContractPositionTypeObsolete": { "Id": 1, "Name": "text", "ShortCode": "text", "IsPartOfNetRentCensus": true, "IsPartOfNetRent": true, "ReportAsSinkingFund": true, "IsBasisCalculationReminderChargeInterest": true, "IsPrepaymentHeating": true, "IsPrepaymentRunningCost": true, "IsGrossRentWithoutHeating": true }, "Amount": 1, "NetAmount": 1, "Currency": { "Id": 1, "Code": "text" }, "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "VatRate": { "Id": 1, "Code": "text" }, "Info": "text" } ], "Person": { "Id": 1, "IdNum": "text", "Shortname": "text", "Name": "text", "NodeId": 1, "TaxNumber": "text", "TaxIdentificationNumber": "text", "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "IsNaturalPerson": true, "NaturalPerson": { "Title": "text", "FirstName": "text", "LastName": "text", "BirthName": "text", "CareOf": "text", "BirthDate": "2025-04-26", "DeathDate": "2025-04-26T11:12:13.635Z", "Gender": { "Id": 1, "Name": "text" }, "MaritalType": { "Id": 1, "Name": "text" }, "Nationality": { "Id": 1, "Name": "text", "Code": "text" }, "ContactPreference": { "Id": 1, "Name": "text" }, "PersonInCare": { "Id": 1, "IdNum": "text" } }, "LegalPerson": { "LongName1": "text", "LongName2": "text", "VatId": "text", "CommercialRegisterNumber": "text", "CommercialRegisterTown": "text" }, "Addresses": [ { "Id": 1, "Zip": "text", "Town": "text", "Street": "text", "HouseNumber": "text", "HouseNumberAddition": "text", "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "StreetComplete": "text", "HouseNumberComplete": "text", "MainAddress": true, "AddressType": { "Id": 1, "Name": "text" }, "Country": { "Id": 1, "Name": "text", "Code": "text" } } ], "Communications": [ { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } } ], "BankAccounts": [ { "Id": 1, "BankAccountId": 1, "Iban": "text", "Bic": "text", "AccountHolder": "text", "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "BankAccountType": { "Id": 1, "Code": "text" }, "BankAccountUsageType": { "Id": 1, "Code": "text" } } ], "FirstEmailCommunication": { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } }, "FirstLandlinePhoneCommunication": { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } }, "FirstMobilePhoneCommunication": { "Id": 1, "RelatedAddressId": 1, "Content": "text", "Explanation": "text", "RelatedAddress": "text", "CommunicationType": { "Id": 1, "Name": "text" } } } }

POST /openwowi/v1.2/SuggestedContractor/SuggestedContractor HTTP/1.1 Host: Content-Type: application/json Accept: */* Content-Length: 500 { "LicenseAgreementId": 1, "PersonId": 1, "TypeOfUserId": 1, "EstimatedColdRent": 1, "EstimatedPrepaymentHeating": 1, "EstimatedRunningCost": 1, "EstimatedTotalRent": 1, "EstimatedContractSecurity": 1, "EstimatedStartContract": "2025-04-26", "ContractSignedAt": "2025-04-26", "CommonSetEndOfContract": "2025-04-26", "Address1": "text", "Address2": "text", "Address3": "text", "Address4": "text", "Address5": "text", "Address6": "text", "Title": "text", "FutureUpdateRecipientAddress": true, "TaxAgreementVatRateId": 1, "LifeOfAContractId": 1 }

PUT /openwowi/v1.2/SuggestedContractor/SuggestedContractor/{id} HTTP/1.1 Host: Content-Type: application/json Accept: */* Content-Length: 500 { "LicenseAgreementId": 1, "PersonId": 1, "TypeOfUserId": 1, "EstimatedColdRent": 1, "EstimatedPrepaymentHeating": 1, "EstimatedRunningCost": 1, "EstimatedTotalRent": 1, "EstimatedContractSecurity": 1, "EstimatedStartContract": "2025-04-26", "ContractSignedAt": "2025-04-26", "CommonSetEndOfContract": "2025-04-26", "Address1": "text", "Address2": "text", "Address3": "text", "Address4": "text", "Address5": "text", "Address6": "text", "Title": "text", "FutureUpdateRecipientAddress": true, "TaxAgreementVatRateId": 1, "LifeOfAContractId": 1 }

{ "Id": 1, "Person": { "Id": 1, "IdNum": "text", "Name": "text", "ShortName": "text", "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "IsNaturalPerson": true, "LegalPerson": { "LongName1": "text", "LongName2": "text" }, "NaturalPerson": { "Title": "text", "FirstName": "text", "LastName": "text", "BirthName": "text", "CareOf": "text", "BirthDate": "2025-04-26", "DeathDate": "2025-04-26T11:12:13.635Z", "Gender": { "Id": 1, "Name": "text" }, "MaritalType": { "Id": 1, "Name": "text" }, "Nationality": { "Id": 1, "Name": "text", "Code": "text" }, "ContactPreference": { "Id": 1, "Name": "text" }, "PersonInCare": { "Id": 1, "IdNum": "text" }, "ContactFor": [ { "Id": 1, "IdNum": "text", "LongName1": "text", "LongName2": "text" } ] } }, "LicenseAgreement": { "Id": 1, "UseUnit": { "Id": 1, "UseUnitNumber": "text", "BuildingLandId": 1, "EconomicUnitId": 1, "EconomicUnit": "text" }, "RestrictionsOfUse": { "Id": 1, "NodeId": 1, "Name": "text", "IsVacancy": true }, "ContractStatus": { "Id": 1, "Name": "text" }, "IdNum": "text", "StartContract": "2025-04-26", "EndOfContract": "2025-04-26" }, "ContractorType": { "Id": 1, "Name": "text", "Classification": "text" }, "EstimatedContractData": { "EstimatedColdRent": 1, "EstimatedPrepaymentHeating": 1, "EstimatedRunningCost": 1, "EstimatedTotalRent": 1, "EstimatedContractSecurity": 1, "EstimatedStartContract": "2025-04-26", "ContractSignedAt": "2025-04-26", "CommonSetEndOfContract": "2025-04-26", "TaxSlimAgreementVatRate": { "Id": 1, "Code": "text" }, "LifeOfAContract": { "Id": 1, "Code": "text" }, "Address1": "text", "Address2": "text", "Address3": "text", "Address4": "text", "Address5": "text", "Address6": "text", "Title": "text", "FutureUpdateRecipientAddress": true }, "HasLicenseAgreementHandled": true, "HasContractPositionHandled": true, "SuggestedContractPositions": [ { "Id": 1, "ContractPositionContractPositionTypeObsolete": { "Id": 1, "Name": "text", "ShortCode": "text", "IsPartOfNetRentCensus": true, "IsPartOfNetRent": true, "ReportAsSinkingFund": true, "IsBasisCalculationReminderChargeInterest": true, "IsPrepaymentHeating": true, "IsPrepaymentRunningCost": true, "IsGrossRentWithoutHeating": true }, "Amount": 1, "NetAmount": 1, "Currency": { "Id": 1, "Code": "text" }, "ValidFrom": "2025-04-26", "ValidTo": "2025-04-26", "VatRate": { "Id": 1, "Code": "text" }, "Info": "text" } ] }

POST /openwowi/v1.0/SuggestedContractor/SuggestedContractor HTTP/1.1 Host: Content-Type: application/json Accept: */* Content-Length: 500 { "LicenseAgreementId": 1, "PersonId": 1, "TypeOfUserId": 1, "EstimatedColdRent": 1, "EstimatedPrepaymentHeating": 1, "EstimatedRunningCost": 1, "EstimatedTotalRent": 1, "EstimatedContractSecurity": 1, "EstimatedStartContract": "2025-04-26", "ContractSignedAt": "2025-04-26", "CommonSetEndOfContract": "2025-04-26", "Address1": "text", "Address2": "text", "Address3": "text", "Address4": "text", "Address5": "text", "Address6": "text", "Title": "text", "FutureUpdateRecipientAddress": true, "TaxAgreementVatRateId": 1, "LifeOfAContractId": 1 }

PUT /openwowi/v1.0/SuggestedContractor/SuggestedContractor/{id} HTTP/1.1 Host: Content-Type: application/json Accept: */* Content-Length: 500 { "LicenseAgreementId": 1, "PersonId": 1, "TypeOfUserId": 1, "EstimatedColdRent": 1, "EstimatedPrepaymentHeating": 1, "EstimatedRunningCost": 1, "EstimatedTotalRent": 1, "EstimatedContractSecurity": 1, "EstimatedStartContract": "2025-04-26", "ContractSignedAt": "2025-04-26", "CommonSetEndOfContract": "2025-04-26", "Address1": "text", "Address2": "text", "Address3": "text", "Address4": "text", "Address5": "text", "Address6": "text", "Title": "text", "FutureUpdateRecipientAddress": true, "TaxAgreementVatRateId": 1, "LifeOfAContractId": 1 }