ERP Connect API (v1)

Base URL

https://maxpack.com.au/api/v1/

ERP Connect customers receive an API key via the customer portal. Demo credentials on the sign-in page.

Authentication

Include header on every request: X-Api-Key: your-api-key

Production requires a valid key. Parcel and Container plans are browser-only — ERP Connect includes full API access.

POST /pack.php — pack lines (no order saved)

Quote or pre-ship check — returns outer carton choice and full load design.

{

  "reference": "SO-12345",

  "shipMode": "parcel",

  "lines": [

    { "sku": "TAPE-48", "qty": 4 },

    { "sku": "TAP-BAS", "qty": 2 }

  ]

}

Response (200):

{

  "ok": true,

  "apiVersion": 1,

  "reference": "SO-12345",

  "summary": {

    "ok": true,

    "headline": "2 outer boxes, 35.00 L total cube",

    "composition": "CTN-M+CTN-M",

    "outerCount": 2

  },

  "pack": { "ok": true, "packedBins": [ "..." ], "steps": [ "..." ] }

}

POST /orders.php — create order (+ optional pack)

{

  "reference": "SO-12345",

  "customer": "Acme Pty Ltd",

  "shipMode": "parcel",

  "pack": true,

  "fullExhaustive": false,

  "lines": [{ "sku": "TAPE-24", "qty": 6 }]

}

Set pack: true to run the optimizer and save results. Use fullExhaustive: false for faster response on multi-SKU orders.

GET /orders.php

• ?reference=SO-12345 — slim order + lastPackSummary
• ?id=id-1 — by internal id
• &pack=full — attach saved pack file with load steps

POST /station.php — push to packer bench

Assign a packed order to a station display (e.g. PACK-01). Returns display bins and pack steps for floor screens.

Error responses

HTTP	Meaning
400	Invalid body — empty lines, bad JSON
401	Missing or invalid API key
404	Order not found
405	Wrong HTTP method

Try it (demo)

curl -X POST "https://maxpack.com.au/api/v1/pack.php" \

  -H "Content-Type: application/json" \

  -H "X-Api-Key: YOUR_DEMO_KEY" \

  -d '{"reference":"TEST","shipMode":"parcel","lines":[{"sku":"TAPE-48","qty":2}]}'

Full reference: docs/ERP_API.md (repository) · Smoke-tested against production on every deploy.