API och integrationer Headless commerce Priser

Priser

Prices for a set of items in one call. The answer depends on the channel and on whether the session is signed in, because a signed-in customer gets their agreement prices. Do not cache the result across visitors.

2 anrop GET POST 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 /catalog/prices

Get prices for items

Returns calculated prices for a batch of items. Supports customer-specific pricing for authenticated B2B sessions via the session token. Respects channel price lists, campaigns, and quantity breaks.

Visa hela beskrivningen

Maximum 100 item ids per request; ids that cannot be parsed are skipped. With GUIDs the URL runs out before that limit does — use POST /ecom/catalog/prices for longer lists.

Frågeparametrar

Fält	Typ
`itemIds` Krävs	string

Svar

200


                      PricesResponse

Fält	Typ
`currency`	string · nullable
`prices`	ItemPrice[] · 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: 400404 Felhantering

Exempel

curl

curl "https://api.erp.fluit.cloud/ecom/catalog/prices" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web"

Svar 200

{
  "currency": "string",
  "prices": [
    {
      "itemId": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
      "listPrice": "299.00",
      "lowestPrice30Days": "299.00",
      "priceListName": "Retail 2026",
      "quantityBreaks": [
        {
          "maxQuantity": "10",
          "minQuantity": "10",
          "unitPrice": "299.00"
        }
      ],
      "source": "string",
      "unitPrice": "299.00"
    }
  ]
}

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

POST /catalog/prices

Get prices for items (ids in body)

Identical to GET /ecom/catalog/prices — same handler, same response body — but takes the item ids in a JSON body. Use it when the id list is long enough to strain the URL: with GUIDs a typical URL budget runs out around 50 ids, well below the limit of 100 that both variants enforce.

Visa hela beskrivningen

Respects channel price lists, campaigns and quantity breaks, and returns the customer's agreement prices when the session is signed in.

Body krävs

Fält	Typ	Beskrivning
`itemIds`	string(uuid)[] · nullable	Artikel-id:n att slå upp. Dubbletter tas bort; ordningen saknar betydelse.

Svar

200


                      PricesResponse

Fält	Typ
`currency`	string · nullable
`prices`	ItemPrice[] · nullable

Retry-After — Seconds to wait before retrying.

Standardfel: 400404 Felhantering

Exempel

curl

curl -X POST "https://api.erp.fluit.cloud/ecom/catalog/prices" \
  -H "Authorization: Bearer $SESSION_TOKEN" \
  -H "X-Tenant-Id: $FLUIT_TENANT_ID" \
  -H "X-Channel: web" \
  -H "Content-Type: application/json" \
  -d @body.json

Svar 200

{
  "currency": "string",
  "prices": [
    {
      "itemId": "0f8b2c1e-4d3a-4b7e-9f10-2a6c5d8e1b44",
      "listPrice": "299.00",
      "lowestPrice30Days": "299.00",
      "priceListName": "Retail 2026",
      "quantityBreaks": [
        {
          "maxQuantity": "10",
          "minQuantity": "10",
          "unitPrice": "299.00"
        }
      ],
      "source": "string",
      "unitPrice": "299.00"
    }
  ]
}

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.

ItemPrice


                      ItemPriceResponse

Fält	Typ
`itemId`	string(uuid)
`listPrice`	decimal · nullable
`lowestPrice30Days`	decimal · nullable
`priceListName`	string · nullable
`quantityBreaks`	QuantityBreak[] · nullable
`source`	string · nullable
`unitPrice`	decimal

QuantityBreak


                      QuantityBreakResponse

Fält	Typ
`maxQuantity`	decimal · nullable
`minQuantity`	decimal
`unitPrice`	decimal