Load plans from your own systems

curl · shipment.sh

curl https://api.stowtix.com/v1/shipments \
  -H "Authorization: Bearer $STOWTIX_KEY" \
  -H "Idempotency-Key: po-4471" \
  -H "Content-Type: application/json" \
  -d '{"name": "PO 4471", "lines": [{
        "description": "Pump housing", "quantity": 6,
        "length_mm": 1200, "width_mm": 1150, "height_mm": 1300,
        "weight_kg": 640, "stop_no": 3}]}'
# 201 Created  {"id": "…", "name": "PO 4471", "lines": [ … ]}

Python · shipment.py

import os, requests

api = requests.Session()
api.headers["Authorization"] = f"Bearer {os.environ['STOWTIX_KEY']}"

shipment = api.post("https://api.stowtix.com/v1/shipments",
    headers={"Idempotency-Key": "po-4471"},
    json={"name": "PO 4471", "lines": [{
        "description": "Pump housing", "quantity": 6,
        "length_mm": 1200, "width_mm": 1150, "height_mm": 1300,
        "weight_kg": 640, "stop_no": 3}]}).json()

Node.js · shipment.mjs

const headers = {
  Authorization: `Bearer ${process.env.STOWTIX_KEY}`,
  "Content-Type": "application/json",
};

const shipment = await fetch("https://api.stowtix.com/v1/shipments", {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": "po-4471" },
  body: JSON.stringify({ name: "PO 4471", lines: [{
    description: "Pump housing", quantity: 6,
    length_mm: 1200, width_mm: 1150, height_mm: 1300,
    weight_kg: 640, stop_no: 3 }] }),
}).then((r) => r.json());

curl · calculation.sh

curl https://api.stowtix.com/v1/shipments/$SHIPMENT_ID/calculations \
  -H "Authorization: Bearer $STOWTIX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"equipment": [{"equipment_type_id": "'$HIGH_CUBE'", "max_units": 2}]}'
# 202 Accepted  {"id": "…", "status": "queued", "progress": 0, …}

Python · calculation.py

calc = api.post(
    f"https://api.stowtix.com/v1/shipments/{shipment['id']}/calculations",
    json={"equipment": [{"equipment_type_id": os.environ["HIGH_CUBE"], "max_units": 2}]},
).json()
# calc["status"] == "queued"

Node.js · calculation.mjs

const calc = await fetch(
  `https://api.stowtix.com/v1/shipments/${shipment.id}/calculations`,
  { method: "POST", headers, body: JSON.stringify({
      equipment: [{ equipment_type_id: process.env.HIGH_CUBE, max_units: 2 }] }) },
).then((r) => r.json());
// calc.status === "queued"

HTTP · webhook.http

POST https://your-erp.example/hooks/stowtix
Stowtix-Event: calculation.finished
Stowtix-Signature: t=1790850000,v1=5f2c9e…

{"id": "…", "event": "calculation.finished",
 "created_at": "2026-10-01T10:20:00Z",
 "data": {"calculation_id": "…", "shipment_id": "…",
          "status": "succeeded", "totals": { … }}}

Python · webhook.py

import hashlib, hmac, time

def from_stowtix(secret: str, header: str | None, body: bytes) -> bool:
    fields = dict(part.split("=", 1) for part in (header or "").split(",") if "=" in part)
    try:
        t = int(fields["t"])
    except (KeyError, ValueError):
        return False  # not a Stowtix signature
    if abs(int(time.time()) - t) > 300:
        return False  # older than five minutes
    mac = hmac.new(secret.encode(), f"{t}.".encode() + body, hashlib.sha256)
    return hmac.compare_digest(mac.hexdigest().encode(), fields.get("v1", "").encode())

Node.js · webhook.mjs

import { createHmac, timingSafeEqual } from "node:crypto";

function fromStowtix(secret, header, body) {
  const f = Object.fromEntries((header ?? "").split(",").map((p) => p.split("=")));
  const t = Number(f.t);
  if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > 300) return false;
  const mac = Buffer.from(createHmac("sha256", secret).update(`${t}.`).update(body).digest("hex"));
  const v1 = Buffer.from(f.v1 ?? "");
  return mac.length === v1.length && timingSafeEqual(mac, v1);
}

curl · plan.sh

curl https://api.stowtix.com/v1/calculations/$CALC_ID \
  -H "Authorization: Bearer $STOWTIX_KEY"

# the reports for the dock
curl https://api.stowtix.com/v1/calculations/$CALC_ID/report.pdf \
  -H "Authorization: Bearer $STOWTIX_KEY" -o plan.pdf
curl https://api.stowtix.com/v1/calculations/$CALC_ID/loading-list.xlsx \
  -H "Authorization: Bearer $STOWTIX_KEY" -o list.xlsx

Python · plan.py

plan = api.get(f"https://api.stowtix.com/v1/calculations/{calc['id']}").json()

pdf = api.get(f"https://api.stowtix.com/v1/calculations/{calc['id']}/report.pdf")
open("plan.pdf", "wb").write(pdf.content)

Node.js · plan.mjs

const plan = await fetch(`https://api.stowtix.com/v1/calculations/${calc.id}`,
  { headers }).then((r) => r.json());

const pdf = await fetch(`https://api.stowtix.com/v1/calculations/${calc.id}/report.pdf`,
  { headers }).then((r) => r.arrayBuffer());