Table of Contents

Einrichtung der Integration

In diesem Artikel erfahren Sie, wie Sie eine Verbindung zwischen Business Central und Pulpo WMS einrichten.

Voraussetzungen

  • Ein aktiver Pulpo WMS-Mandant muss vorhanden sein.
  • Der Berechtigungssatz Aident Pulpo WMS Integration - Admin muss dem Benutzer zugewiesen sein, der die Einrichtung bearbeitet.

Allgemeine Einrichtung

Folgen Sie diesen Schritten, um die Aident Pulpo WMS Integration-App in Business Central zu konfigurieren.

  1. Zugriff auf die Einrichtung

    • Navigieren Sie zur Aident Pulpo WMS Einrichtung Seite in Business Central.

  2. Allgemein

    • Geben Sie eine Basis-URL und Tenant-ID von Pulpo WMS sowie die maximale Anzahl von Objekten ein, die in einer einzelnen Anfrage exportiert werden dürfen.

  3. Authentifizierung

    • Geben Sie Benutzernamen und Passwort des Pulpo WMS-Benutzers für APIs ein.
    • Geben Sie Scope, Grant Type und Authentifizierungsendpunkt von Pulpo WMS ein.

  4. Artikel

    • Konfigurieren Sie Endpunkte für den Export und die Aktualisierung von Artikeln von Business Central nach Pulpo WMS.
    • Wählen Sie, von wo die Artikelbarcodes exportiert werden sollen.
    • Geben Sie ein Sonderzeichen ein, um einen eindeutigen Kennzeichner für Artikelvarianten in Pulpo WMS zu erstellen.

  5. Drittanbieter

    • Konfigurieren Sie Endpunkte für den Export und die Aktualisierung von Drittanbietern (Lieferanten und Kunden) von Business Central nach Pulpo WMS.
    • Wählen Sie, ob Sie alle Lieferanten und/oder Kunden exportieren möchten, oder ob der Export mit Aufträgen erfolgen soll.

  6. Eingehende Dokumente

    • Konfigurieren Sie Endpunkte für den Export und die Aktualisierung eingehender Dokumente (Bestellaufträge, Wareneingänge und Verkaufsretouren) von Business Central nach Pulpo WMS.
    • Wählen Sie, ob Sie mit Aufträgen oder Wareneingängen arbeiten und diese exportieren möchten. Dies hängt auch davon ab, wie Ihre Lagerorte eingerichtet sind.

  7. Ausgehende Dokumente

    • Konfigurieren Sie Endpunkte für den Export und die Aktualisierung ausgehender Dokumente (Verkaufsaufträge, Warenausgänge, Einkaufsretouren und Umlagerungsaufträge) von Business Central nach Pulpo WMS.
    • Wählen Sie, ob Sie mit Aufträgen oder Warenausgängen arbeiten und diese exportieren möchten.

  8. Bestandskorrektur

    • Konfigurieren Sie Vorlage und Chargenbezeichnung, die für die Behandlung von Bestandskorrektur in Business Central verwendet werden.
    • Bestandskorrektur können manuell oder automatisch verbucht werden.

  9. Lagerorte

    • Konfigurieren Sie Lagerorte in Business Central, die mit den Lagern in Pulpo WMS verbunden sind.

Nun ist alles eingerichtet, und Sie sind bereit, Daten nach Pulpo WMS zu exportieren.

Pulpo WMS Webhooks

Für eine vollständige Integration ist eine Einrichtung auch in Pulpo WMS erforderlich. Folgende Webhooks werden in der Aident Pulpo WMS Integration-App unterstützt:

  • stock_correction_finished
  • incoming_good_created
  • picking_order_created
  • picking_order_finished
  • picking_order_deleted
  • sales_order_cancelled
  • sales_order_finished
  • counting_task_closed
  • replenishment_order_created (type=kit_move)
  • replenishment_order_finished (type=kitting)

Architektur

sequenceDiagram
    autonumber
    participant BC as Business Central (Aident Pulpo WMS Integration)
    participant PULPO as Pulpo WMS
    participant ASB as Azure Service Bus Queue

    BC->>PULPO: POST Item/Customer/Vendor/Purchase Documents/Sales Document
    PULPO-->>BC: Save Pulpo WMS ID and export time
    BC->>PULPO: PUT Item/Customer/Vendor/Purchase Documents/Sales Document
    BC->>PULPO: DELETE Purchase Documents/Sales Document
    PULPO->>PULPO: Process Order/Stock (trigger webhook)
    PULPO->>ASB: POST /pulpowms/messages
    ASB->>ASB: Send to Azure Function and transform data
    ASB->>BC: POST /webhookMessages

Azure Service Bus

Webhook-Nachrichten werden von Pulpo WMS über Azure Service Bus und eine Azure Function in Business Central empfangen. Zur Aktivierung stehen Kunden zwei Einrichtungsoptionen zur Verfügung:

  1. Kundenverwaltete Azure-Einrichtung - Sie konfigurieren die erforderlichen Azure-Ressourcen innerhalb Ihres eigenen Abonnements. Anschließend kontaktieren Sie Aident, um die Azure Function und zusätzliche für die Integration benötigte Details zu erhalten.
  2. Von Aident verwaltete Azure-Einrichtung (empfohlen) - Sie erstellen ein Azure-Abonnement und gewähren Aident erhöhte Berechtigungen. Aident stellt anschließend alle erforderlichen Azure-Ressourcen in Ihrem Namen bereit und konfiguriert sie.

Diese Flexibilität ermöglicht es Ihnen, entweder die vollständige Kontrolle über Ihre Azure-Umgebung zu behalten oder die komplette Einrichtung an Aident zu delegieren.

Für die Aktivierung der Integration zwischen Pulpo WMS und Business Central sind folgende Azure-Ressourcen erforderlich:

  • Azure Service Bus: zum Empfangen von Nachrichten von Pulpo WMS
  • Azure Function App: zum Verarbeiten von Service-Bus-Nachrichten und Aktualisieren von Business Central
  • Azure Storage Account: (optional, aber empfohlen) für Zustandsverwaltung der Function, Protokolle und Warteschlangen
  • Azure App Registration (Azure AD): für Authentifizierung und sichere API-Kommunikation zwischen Pulpo WMS und Business Central
  • Azure Key Vault: zum sicheren Speichern von Geheimnissen und Verbindungszeichenfolgen. Key Vault und Geheimnisse müssen vordefinierte Namen haben.

Rollenzentrum

Die Aident Pulpo WMS Integration-App bietet ein dediziertes Profil (Aident Pulpo WMS), das Ihnen ermöglicht, alle Aspekte der Verbindung zwischen Business Central und Pulpo WMS zu verwalten.

Aufgabenwarteschlangen

Es gibt mehrere Aufgabenwarteschlangen, die verwendet werden können, um Integrationsprozesse zu automatisieren:

  • codeunit ItemImplWMSNID: Exportiert alle Inventarartikel nach Pulpo WMS.
  • codeunit ThirdPartyImplWMSNID: Exportiert alle Drittanbieter (Lieferanten und Kunden) nach Pulpo WMS.
  • codeunit PurchaseDocumentImplWMSNID: Exportiert alle freigegebenen Einkaufsbelege nach Pulpo WMS.
  • codeunit SalesDocumentImplWMSNID: Exportiert alle freigegebenen Verkaufsbelege nach Pulpo WMS.
  • codeunit PurchReturnDocumentImplWMSNID: Exportiert alle freigegebenen Einkaufsretourenbelege nach Pulpo WMS.
  • codeunit SalesReturnDocumentImplWMSNID: Exportiert alle freigegebenen Verkaufsretourenbelege nach Pulpo WMS.
  • codeunit TransferOrderImplWMSNID: Exportiert alle freigegebenen Transferbelege nach Pulpo WMS.
  • codeunit ProcessOpenClosingsWMSNID: Verarbeitet offene Pulpo WMS Abschlüsse.

Checkliste

  • Erstellen Sie für jedes Pulpo WMS-Warenlager einen Business Central-Lagerort
  • Setzen Sie "Default Quantity to Ship" in "Sales & Receivables Setup" auf "Blank"
  • Setzen Sie "Default Quantity to Receive" in "Purchases & Payables Setup" auf "Blank"
  • Weisen Sie jedem Benutzer in Business Central den korrekten Berechtigungssatz Aident Pulpo WMS Integration zu
  • Führen Sie die erforderlichen Einstellungen auf der Seite "Aident Pulpo WMS Setup" in Business Central durch
  • Richten Sie die PULPOWMS-Aufgabenwarteschlangen so ein, dass sie zu bestimmten Zeiten und Intervallen ausgeführt werden
  • Richten Sie Azure Service Bus Queue, Key Vault und Function ein
  • Definieren Sie die Liste der Webhooks in der Pulpo WMS-Desktop-App zusammen mit dem Authentifizierungsverfahren und der URL zur Azure Service Bus Queue

Nächster Schritt

Artikel