Diese Veröffentlichung ist das öffentliche Produkthandbuch. Die Fachanwendungen öffnen Sie unter der vom eigenen Betrieb bereitgestellten Adresse; genannte Anwendungspfade beziehen sich auf diese Installation.

<a id="import"></a>
# Gemeinsamer Importstandard und Verkaufsdateien

Der gemeinsame Standard heißt **partuvo-import, Version 1**. JSON und CSV bilden dasselbe Modell ab. Unter „Datenübernahme“ führt die Hauptanwendung durch Dateiauswahl, Spaltenzuordnung, Konfliktprüfung, Vorschau und bestätigte Übernahme. Die Beschreibung des Dateiformats, Vorlagen und Beispieldateien stehen ergänzend bereit. Die Vorschau prüft ohne Buchungswirkung; erst der bestätigte Plan darf ausgeführt werden.

Die Datenübernahme verlangt Administration im ausgewählten Betrieb und die Lese-/Schreibrechte der beteiligten Fachmodule. Referenzierte Daten müssen ebenfalls zugänglich sein. Das eigene Modul „Verkaufsdateien“ verwendet **partuvo-sales, Version 1** und bleibt der gesonderte Weg für Verkaufsdateien und deren Mappingprofile. Seine Anleitung folgt unten. Beide Wege verwenden den gemeinsamen Verkaufseingang zur Vermeidung von Doppelübernahmen; Formate und Mengen-/Geldeinheiten bleiben verschieden.

<a id="import-dateien-und-einheiten"></a>
## Dateien und Einheiten

Maßgeblich ist das [JSON-Schema Version 1](https://partuvo.com/handbook/import/schema/partuvo-import-v1.schema.json). Eine JSON-Datei enthält `format`, `version`, `batch` und `entities`. Ein CSV-Bündel enthält [batch.json](https://partuvo.com/handbook/import/templates/batch.json) und die passenden Entitätstabellen:

| Datei | Inhalt |
| --- | --- |
| [partners.csv](https://partuvo.com/handbook/import/templates/partners.csv) | Kontakte mit Kunden-/Lieferantenrollen |
| [vehicles.csv](https://partuvo.com/handbook/import/templates/vehicles.csv) | Fahrzeuge und Stammdaten |
| [locations.csv](https://partuvo.com/handbook/import/templates/locations.csv) | Standorte, Lager, Bereiche, Plätze und Kisten |
| [storage_rules.csv](https://partuvo.com/handbook/import/templates/storage_rules.csv) | Platzregeln für die vier Lagerstrategien |
| [parts.csv](https://partuvo.com/handbook/import/templates/parts.csv) | Teile, Preise und Herkunftsbezüge |
| [stocks.csv](https://partuvo.com/handbook/import/templates/stocks.csv) | gezählte Lose und Platzierungen |
| [sales.csv](https://partuvo.com/handbook/import/templates/sales.csv) | Verkaufsaufträge |
| [sale_lines.csv](https://partuvo.com/handbook/import/templates/sale_lines.csv) | sämtliche Positionen mit Verkaufsreferenz |

Vorlagen enthalten noch keine Geschäftsdaten. `batch` verlangt Kennung, Erstellzeitpunkt, Modus, Quellsystem, IANA-Zeitzone, Währung `EUR` und Preisbasis `net`; Quellkonto ist optional. Ein Datensatz benötigt eine dauerhafte `externalId` und seine im Schema als erforderlich angegebenen Felder. Für Kontakte sind das insbesondere Name und Rollen, für Fahrzeuge Referenz/Hersteller/Modell, für Teile SKU/Name/Zustand. Bestandsmengen stehen in Losen, nicht frei am Teil.

CSV verwendet UTF-8, optional BOM, Komma oder Semikolon entsprechend der Kopfzeile und Anführungszeichen für mehrzeilige Felder. Leere Zellen bedeuten „nicht angegeben“, Listen sind mit `|` getrennt. Wahrheitswerte: `true`/`false` oder `ja`/`nein`. Mengen und Geldbeträge sind ganze Zahlen: 1.250 Cent bedeutet 12,50 EUR, nicht 1.250 EUR. Datum: `YYYY-MM-DD`; Zeitstempel: ISO 8601 mit Zeitzone. `powerKw` ist Dezimaltext mit Punkt. Tabellenkalkulationen dürfen Kennungen, HSN/TSN oder führende Nullen nicht verändern. Formelähnliche Texte werden wörtlich gelesen und gemeldet, nicht berechnet; beim Öffnen solcher Dateien in Tabellenprogrammen besondere Sorgfalt walten lassen.

Der Assistent akzeptiert je Lauf höchstens **4 MiB für das übertragene Bündel und 2.000 Datensätze insgesamt, einschließlich Bestandslosen und Verkaufspositionen**. Die Übertragung enthält zusätzliche Strukturzeichen; bei einer Datei nahe 4 MiB kann deshalb bereits die Vorschau die Grenze melden. Größere Datenmengen in fachlich zusammenhängende Stapel teilen; Folgeimporte können auf vorher übernommene Kennungen derselben Quelle verweisen. Ein Teil mit seinen Eröffnungsbeständen und ein Verkauf mit sämtlichen Positionen gehören jeweils zusammen.

Für das Dateiformat gelten außerdem höchstens 10.000 Zeichen je Feld und 64 Spalten. Pro Prüfung werden höchstens 1.000 Fehler angezeigt. Unbekannte Felder, Tabellen oder Formatversionen nicht durch bloßes Umbenennen passend machen: Die Bedeutung der Quelldaten muss zum gewählten Feld passen.

<a id="import-art-der-ubernahme"></a>
## Art der Übernahme

| Modus | Erlaubter Inhalt und Wirkung |
| --- | --- |
| `master_data` | Kontakte, Fahrzeuge, Orte, Regeln, Teile; keine Mengen oder Belege |
| `opening_balance` | zusätzlich gezählte Bestandslose; keine erfundene Bewegungshistorie |
| `historical` | zusätzlich historische Verkäufe und Positionen; kein neuer Verkaufsabgang |
| `operative` | nur neue Verkäufe und Positionen; Stammdaten bereits bekannt; Abgang erst bei Bestätigung |

Der Assistent prüft diese Bedeutungen gegen die tatsächlichen Fachdaten. Bei historischen, bereits bestätigten, aber noch nicht versandten Verkäufen bleibt Ware physisch vorhanden: Der verkäufliche Anfangsbestand ist Zählmenge minus noch vorliegende verkaufte Menge. Historische Teile bleiben für neue Vorgänge gesperrt, bis die zugehörigen Altverkäufe vollständig übernommen sind und der vorgesehene Endbestand stimmt. Das Weglassen eines fehlgeschlagenen Altverkaufs oder ein manuelles Aktivieren hebt diese Sperre nicht auf. Historische Verkäufe dienen als Übernahmenachweis; sie lassen sich nicht anschließend wie neue Verkäufe bestätigen, versenden oder abrechnen. Nicht dieselbe Altlieferung nochmals operativ bestätigen. Rechnungen, Zahlungen, Retouren, Einkauf/Wareneingang und Medien können in diesem Format noch nicht übernommen werden. Unbekannte Listen werden abgewiesen. Bilder und Originaldokumente haben ihren eigenen [kontrollierten Upload](https://partuvo.com/handbook/bilder-dokumente.md); keine beliebigen Bild-URLs oder Zugangsschlüssel in Importdateien eintragen.

<a id="import-referenzen-und-reihenfolge"></a>
## Referenzen und Reihenfolge

Kontakte, Fahrzeuge und Lagerhierarchie vor Teilen/Bestand und danach Verkäufe samt Positionen prüfen. Referenzen wie `vehicleRef`, `parentRef`, `partRef` oder `saleRef` nennen die externe Kennung derselben Quelle. Lagerhierarchien dürfen keine Zyklen bilden. Fahrzeugkisten und eingebaute Teile müssen zum richtigen Fahrzeug gehören. Eine Regelabweichung braucht `overrideReason`. Ein Teil kann mehrere Lose sowie nicht zugeordnete Mengen haben.

Für eine wiederholbare Übernahme müssen Betrieb, Quellsystem, Quellkonto, Datenart und externe Kennung erhalten bleiben. Bereits übernommene gleiche Inhalte werden als unverändert erkannt; abweichende Inhalte erfordern eine ausdrückliche Konfliktentscheidung. Bei einer gewünschten Änderung eines vorhandenen Datensatzes verlangt die Datei mit `operation:update` auch dessen aktuellen Stand in `expectedVersion`. Bei Verkäufen werden zusätzlich Kanal, Verkäuferkonto, Bestell- und Positionskennungen mit dem gemeinsamen Verkaufseingang abgeglichen. Für eBay-Bestellungen aus gobecom ist `channelProvider:gobecom` anzugeben; `channelAccount` muss dabei den tatsächlichen Verkäufernamen enthalten, keine interne Konto-ID. Ohne Kanalangaben bilden Quellsystem, Quellkonto und externe Kennungen die Verkaufsidentität; ein leeres Quellkonto wird als `default` geführt. Ein Dateiimport erteilt keine Freigabe für einen Versandauftrag an eBay. Dieselben Kennungen aus Datei und eBay dürfen keinen zweiten Bestandsabgang erzeugen. Inhaltliche Abweichungen und die Zuständigkeit eines bestehenden Verkaufseingangs werden als Konflikt behandelt, nicht durch eine neue erfundene Kennung umgangen. E-Mail allein ist kein Zusammenführungsschlüssel.

`partuvo:<id>` bezeichnet einen bestehenden Zieldatensatz im ausgewählten Betrieb. Der Assistent prüft dessen Verfügbarkeit, Berechtigung und aktuellen Stand. Vorhandene Zielkennungen nur aus dem eigenen Betrieb übernehmen.

<a id="import-datenubernahme-im-assistenten"></a>
## Datenübernahme im Assistenten

1. Im richtigen Betrieb „Datenübernahme“ öffnen. Bei Bedarf „JSON-Schema v1“, „Beispieldatensatz“, „CSV-Stapelvorlage“ und die benötigten Tabellen herunterladen. Unter „JSON oder CSV-Bündel“ entweder eine JSON-Datei oder `batch.json` zusammen mit den passenden CSV-Dateien auswählen.
2. „Art der Übernahme“ prüfen. „Modus aus Datei verwenden“ übernimmt den ausdrücklich in `batch` angegebenen Modus; die anderen Auswahlwerte setzen ihn für diesen Plan. Besonders gezählte Eröffnungsbestände, historische Verkäufe und neue operative Verkäufe nicht verwechseln.
3. Bei CSV jede „Spaltenzuordnung“ kontrollieren. Fremde Spalten einem passenden Standardfeld zuordnen oder ausdrücklich „Spalte nicht übernehmen“ wählen. Pflichtfelder müssen erhalten bleiben. Anschließend „Vorschau prüfen“ wählen.
4. Datensätze, Hinweise, Fehler, Mengenwirkung und Reihenfolge im „Importplan“ prüfen. Unter „Konflikte ausdrücklich auflösen“ gegebenenfalls den Datensatz überspringen, einem vorhandenen Datensatz zuordnen oder einen unterstützten Stammdatensatz ändern. Zuordnen und Ändern verlangen die tatsächliche Partuvo-ID und aktuelle Zielversion. Verkaufsinhalte werden über diese Auswahl nicht umgeschrieben. Lose werden mit ihrem Teil, Positionen mit ihrem Verkauf entschieden. Danach erneut „Vorschau prüfen“; eine fehlende übersprungene Referenz kann weitere Datensätze sperren.
5. Erst bei fehlerfreier Vorschau „Ich habe Modus, Zuordnungen, Hinweise und Auswirkungen dieses Plans geprüft.“ aktivieren und „Diesen Plan verbindlich bestätigen“ wählen. Unter „Bindung der geprüften Vorschau“ ist erkennbar, welche Datei und Zuordnung geprüft wurde. Die Bestätigung gilt nur für diese Dateien, den Modus, die Zuordnungen und Konfliktentscheidungen sowie die geprüften Zielversionen. Eine Änderung verlangt eine neue Vorschau; auch zwischenzeitlich geänderte Fachdaten dürfen nicht still übernommen werden.
6. Mit „Übernahme ausführen / fortsetzen“ die bestätigten Schritte ausführen. Abhängige Daten folgen ihren Vorgängern. Ein Teil einschließlich seiner Eröffnungslose und ein Verkauf einschließlich sämtlicher Positionen werden jeweils vollständig oder gar nicht übernommen. Die Bestätigung allein startet noch keine Übernahme.
7. Ergebnisse je Schritt und den abschließenden Zustand lesen. „Nach aktuellem Schritt anhalten“ beendet die Folge nach dem bereits laufenden Schritt. Bereits erfolgreiche Schritte bleiben bestehen. Bei Teilfehlern Fehler und gesperrte Abhängigkeiten prüfen; unabhängige ausstehende Schritte lassen sich fortsetzen. Korrigierte Quelldaten benötigen eine neue Vorschau mit denselben dauerhaften Quellkennungen.

Unter „Gespeicherte Übernahmen“ bleiben Pläne und Ergebnisse auf dem Server erhalten. Nach Neuladen, Verbindungsabbruch oder Serverneustart „Gespeicherte Übernahmen laden“, den betreffenden Lauf öffnen und ausdrücklich fortsetzen. Kein neuer Lauf ist nötig, nur weil eine Antwort ausgeblieben ist. Bereits bestätigte Schritte werden anhand des gespeicherten Stands wiedererkannt. Die Liste zeigt die jüngsten 100 für den Benutzer zugänglichen Läufe.

Bei Rechteentzug beendet die Oberfläche die Bearbeitung und entfernt die geladenen Importdaten aus der Ansicht. Der Server prüft die aktuellen Rechte auch für das Laden, Fortsetzen und Exportieren. Erfolgreich übernommene Fachdaten werden durch Rechteentzug oder das Schließen des Fensters nicht zurückgenommen.

<a id="import-synthetisch-prufen"></a>
## Synthetisch prüfen

Das [vollständige synthetische JSON-Beispiel](https://partuvo.com/handbook/import/examples/nordwerk-2026.json) umfasst alle acht Entitäten und die vier Lagerstrategien. Der Name bezeichnet ausschließlich ein fiktives Beispielszenario. Für die CSV-Darstellung gehören alle neun Dateien zusammen: [batch.json](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/batch.json), [Kontakte](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/partners.csv), [Fahrzeuge](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/vehicles.csv), [Orte](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/locations.csv), [Regeln](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/storage_rules.csv), [Teile](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/parts.csv), [Lose](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/stocks.csv), [Verkäufe](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/sales.csv), [Positionen](https://partuvo.com/handbook/import/examples/nordwerk-2026-csv/sale_lines.csv).

Die Beispieldateien ausschließlich in einem dafür vorgesehenen Testbetrieb prüfen. Das vollständige Beispiel enthält 72 Datensätze und zwei erklärungsbedürftige Hinweise: einen Formeltext und eine begründete Abweichung von einer Platzregel. Hinweise auch dann lesen, wenn keine Fehler vorliegen.

Ein Fehler nennt das betroffene Feld, den Datensatz beziehungsweise die Zeile und Hinweise zur Korrektur. Fehlerhafte Vorgänger können abhängige Daten sperren; eine fehlerhafte Verkaufsposition sperrt den gesamten Verkauf. Bei fehlenden Bezügen die Quellkennung korrigieren, bei zwischenzeitlichen Änderungen zuerst den aktuellen Zielstand prüfen. Die Originaldatei getrennt behalten und Änderungen in einer Kopie erneut prüfen.

<a id="import-ubernahme-export-und-rucknahmegrenzen"></a>
## Übernahme, Export und Rücknahmegrenzen

Bei einem vollständig abgeschlossenen Lauf ist „Übernahmedatei exportieren“ verfügbar. Die JSON-Datei enthält das akzeptierte, normalisierte Quellbündel im gemeinsamen Format. Sie ist ein Archiv dieser Übernahme, kein Export des inzwischen möglicherweise bearbeiteten Fachbestands und keine vollständige Sicherung. Unverändert im selben Betrieb und mit denselben Quellkennungen erneut geprüft, erzeugt sie keine weiteren Datensätze oder Bestandsabgänge. Spätere fachliche Änderungen können eine erneute Prüfung sperren und müssen geprüft werden. Ein unvollständiger Lauf kann noch nicht als abgeschlossene Übernahmedatei exportiert werden.

Für einen synthetischen Probelauf das vollständige Beispiel in einer gesonderten Testinstallation prüfen, Modus und beide Hinweise kontrollieren, bestätigen und ausführen. Danach Teile, Platzierungen, historische Verkäufe und verfügbare Mengen vergleichen. Den abgeschlossenen Lauf exportieren und die Datei erneut prüfen: Bereits übernommene Inhalte müssen unverändert erkannt werden. Bei einer Unterbrechung den gespeicherten Lauf wieder öffnen und seine Ergebnisse prüfen, bevor die Übernahme fortgesetzt wird.

Fachlistenexporte in CSV beziehungsweise JSON sind nicht automatisch zur vollständigen Rückübernahme im gemeinsamen Standard geeignet. Der weiter unten beschriebene Verkaufsdatei-Export hat einen eigenen Rückimportweg.

Eine reine Vorschau verändert noch keine Fachdaten. Versehentlich geänderte Arbeitsdateien lassen sich aus der eigenen Originalkopie wiederherstellen. Für tatsächlich übernommene Daten gelten die jeweiligen [Fachkorrekturen](https://partuvo.com/handbook/diagnose.md). Die Wiederherstellung einer vollständigen Sicherung betrifft auch andere Vorgänge und muss durch den Betreiber geprüft werden.

<a id="import-verkaufsdateien-unterstutzte-formate-und-voraussetzungen"></a>
## Verkaufsdateien: unterstützte Formate und Voraussetzungen

„Verkaufsdateien“ übernimmt vorhandene Verkäufe oder neue Verkaufsaufträge, keine Teile, Kontakte oder Lagerorte. Lesen und Export verlangen Verkaufsleserecht. Vorschau und Übernahme verlangen Verkaufsschreibrecht plus Teilelagerleserecht, also im üblichen Rollenmodell Administration oder Verkauf & Belege bei freigegebenen Modulen. Ein unbekanntes Teil muss zunächst über den normalen Teileweg angelegt werden. Eine optionale Kundennummer muss exakt einem vorhandenen aktiven Kunden entsprechen; Name oder E-Mail verschmelzen keine Kontakte.

Das [Verkaufsdatei-Schema v1](https://partuvo.com/handbook/sales-files/partuvo-sales-v1.schema.json), die [CSV-Vorlage](https://partuvo.com/handbook/sales-files/partuvo-sales-v1-vorlage.csv) und das [synthetische historische Beispiel](https://partuvo.com/handbook/sales-files/examples/historisch.json) gehören zum separaten Format `partuvo-sales`. JSON enthält `format`, `version`, optional `source` und `orders` mit vollständigen `lines`. CSV führt eine Zeile je Position; Bestellfelder müssen in allen Zeilen derselben Bestellung übereinstimmen. Pflichtangaben umfassen Kanal, Konto, Bestellkennung, Bestellzeitpunkt, Auftragsstatus, Währung, Preisbasis, Käufer sowie Positionskennung, bestehende SKU, ganze Menge und Stückpreis.

Hier sind Stückpreise **Dezimalbeträge in der Quellwährung**, beispielsweise `"12.50"`; sie sind keine Centzahl des allgemeinen `partuvo-import`-Formats. `priceBasis:gross` benötigt einen ausdrücklichen Steuersatz; Fremdwährung einen Kurs in EUR je Quelleinheit. Die Vorschau zeigt den daraus errechneten Nettostückpreis in EUR-Cent und Rundungsabweichungen. Versandkosten und Rabatt auf Bestellebene werden dokumentiert, aber nicht als Partuvo-Verkaufspositionen übernommen. Negative Mengen sind keine Retouren. Rechnungen, Zahlungen, Erstattungen und Gutschriften werden nicht erzeugt; gemeldeter Zahlungsstatus bleibt Dokumentation.

Grenzen: UTF-8 mit oder ohne BOM, CSV mit Komma oder Semikolon, maximal 4 MiB, 2.000 Bestellungen, 20.000 Positionen und 100 Positionen je Bestellung. Windows-1252/UTF-16, unbekannte Spalten und unzugeordnete Statuswerte werden gemeldet. Der Export entschärft Formeltexte; der eigene Reimport erhält ihre ursprüngliche Textbedeutung. Originaldatei separat erhalten und keine echten Kundendaten in öffentliche Muster kopieren.

<a id="import-verkaufsdatei-prufen-und-ubernehmen"></a>
## Verkaufsdatei prüfen und übernehmen

1. „Verkaufsdateien“ → „Verkaufsdatei importieren“ öffnen. Datei wählen, „Format / Mappingprofil“ prüfen und „Art der Übernahme (Pflicht)“ ausdrücklich auswählen: „Historische Übernahme (ohne Bestandsabgang)“ oder „Operative Neubestellungen (mit Bestandsabgang)“.
2. Eingebaute Profile sind `partuvo-sales-v1` und `gobecom-ebay-orders-v1`. Für eine gespeicherte gobecom-Bestellantwort zusätzlich das tatsächliche Verkäuferkonto und den Steuersatz angeben. Eine unvollständige einzelne Anbieterdatei bleibt als solche gekennzeichnet; sie ersetzt keinen vollständigen Abruf. Für fremde CSV-Spalten unter „Mappingprofile (CSV)“ Namen, Zahlen-/Datumsformat, Zeitzone, Spalten/Festwerte und Wertzuordnungen erfassen und „Profil anlegen“. Änderungen speichern eine neue Version; „Profil archivieren“ sperrt neue Vorschauen. Eigene JSON-Mappingprofile gibt es nicht.
3. „Prüfen (Vorschau)“ wählen. Diese Aktion speichert den Plan, bucht aber noch nichts. Dateibefunde, Zeile/Feld, jede betroffene Bestellung, Position, Preis, geplante Mengenwirkung und gegebenenfalls Retourenentscheidung prüfen. Weitere Vorschauseiten berücksichtigen. Ein Fehler einer Position sperrt die ganze Bestellung; andere gültige Bestellungen können trotzdem übernommen werden.
4. Bestätigungsfeld „Ich habe die Vorschau geprüft und übernehme die Bestellungen mit der angezeigten Wirkung.“ aktivieren und „Übernahme bestätigen“. Vorschau ist an Dateihash, Profilversion und Zielstand gebunden und läuft nach 24 Stunden ab. Zwischenzeitlich geänderte Zieldaten machen die Vorschau ungültig und müssen erneut geprüft werden.
5. Ergebnis je Bestellung lesen und Aufträge, Bestandsbewegung und verbleibende Fehler vergleichen. Eine unterbrochene Übernahme bleibt serverseitig erhalten. Nach erneutem Öffnen „Unterbrochene Übernahme fortsetzen …“ bestätigen und „Übernahme fortsetzen“. Bereits verbuchte Bestellungen werden übersprungen; beim Beginn bestätigte Retourenentscheidungen lassen sich während der Fortsetzung nicht austauschen.

Historisch werden nur bereits versandte oder stornierte Altverkäufe ohne Bestandsabgang übernommen. Offene Altaufträge erfordern eine bewusst operative Übernahme; neue operative bereits versandte Aufträge werden abgewiesen. Operative bestätigte Neubestellungen buchen über die normale Verkaufsbestätigung ab. Retouren zu bekannten, entsprechend fortgeschrittenen Aufträgen benötigen die ausdrückliche Entscheidung, ob tatsächlich rückgelagert wird. Historische Retouren sind kein unterstützter Dateiweg.

Gleichbleibende Angaben zu Betrieb, Kanal, Verkäufer, Bestellung und Position verhindern Doppelübernahmen zwischen Datei und eBay-Abruf. Eine bereits über eBay geführte Bestellung wird durch eine Datei nicht neu gebucht oder still umgeschrieben; Konflikte werden angezeigt. Käufer-/Textunterschiede sind keine Erlaubnis für eine neue Bestellung mit erfundener Kennung.

<a id="import-verkaufsdateien-exportieren-und-synthetisch-kontrollieren"></a>
## Verkaufsdateien exportieren und synthetisch kontrollieren

Unter „Verkäufe exportieren“ bei Bedarf „Bestellt ab“, „Bestellt bis (einschließlich)“, Status und Quelle wählen, dann CSV oder JSON und „Exportieren“. Der Zeitraum verwendet Europe/Berlin; Datei-Zeitstempel sind UTC. Die Vollausgabe umfasst höchstens 10.000 lesbare Aufträge. Ein unveränderter Export mit denselben Identitäten wird im selben Betrieb beim Rückimport als unverändert erkannt; eigene Partuvo-Aufträge werden in einem fremden Betrieb nicht dadurch neu angelegt.

Synthetischer Probelauf: Zwei Musterteile mit den SKUs `VW-ALT-100` und `VW-PUMP-200` anlegen und die Bestände notieren. Das verlinkte historische Beispiel enthält ausschließlich erfundene Käufer, Konten und Belegdaten. Mit `partuvo-sales-v1` historisch prüfen. Erwartet werden die versandte und die stornierte Altbestellung ohne Bestandsabgang; Hinweise auf Versandkosten/Rundung lesen. Nach ausdrücklicher Übernahme Auftrag und unveränderten Bestand kontrollieren, anschließend JSON exportieren und im selben Betrieb erneut prüfen: keine neue Buchung. Für operative Tests einen separaten offenen Musterauftrag verwenden und dessen tatsächliche Bestandswirkung vor Bestätigung prüfen.

`Vorschau verwerfen` entfernt die normalisierte Datei aus einer unübernommenen Vorschau; Kopf und Statistik bleiben. Nach abgeschlossener Übernahme werden normalisierte Dateidaten ebenfalls entfernt, während Aufträge und unveränderliche Ergebnisse erhalten bleiben. Verwerfen eines Plans nimmt bereits übernommene Verkäufe nicht zurück. Bereits gebuchte Wirkungen nur über zulässiges Storno, Retoure und andere [Fachkorrekturen](https://partuvo.com/handbook/verkauf-einkauf-kasse.md) berichtigen. Ein Fehler betrifft eine Bestellung, nicht automatisch den ganzen Stapel; vor einer Wiederholung deshalb Ergebnisse lesen. Die Dateiübernahme wird im Browser durchgeführt. Eine unterbrochene Übernahme lässt sich über den gespeicherten Lauf fortsetzen.

---

Handbuch 1.4.0 · Stand 30.10.2026
