Freight

Endpoints for creating, updating, and managing individual freight orders. A freight represents a single transport job with pickup and delivery locations, cargo details, and status tracking.

📄️ Create a freight

Create a freight using your unique id as `ExternalId`. Called from Shipper's ERP.

📄️ Update a freight

Update an existing freight using the `ExternalId` to identify it. Only supported for select integrations.

📄️ Update freight status using patch

Update freight status, total CO2(grams) and Distance(km) using Swipref. Called from Carrier's TMS.

📄️ Update Carriers Reference

Update carriersReference.

📄️ Update Shippers Reference

Update shippersReference.

📄️ Create or update carrier freight cost settlement

Set the freight price and expenses for a specific freight

📄️ Update freight, settlements and expenses

Update freight and set the shipment price and expenses for a specific shipment. If 'final' the carrier settlement will be confirmed.

📄️ Upload freight attachments

Upload one or more Base64-encoded documents (e.g. CMR, packing list, photos) to an existing freight identified by its Swipload reference.

📄️ Upload freight signature

Upload a signature image (e.g. proof of pickup or delivery) for a freight identified by its Swipload reference. The signature type indicates whether it is a pickup or delivery signature.

📄️ Register a deviation on an order

Register a deviation (e.g. damaged goods, a failed pickup) on an existing order identified by its

📄️ Send a freight to a carrier

Send a Draft or Open freight to a carrier in the shipper's network. The carrier is looked up by name (case-insensitive, partial match) and receives the shipment request on its booking email, with the carrier setting the price afterwards.