# Rahmenverträge

Stammdaten zum Validieren von Rahmenvertragsnummern. Workist kann Rahmenvertragsnummern erkennen und diese mit den bereitgestellten Stammdaten validieren. Rahmenverträge nutzt Workist bei Anfragen und Bestellungen.

## Spaltenbeschreibung

> **Pflichtfeld:** Ohne diese Spalte kann Workist den Datensatz nicht verwenden. **Empfohlen:** verbessert die Erkennung deutlich. Der Import selbst prüft keine Spalten: Fehlt eine Spalte, bleibt das Feld leer.

| # | Feldname | Status | Beschreibung |
|---|----------|--------|--------------|
| 1 | `partition_id` | <span class="status-required">Pflichtfeld</span> | `client_id1` des Kunden, zu dem der Vertrag gehört. Nötig, damit nur die Rahmenverträge dieses Kunden ausgewählt werden können. Bleibt das Feld leer, bietet Workist den Vertrag bei allen Kunden an. |
| 2 | `client_id` | <span class="status-optional">Optional</span> | Alternative Kundennummer, falls der Vertrag zu einem übergeordneten Kunden gehört. Nur relevant, falls die Kundennummer des Vertrags in der Ausgabe von dem erkannten Kunden am Dokument abweichen kann. |
| 3 | `client_name` | <span class="status-optional">Optional</span> | Name des Kunden |
| 4 | `contract_id1` | <span class="status-required">Pflichtfeld</span> | Vertragsnummer, die am Dokument gefunden werden soll bzw. die Workist in der Ausgabe mitgibt |
| 5 | `contract_id2` | <span class="status-optional">Optional</span> | Alternative Vertragsnummer |
| 6 | `contract_name` | <span class="status-recommended">Empfohlen</span> | Name des Vertrags, der zur Anzeige verwendet wird |
| 7 | `extra_data` | <span class="status-optional">Optional</span> | Zusätzliche Angaben als JSON-Objekt, z. B. `{"Marke": "Muster"}`. Workist speichert sie mit dem Datensatz und zeigt sie im Datenexplorer an. Für die Erkennung nutzt Workist sie standardmäßig nicht. |

## Format

> Nicht benötigte Spalten können im Datenexport weggelassen werden.

Beispieldateiname: `framework_contract_list.csv`

```csv
partition_id;contract_id1;contract_id2;contract_name
K001;RV-2024-001;FW001;Jahresvertrag Muster GmbH 2024
K002;RV-2024-002;;Rahmenvertrag Beispiel AG 2024
K001;RV-2024-003;;Sonderkonditionen Muster GmbH
```

Das Beispiel verwendet `;` als Trennzeichen. Stellen Sie das Trennzeichen in der [Importkonfiguration](/docs/master-data/transformer-configuration.md) ein; ohne Angabe erwartet Workist ein Komma.

Per API übermitteln Sie dieselben Spalten als CSV-Datei oder als JSON. Endpunkt: [Swagger](https://api.workist.com/v1/swagger/#/Master%20Data/framework_contracts_imports_create), Grundlagen: [Benutzung der Stammdaten-API](/docs/api-documentation/master-data-api.md).