Freight middleware · live at api.velcun.com

One platform
for every mile.

Velcun is the unified backend for truckers and trucking companies. Post and match freight, negotiate rates, dispatch drivers, ingest live truck telemetry, exchange EDI with any TMS — and settle every load automatically.

API operational EDI X12 · 204 / 990 / 214 REST + OpenAPI 3
Velcun platform · live
OPERATIONAL
—
API status
—
REST endpoints
10
Platform modules
204/990/214
EDI X12 live
checking api.velcun.com…
The lifecycle, handled

From posted load to paid driver,
one state machine.

Every shipment walks the same audited lifecycle. Steps marked auto happen without anyone touching a keyboard.

01
📦

Post

Shipper posts freight — via dashboard or an EDI 204 tender.

02
🎯

Match

Carriers search lanes; loads scored by pay and $/mile.

03
🤝

Negotiate

Bids and counter-offers until both sides accept the rate.

04
🚛

Dispatch

Assign driver and truck; illegal transitions are blocked.

AUTO
05
📡

Track

ELD pings accumulate miles; movement and geofence arrival update status.

AUTO
06
🧾

Invoice

Delivery triggers the invoice: linehaul + fuel surcharge.

AUTO
07
💸

Settle

Payment generates driver pay — per mile or % of linehaul.

Platform modules

Everything a freight operation runs on.

📦

Load board & matching

Post freight with pickup windows, equipment and FSC. Carriers filter by lane, equipment and minimum rate.

GET /loads/search
🤝

Offers & negotiation

Carrier bids, shipper counters, one live offer per side. Acceptance locks the agreed rate into the booking.

POST /offers
🚛

Dispatch & lifecycle

Assign drivers and power units. A strict state machine keeps every shipment honest and auditable.

POST /bookings/:id/dispatch
📡

Live telemetry

Batch GPS ingestion from ELDs with odometer-first mileage, movement detection and arrival geofencing.

POST /telemetry/pings
🏭

Docks & appointments

Facilities with dock doors and windows. Doors auto-assign; overlapping appointments are rejected.

POST /facilities/:id/appointments
🧾

Billing & settlement

Invoices auto-issue on delivery. Payment settles the driver automatically — per-mile or percentage.

POST /billing/invoices/:id/pay
🔀

EDI X12 engine

Ingest 204 tenders (returns a 990), accept 214 status messages, translate X12 ↔ JSON. Full interchange audit.

POST /edi/x12/204
🔔

Signed webhooks

Every domain event fans out to your endpoints, HMAC-SHA256 signed, with retries and delivery history.

X-Velcun-Event-Signature
Built for both sides of the load

Truckers and trucking companies.
Shippers and brokers.

For shippers & brokers

Post once. Reach every carrier.

  • Publish loads from the dashboard or straight from your TMS via EDI 204
  • Review carrier bids, counter once, lock the rate
  • Watch every shipment move with live telemetry milestones
  • Auto-issued invoices with fuel surcharge on delivery
  • Outbound webhooks keep your ERP in sync in real time
For carriers & truckers

Your truck, booked and paid.

  • Search lanes by state, equipment and rate — scored by $/mile
  • Negotiate from your phone; accept when the number works
  • Dispatch with driver and truck assignment in one tap
  • Miles tracked from ELD pings — no more odometer disputes
  • Driver pay calculated automatically when the invoice pays
Developers

Middleware means APIs first.

tender-a-load.sh
# 1. authenticate (or use an org API key: X-API-Key: vk_...)
curl -s https://api.velcun.com/api/v1/auth/login \
  -d '{"email":"shipper@velcun.demo","password":"•••"}' \
  -H 'Content-Type: application/json'

# 2. tender a load the legacy way — raw EDI X12 204
curl -s https://api.velcun.com/api/v1/edi/x12/204 \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"raw":"ISA*00*...~ST*204*0001~B2**ACME-EDI-001~..."}'

# Velcun parses it, creates the load, and answers:
{
  "accepted": true,
  "load_id":  42,
  "x12_990":  "ST*990*0001~B1*VELCUN*ACME-EDI-001**A~..."
}
⚡

REST + OpenAPI 3

Every endpoint documented and interactive at api.velcun.com/docs.

🔑

Instant self-serve access

Sign up free — a live API key is in the signup response, shown once. No sales call, no waitlist.

🪙

Micro-tolls, per action

Pay-as-you-go keys pay by what the call is worth: 1¢ lane search, 3¢ bid placed, 1¢ telemetry batch, 5¢ EDI transaction. Plans bundle an allowance instead.

🧬

EDI X12 in, JSON out

204 tenders in, 990 responses out, 214 status streams both directions.

🔗

HMAC webhooks

Subscribe per event type; verify every delivery against the shared secret.

What trucking actually pays today

Real costs in the industry,
automated away.

These aren't our numbers — they're the industry's own benchmarks. Each one is a cost carriers already pay, and each maps to a module that automates it.

🧑‍💼

Dispatch services

Independent dispatchers charge 4–7% of gross (median 5–6%) — about $1,200–$1,400 per truck per month, or $250–500/week flat.

→ automated by auto-bid + auto-negotiate
⏱️

Cash-advance factoring

Brokers pay Net 30–60 (often 90+). Carriers factor invoices at 2.5–3.5% for cash flow — thousands per truck per year in fees.

→ automated by invoice-on-delivery + auto-collection
🚧

Deadhead miles

The benchmark is 15–20% empty miles; every +10 points costs a truck roughly $27,000 a year at a $2.26/mi operating cost.

→ automated by lane matching + backhaul search
⏳

Detention that goes unbilled

Detention runs $50–100+/hr after 2 free hours, drivers wait 117–209 hrs/year, and most claims are never documented — billions go unclaimed industry-wide.

→ automated by geofence timestamps = evidence
📋

Load boards & TMS

DAT and Truckstop run $45–$199/month per seat, before a TMS. Searching, booking and tracking live in three disconnected tools.

→ included: load board, dispatch, tracking, docs
📄

Back-office paperwork

POD chasing, rate confirmations, driver settlements, IFTA mileage — hours per truck per week that nobody bills for.

→ automated end to end by the ledger
Pricing

$1,000 per truck, per month.

  • Flat per truck — not a percentage of your gross
  • Everything above included: matching, negotiation, dispatch, tracking, detention evidence, invoicing, settlement
  • EDI + REST API included — your shippers plug straight in
  • Cancel any month; your data stays yours
The honest math

Priced against what you already pay.

  • Dispatch alone: $1,200–$1,400/mo at the industry median
  • Factoring a $150k/mo gross at 3%: $4,500/mo
  • Cutting deadhead 20%→15%: ~$13k/yr per truck
  • Capturing even 2 detention hours/week: $5k+/yr per truck
Start with one truck → No per-load fees. No percentage of linehaul.

Driver on the road? Check in at velcun.com/driver.html — load, check-ins and POD on one phone screen. No app store.

Sources: ATRI Operational Costs of Trucking (2024–25) · FMCSA/ATRI detention research · learndispatch.com dispatch-pricing survey · DAT & Truckstop published pricing · Porter Freight Funding / OTR Solutions factoring rates · Scale Funding payment-trends report.

Get rolling

Your next load is on Velcun.

Open the dashboard with the demo accounts and run a load end to end — bid, dispatch, track, invoice, settle — in under five minutes.