Table of Contents

Integration Setup

In this article, you will learn how to set up a connection between Business Central and Pulpo WMS.

Prerequisites

  • An active Pulpo WMS tenant must exist.
  • The permission set Aident Pulpo WMS Integration - Admin must be assigned to user editing the setup.

General setup

Follow these steps to configure the Aident Pulpo WMS Integration app in Business Central.

  1. Access the Setup

    • Navigate to Aident Pulpo WMS Setup page in Business Central.

  2. General

    • Enter a base URL and tenant ID of Pulpo WMS, as well as maximum objects allowed to export in single request.

  3. Authentication

    • Enter username and password of Pulpo WMS user for APIs.
    • Enter scope, grant type and authentication endpoint of Pulpo WMS.

  4. Item

    • Configure endpoints for exporting and updating items from Business Central to Pulpo WMS.
    • Choose from where item barcodes will be exported.
    • Enter special character for creating unique identifier for item variants in Pulpo WMS.

  5. Third Party

    • Configure endpoints for exporting and updating third parties (vendors and customers) from Business Central to Pulpo WMS.
    • Choose whether you would like to export all vendors and/or customers or export should be done with orders.

  6. Incoming Documents

    • Configure endpoints for exporting and updating incoming documents (purchase orders, warehouse receipts and sales return orders) from Business Central to Pulpo WMS.
    • Choose whether you would like to work with and export Orders or Warehouse Receipts. This will also depend on how you Locations are setup.

  7. Outgoing Documents

    • Configure endpoints for exporting and updating outgoing documents (sales orders, warehouse shipments, purchase return orders and transfer orders) from Business Central to Pulpo WMS.
    • Choose whether you would like to work with and export Orders or Warehouse Shipments.

  8. Stock Correction

    • Configure journal template and batch name that will be used for handling stock correction in Business Central.
    • Stock correction can be posted manually or automatically.

  9. Locations

    • Configure Locations in Business Central connected with warehouses in Pulpo WMS.

Now everything is set up, and you’re ready to export data to Pulpo WMS.

Pulpo WMS webhooks

For full integration to work correctly, setup is also needed in Pulpo WMS. Next webhooks are supported in Aident Pulpo WMS Integration app:

  • stock_correction_finished
  • incoming_good_created
  • picking_order_created
  • picking_order_finished
  • picking_order_deleted
  • sales_order_cancelled
  • sales_order_finished
  • counting_task_closed

Azure Service Bus

Webhook messages are received from Pulpo WMS in Business Central via Azure Service Bus and Azure Function. To enable this, customers have two setup options:

  1. Customer-managed Azure setup - you configure the required Azure resources within your own subscription. You then contact Aident to obtain the Azure Function and additional details required for the integration.
  2. Aident-managed Azure setup (recommended) - you create an Azure subscription and grant Aident elevated permissions. Aident will then provision and configure all necessary Azure resources on your behalf.

This flexibility allows you to choose between maintaining full control of your Azure environment or delegating the complete setup to Aident.

To enable the Pulpo WMS to Business Central integration, the following Azure resources are required:

  • Azure Service Bus: for receiving messages from Pulpo WMS
  • Azure Function App: to process Service Bus messages and update Business Central
  • Azure Storage Account: (optional, but recommended) for function state management, logs, and queues
  • Azure App Registration (Azure AD): for authentication and secure API communication between Pulpo WMS and Business Central
  • Azure Key Vault: for securely storing secrets and connection strings. Key vault and secrets must have predefined names.

Role center

The Aident Pulpo WMS Integration app offers a dedicated profile (Aident Pulpo WMS) that enables you to manage all aspects of the connection between Business Central and Pulpo WMS.

Job queues

There are multiple job queues that can be used to help automate integration processes:

  • codeunit ItemImplWMSNID: Exports all inventory Items to Pulpo WMS.
  • codeunit ThirdPartyImplWMSNID: Exports all third parties (vendors and customers) to Pulpo WMS.
  • codeunit PurchaseDocumentImplWMSNID: Exports all released Purchase Documents to Pulpo WMS.
  • codeunit SalesDocumentImplWMSNID: Exports all released Sales Documents to Pulpo WMS.
  • codeunit PurchReturnDocumentImplWMSNID: Exports all released Purchase Return Documents to Pulpo WMS.
  • codeunit SalesReturnDocumentImplWMSNID: Exports all released Sales Return Documents to Pulpo WMS.
  • codeunit TransferOrderImplWMSNID: Exports all released Transfer Documents to Pulpo WMS.
  • codeunit ProcessOpenClosingsWMSNID: Processes Open Pulpo WMS Closings.

Next step

Items