Posted by Markus Wals

3PL-Lager mit Chargen, MHD & Seriennummern an weclapp anbinden: Wie ELM und VRV Rückrufe und Garantien absichern

3PL Chargennummern FEFO Fulfillment Kontraktlogistik MHD Seriennummern TradeHub weclapp weclapp API

KI-generierte technische Illustration: Glatte Behälter und Elektronikmodule passieren eine rote Prüfbrücke vor der Freigabe in das Belegfach. Überschrift: Chargen & MHD im 3PL-Lager führen

Kurz gesagt: Im externen 3PL-Lager scheitert die Chargen-, MHD- und Seriennummern-Rückverfolgbarkeit fast immer am Medienbruch zwischen der Kommissionierung am Regal und der weclapp-Lieferung (shipment). Über wals.pro TradeHub bucht die Einlagerungsmeldung (ELM) reale Herstellerchargen und Verfallsdaten in Epoch-Millisekunden über incomingBookings bis zum Status INCOMING_MOVED_INTO_STORE ein, der Versandauftrag (VA) übergibt bewusst nur Artikel und Menge ohne Vorab-Chargenreservierung für echtes FEFO im WMS, und erst die Versandrückmeldung (VRV) schreibt die tatsächlich gepickten Chargen und Seriennummern per updatePicks sowie packageTrackingNumber zurück, bevor Status SHIPPED die Rechnung auslöst.

Marken aus Lebensmittelhandel, Nahrungsergänzung, Heimtierfutter, Kosmetik, Medizintechnik und Unterhaltungselektronik lagern ihre Logistik ab einer gewissen Sendungsmenge regelmäßig an spezialisierte Fulfillment-Dienstleister (3PL) aus. Physisch ist das externe Lager meist hervorragend aufgestellt: Handscanner prüfen Barcodes an der Rampe, das Lagerverwaltungssystem (WMS) steuert klimatisiertes FEFO am Regal, und an der Packstation wird jede Seriennummer erfasst.

Der kritische Bruch entsteht eine Sekunde später auf dem Rückweg in dein ERP-System: Steht auf deinem weclapp-Lieferschein, deiner Ausgangsrechnung oder deinem elektronischen Handelsavis (DESADV) am Ende eine andere Charge als die, die das 3PL-Lager tatsächlich ins Paket gelegt hat, ist deine gesetzliche Rückrufkette wertlos – und im Garantiefall lässt sich kein zurückgesendetes Elektronikgerät eindeutig der ursprünglichen Lieferung zuordnen.

Während unser Leitfaden Chargenpflicht und MHD in weclapp nachträglich aktivieren zeigt, wie du bestehende Bestandsartikel per Stichtags-Schnitt oder ALT--Rotation überhaupt erst auf batchNumberRequired: true umstellst, führt dich dieser Artikel tief in den laufenden 3PL-Produktionsbetrieb auf wals.pro TradeHub: vom Wareneingang über die FEFO-Entnahme ohne Reservierungsblockade bis zum Abfangen fehlender Chargenbestände und Seriennummern-Drifts.

Vierstufiger Chargen-, MHD- und Seriennummern-Fluss zwischen weclapp und 3PL-Lager über wals.pro TradeHub: (1) ELM bucht Wareneingang mit batchNumber und expirationDate in Epoch-Millisekunden bis INCOMING_MOVED_INTO_STORE, (2) VA übergibt nur Artikel und Menge ohne Vorab-Reservierung für echtes FEFO am Regal, (3) VRV schreibt gepickte Chargen per updatePicks und Trackingnummer vor SHIPPED, (4) serialIntegrity prüft Bestände vor Fehlern.

Das Wichtigste in Kürze

  • Rückruffähigkeit verlangt Deckungsgleichheit zwischen Paket und ERP-Beleg. Ob Lebensmittel, Tiernahrung, Kosmetik oder Elektronik: Nur wenn die vom 3PL-WMS physisch kommissionierte Charge oder Seriennummer vor Status SHIPPED in die weclapp-Lieferung fließt, stimmen Chargenverwendungsnachweis, Lieferschein, Rechnung und DESADV.
  • ELM legt Chargen beim Wareneingang samt Bewertungspreis in weclapp an. Da /batchNumber in der weclapp REST API v2 keinen POST-Endpunkt besitzt, entstehen Chargen und expirationDate (in Unix-Millisekunden) direkt beim Buchen der incomingBookings inklusive sauberer Umformung von Teilmengen und Chargensplits.
  • VA übergibt Artikel und Menge – FEFO entscheidet das 3PL-WMS am Regal. Automatische Vorab-Entnahmen in weclapp bleiben für das 3PL-Lager deaktiviert, damit keine am Schreibtisch reservierte Charge A den realen Pick von Charge B im Außenlager blockiert.
  • VRV folgt einer strikten Status- und Schreibreihenfolge in weclapp. Weil weclapp einen direkten Sprung von NEW auf SHIPPED ablehnt, hebt TradeHub Lieferungen geordnet auf DELIVERY_NOTE_PRINTED, bucht updatePicks, setzt packageTrackingNumber (Singular) und schließt erst danach auf SHIPPED ab.
  • Fehlende Chargenbestände dürfen niemals still umgebogen werden. Meldet der 3PL eine Charge oder Seriennummer, die in weclapp (noch) keinen freien Bestand aufweist, stoppt die Vorab-Prüfung vor der ersten Schreiboperation kontrolliert mit Belegkommentar, statt heimlich eine fremde Charge abzubuchen.

Warum scheitert die Chargen-, MHD- und Seriennummern-Hoheit im 3PL-Betrieb fast immer am Medienbruch?

Rechtlich und kaufmännisch duldet die Rückverfolgbarkeit keinen Interpretationsspielraum. Lebensmittel- und Futtermittelunternehmen müssen nach Art. 18 der Verordnung (EG) Nr. 178/2002 über alle Vertriebsstufen hinweg feststellen können, von wem sie ein Erzeugnis bezogen und an welche gewerblichen Abnehmer:innen sie welche Partie geliefert haben (ergänzt um § 1 der Los-Kennzeichnungs-Verordnung, die Abgrenzung zum strengen Verbrauchsdatum nach Art. 24 der Verordnung (EU) Nr. 1169/2011 sowie bei Heimtierfutter Art. 15 lit. d und Art. 17 Abs. 1 lit. d der Verordnung (EG) Nr. 767/2009).

Im Beauty-Segment fordert Art. 19 Abs. 1 lit. e der Kosmetik-Verordnung (EG) Nr. 1223/2009 die Chargennummer, in der Medizintechnik Art. 27 der Verordnung (EU) 2017/745 die UDI-Kennzeichnung, und im Elektronik- oder Re-Commerce-Handel entscheidet die Seriennummer beziehungsweise IMEI über Garantieanspruch, Betrugsabwehr und Marktplatz-Freigabe. Welche Pflichten für deine konkreten Produkte gelten, klärst du vorab rechtlich ab. Das ersetzt keine Rechtsberatung.

Solange du im eigenen Haus mit Handscanner und Chargen- und Seriennummern-Scan 4 weclapp arbeitest, prüft der Packtisch live gegen denselben weclapp-Datenbestand. Sobald jedoch ein externer 3PL-Dienstleister per REST-API oder SFTP und XML dazwischensteht, krachen eigengebaute Anbindungen regelmäßig an drei Stellen zusammen:

  1. Konflikt durch Vorab-Reservierung in weclapp: Ist in weclapp die automatische Entnahme aktiviert, reserviert weclapp beim Erzeugen der Lieferung sofort eine bestimmte Charge (etwa CH-2026-04). Im 3PL-Lager liegt diese Palette aber im Nachschub-Hochregal, während am Kommissionierplatz eine andere verkehrsfähige Charge (CH-2026-05) mit ausreichendem MHD griffbereit steht und gescannt wird. Beim Rückmelden blockiert die fremde Reservierung entweder den API-Schreibvorgang oder es bleibt die falsche Charge auf dem Lieferschein stehen.
  2. Versandabschluss vor der Pick-Rückmeldung: Viele einfache Skripte empfangen vom Fulfiller lediglich die Paket-Trackingnummer und setzen die weclapp-Lieferung direkt auf status: "SHIPPED", ohne zuvor die Entnahmen (picks) zu übertragen. Ist die Lieferung in weclapp als versendet gebucht, lässt sich nachträglich keine Charge mehr zuordnen – bei fehlenden Entnahmen schlägt der Statuswechsel bei Chargenartikeln entweder mit einem Validierungsfehler fehl oder bucht bei ungeschützten Einstellungen am realen Regal-Pick vorbei.
  3. Gelöschte Positionen und verschluckte Sendungsnummern durch API-Fallstricke: In der weclapp REST API v2 ersetzt ein PUT /shipment/id/{id}?ignoreMissingProperties=true untergeordnete Listen wie shipmentItems vollständig, ignoriert ein fälschlich gesendetes Plural-Feld trackingNumbers kommentarlos mit HTTP 200 und schreibt bei Verwechslung von packageTrackingNumber mit packageReturnTrackingNumber jede Ausgangs-Sendungsnummer unsichtbar in das Retourenfeld.

Fazit: Im 3PL-Betrieb entsteht echte Rückverfolgbarkeit erst dann, wenn Wareneingang, aufhebungsfreie Versandübergabe und geordnete Pick-Rückmeldung exakt auf die Zustandsautomaten der weclapp-API abgestimmt sind.

Wie bucht die Einlagerungsmeldung (ELM) Chargen, MHD und Bewertungspreis fehlerfrei in weclapp ein?

Jede saubere Chargen- und Seriennummern-Kette beginnt an der Wareneingangsrampe deines Logistikpartners. In weclapp (ab Paket ERP Handel) legst du die Lieferantenbestellung (purchaseOrder) an und gibst sie auf CONFIRMED frei. Daraus erzeugt wals.pro TradeHub das ausgehende Wareneingangsavis (WEA) mit Bestellnummer, Lieferantenadresse, geplantem Liefertermin und den erwarteten Stückzahlen je SKU – geschützt durch unseren ArticleMaster-Wächter, der den Export sofort stoppt, falls ein neuer Artikel dem WMS noch nicht per PRICAT gemeldet wurde.

Hat dein 3PL die Anlieferung entladen und gescannt, sendet das WMS die Einlagerungsmeldung (ELM) zurück – in der Praxis oft mit mehreren <AVIS>-Blöcken in einer einzigen SFTP-Datei und aufgeteilt auf mehrere Herstellerchargen je Bestellposition. Da die Entität /batchNumber in der weclapp OpenAPI v2 ausschließlich GET und PUT anbietet, legt unser weclapp-Adapter neue Chargen direkt innerhalb der vierstufigen Wareneingangsbuchung an:

  1. Wareneingangsbeleg zur Bestellung erzeugen: Über POST /purchaseOrder/id/{poId}/createIncomingGoods entsteht der verknüpfte incomingGoods-Beleg samt vorbefüllter Positionen (incomingGoodsItems) und den Einkaufspreisen aus der Bestellung.
  2. Positionen auf reale Liefermengen und Überlieferungen umformen: Weicht die gezählte Menge an der 3PL-Rampe von der Bestellung ab, formt TradeHub incomingGoodsItems per PUT /incomingGoods/id/{igId} passend um: Nicht mitgelieferte Bestellpositionen werden aus diesem Teil-Wareneingang entfernt (sodass die Restmenge auf der Bestellung offen bleibt), Unterlieferungen auf die reale Ist-Menge gesetzt und echte Überlieferungen sauber abgebildet. Wichtig: Liefert der Hersteller 500 Stück verteilt auf 300 Stück Charge A und 200 Stück Charge B, summiert TradeHub beide Zeilen je purchaseOrderItemId auf 500 Stück zusammen – dadurch laufen Chargensplits sauber durch, ohne einen falschen Unterlieferungs-Alarm auszulösen.
  3. Chargen, MHD in Epoch-Millisekunden und Seriennummern buchen: Nach einem Lesevorlauf über GET /incomingGoods/id/{igId}/incomingBookings (der die serverseitig angelegten Buchungsgerüste samt incomingGoodsItemId und Bewertungspreis liefert) sendet der Adapter POST /incomingGoods/id/{igId}/updateIncomingBookings mit dem vollständigen Array incomingBookings. Für jede Teilcharge entsteht eine eigene Buchungszeile mit incomingGoodsItemId, quantity, storagePlaceId (aufgelöst auf den eindeutigen Nicht-System-Lagerplatz deines 3PL-Lagers, unter Ausschluss interner weclapp-Systemplätze wie Transit oder Loading equipment), batchNumber, expirationDate als Unix-Zeitstempel in Millisekunden sowie bei seriennummernpflichtigen Artikeln dem Array serialNumbers (beachte: bei Seriennummernartikeln leitet weclapp die gebuchte Menge aus der Länge von serialNumbers ab).
  4. Plausibilitätsfilter für Pseudo-MHDs und Einlagerung: Manche Lagerverwaltungssysteme füllen leere MHD-Pflichtfelder an der Rampe hilfsweise mit dem tagesaktuellen Buchungsdatum. TradeHub vergleicht deshalb in der Zeitzone Europe/Berlin das gemeldete MHD mit dem Buchungszeitstempel der ELM: Sind beide Kalendertage identisch, verwirft der Flow das unplausible Tagesdatum kontrolliert und protokolliert den Hinweis im Abweichungsfeld, statt deine frische Charge in weclapp sofort als heute abgelaufen zu sperren. Anschließend bucht PUT /incomingGoods/id/{igId} mit status: "INCOMING_MOVED_INTO_STORE" und aktueller version die Ware physisch ins Lager (ein separater updateStatus-Aktionsendpunkt existiert auf incomingGoods nicht).

Auch der Wiederholungsfall nach einem Netzwerk-Timeout ist wasserdicht abgesichert: Meldet createIncomingGoods beim zweiten Versuch, dass die Bestellung keine offenen Positionen mehr enthält, prüft TradeHub automatisch die bereits gebuchten receivedQuantity-Werte auf der Bestellung sowie vorhandene incomingGoods-Belege. Ist die Menge bereits auf INCOMING_MOVED_INTO_STORE, endet der Lauf idempotent als erfolgreich; hängt ein bereits angelegter Beleg noch vor der Einlagerung, vollendet TradeHub gezielt nur noch den Statuswechsel.

Fazit: Durch das Zusammenspiel aus Bestellbezug, Chargensplit-Aggregation, Epoch-Millisekunden-Prüfung und dreistufiger Idempotenz landen Charge, MHD und Einkaufs-Bewertungspreis ohne manuelle Nachbuchung im weclapp-Lager.

Warum übergibt der Versandauftrag (VA) nur Artikel und Menge – und wie schreibt VRV den realen FEFO-Pick vor Status SHIPPED zurück?

Im Warenausgang dreht sich die Systemhoheit um: Während dein Einkauf weiß, was er bestellt hat, weiß beim Versand erst der Scanner am 3PL-Regal, welche konkrete Dose, Flasche oder Elektronikbox tatsächlich im Versandkarton landet. Damit FEFO (First Expired, First Out) im externen Lager ohne Reibung funktioniert, treffen wir in weclapp und TradeHub zwei gezielte Voreinstellungen:

  • Keine Vorab-Chargenreservierung in weclapp: Für das 3PL-Lager stellst du automatische Entnahmen für Lieferungen in den globalen Lagereinstellungen auf Keine und erlaubst Lieferungen Mit fehlenden Entnahmen. Unser VA-Export liest versandbereite Lieferungen über list_shipments_to_export bewusst mit require_picks_complete=False aus, filtert reine Dienstleistungspositionen heraus (sodass nur lagerfähige STORABLE-Artikel an das WMS gehen) und übergibt dem 3PL Artikelnummer, EAN und Stückzahl.
  • Mindest-Restlaufzeit über PRICAT statt starrer Einzelcharge: Verlangen B2B-Handelskund:innen oder Marktplätze wie Fressnapf und zooplus eine garantierte Restlaufzeit bei Auslieferung, pflegst du die Mindest-Restlaufzeit in Tagen als Artikel-Zusatzfeld (mhdRestlaufzeit beziehungsweise shelfLifeDays) in weclapp. TradeHub überträgt diesen Wert im PRICAT-Stammsatz an das 3PL-WMS, sodass das Lagersystem zu kurz laufende Chargen am Regal automatisch überspringt.

Sobald das Paket im 3PL-Lager gepackt und belabelt ist, trifft die Versandrückmeldung (VRV) mit Sendungsnummern, Gewichten und den detaillierten PACKDETAILS (gepickte Menge, CHARGE, MHD und Seriennummern PP_SN je Kollo) in TradeHub ein. Unser VRV-Worker führt die Rückmeldung in sechs streng geordneten Schritten gegen die bestehende weclapp-Lieferung aus:

  1. Lesevorlauf und Status-Schutzweiche: TradeHub lädt die Lieferung über shipmentNumber-eq inklusive includeReferencedEntities=shipmentItems.articleId (da der Einzelabruf /shipment/id/{id} keine referenzierten Artikeldaten einbettet). Steht die Lieferung bereits auf SHIPPED, endet der Lauf sofort idempotent. Wurde die Lieferung in weclapp zwischenzeitlich auf CANCELLED gesetzt, wirft der Worker gezielt einen SkippedError, hinterlegt einen Warnkommentar direkt an der weclapp-Lieferung und informiert dein Team per E-Mail, statt endlos in die Wiederholungsschleife zu laufen.
  2. Vorab-Validierung aller Positionen, Chargen und Seriennummern vor der ersten Änderung: Bevor ein einziger Schreib-Request an weclapp rausgeht, dedupliziert TradeHub doppelt übermittelte TRACKINGPOSITION-Blöcke der XML-Datei, ordnet jede Packzeile ihrer shipmentItem zu und prüft gegen /warehouseStock, ob die gemeldeten Chargen und Seriennummern auf dem 3PL-Lagerplatz tatsächlich verfügbar sind. Schlägt eine Prüfung fehl, bleibt die weclapp-Lieferung völlig unberührt (kein halb umgebauter Beleg).
  3. Teilmengen-Anpassung mit id- und version-Stubs: Konnte das 3PL-Lager bei einem Engpass nur 8 statt 10 Stück versenden, passt TradeHub die Positionsmengen der Lieferung an (sofern manualQuantity dies erlaubt; bei Lieferungen jenseits von NEW wird der Status dafür kurz auf NEW zurückgenommen). Beim anschließenden PUT /shipment/id/{id}?ignoreMissingProperties=true übergibt der Adapter jede unveränderte Position zwingend als {"id": itemId, "version": version}-Stub im Array shipmentItems, damit weclapp keine unbeteiligten Lieferzeilen löscht (GET-Merge-PUT-Prinzip).
  4. Geordnete Status-Hebung auf DELIVERY_NOTE_PRINTED: weclapp lehnt in der API sowohl einen direkten Statussprung von NEW auf SHIPPED als auch manche Pick-Aktualisierungen im Rohstatus NEW ab. Steht die Lieferung auf NEW, hebt TradeHub sie deshalb vor dem Pick-Schreiben per versionsgesichertem PUT gezielt auf DELIVERY_NOTE_PRINTED.
  5. Chargen- und Seriennummern-Entnahme per updatePicks schreiben: Nun überträgt TradeHub alle kommissionierten Packzeilen über POST /shipment/id/{id}/updatePicks mit "updateShipQuantity": true sowie pro Pick-Zeile shipmentItemId, pickQuantity, storagePlaceId und bei chargenpflichtigen Artikeln (batchNumberRequired: true) der real gepickten batchNumber (plus serialNumbers bei Seriennummernpflicht) und verifiziert Seriennummern-Picks unmittelbar per Read-back über GET /shipment/id/{id}/picks.
  6. Ausgangs-Tracking in packageTrackingNumber setzen und SHIPPED buchen: Im vorletzten Schritt schreibt TradeHub die Sendungsnummer exakt in das Feld packageTrackingNumber (niemals in das ignorierte trackingNumbers und niemals in das Retourenfeld packageReturnTrackingNumber, weil nur packageTrackingNumber die Sendungsverfolgungs-Links und Marktplatz-Feeds in weclapp speist) und setzt die Lieferung schließlich auf status: "SHIPPED". Erst jetzt erzeugt dein weclapp-Workflow Ausgangsrechnung und gegebenenfalls das DESADV – mit hundertprozentig stimmigen Mengen, Chargen und Seriennummern.

Fazit: Wer Vorab-Validierung, Status-Hebung über DELIVERY_NOTE_PRINTED, updatePicks und packageTrackingNumber strikt vor den finalen Wechsel auf SHIPPED schaltet, erhält lückenlos rückruffähige Lieferscheine und Rechnungen.

Was passiert, wenn die vom 3PL gemeldete Charge oder Seriennummer in weclapp (noch) keinen Bestand hat?

Im echten Hallenbetrieb tritt früher oder später der härteste Grenzfall jeder 3PL-Integration auf: Das WMS sendet eine VRV-Versandrückmeldung mit gepickter Charge CH-2026-09, doch in weclapp weist /warehouseStock für genau diese Charge im 3PL-Lager null Stück aus. In der Praxis hat das fast immer eine von drei Ursachen:

  • Reihenfolge-Überholung (Race Condition am Hallenboden): Eine eilbedürftige Palette wurde im 3PL-Lager morgens direkt aus der Entladezone in einen wartenden Auftrag kommissioniert (Cross-Docking), und das WMS hat die VRV-Datei zehn Minuten vor der zugehörigen ELM-Einlagerungsmeldung auf den SFTP-Server gelegt.
  • Unangemeldete Chargen-Nachetikettierung im Lager: Das Lagerpersonal hat am Regal einen Zahlendreher oder ein Präfix an einer Herstellercharge korrigiert, ohne dass die zugehörige BEW-Bewegungsdatei (UMB-C) bereits verarbeitet wurde.
  • Seriennummern-Abweichung zwischen Bestands- und Versandebene: Bei hochvolumigen Seriennummernartikeln wurden beim Wareneingang oder bei einer Korrekturbuchung noch keine Einzel-Seriennummern vom Hersteller übermittelt oder sind bereits durch andere offene Liefer-Picks reserviert.

Genau hier entscheidet sich die Seriosität deiner Integrationsarchitektur. Ein gefährlicher „Quick-Fix“, den man in manchen Individualskripten sieht, bucht bei fehlendem Chargenbestand einfach irgendeine andere in weclapp vorhandene Charge ab oder legt im Hintergrund ungeprüft künstlichen Plus-Bestand ohne Einkaufsbezug an. Beides ist fatal: Im ersten Fall trifft ein späterer Produktrückruf die falschen Empfänger:innen, im zweiten Fall verdoppelt sich dein Lagerwert in der Finanzbuchhaltung, sobald eine Stunde später die reguläre ELM-Datei eintrifft.

wals.pro TradeHub löst diesen Konflikt stattdessen sauber und revisionsfest:

  1. Zeitliche Überholungen heilen sich selbst über den Stufen-Retry: Lehnt weclapp den Pick ab, weil die ELM-Datei wenige Minuten hinterherhängt, geht das VRV-Dokument im Firestore-Ledger zunächst in den Status retrying (exponentieller Backoff im 60-Sekunden-Scanner). Sobald der nächste Poller-Takt die ELM verarbeitet und Charge CH-2026-09 regulär eingebucht hat, läuft der nächste Retry des VRV-Dokuments ab Stufe erp_write automatisch grün durch.
  2. Echte Stammdaten- oder Bestandsfehler stoppen sichtbar vor jeder Teil-Änderung: Bleibt der Bestand auch nach den geplanten Versuchen ungedeckt, überführt TradeHub das Dokument in die Dead-Letter-Queue, hinterlegt einen präzisen Kommentar direkt an der betroffenen weclapp-Lieferung (inklusive Artikelnummer, gemeldeter Charge, benötigter und verfügbarer Menge) und benachrichtigt dein Operations-Team. Nach Klärung mit dem 3PL – etwa durch Einspielen der fehlenden BEW-Chargenumbuchung (UMB-C) oder den täglichen BML-Bestandsabgleich – stößt du das Dokument ohne Datenverlust erneut an.
  3. Zwei saubere Betriebsmodelle für Seriennummern plus proaktiver serialIntegrity-Wächter: Über den weclapp-ERP-Adapter lassen sich bereits im Wareneingang erfasste Seriennummern direkt in incomingBookings einbuchen und per updatePicks entnehmen. Im SFTP-Kontraktlogistik-Flow (VRV), in dem das 3PL-Lager die physischen Geräte-Seriennummern (PP_SN) erst beim Packen am Warenausgang scannt, greift ein bewährtes Hybrid-Muster: Beim Zugang hält weclapp eindeutig generierte Bestands-Platzhalter je Charge vor, beim VRV wählt der Flow für updatePicks konfliktfrei verfügbare Bestands-Seriennummern der Charge (abzüglich bestehender picks-Reservierungen) aus und speichert die real gescannten PP_SN-Nummern im selben SHIPPED-Request unverlierbar im Positions-Zusatzfeld shipment_item_serials für Lieferschein, Rechnung und Garantiesuche. Zusätzlich prüft unser geplanter serialIntegrity-Wächter laufend je (articleId, batchNumber), ob Lagermenge, verfügbare Seriennummern und offene Reservierungen exakt übereinstimmen, und schlägt Alarm, bevor die nächste VRV-Datei auf eine Lücke läuft.
Prozesspunkt TradeHub-Dokument weclapp-Endpunkt & Pflichtfelder Fehler- & Rückrufschutz
Stammdaten & Restlaufzeit PRICAT (ausgehend) GET /article mit batchNumberRequired, serialNumberRequired, Zusatzfeld mhdRestlaufzeit Fail-Closed-ArticleMaster sperrt WEA/VA für ungemeldete SKUs
Wareneingang zur Bestellung WEA → ELM (eingehend) createIncomingGoods → PUT /incomingGoods → updateIncomingBookings (batchNumber, expirationDate in ms) → INCOMING_MOVED_INTO_STORE Aggregiert Chargensplits je PO-Zeile, verwirft Buchungstag-Schein-MHDs, prüft Idempotenz
Versandübergabe ohne Fessel VA (ausgehend) GET /shipment (require_picks_complete=False, nur STORABLE-Zeilen) Keine Vorab-Chargenreservierung in weclapp; echtes FEFO am 3PL-Regal
Pack- & Chargenrückmeldung VRV (eingehend) Vorab-Check /warehouseStock → DELIVERY_NOTE_PRINTED → POST .../updatePicks → packageTrackingNumber → SHIPPED Kein stilles Umbiegen fehlender Chargen; id/version-Stubs schützen Lieferzeilen
Umbuchung & Frühwarnung BEW / BML + Wächter bookIncomingMovement (batchNumberExpirationDate, articleValuationPrice), bookOutgoingMovement, serialIntegrity Chargen-/MHD-Korrektur als Aus-/Einbuchung am selben Platz; Alarm vor Seriennummern-Lücke

Fazit: Kein stilles Umbiegen von Chargen, automatische Selbstheilung bei kurzen ELM-Verzögerungen und ein proaktiver serialIntegrity-Check halten Lagerrealität und weclapp-Beleg dauerhaft synchron.

Wann stößt die 3PL-Chargen- und Seriennummernführung an Grenzen?

Plane vor dem Projektstart mit deinem Logistikpartner vier reale Systemgrenzen fest ein:

  • Bestehende Artikel ohne aktiviertes Chargen- oder Seriennummern-Flag: Wurde ein Artikel in weclapp bereits in Angeboten, Aufträgen oder Lagerbewegungen verwendet, lassen sich batchNumberRequired und serialNumberRequired weder in der Oberfläche noch per normalem PUT /article nachträglich einschalten (unser Adapter entfernt beide Flags bei Updates bestehender Artikel gezielt, damit kein 400-Fehler entsteht). Stelle betroffene SKUs vor dem 3PL-Start geordnet nach dem Leitfaden zur nachträglichen Chargenaktivierung um.
  • Unveränderbarkeit einmal gebuchter Chargen- und MHD-Werte in weclapp: Hat ein Wareneingang eine Charge mit falschem Namen oder Verfallsdatum eingebucht, lässt sich der Chargensatz im Bestand nicht einfach frei überschreiben. TradeHub bildet Chargen- und MHD-Korrekturen (UMB-C und UMB-M) deshalb technisch sauber als Ausbuchung des alten Bestands plus sofortige Wiedereinbuchung mit neuer Charge beziehungsweise neuem MHD und Bewertungspreis am selben Lagerplatz ab – vorausgesetzt, die betroffene Menge ist nicht bereits durch offene Picks blockiert.
  • MHD versus gesetzliches Verbrauchsdatum in einem einzigen Datumsfeld: weclapp speichert auf der Charge ausschließlich expirationDate. Führst du neben MHD-Sortimenten auch sehr leicht verderbliche Erzeugnisse mit Verbrauchsdatum nach Art. 24 LMIV, kennzeichnest du die Datumsart über ein Artikel-Zusatzfeld und lässt abgelaufene Bestände im 3PL sofort per BEW in das Sperrlager buchen. Das ersetzt keine Rechtsberatung.
  • Lizenz-Voraussetzung in weclapp: Serien- und Chargennummern sowie bestandsführende Mehr-Lager-Prozesse stehen laut weclapp-Preisseite ausschließlich ab dem Paket ERP Handel (oder Enterprise) zur Verfügung.

Fazit: Kläre Artikel-Flags, Korrekturprozesse für Fehleneinlagerungen und Restlaufzeit-Regeln vor dem ersten produktiven Wareneingang im Testmandanten.

Quellen und Grenzen

Stand: 19. November 2026.

Grenzen dieses Artikels: Dieser Beitrag beschreibt die technische Prozess- und API-Architektur zwischen weclapp und externen 3PL-Lagerverwaltungssystemen und ersetzt weder eine Rechtsberatung zu branchenspezifischen Kennzeichnungs-, Rückruf- oder Produktsicherheitspflichten noch eine Steuerberatung zur Bestandsbewertung. Das ersetzt keine Rechtsberatung. Das ersetzt keine Steuerberatung.

Weiterlesen: Den strategischen Gesamtüberblick über alle drei Anbindungswege findest du auf Fulfillment-Dienstleister (3PL) an weclapp anbinden und im SFTP-Praxisleitfaden Kontraktlogistik per SFTP und XML an weclapp anbinden. Wie du laufende Bestandsdifferenzen ohne Zerstörung deiner Bewertungspreise auflöst, zeigt Bestandsabgleich zwischen Fulfiller und weclapp; für die Stammdaten-Grundlagen empfehlen wir Chargenpflicht und MHD nachträglich aktivieren, Chargenrückverfolgung im ERP und Seriennummern in weclapp.

Häufige Fragen

Warum darf weclapp bei einem externen 3PL-Lager keine Chargen im Versandauftrag vorab reservieren?

Ein externes Lagerverwaltungssystem steuert Laufwege, Nachschub und FEFO-Entnahme eigenständig direkt am physischen Regal. Reserviert weclapp bereits beim Anlegen der Lieferung am Schreibtisch eine bestimmte Charge, entsteht sofort ein Konflikt, wenn im 3PL-Lager eine andere verkehrsfähige Charge gescannt wird: Entweder blockiert die alte Reservierung die Rückmeldung oder auf Lieferschein und Rechnung steht die falsche Charge. Deshalb bleibt die automatische Entnahme für das 3PL-Lager in weclapp deaktiviert und erst die Versandrückmeldung (VRV) bucht die tatsächlich gegriffene Charge ein.

Wie legt die 3PL-Einlagerungsmeldung (ELM) neue Chargen und Mindesthaltbarkeitsdaten in weclapp an?

Da die Entität batchNumber in der weclapp REST API v2 keinen eigenen POST-Endpunkt zum Vorabanlegen besitzt, entstehen neue Chargen direkt beim Buchen des Wareneingangs. wals.pro TradeHub erzeugt aus der bestätigten Bestellung den Wareneingangsbeleg, passt die Positionen an Teilmengen oder Chargensplits an, übergibt Chargennummer, Verfallsdatum als Unix-Zeitstempel in Millisekunden und Lagerplatz über updateIncomingBookings und setzt den Beleg anschließend auf den Status INCOMING_MOVED_INTO_STORE.

In welcher Reihenfolge muss die Versandrückmeldung (VRV) eine weclapp-Lieferung aktualisieren?

Zuerst prüft TradeHub rein lesend alle Positionen sowie die Verfügbarkeit der gemeldeten Chargen und Seriennummern im weclapp-Bestand. Danach werden bei Teilversand gegebenenfalls die Liefermengen angepasst, Lieferungen aus dem Status NEW gezielt auf DELIVERY_NOTE_PRINTED gehoben (weil weclapp keinen direkten Sprung von NEW auf SHIPPED erlaubt), die gepickten Chargen per updatePicks eingetragen, die Sendungsnummer in das Einzelfeld packageTrackingNumber geschrieben und erst ganz am Schluss der Status SHIPPED gesetzt.

Was passiert, wenn das 3PL-Lager im Versand eine Charge meldet, die in weclapp noch keinen Bestand hat?

Eine seriöse Integration darf in diesem Fall niemals stillschweigend eine andere Charge abbuchen, weil dadurch jede Rückrufliste nach Art. 18 der Verordnung (EG) Nr. 178/2002 verfälscht würde. Liegt lediglich eine kurze zeitliche Überholung vor, weil die Einlagerungsmeldung (ELM) wenige Minuten nach der Versandrückmeldung eintrifft, löst der automatische Stufen-Retry in wals.pro TradeHub den Fall von selbst; bleibt die Charge unbekannt, stoppt der Vorgang ohne Teil-Änderung in der Fehler-Queue und hinterlegt automatisch einen klaren Prüfkommentar an der weclapp-Lieferung. Das ersetzt keine Rechtsberatung.

Wie lassen sich Seriennummern abbilden, wenn das 3PL-Lager sie erst am Packtisch statt beim Wareneingang scannt?

Über den weclapp-ERP-Adapter lassen sich im Wareneingang erfasste Seriennummern direkt in incomingBookings einbuchen und über updatePicks entnehmen. Scannt das 3PL-Lager die physischen Gerätenummern (PP_SN) im SFTP-Kontraktlogistik-Flow dagegen erst am Packtisch, wählt TradeHub für updatePicks konfliktfrei verfügbare Bestands-Seriennummern der jeweiligen Charge (abzüglich offener Reservierungen) aus, speichert die real gescannten 3PL-Seriennummern beim Versandabschluss im Positions-Zusatzfeld shipment_item_serials für Belegdruck und Garantiesuche und überwacht die Bestandsdeckung über den serialIntegrity-Wächter.

Wie stelle ich sicher, dass B2B-Handelskund:innen aus dem 3PL-Lager nur Ware mit ausreichender Restlaufzeit erhalten?

Du pflegst die geforderte Mindest-Restlaufzeit in Tagen als strukturiertes Zusatzfeld am Artikel in weclapp und überträgst sie über den täglichen PRICAT-Artikelstamm automatisch an das Lagerverwaltungssystem deines 3PL-Partners. Das WMS berücksichtigt diese Schwelle direkt bei der FEFO-Auswahl am Regal und sperrt Chargen mit zu kurzer Restlaufzeit für diesen Kanal, noch bevor ein Paket gepackt oder ein elektronisches Lieferavis (DESADV) erzeugt wird.