Complete Blue Yonder Integration Guide

CubeMaster API Integration Guide

Using Blue Yonder / JDA WMS & TMS (Luminate Logistics REST API)

To enable Blue Yonder Luminate Platform to invoke CubeMaster optimization services, obtain your secret key:

  1. Log in to CubeMaster Online.
  2. Go to Settings > Integration > API Keys.
  3. Copy your secret TokenID. All requests from Blue Yonder Integrator must supply HTTP header: TokenID: your-token-id-here.

In Blue Yonder Integrator (formerly JDA Connect), configure a web service outbound task:

  1. Open BY Integrator Studio and create a new Outbound HTTP Request Component.
  2. URL: https://api.cubemaster.net/loads
  3. Method: POST
  4. Headers: Content-Type: application/json, TokenID: your-token-id-here

Map Blue Yonder outbound shipment lines (`ord_line`, `prtdtc`) to CubeMaster JSON payload:

{
    "Title": "BY Shipment #BY-90182",
    "Description": "Luminate Load Optimization",
    "Cargoes": [
        {
            "Name": "PALLET-SKU-BY01",
            "Length": 48.0,
            "Width": 40.0,
            "Height": 55.0,
            "Weight": 720.0,
            "Qty": 18,
            "OrientationsAllowed": "OrientationsAll"
        }
    ],
    "Containers": [
        {
            "VehicleType": "Dry",
            "Name": "53FT-Trailer",
            "Length": 630.0,
            "Width": 98.0,
            "Height": 106.0
        }
    ],
    "Rules": {
        "IsWeightLimited": true,
        "FillDirection": "FrontToRear",
        "CalculationType": "MixLoad"
    }
}

Extract volume utilization, total weight, and 3D diagram links into Blue Yonder dispatching dashboards (`shipment_header` custom fields):

{
    "status": "succeed",
    "loadSummary": {
        "piecesLoaded": 18,
        "volumeLoaded": 4200000.0,
        "weightLoaded": 12960.0
    },
    "filledContainers": [
        {
            "name": "#1 53FT-Trailer",
            "loadSummary": {
                "volumeUtilization": 78.2
            },
            "graphics": {
                "images": {
                    "path3DDiagram": "https://api.cubemaster.net/runtimes/by_load_3d.PNG"
                }
            }
        }
    ]
}