menu-icon

Table of Contents

    Table of Contents

      Share On

      X IconLinkedIn IconFacebook Icon
      HomeRelease NotesTMS - Dynamic Pickup Address
      Date: 13 March 2026

      TMS - Dynamic Pickup Address

      Dynamic pickup handling during shipment creation in Omniful TMS.

      Version: 1.0
      Date: 2026-02-27
      Owner: Omniful Product Team

      Summary

      Dynamic Pickup Address Support allows shipment creation in Omniful TMS without requiring pickup locations to be pre-configured as Seller Hubs.

      Previously, shipment creation required passing seller_hub_code. The system fetched the pickup address from the configured Seller Hub master data. This approach worked for fixed pickup locations but created operational challenges for 3PL, courier, and aggregator workflows where pickup addresses vary frequently and cannot always be pre-created.

      With this enhancement, pickup details can now be passed directly in the shipment request, and the system can create the corresponding Seller Hub in real time when required.

      Key Highlights

      • Shipment creation supports dynamic pickup addresses.
      • Pickup details can be passed directly in the shipment payload.
      • Automatic Seller Hub creation for new pickup addresses.
      • Branch / Address ID can be reused for future shipments.
      • Existing seller_hub_code flow remains unchanged.

      How It Works

      1. Create shipment using seller_hub_code — If seller_hub_code is provided, the system fetches the pickup address from the configured Seller Hub master data. The shipment flow continues exactly as before.
      2. Provide pickup details in shipment request — Pickup location details can be passed directly in the shipment payload using a pickup object.
      3. Automatic Seller Hub creation — When a new pickup address or Branch / Address ID is received, the system automatically creates a Seller Hub in real time using the supplied information.
      4. Reuse for future shipments — Once created, the same Branch / Address ID or Seller Hub Code can be reused for future shipments without sending the full pickup address again.
      5. Backward compatibility — The existing flow using seller_hub_code remains unchanged and continues to work as before.

      Technical Details

      The following details describe the behavior of Dynamic Pickup Address Support during shipment creation.

      AreaBehavior / Details
      Previous requirementPickup locations had to be pre-configured as Seller Hubs in master data.
      Shipment creation inputUsers can provide either seller_hub_code or pickup details in the shipment request.
      Pickup objectPickup address details can be passed directly in the shipment payload.
      Seller Hub creationIf a new pickup address or Branch / Address ID is received, the system creates a Seller Hub in real time.
      Reuse logicAfter creation, the same Branch / Address ID / Seller Hub Code can be reused without resending full address details.
      Backward compatibilityExisting seller_hub_code-based flow remains unchanged.
      UI impactNo change to existing dashboard flow.
      Business applicabilitySupports dynamic pickup workflows for 3PL, courier, and aggregator models.