3PL & Kontraktlogistik
Wie binde ich eine Kontraktlogistik per SFTP und XML an weclapp an?
Kurz gesagt: Klassische Kontraktlogistik-Betriebe und Speditionslager arbeiten selten mit Echtzeit-Webhooks, sondern tauschen strukturierte XML-Batchdateien über gesicherte SFTP-Verzeichnisse aus. Über wals.pro TradeHub verbindest du dieses Dateiprotokoll in einem geschlossenen Sechs-Beleg-Zyklus – Artikelstamm (PRICAT), Wareneingangsavis (WEA), Einlagerungsmeldung (ELM), Versandauftrag (VA), Versandrückmeldung (VRV) sowie Bestandsbewegungen und Bestandsmeldeliste (BEW und BML) – direkt mit deiner weclapp-Schnittstelle. Atomares Datei-Schreiben per temporärer Zwischendatei, transaktionaler SHA-256-Duplikatschutz und sieben Jahre Rohdatenarchivierung in Frankfurt ersetzen jedes manuelle Datei-Schubsen.
Eine Kontraktlogistik ohne moderne REST-Schnittstelle bindest du über wals.pro TradeHub an weclapp an, indem unsere Integrationsplattform die weclapp-API im Hintergrund bedient und gegenüber dem Lagerverwaltungssystem (WMS) deines Logistikpartners genau die XML-Dateien und SFTP-Ordnerkonventionen bereitstellt, die dessen Standardprozess erwartet. Dein weclapp-Mandant benötigt dafür mindestens das Paket ERP Handel (oder Enterprise), damit Lagerverwaltung, Chargen- und Seriennummernführung sowie der API-Zugriff aktiv sind.
Im mittelständischen Groß- und Markenhandel ist SFTP mit XML kein veraltetes Notbehelf, sondern gelebter Industriestandard: Etablierte Speditionsgruppen, Kühl- und Lebensmittel-Logistikbetriebe sowie regulierte Kosmetik- und Medizintechnik-Lager entkoppeln ihre Hallenprozesse bewusst über dateibasierte Warteschlangen von externen ERP-Systemen. Fällt ein Drittsystem für zwanzig Minuten aus, steht auf dem Hallenboden kein einziger Gabelstapler still.
Problematisch wird SFTP erst dann, wenn Händler:innen versuchen, den Dateiaustausch mit einfachen Zeitplan-Skripten ohne Artikelstamm-Wächter, ohne atomare Schreibsperren und ohne Beleg-Korrelation selbst zu überbrücken. Dieser Praxis-Blueprint zeigt dir den produktiv bewährten Sechs-Dokumenttypen-Kreislauf und die technischen Schutzmechanismen in wals.pro TradeHub im Detail.

Das Wichtigste in Kürze
- Sechs aufeinander abgestimmte Dokumenttypen decken die gesamte Lagerlogistik ab. Von der Artikelanlage (PRICAT) über Wareneingang (WEA und ELM) und Warenausgang (VA und VRV) bis zur laufenden Bestandskontrolle (BEW und BML) bleibt keine Lagerbewegung undokumentiert.
- Ein Fail-Closed-Artikelstamm-Wächter verhindert abgewiesene Lieferdateien. TradeHub merkt sich jede erfolgreich per PRICAT übertragene Artikelnummer und blockiert ausgehende Einkaufs- oder Versandavise sofort, falls eine neue SKU dem WMS noch unbekannt ist.
- Atomare Datei-Übergaben per temporärer Endung verhindern kaputte XML-Reads. Ausgehende Dateien werden zuerst vollständig mit temporärer Dateiendung (.tmp) auf den SFTP-Server gestreamt und erst im letzten Schritt atomar umbenannt, sodass der Poller des Logistikpartners nie halbe Dateien greift.
- Transaktionale SHA-256-Prüfsummen schließen Doppelbuchungen aus. Jede abgeholte Rückmeldedatei wird vor der Verarbeitung per Prüfsumme beansprucht, in strukturierte Monats-Archivordner verschoben und bei versehentlicher Neuanlieferung sicher übersprungen.
- Sieben Jahre Rohdaten-Archivierung in Frankfurt sichern jede Belegprüfung ab. Sämtliche Original-XML-Dateien und weclapp-Antworten liegen unverändert im europäischen Rechenzentrum Frankfurt (Region europe-west3) bereit und verknüpfen Avis und Rückmeldung über eine gemeinsame Korrelations-ID.
Wie greifen die sechs XML-Dokumenttypen zwischen weclapp und Kontraktlogistik ineinander?
Anders als beim einfachen Paketdruck am eigenen Packtisch kennt ein externes Kontraktlogistik-Lager deine Einkaufs- und Verkaufsvorgänge nur so genau, wie deine Belegkette sie beschreibt (zur grundsätzlichen Einordnung der drei Protokollwege siehe Fulfillment-Dienstleister (3PL) an weclapp anbinden). Fehlt bereits beim Stammdaten-Export das Chargen-Kennzeichen oder das Einzelgewicht in Gramm, scheitert Tage später entweder die Vereinnahmung an der Rampe oder die Gewichtsprüfung auf dem Förderband.
In wals.pro TradeHub bilden sechs klar abgegrenzte Nachrichtentypen (plus der periodische Bestands-Snapshot BML als Gegenprobe zu den laufenden BEW-Bewegungen) einen geschlossenen Regelkreis zwischen deinem weclapp-Mandanten und dem SFTP-Server deines Logistikpartners:
| Dokumenttyp | Richtung & Takt | Fachlicher Inhalt der XML-Datei | Anker in weclapp | Schutzregel in TradeHub |
|---|---|---|---|---|
| 1. PRICAT (Artikelstamm) | weclapp an 3PL (täglich / Wasserzeichen) | Artikelnummer, EAN/GTIN, Maße (mm), Gewicht (g), Chargen-, MHD- und Seriennummern-Flag, Umkarton- und Paletten-VPE | Aktive Verkaufsartikel inklusive Zusatzfelder für Restlaufzeit und Gebinde | Überspringt Artikel ohne EAN oder Alt-SKUs; rückt Änderungs-Cursor erst nach SFTP-Erfolg vor |
| 2. WEA (Wareneingangsavis) | weclapp an 3PL (bei Bestellfreigabe) | Avis-ID, Lieferantenadresse, geplanter Liefertermin, Positionen mit SKU, EAN und erwarteter Stückzahl | Bestätigte Lieferantenbestellung im Einkauf | Prüft vorab PRICAT-Bekanntheit aller SKUs; warnt bei weniger als zwei Werktagen Vorlauf |
| 3. ELM (Einlagerungsmeldung) | 3PL an weclapp (nach Vereinnahmung) | Bezug auf Avis-ID, Buchungszeitpunkt, real gezählte Mengen, eingelagerte Chargen, MHDs und Seriennummern | Wareneingang zur Bestellung bis zur Einlagerung ins Lager | Verarbeitet Mehrfach-Avise je Datei, erkennt Unter-/Überlieferung und prüft Idempotenz |
| 4. VA (Versandauftrag) | weclapp an 3PL (alle 5 bis 15 Minuten) | Liefernummer, Auftragsreferenz, Versandart/Carrier, Empfänger- und Rechnungsadresse, lagerfähige Positionen | Versandbereite Lieferung (ohne Dienstleistungen, aufgelöste Stücklisten-Bezüge) | 35-Zeichen-Wortumbruch für Empfängernamen, automatische Kontaktperson-Befüllung und Duplikat-Fingerprint |
| 5. VRV (Versandrückmeldung) | 3PL an weclapp (nach Packabschluss) | Versendete Mengen, Paket-Trackingnummern, Gewicht, Carrier sowie gepickte Chargen, MHDs und Seriennummern je Kollo | Lieferung: Mengenkorrektur, Entnahmen (Picks), Sendungsnummer und Status Versendet | Vorab-Bestandsprüfung, saubere Status-Kaskade vor Versandabschluss und Storno-Schutz |
| 6. BEW & BML (Bestandsabgleich) | 3PL an weclapp (untertags & täglich) | BEW: Bruch, Schwund, Sperrlager-, Chargen- und MHD-Umbuchungen; BML: Stichtagsbestand frei, gesperrt und reserviert | Lagerbewegungen mit Buchungsgrund und Bewertungspreis aus Bezugsquelle | Einzelfehler-Isolation je Buchungszeile und automatischer HTML-Abweichungsbericht per E-Mail |
Fazit: Weil jede ausgehende Nachricht (WEA und VA) zwingend auf einem bestätigten PRICAT-Artikelstamm aufbaut und durch ihre Rückmeldung (ELM und VRV) sowie den BML-Snapshot gegengeprüft wird, entsteht im SFTP-Betrieb dieselbe Datensicherheit wie bei einer synchronen Direktverbindung.
Die vier Prozessstufen im Detail: Wie übersetzt TradeHub SFTP-XML in saubere weclapp-Belege?
Hinter den sechs Kürzeln stecken konkrete Übersetzungsregeln, an denen eigenentwickelte Skripte in der Praxis regelmäßig auflaufen. Ein Blick unter die Haube zeigt, wie wals.pro TradeHub jede Stufe fachlich absichert.
1. Artikelstammdaten-Übergabe (PRICAT) mit Vorab-Sperre für unbekannte SKUs
Bevor dein Kontraktlogistik-Partner den ersten Karton vereinnahmen oder versenden kann, benötigt sein WMS exakte Stammdaten. Der tägliche PRICAT-Lauf liest alle seit dem letzten Wasserzeichen geänderten, aktiven und für den Verkauf freigegebenen Artikel aus weclapp aus, rechnet Artikelgewichte von Kilogramm verlustfrei in Gramm sowie Abmessungen in Millimeter um, normiert Mengeneinheiten (etwa Stück, Kilogramm, Liter oder Karton) und überträgt die Pflichtkennzeichen für Chargennummer, Mindesthaltbarkeitsdatum inklusive geforderter Restlaufzeit-Tage sowie Seriennummernpflicht.
Zusätzlich liest TradeHub gepflegte Gebindestufen für Innenkarton, Umkarton und Palette aus den Artikel-Zusatzfeldern aus und filtert interne Testartikel, inaktive Alt-Artikel oder Positionen ohne gültige EAN konsequent vor dem Export heraus (mit klarem Protokoll für dein Stammdatenteam). Entscheidend für den Betrieb: Erst nach erfolgreichem SFTP-Upload rückt der Änderungs-Cursor vor, und jede übertragene Artikelnummer landet im mandanteneigenen Artikelstamm-Register, das spätere WEA- und VA-Exporte mit unbekannten SKUs sofort anhält, bevor der SFTP-Server des Logistikpartners eine fehlerhafte Datei ablehnt.
2. Wareneingangsavis (WEA) aus der Bestellung und Einlagerungsmeldung (ELM)
Sobald dein Einkauf eine Lieferantenbestellung in weclapp bestätigt, erzeugt TradeHub das elektronische Wareneingangsavis (WEA) mit Bestellnummer, Lieferantenanschrift, geplantem Anlieferdatum und allen Bestellpositionen. Liegt der geplante Liefertermin weniger als zwei Werktage in der Zukunft, protokolliert das System automatisch einen Vorlaufzeit-Hinweis, weil viele Kontraktlogistik-Betriebe laut Service-Level-Agreement mindestens 48 Stunden Vorankündigung für die Rampenplanung fordern.
Trifft die Ware im Lager ein, scannt das Hallenteam Artikel, Mengen, Chargen und Verfallsdaten und legt eine Einlagerungsmeldung (ELM) im SFTP-Ausgang ab – häufig gebündelt mit mehreren Avis-Blöcken in einer einzigen XML-Datei. TradeHub verarbeitet jeden Block einzeln, löst die zugehörige weclapp-Bestellung auf, passt die Wareneingangspositionen exakt an Teil- oder Überlieferungen sowie Chargensplits an (sodass zwei Teilchargen, die zusammen die Bestellmenge ergeben, keinen falschen Fehlbestand melden), filtert unplausible Platzhalter-Verfallsdaten heraus, die identisch mit dem Buchungstag sind, und bucht den Wareneingang bis in den Status Eingelagert durch. Trifft eine ELM-Datei nach einer Zeitüberschreitung erneut ein, erkennt eine dreistufige Idempotenzprüfung anhand bereits vereinnahmter Bestellmengen und vorhandener Wareneingangsbelege sofort, dass die Ware schon im Bestand liegt.
3. Versandauftrag (VA) aus der Lieferung und Packrückmeldung (VRV) vor der Rechnung
Für den Warenausgang ist in unserer Architektur bewusst die weclapp-Lieferung (und nicht der rohe Verkaufsauftrag) die führende Quelle. Dadurch bleiben Teillieferungen, Auftrags-Splits und Liefersperren sauber in weclapp steuerbar, während reine Dienstleistungs- oder Versandkostenzeilen automatisch ausgeblendet und Komponenten von Verkaufsstücklisten korrekt ihrer Hauptposition zugeordnet werden. Gleichzeitig übernimmt der Codec praxisrelevante Frachtführer-Details wie den wortgenauen Umbruch langer Firmennamen nach 35 Zeichen und die Übergabe einer Kontaktperson samt Telefonnummer für internationale Paket- und Speditionszustellungen.
Hat das 3PL-WMS kommissioniert und verpackt, liefert die Versandrückmeldung (VRV) je Packstück die Sendungsnummer, das Versandgewicht, den Frachtführer sowie alle gepickten Mengen, Chargen, Mindesthaltbarkeitsdaten und Seriennummern zurück. TradeHub validiert zuerst rein lesend alle Positionen und Bestände, fängt in weclapp zwischenzeitlich stornierte Lieferungen kontrolliert mit Belegkommentar ab, korrigiert bei Teilversand die Liefermengen, führt die Lieferung sauber über den Lieferschein-Status, schreibt Entnahmen (Picks) sowie die Ausgangs-Sendungsnummer zurück und setzt erst ganz am Schluss den Status Versendet – genau dieser Statuswechsel stößt in weclapp deine automatische Rechnungsstellung und die Marktplatz-Rückmeldung an (die Chargen- und Seriennummern-Details vertieft 3PL-Lager mit Chargen, MHD und Seriennummern in weclapp).
4. Laufende Bestandsbewegungen (BEW) und täglicher Bestands-Snapshot (BML)
Im Lageralltag bewegt sich Bestand nicht nur durch Einkauf und Verkauf: Eine Palette wird beim Rangieren beschädigt, eine Retoure wird vom Sperrlager in den freien Bestand umgebucht, oder die Qualitätssicherung korrigiert eine falsch abgetippte Chargennummer. Solche Ereignisse überträgt das 3PL-Lager untertags per BEW-Datei in fünf klar getrennten Bewegungsarten (Lagerplatz-/Sperrlager-Umbuchung, Chargenänderung, MHD-Änderung, Bestandszugang und Bestandsabgang) inklusive fachlichem Grund wie Verschrottung, Defekt oder Inventur.
Als doppeltes Sicherheitsnetz gleicht die Bestandsmeldeliste (BML) regelmäßig den gesamten physischen Bestand des 3PL-Lagers (Summe aus freiem Bestand, Sperrbestand und reserviertem Bestand, ohne unverbindlichen Vormerkbestand) je Artikel und Charge gegen den weclapp-Lagerbestand ab, bucht echte Differenzen mit aktuellem Bewertungspreis aus deiner primären Bezugsquelle nach und schickt deinem Team einen übersichtlichen HTML-Abweichungsbericht per E-Mail (warum ein naives Überschreiben per Nacht-Skript dagegen deine Buchhaltung ruiniert, liest du in Bestandsabgleich zwischen Fulfiller und weclapp).
Fazit: Jede der vier Prozessstufen fängt die typischen Praxisfehler klassischer SFTP-Schnittstellen – fehlende EANs, Chargensplits, Teilmengen, Stornos und Bewertungsbrüche – automatisch ab, bevor inkonsistente Daten in weclapp entstehen.
Wie sind SFTP-Ordner, SSH-Authentifizierung und Rohdaten-Archiv technisch abgesichert?
Wenn Unternehmensdaten im Minutentakt über Dateiserver laufen, entscheiden saubere Transport- und Ordnerregeln über Stabilität und Informationssicherheit. Der SFTP-Connector von wals.pro TradeHub folgt dafür vier verbindlichen Betriebsregeln:
- SSH-Key-Authentifizierung und Secret Manager: Die Anmeldung am SFTP-Server deines Logistikpartners erfolgt vorrangig über asymmetrische SSH-Schlüsselpaare (RSA, ED25519 oder ECDSA, optional passwortgeschützt; Passwort-Login nur als Rückfall für Altsysteme). Alle Schlüssel liegen mandantenisoliert im Google Secret Manager und stehen niemals im Quellcode oder in Konfigurationstabellen; ein Verbindungs-Pool hält den SFTP-Kanal während eines Poller-Laufs effizient offen und fängt kurze Netzwerkunterbrechungen mit einem dreistufigen Sofort-Retry (2, 4 und 8 Sekunden) ab.
- Klare Verzeichnisstruktur (Outbox, Inbox, Archive und Fehler-Isolation): Ausgehende Belege (Outbox) und eingehende Rückmeldungen (Inbox) liegen in strikt getrennten Verzeichnissen – wahlweise als Sammelordner oder sauber nach Dokumenttyp unterteilt in eigene Unterordner für PRICAT, WEA und VA im Ausgang sowie ELM, VRV, BEW und BML im Eingang. Sobald eine Eingangsdatei erfolgreich im Dokumenten-Ledger registriert ist, verschiebt der Poller sie automatisch in eine datierte Archivstruktur nach Jahr und Monat, sodass das Eingangsverzeichnis schlank und schnell bleibt, während fehlerhafte Inhalte im Ledger samt Fehlerklasse und weclapp-Belegkommentar isoliert werden.
- Atomares Datei-Schreiben per temporärer Zwischendatei (.tmp zu Rename): Schreibt ein Sender eine große XML-Datei direkt unter ihrem Endnamen in den SFTP-Ordner, während der Poller der Gegenseite im selben Moment zugreift, liest das Zielsystem ein abgeschnittenes XML-Fragment ein und bricht mit einem Parserfehler ab. TradeHub lädt jede ausgehende Datei deshalb zwingend zuerst unter einem temporären Schatten-Namen hoch und benennt sie erst nach vollständigem Byte-Transfer atomar auf dem Server in die endgültige XML-Datei um.
- Transaktionaler Duplikatschutz und sieben Jahre EU-Rohdatenarchiv: Jede eingehende Datei erhält beim Abruf einen SHA-256-Fingerabdruck, der transaktional gegen den Idempotenz-Speicher geprüft wird. Gleichzeitig legt TradeHub jede unveränderte Original-XML-Datei sowie die zugehörigen ERP-Antworten im europäischen Cloud-Speicher in Frankfurt (Region europe-west3) mit sieben Jahren technischer Rohdaten-Aufbewahrung ab.
Rechtlicher Hinweis zur Aufbewahrung: Die siebenjährige Rohdaten-Speicherung in TradeHub dokumentiert den technischen Schnittstellenverkehr für Betrieb und Nachvollziehbarkeit gegenüber deinem Logistikpartner. Deine handels- und steuerrechtlichen Aufbewahrungspflichten für Buchungsbelege, Inventare und Handelsbücher – in Deutschland acht beziehungsweise zehn Jahre nach § 147 Abs. 1 und Abs. 3 AO in Verbindung mit den GoBD, in Österreich sieben Jahre nach § 132 Abs. 1 BAO – erfüllst du über dein führendes ERP- und Archivsystem gemäß deiner mit der Steuerkanzlei abgestimmten Verfahrensdokumentation. Das ersetzt keine Steuerberatung. Das ersetzt keine Rechtsberatung.
Fazit: Mit SSH-Schlüsseln aus dem Secret Manager, atomarem .tmp-Rename, datierten Archivordnern und siebenjährigem Rohdaten-Speicher in Frankfurt läuft der SFTP-Austausch auch unter Hochlast wartungsarm und revisionsfest.
Wie läuft das Onboarding einer SFTP-Kontraktlogistik in vier Phasen ab?
Damit beim Lagerumzug oder bei der Aufschaltung eines neuen Logistikstandorts am ersten Versandtag keine Pakete liegen bleiben, setzen wir SFTP-Anbindungen auf wals.pro TradeHub in vier strukturierten Etappen um:
- Schnittstellen-Abgleich und Stammdaten-Check: Wir prüfen das XML- oder CSV-Schnittstellenhandbuch deines Kontraktlogistik-Partners gegen unser kanonisches 3PL-Modell, klären Partner- und Lagernummern, Mengeneinheiten, Versandarten-Codes (zum Beispiel DHL Paket, DPD, GLS oder Stückgut-Spedition) sowie Nummernkreis-Präfixe und prüfen deine weclapp-Artikel auf lückenlose EANs, Maße, Gewichte und Chargen-Einstellungen.
- SSH-Schlüsseltausch, Testverzeichnis und PRICAT-Erstabzug: Nach Hinterlegung der SFTP-Zugangsdaten im Secret Manager testen wir Verbindung und Verzeichnisrechte gegen das Testsystem des Logistikpartners und übergeben den ersten vollständigen PRICAT-Artikelstamm zur Prüfung im WMS.
- End-to-End-Belegtest im geklonten weclapp-Testmandanten: Vor jeder Live-Schaltung durchlaufen wir alle sechs Dokumenttypen mit echten Testfällen auf einem weclapp-Testsystem: regulärer Wareneingang, Unterlieferung mit zwei Chargen, Einzellieferung, Teilversand, stornierte Lieferung, Sperrlager-Umbuchung und BML-Snapshot.
- Stichtags-Cutover mit initialem Bestandsabgleich: Nach Einlagerung der physischen Ware im 3PL-Lager gleichen wir den Startbestand über einen initialen BML-Lauf sauber gegen das neue weclapp-Lager ab, schalten die produktiven SFTP-Poller scharf und überwachen die ersten Versandwellen engmaschig im Dokumenten-Ledger.
Fazit: Ein sauberer Durchlauf aller sechs Belegtypen inklusive Teilmengen- und Storno-Szenarien im Testmandanten spart dir wochenlange Nacharbeiten im Live-Betrieb.
Wann passt das nicht
- Dein E-Commerce-Fulfiller stellt bereits eine moderne Standard-REST-API bereit. Bietet das WMS deines Partners dokumentierte JSON-Endpunkte und Webhooks an, binden wir ihn über unseren REST- und Webhook-Connector auf TradeHub direkter und mit geringerer Latenz an als über SFTP-Batchdateien (Vergleich der drei Integrationswege).
- Deine Handelspartner fordern zertifiziertes UN/EDIFACT über AS2 samt Paletten-SSCC. Für Zentrallager des Lebensmitteleinzelhandels, Drogerie- oder Baumarktketten, die normierte EANCOM-Nachrichten (ORDERS, DESADV, INVOIC) über AS2 voraussetzen, nutzen wir den EDIFACT-Weg statt bilateraler SFTP-XML-Schemata (EDI-Anbindung an weclapp).
- Du brauchst synchrone Echtzeit-Rückmeldungen im Sekundenbruchteil am eigenen Packtisch. SFTP-Polling arbeitet bauartbedingt in kurzen Intervallen von typischerweise fünf bis fünfzehn Minuten; für das eigene Lager mit Handscanner ist Fulfillment 4 weclapp der passende Weg.
- Deine Artikelstammdaten in weclapp besitzen weder eindeutige EANs noch gepflegte Gewichte. Klassische Kontraktlogistik-Betriebe weisen Stammdaten ohne Barcode und Geodaten konsequent ab – die Datenpflege in weclapp muss daher vor dem ersten PRICAT-Lauf abgeschlossen sein.
- Du nutzt weclapp ERP Starter oder ERP Dienstleistung ohne Lagerverwaltung. Für Bestandsartikel, Wareneingänge, Lieferungen und Chargen ist das Paket ERP Handel (oder Enterprise) zwingende Voraussetzung.
Fazit: Wo immer eine erprobte Kontraktlogistik oder Spedition auf SFTP und XML setzt und deine weclapp-Stammdaten sauber gepflegt sind, liefert der Sechs-Beleg-Blueprint eine langfristig stabile Produktionsstrecke.
Quellen und Grenzen
Stand: 19. November 2026.
- weclapp Dokumentation & API-Spezifikation: weclapp OpenAPI v2 (Entitäten article, purchaseOrder, incomingGoods, shipment, warehouseStock und warehouseStockMovement), weclapp Preise & Pakete, GoBD-Hinweise von weclapp sowie Lagerbewegungen in weclapp durchführen, alle abgerufen am 19. November 2026.
- Kryptografische Transport- und Sicherheitsstandards: IETF RFC 4251 (The Secure Shell Protocol Architecture) sowie BSI IT-Grundschutz, beide abgerufen am 19. November 2026.
- Handels- und steuerrechtliche Aufbewahrungsvorschriften (DE & AT): § 147 Abgabenordnung (AO), BMF – Grundsätze zur ordnungsmäßigen Führung und Aufbewahrung von Büchern, Aufzeichnungen und Unterlagen in elektronischer Form (GoBD, Stand 11. März 2024) sowie § 132 Bundesabgabenordnung (BAO – Österreich), alle abgerufen am 19. November 2026.
- Plattform-Architektur wals.pro TradeHub: interne technische Spezifikation des SFTP-Connectors, des Sechs-Beleg-XML-Codecs (PRICAT, WEA, ELM, VA, VRV, BEW und BML), des transaktionalen Idempotenz-Speichers und der 7-jährigen Rohdaten-Aufbewahrung in Frankfurt (Stand: 19. November 2026).
Grenzen: XML-Feldnamen, Verzeichnisstrukturen, Polling-Intervalle und unterstützte Bewegungsarten variieren je nach eingesetztem Lagerverwaltungssystem deines Kontraktlogistik-Partners und werden im Onboarding gegen dessen Schnittstellenhandbuch gemappt. Die Hinweise zu Aufbewahrungsfristen nach AO, GoBD und BAO ersetzen keine steuerliche oder rechtliche Prüfung deiner individuellen Verfahrensdokumentation. Das ersetzt keine Steuerberatung. Das ersetzt keine Rechtsberatung.
Häufige Fragen
Was bedeuten die Kürzel PRICAT, WEA, ELM, VA, VRV, BEW und BML in der Kontraktlogistik?
Die Kürzel bezeichnen den geschlossenen Belegkreislauf zwischen Warenwirtschaft und externem Lagerverwaltungssystem: PRICAT überträgt Artikelstammdaten samt EAN, Maßen und Gewichten, WEA kündigt eine erwartete Lieferantenanlieferung als Wareneingangsavis an und ELM bestätigt die tatsächliche Einlagerung. Im Warenausgang übergibt VA den Versandauftrag aus deiner weclapp-Lieferung, VRV meldet Trackingnummern, Mengen und gepickte Chargen zurück, während BEW untertägige Bestandsbewegungen wie Bruch oder Sperrlager-Umbuchungen und BML den gesamten Stichtagsbestand zur Differenzkontrolle übermitteln.
Warum nutzen viele etablierte Speditionen und Kontraktlogistik-Betriebe weiterhin SFTP und XML statt einer REST-API?
Dateibasierte SFTP-Warteschlangen entkoppeln die physische Hallenlogistik zuverlässig von Wartungsfenstern, Internet-Schwankungen oder Rate-Limits externer Kundensysteme, sodass Kommissionierung und Verladung im Schichtbetrieb unterbrechungsfrei weiterlaufen. Über wals.pro TradeHub kombinierst du diese bewährte Robustheit auf Lagerseite mit modernen API-Aufrufen, automatischem Retry und einem übersichtlichen Dokumenten-Ledger auf deiner weclapp-Seite.
Wie verhindert wals.pro TradeHub, dass halb hochgeladene XML-Dateien oder Duplikate verarbeitet werden?
Beim Schreiben auf den SFTP-Server lädt TradeHub jede ausgehende XML-Datei zuerst vollständig unter einer temporären Dateiendung (.tmp) hoch und benennt sie erst nach abgeschlossenem Transfer atomar in den Zielnamen um, sodass der Poller des Logistikpartners niemals unfertige Dateien sieht. Umgekehrt berechnet TradeHub bei jeder abgeholten Rückmeldedatei sofort die SHA-256-Prüfsumme, reserviert sie transaktional im Idempotenz-Speicher und verschiebt verarbeitete Dateien in datierte Monats-Archivordner.
Warum werden Versandaufträge (VA) aus der weclapp-Lieferung statt direkt aus dem Verkaufsauftrag erzeugt?
Die weclapp-Lieferung bildet die konkrete logistische Versandeinheit ab, unterstützt gesteuerte Teillieferungen, trennt verschiedene Auslieferungslager sauber voneinander und erlaubt das Herausfiltern nicht lagerfähiger Dienstleistungspositionen vor der Übergabe an das WMS. Erst wenn die Versandrückmeldung (VRV) die tatsächlich verpackten Mengen, Chargen und die Sendungsnummer in genau diese Lieferung zurückgeschrieben und sie auf Versendet gesetzt hat, stößt weclapp die nachgelagerte Rechnungsstellung an.
Wie gehen WEA und ELM mit Unterlieferungen, Überlieferungen oder mehreren Chargen je Bestellposition um?
Meldet das Kontraktlogistik-Lager in der ELM-Datei eine geringere oder höhere Stückzahl als bestellt oder teilt es eine angelieferte Position auf mehrere Herstellerchargen mit unterschiedlichen Verfallsdaten auf, formt TradeHub die weclapp-Wareneingangspositionen und Buchungszeilen passend zur real vereinnahmten Lieferung um. Echte Mengenabweichungen zur Bestellung werden strukturiert im Beleg-Ergebnis dokumentiert, während reine Chargensplits mit passender Gesamtsumme fehlerfrei ohne falschen Fehlbestandsalarm ins Lager gebucht werden.
Wie lange bewahrt wals.pro TradeHub die ausgetauschten SFTP-Rohdateien auf?
Jede ein- und ausgehende Original-XML-Datei wird unverändert im europäischen Cloud-Speicher in der Region Frankfurt (europe-west3) für sieben Jahre archiviert, ergänzt um drei Jahre Aufbewahrung für die technischen ERP-Antwortprotokolle. Wie du diese technischen Übertragungsprotokolle gemeinsam mit deinen weclapp-Buchungsbelegen gemäß AO, GoBD beziehungsweise österreichischer BAO in deine Verfahrensdokumentation aufnimmst, legst du mit deiner Steuerberatung fest. Das ersetzt keine Steuerberatung.
Weiterlesen
- Fulfillment-Dienstleister (3PL) an weclapp anbinden: Vergleich von REST, SFTP/XML und EDIFACT
- 3PL-Lager mit Chargen, MHD und Seriennummern an weclapp anbinden
- Bestandsabgleich zwischen Fulfillment-Dienstleister und weclapp: BEW und BML im Zusammenspiel
- EDI-Anbindung an weclapp: ORDERS, DESADV, NVE/SSCC und INVOIC für Handelsketten
- Fulfiller-Anbindung an weclapp per REST-API: Sieben technische Berührungspunkte