Complete Manhattan WMS Integration Guide

CubeMaster API Integration Guide

Using Manhattan Associates Active® WMS (REST API & Webhooks)

To authorize Manhattan Active® WMS to communicate with the CubeMaster API, generate your API key:

  1. Log in to your CubeMaster Online dashboard.
  2. Navigate to Settings > Integration > API Keys.
  3. Generate a secret TokenID (e.g. mb_active_88921a) and save it securely.
  4. Your TokenID must be included as an HTTP header in all requests: TokenID: your-token-id-here.

In Manhattan Active® WMS Integration Portal, configure an outbound REST endpoint trigger for wave release or shipment consolidation events:

  1. Navigate to Integration Platform > External Services.
  2. Create a new External Web Service target:
    • Service Name: CubeMaster_Load_Optimizer
    • Target URL: https://api.cubemaster.net/loads
    • HTTP Method: POST
    • Header Authorization: Add header TokenID with your key.
  3. Set trigger event to Wave.Release or OutboundOrder.Consolidate.

Map Manhattan WMS item master and shipment fields to the standard CubeMaster API POST body format:

{
    "Title": "Manhattan Order #ORDER-88219",
    "Description": "Automated Wave Packing Plan",
    "Cargoes": [
        {
            "Name": "SKU-MANH-001",
            "Length": 48.0,
            "Width": 40.0,
            "Height": 60.0,
            "Weight": 850.0,
            "Qty": 12,
            "OrientationsAllowed": "OrientationsAll"
        },
        {
            "Name": "SKU-MANH-002",
            "Length": 24.0,
            "Width": 20.0,
            "Height": 30.0,
            "Weight": 120.0,
            "Qty": 40,
            "OrientationsAllowed": "OrientationsAll"
        }
    ],
    "Containers": [
        {
            "VehicleType": "Dry",
            "Name": "53FT-Standard-Trailer",
            "Length": 630.0,
            "Width": 98.0,
            "Height": 106.0
        }
    ],
    "Rules": {
        "IsWeightLimited": true,
        "FillDirection": "FrontToRear",
        "CalculationType": "MixLoad"
    }
}

When CubeMaster returns "status": "succeed", parse container utilization metrics and store diagram URLs into Manhattan custom attributes for display on RF terminals and packing station screens:

{
    "status": "succeed",
    "loadSummary": {
        "cargoesLoaded": 52,
        "volumeLoaded": 4810200.0,
        "weightLoaded": 15000.0
    },
    "filledContainers": [
        {
            "name": "#1 53FT-Standard-Trailer",
            "loadSummary": {
                "volumeUtilization": 84.5
            },
            "graphics": {
                "images": {
                    "path3DDiagram": "https://api.cubemaster.net/runtimes/manhattan_plan_3d.PNG"
                }
            }
        }
    ]
}