Table of Contents

Verkaufsaufträge

In diesem Artikel erfahren Sie, wie Sie Verkaufsaufträge von Business Central nach Pulpo WMS exportieren und verarbeiten können.

Vier Arten von ausgehenden Belegen werden unterstützt:

  1. Verkaufsauftrag
  2. Einkaufsreklamation
  3. Umlagerungsauftrag
  4. Warenausgang

Verkaufsauftrag

Verkaufsaufträge mit Pulpo WMS Lagerort im Kopf dürfen keine anderen Lagerorte in den Belegzeilen haben. Dies stellt sicher, dass alle Aufträge und deren Zeilen zum richtigen Lager gelangen.

Einmal exportierte Verkaufsaufträge können nicht gelöscht oder manuell für den Versand in Business Central gebucht werden. Das Wiederöffnen und Bearbeiten von Belegen ist möglich, bis Pulpo WMS mit diesem Auftrag beginnt zu arbeiten.

Notwendige Felder für den Export eines Verkaufsauftrags:

  • Debitorennummer
  • Lagerortcode (Pulpo WMS Lagerort)
  • Lieferungsdatum
  • Priorität
  • Lieferadressdetails
  • Lagerbestand Artikelzeilen
    • Nr.
    • Menge
    • Zeilennr.

[!HINWEIS]
Es wird empfohlen, dass "Zu liefernde Standardmenge" in "Einrichtung Debitoren und Verkauf" auf Leer gesetzt ist

Einkaufsreklamation

Falls eine Rücksendung von Waren an Kreditoren benötigt wird, werden Einkaufsreklamationen verwendet. Der Export von Einkaufsreklamationen für einen Pulpo WMS Lagerort erfolgt als Verkaufs-/Ausgangsbeleg mit type=return und einer Liste von Artikeln und Mengen, die wir erwarten, vom Kreditor zurückgesendet zu bekommen.

Einmal exportierte Einkaufsreklamationen können nicht gelöscht oder manuell für den Versand in Business Central gebucht werden. Das Wiederöffnen und Bearbeiten von Belegen ist möglich, bis Pulpo WMS mit diesem Auftrag beginnt zu arbeiten.

Notwendige Felder für den Export einer Einkaufsreklamation:

  • Einkauf von Kreditor Nr.
  • Lagerortcode (Pulpo WMS Lagerort)
  • Erwartetes Wareneingangsdatum
  • Priorität
  • Lieferdetails
  • Lagerbestand Artikelzeilen
    • Nr.
    • Menge
    • Zeilennr.

[!HINWEIS]
Es wird empfohlen, dass "Standardmenge akt. Lieferung" in "Kreditoren & Einkauf Einr." auf Leer gesetzt ist

Umlagerungsauftrag

Wenn wir Artikel von einem Pulpo WMS Lagerort zu einem anderen übertragen wollen, können wir das mit einem Umlagerungsauftrag in Business Central tun. Sowohl von- als auch zu-Lagerorte müssen Pulpo WMS Lagerorte sein. Ein direkter Transfer wird in diesem Fall nicht unterstützt.

Beim Export des Umlagerungsauftrags zu Pulpo WMS fungiert er als ausgehender Beleg im Quelllager (type=warehouse_movement). Notwendige Felder für den Export eines Umlagerungsauftrags:

  • Von Lagerortcode
  • Zu Lagerortcode
  • Lieferungsdatum
  • Priorität
  • Artikelzeilen
    • Nr.
    • Menge
    • Zeilennr.

Der Empfangsteil des Umlagerungsauftrags wird nicht von Business Central nach Pulpo WMS exportiert. warehouse_movement eingehender Beleg wird im Ziel-Lager in Pulpo WMS automatisch erstellt, nachdem die Lieferung aus dem Quelllager erfolgt ist. Der Prozess in Business Central ist dann wie bei anderen eingehenden Belegen.

Warenausgang

Der Warenausgang wird in Verbindung mit der Einrichtung "Warenausgang erforderlich" und "Belegart Export" aus der Einrichtung verwendet, die als Lieferung festgelegt ist. Warenausgänge sollten pro Auftrag in Business Central erstellt werden.

Nur Warenausgänge, die aus Verkaufsauftrag, Einkaufsreklamation oder Umlagerungsauftrag erstellt wurden, können nach Pulpo WMS exportiert werden. Eine Statusänderung im Warenausgang aktualisiert den Status im verbundenen Auftrag.

Dasselbe Regelwerk für den Export gilt wie für obige Auftragsarten.

Export

Zwei Exportmethoden werden unterstützt:

  • Stapel-Export: Export aller freigegebenen, noch nicht exportierten ausgehenden Belege
  • Einzel-Export: Export eines einzelnen eingehenden Belegs über eine Aktion auf der Auftragsseite

Stapel-Exports werden an die POST /sales/bulk/orders Pulpo WMS API gesendet, während Einzel-Exports an die POST /sales/orders API gesendet werden. Wenn ein Beleg erfolgreich exportiert wurde, wird die Pulpo WMS ID in den Kopftabellen gespeichert. Wenn ein Beleg bereits exportiert wurde, kann ein Update durch Aufrufen von PUT /sales/orders/%1 Pulpo WMS API durchgeführt werden.

Nach jedem API-Aufruf wird ein neuer Eintrag in der Anforderungsprotokolltabelle mit dem Typ Verkaufsbeleg, Einkaufsrückgabebeleg oder Transferbeleg gespeichert. Im Fehlerfall oder bei unvollständigen Daten wird das Ergebnis in diesem Protokoll gespeichert.

Status

Mögliche Status von ausgehenden Belegen:

  1. Gesendet: Beleg ist erfolgreich exportiert und befindet sich im Status-Warteschleife in Pulpo WMS. Während dieses Status ist es möglich, den Beleg zu bearbeiten und ein Update an Pulpo WMS über eine Aktion auf den Seiten zu senden.
  2. Picking: Auftrag wurde zur Kommissionierliste in Pulpo WMS hinzugefügt. Keine weitere Bearbeitung dieses Auftrags ist erlaubt.
  3. Packing: Die Kommissionierung von Artikeln aus dem Auftrag wurde in Pulpo WMS abgeschlossen.
  4. Teilweise geliefert: Lagermitarbeiter in der Pulpo WMS App hat die Bearbeitung dieses Belegs abgeschlossen, aber nicht alle Artikel aus dem Beleg wurden versendet.
  5. Geliefert: Lagermitarbeiter in der Pulpo WMS App hat die Bearbeitung dieses Belegs abgeschlossen und alle Artikel aus dem Beleg wurden versendet.
  6. Storniert: Beleg wurde von Pulpo WMS storniert. Stornierung kann direkt in Pulpo WMS oder in Business Central über eine Aktion auf den Auftragsseiten erfolgen.

Webhooks

Wenn ein ausgehender Beleg in der Pulpo WMS App verarbeitet wird, müssen wir das in Business Central wissen. Dafür werden Pulpo WMS Webhooks verwendet:

  • picking_order_created
  • picking_order_deleted
  • picking_order_finished
  • sales_order_cancelled
  • sales_order_finished

Picking Order Created

Wenn ein ausgehender Beleg zur neuen Kommissionierliste in Pulpo WMS hinzugefügt wird, wird die picking_order_created Webhook-Nachricht über den Azure Service Bus an Business Central gesendet. Die Kommissionierliste kann Artikel aus einem oder mehreren ausgehenden Belegen enthalten.

Die Webhook-Nachricht wird in der Pulpo WMS Webhook-Nachrichtentabelle gespeichert und von dort aus analysiert und in der Pulpo WMS Bewegungstabelle gespeichert. Belegart der Webhook-Nachricht ist entweder sales_order, return oder warehouse_movement. Bewegungszeilen enthalten eine Liste von Artikeln, die zur Kommissionierliste hinzugefügt wurden.

Nach dem Einfügen der Bewegungszeile, wenn keine Fehler vorliegen:

  • Status des ausgehenden Belegs in Business Central wird auf Picking geändert

Picking Order Deleted

Wenn eine Kommissionierliste in Pulpo WMS gelöscht wird, wird die picking_order_deleted Webhook-Nachricht über den Azure Service Bus an Business Central gesendet.

Die Webhook-Nachricht wird in der Pulpo WMS Webhook-Nachrichtentabelle gespeichert und von dort aus analysiert und in der Pulpo WMS Bewegungstabelle gespeichert. Bewegungszeilen enthalten eine Liste von Artikeln, die in der Kommissionierliste waren.

Nach dem Einfügen der Bewegungszeile, wenn keine Fehler vorliegen:

  • Status des ausgehenden Belegs in Business Central wird auf Gesendet geändert

Picking Order Finished

Wenn die Kommissionierung in Pulpo WMS abgeschlossen ist, wird die picking_order_finished Webhook-Nachricht über den Azure Service Bus an Business Central gesendet.

Die Webhook-Nachricht wird in der Pulpo WMS Webhook-Nachrichtentabelle gespeichert und von dort aus analysiert und in der Pulpo WMS Bewegungstabelle gespeichert. Bewegungszeilen enthalten eine Liste von kommissionierten Artikeln, Mengen und Auftragsnummern.

Nach dem Einfügen der Bewegungszeile, wenn keine Fehler vorliegen:

  • Status des ausgehenden Belegs wird auf Packing geändert
  • Zu liefern in der Belegzeile wird auf die Menge aus der Webhook-Nachricht aktualisiert

Sales Order Canceled

Wenn ein ausgehender Beleg in Pulpo WMS storniert wird, wird die sales_order_cancelled Webhook-Nachricht über den Azure Service Bus an Business Central gesendet.

Die Webhook-Nachricht wird in der Pulpo WMS Webhook-Nachrichtentabelle gespeichert und von dort aus analysiert und in der Pulpo WMS Abschlusstabelle gespeichert. Der Verarbeitung eines neuen Abschlusses ohne Fehler erfolgt über die Auftragswarteschlange:

  • Status des Belegs wird auf Storniert geändert
  • Abschluss wird als verarbeitet gekennzeichnet

Sales Order Finished

Nachdem die Artikel aus dem Beleg verpackt und für den Versand in Pulpo WMS vorbereitet wurden, wird die sales_order_finished Webhook-Nachricht über den Azure Service Bus an Business Central gesendet.

Die Webhook-Nachricht wird in der Pulpo WMS Webhook-Nachrichtentabelle gespeichert und von dort aus analysiert und in der Pulpo WMS Abschlusstabelle gespeichert. Abschlusszeilen enthalten eine Liste aller versendeten Artikel und Mengen.

Die Verarbeitung eines neuen Abschlusses ohne Fehler erfolgt über die Auftragswarteschlange:

  • Ausgehender Beleg wird gebucht (für Versand)
  • Status wird auf Teilweise geliefert oder Geliefert geändert
  • Abschluss wird als verarbeitet gekennzeichnet

Nächster Schritt

Lagerverwaltung