Hoppa till innehållet

API and integrations Headless commerce Shipments

Svenska

Shipments

Deliveries against the signed-in customer's orders, with carrier tracking where the carrier provides it.

2 calls GET Base URL https://api.erp.fluit.cloud/ecom

Authentication, error codes, rate limits, idempotency and pagination apply to every call and are documented once under Getting started.

GET /portal/shipments

List shipments

Returns a paginated list of shipments for the authenticated customer.

Query parameters

Field Type
page integer
pageSize integer
status string

Responses

200 PortalShipmentListResponse
Field Type
items PortalShipment[] · nullable
page integer
pageSize integer
totalCount integer
429 Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
  • Retry-After — Seconds to wait before retrying.

Standard errors: 401 403 Errors

Examples

curl 
curl "https://api.erp.fluit.cloud/ecom/portal/shipments" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web"
Response 200 
{
  "items": [
    {
      "createdDate": "string",
      "deliveredDate": "string",
      "deliveryCity": "string",
      "deliveryCountry": "string",
      "deliveryName": "Widget A",
      "id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
      "orderNumbers": [
        "SO-2026-1041"
      ],
      "packageCount": 42,
      "shipmentNumber": "SH-2026-0455",
      "shippedDate": "string",
      "status": "string",
      "trackingNumber": "ABC-001"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137
}

Base URL https://api.erp.fluit.cloud/ecom. The response example is generated from the schema: the shape is right, the values are made up.

GET /portal/shipments/{id}

Get shipment detail

Returns the full detail of a specific shipment for the authenticated customer.

Path parameters

Field Type
id Required string(uuid)

Responses

200 PortalShipmentDetailResponse
Field Type
createdDate string · nullable
deliveredDate string · nullable
deliveryAddress PortalShipmentAddress
id string(uuid)
lines PortalShipmentLine[] · nullable
orderNumbers string[] · nullable
packages PortalShipmentPackage[] · nullable
shipmentNumber string · nullable
shippedDate string · nullable
shippingMethodName string · nullable
status string · nullable
totalWeightKg decimal · nullable
trackingNumber string · nullable
429 Rate limit exceeded. Wait the number of seconds given in Retry-After. The body is problem-shaped application/json, not application/problem+json. This API sends no X-RateLimit-* headers — the quota is discovered here.
  • Retry-After — Seconds to wait before retrying.

Standard errors: 401 404 Errors

Examples

curl 
curl "https://api.erp.fluit.cloud/ecom/portal/shipments/{id}" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web"
Response 200 
{
  "createdDate": "string",
  "deliveredDate": "string",
  "deliveryAddress": {
    "city": "Stockholm",
    "country": "string",
    "name": "Acme AB",
    "postalCode": "11122",
    "street": "string"
  },
  "id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
  "lines": [
    {
      "id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
      "itemName": "Widget A",
      "itemNumber": "WIDGET-A",
      "quantity": "10",
      "unit": "st"
    }
  ],
  "orderNumbers": [
    "SO-2026-1041"
  ],
  "packages": [
    {
      "heightCm": "299.00",
      "id": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
      "lengthCm": "299.00",
      "packageNumber": "ABC-001",
      "trackingNumber": "ABC-001",
      "weightKg": "1.250",
      "widthCm": "299.00"
    }
  ],
  "shipmentNumber": "SH-2026-0455",
  "shippedDate": "string",
  "shippingMethodName": "Parcel, next day",
  "status": "string",
  "totalWeightKg": "1.250",
  "trackingNumber": "ABC-001"
}

Base URL https://api.erp.fluit.cloud/ecom. The response example is generated from the schema: the shape is right, the values are made up.

Schemas

The objects this group's calls refer to. The field tables above go one level deep and link here rather than repeating the same schema on every endpoint.

PortalShipment

PortalShipmentListItem
Field Type
createdDate string · nullable
deliveredDate string · nullable
deliveryCity string · nullable
deliveryCountry string · nullable
deliveryName string · nullable
id string(uuid)
orderNumbers string[] · nullable
packageCount integer
shipmentNumber string · nullable
shippedDate string · nullable
status string · nullable
trackingNumber string · nullable

PortalShipmentAddress

PortalShipmentAddressResponse
Field Type
city string · nullable
country string · nullable
name string · nullable
postalCode string · nullable
street string · nullable

PortalShipmentLine

PortalShipmentLineResponse
Field Type
id string(uuid)
itemName string · nullable
itemNumber string · nullable
quantity decimal
unit string · nullable

PortalShipmentPackage

PortalShipmentPackageResponse
Field Type
heightCm decimal · nullable
id string(uuid)
lengthCm decimal · nullable
packageNumber string · nullable
trackingNumber string · nullable
weightKg decimal · nullable
widthCm decimal · nullable