Hoppa till innehållet

API och integrationer Headless commerce Leveranser

English

Leveranser

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

2 anrop GET Bas-URL https://api.erp.fluit.cloud/ecom

Autentisering, felkoder, rate limits, idempotens och paginering gäller alla anrop och står samlade under Kom igång.

GET /portal/shipments

List shipments

Returns a paginated list of shipments for the authenticated customer.

Frågeparametrar

Fält Typ
page integer
pageSize integer
status string

Svar

200 PortalShipmentListResponse
Fält Typ
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.

Standardfel: 401 403 Felhantering

Exempel

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"
Svar 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
}

Bas-URL https://api.erp.fluit.cloud/ecom. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

GET /portal/shipments/{id}

Get shipment detail

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

Sökvägsparametrar

Fält Typ
id Krävs string(uuid)

Svar

200 PortalShipmentDetailResponse
Fält Typ
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.

Standardfel: 401 404 Felhantering

Exempel

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"
Svar 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"
}

Bas-URL https://api.erp.fluit.cloud/ecom. Svarsexemplet är genererat ur schemat: formen stämmer, värdena är påhittade.

Scheman

Objekten som gruppens anrop refererar till. Fälttabellerna ovan går ett steg djupt och länkar hit i stället för att upprepa samma schema på varje endpoint.

PortalShipment

PortalShipmentListItem
Fält Typ
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
Fält Typ
city string · nullable
country string · nullable
name string · nullable
postalCode string · nullable
street string · nullable

PortalShipmentLine

PortalShipmentLineResponse
Fält Typ
id string(uuid)
itemName string · nullable
itemNumber string · nullable
quantity decimal
unit string · nullable

PortalShipmentPackage

PortalShipmentPackageResponse
Fält Typ
heightCm decimal · nullable
id string(uuid)
lengthCm decimal · nullable
packageNumber string · nullable
trackingNumber string · nullable
weightKg decimal · nullable
widthCm decimal · nullable