# Angebote

Stammdaten zum Validieren von Angebotsnummern. Workist kann Angebotsnummern erkennen und diese mit den bereitgestellten Stammdaten validieren. Angebote nutzt Workist bei Bestellungen: Es gleicht Bestellungen mit dem referenzierten Angebot ab, übernimmt den Kunden aus dem Angebot und füllt Bestellungen ohne Positionen aus dem Angebot vor. Wie das im Einzelnen funktioniert, beschreibt [Abgleich mit Bestell- und Angebotsdaten](/docs/channel-configuration/document-processing/matching.md).

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

### Kopfebene

| # | Feldname | Status | Beschreibung |
|---|----------|--------|--------------|
| 1 | `partition_id` | <span class="status-recommended">Stark empfohlen</span> | `client_id1` des Kunden. Nicht verpflichtend, aber sehr stark empfohlen, damit nur die Angebote dieses Kunden ausgewählt werden können. |
| 2 | `offer_number` | <span class="status-required">Pflichtfeld</span> | Angebotsnummer |
| 3 | `valid_from` | <span class="status-optional">Optional</span> | Gültig ab. Wird beim Abgleich nicht geprüft. |
| 4 | `valid_until` | <span class="status-optional">Optional</span> | Gültig bis. Wird beim Abgleich nicht geprüft: Auch abgelaufene Angebote werden gefunden. |

### Positionsebene

Workist kann Angebote auch auf Positionsebene matchen. Hierzu müssen die Kopffelder für jede Position wiederholt werden.

| # | Feldname | Status | Beschreibung |
|---|----------|--------|--------------|
| 1 | `position_number` | <span class="status-recommended">Empfohlen</span> | Positionsnummer im Angebot |
| 2 | `article_id1` | <span class="status-recommended">Empfohlen</span> | Artikelnummer |
| 3 | `article_id2` | <span class="status-optional">Optional</span> | Alternative Artikelnummer 2 |
| 4 | `article_id3` | <span class="status-optional">Optional</span> | Alternative Artikelnummer 3 |
| 5 | `article_description` | <span class="status-recommended">Empfohlen</span> | Artikelbeschreibung |
| 6 | `quantity` | <span class="status-recommended">Empfohlen</span> | Menge |
| 7 | `unit` | <span class="status-recommended">Empfohlen</span> | Einheit |
| 8 | `extra_data` | <span class="status-optional">Optional</span> | Zusätzliche Angaben als JSON-Objekt. Nur importierbar, wenn Ihre Datei bereits die Workist-Spaltennamen verwendet und die Importkonfiguration keine Spaltenzuordnung hat. Den Eintrag `higher_level_position` nutzt Workist, um Set-Bestandteile zu erkennen. |

:::note Abgelaufene Angebote
Da Workist die Gültigkeit beim Abgleich nicht prüft, liefern Sie nur Angebote, die noch gelten. Abgelaufene Angebote entfernen Sie aus Ihrem Export; mit dem nächsten Vollimport verschwinden sie aus Workist.
:::

Mengen speichert Workist mit höchstens zwei Nachkommastellen; weitere Stellen werden gerundet.

## Format

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

Beispieldateiname: `offer_list.csv`

```csv
partition_id;offer_number;valid_from;valid_until;position_number;article_id1;article_description;quantity;unit
K001;ANG-2024-001;2024-01-01;2024-12-31;1;ART001;Schrauben M8x20 100er Pack;500;Packung
K001;ANG-2024-001;2024-01-01;2024-12-31;2;ART002;Dübel 8mm 50er Pack;200;Packung
K002;ANG-2024-002;2024-01-01;2024-06-30;1;ART003;Bohrmaschine XL Pro;10;Stück
```

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.

Datumsangaben schreiben Sie als `JJJJ-MM-TT` oder mit dem Tag zuerst (`31.12.2024`), siehe [Wie Workist Werte beim Import vereinheitlicht](/docs/master-data.md#werte-vereinheitlichen).

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