# Vorgeschlagene Vertragsnehmer

{% hint style="warning" %}
Um auf die Daten der vorgeschlagenen Vertragsnehmer über die API zugreifen zu können, muss die Endpunktberechtigung "Vorgeschlagene Vertragsnehmer lesen/bearbeiten" aktiviert werden.
{% endhint %}

{% hint style="danger" %}
Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.
{% endhint %}

<details>

<summary>Hinweise zur Funktion</summary>

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 [Anlage von Personen](https://docs.openwowi.de/schnittstelle-v1.x/personendaten-aendern) 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".&#x20;

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".

</details>

## Abruf aller vorgeschlagenen Vertragsnehmer

#### Version 1.2

***

{% openapi src="<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>" path="/openwowi/v1.2/SuggestedContractor/SuggestedContractor" method="get" %}
<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>
{% endopenapi %}

***

## Abruf einzelner vorgeschlagener Vertragsnehmer

#### Version 1.0

***

{% openapi src="<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>" path="/openwowi/v1.0/SuggestedContractor/SuggestedContractor/{id}" method="get" %}
<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>
{% endopenapi %}

***

#### Version 1.2

***

{% openapi src="<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>" path="/openwowi/v1.2/SuggestedContractor/SuggestedContractor/{id}" method="get" %}
<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>
{% endopenapi %}

***

## Neuen vorgeschlagenen Vertragsnehmer anlegen

#### Version 1.0

***

{% openapi src="<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>" path="/openwowi/v1.0/SuggestedContractor/SuggestedContractor" method="post" %}
<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>
{% endopenapi %}

***

#### Version 1.2

***

{% openapi src="<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>" path="/openwowi/v1.2/SuggestedContractor/SuggestedContractor" method="post" %}
<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>
{% endopenapi %}

***

## Vorgeschlagenen Vertragsnehmer ändern

#### Version 1.0

***

{% openapi src="<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>" path="/openwowi/v1.0/SuggestedContractor/SuggestedContractor/{id}" method="put" %}
<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>
{% endopenapi %}

***

#### Version 1.2

***

{% openapi src="<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>" path="/openwowi/v1.2/SuggestedContractor/SuggestedContractor/{id}" method="put" %}
<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>
{% endopenapi %}

***

## Vorgeschlagenen Vertragsnehmer löschen

#### Version 1.0

***

{% openapi src="<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>" path="/openwowi/v1.0/SuggestedContractor/SuggestedContractor/{id}" method="delete" %}
<https://application-test.wowiport.de/swagger/openwowi_v1.0/swagger.json>
{% endopenapi %}

***

#### Version 1.2

***

{% openapi src="<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>" path="/openwowi/v1.2/SuggestedContractor/SuggestedContractor/{id}" method="delete" %}
<https://openwowi-demo.wowiport.de/swagger/openwowi_v1.2/swagger.json>
{% endopenapi %}

***

Den Katalog für "TaxAgreementVatRateId" finden Sie im Katalog für "SalesTax" im [Belegsystem](https://docs.openwowi.de/schnittstelle-v1.x/belegsystem/kataloge).

Den Katalog für TypeOfUserId finden Sie im Katalog "ContractorType" in der [Mietenbuchhaltung](https://docs.openwowi.de/schnittstelle-v1.x/mietenbuchhaltung) (die ID kann aus dem Katalog übernommen werden).\
Bitte beachten Sie, dass kundendefinierte Nutzerarten keine Rollen aufweisen müssen und deshalb ggf. nicht per API akzeptiert werden. Alle IDs über "1000" können aus diesem Grund nicht verlässlich für die Nutzerarten verwendet werden.\
Sollten Sie diese verwenden wollen, so muss der Kunde die "FIO-VE-Steuerung Nutzerart" im Katalog für den entsprechenden Eintrag hinterlegen.\
Sie erkennen diesen Eintrag im Katalog Endpunkt, durch Daten im Schlüssel "Classification".

<figure><img src="https://619896158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfOXt8VHk6GRwZ0LymzOn%2Fuploads%2Ffy0diukcjZFVtEWqgZpB%2Fimage.png?alt=media&#x26;token=9572b8b2-a643-46da-9fb4-922af994a112" alt=""><figcaption></figcaption></figure>

## Enumerationen für "LiveOfContractId"

| Id | Type              |
| -- | ----------------- |
| 1  | Unlimited         |
| 2  | Limited           |
| 3  | Duration4Years    |
| 4  | Duration5Years    |
| 5  | Duration10Years   |
| 6  | LimitedWithOption |
| 7  | Duration2Years    |
| 8  | Duration3Years    |
| 9  | Duration6Years    |
| 10 | Duration7Years    |
| 11 | Duration8Years    |
| 12 | Duration9Years    |
| 13 | Duration15Years   |