Hoppa till innehållet

API och integrationer Referens Kanaler

English

Kanaler

Sales channels — webshops, B2B portals, marketplaces and apps — and which items are published on each, with the channel-specific texts, SEO and ordering. Channels are addressed by channelCode, publications by the pair (itemNumber, channelCode). Publishing is opt-in: an item is only part of a channel's assortment once a publication exists. A channel here carries commercial terms only — currency, warehouse, price list, order type. How the storefront looks (branding, menus, content pages) is not part of this contract.

8 anrop GET POST PATCH DELETE Bas-URL https://api.fluit.cloud/preview

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

GET /channels

List sales channels

Returns the sales channels the tenant sells through — webshops, B2B portals, marketplaces and apps — with the commercial terms that apply in each: currency, default warehouse, price list and order type.

Visa hela beskrivningen

Sorted by channel code. Filters combine with AND. Enum filters are matched case-insensitively and an unknown value returns 400. A channel carries no presentation — branding, menus and content pages are not part of this contract. What an item looks like in a channel is under GET /preview/channels/{channelCode}/items.

channels:read Paginerad

Frågeparametrar

Fält Typ Beskrivning
search string Matches channel code and name, case-insensitively and on partial words.
isActive boolean Filters on whether the channel is active.
type enum Filters on the kind of channel. B2C B2B Marketplace App
page integer Page to return, 1-based. Default 1.
pageSize integer Number of records per page. Default 50, max 200.

Svar

200 PagedResult_PublicChannelResponse

Paginerat svar: raderna nedan ligger i items[], omgivna av totalCount, page, pageSize, totalPages, hasPreviousPage och hasNextPage. Paginerad

Fält Typ Beskrivning
allowGuestPrices Krävs boolean Whether prices are shown to visitors who are not logged in.
channelCode Krävs string · nullable Stable channel code, e.g. `webshop-se`. The business key used in URLs.
createdDate Krävs string(date-time) When the channel was created (UTC).
currencyCode string · nullable Default currency as ISO 4217, e.g. `SEK`.
defaultLanguage Krävs string · nullable Default language as ISO 639-1, e.g. `sv`. Drives order confirmations and documents.
defaultPriceListCode string · nullable Code of the price list applied in this channel, when one is configured.
defaultWarehouseCode string · nullable Code of the warehouse orders in this channel are fulfilled from by default.
isActive Krävs boolean Whether the channel is active and may be sold through.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
modifiedDate string(date-time) · nullable When the channel was last changed (UTC), or null if never changed since creation.
name Krävs string · nullable Display name, e.g. "Webshop Sverige".
orderTypeCode string · nullable Code of the order type orders in this channel are created with.
type Krävs enum Sales channel kinds exposed via the Public API. Mirrors `Domain.SalesOrders.SalesChannelType` name-for-name and value-for-value so the query projections can cast directly — a cast is translatable to SQL where a switch over a helper method is not. `PublicChannelEnumParityTests` fails the build if the two ever drift apart, which is what stops a new domain value from silently serialising as a bare number. B2C B2B Marketplace App
400 ProblemDetails The type filter got a value outside its list.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl "https://api.fluit.cloud/preview/channels"
Svar 200 
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "allowGuestPrices": true,
      "channelCode": "STD",
      "createdDate": "2026-06-11T09:24:13.418",
      "currencyCode": "SEK",
      "defaultLanguage": "string",
      "defaultPriceListCode": "STD",
      "defaultWarehouseCode": "MAIN",
      "isActive": true,
      "links": {
        "self": "string"
      },
      "modifiedDate": "2026-06-11T09:24:13.418",
      "name": "Acme AB",
      "orderTypeCode": "STD",
      "type": "B2C"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137,
  "totalPages": 3
}

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

GET /channels/{channelCode}

Get a sales channel by code

Returns the commercial terms that apply when something is sold through this channel: currency, default warehouse, price list and order type. Responses carry a weak ETag; pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.

channels:read Stödjer ETag

Sökvägsparametrar

Fält Typ Beskrivning
channelCode Krävs string Code of the channel to read, e.g. webshop-se.

Svar

200 PublicChannelResponse
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
Fält Typ Beskrivning
allowGuestPrices Krävs boolean Whether prices are shown to visitors who are not logged in.
channelCode Krävs string · nullable Stable channel code, e.g. `webshop-se`. The business key used in URLs.
createdDate Krävs string(date-time) When the channel was created (UTC).
currencyCode string · nullable Default currency as ISO 4217, e.g. `SEK`.
defaultLanguage Krävs string · nullable Default language as ISO 639-1, e.g. `sv`. Drives order confirmations and documents.
defaultPriceListCode string · nullable Code of the price list applied in this channel, when one is configured.
defaultWarehouseCode string · nullable Code of the warehouse orders in this channel are fulfilled from by default.
isActive Krävs boolean Whether the channel is active and may be sold through.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
modifiedDate string(date-time) · nullable When the channel was last changed (UTC), or null if never changed since creation.
name Krävs string · nullable Display name, e.g. "Webshop Sverige".
orderTypeCode string · nullable Code of the order type orders in this channel are created with.
type Krävs enum Sales channel kinds exposed via the Public API. Mirrors `Domain.SalesOrders.SalesChannelType` name-for-name and value-for-value so the query projections can cast directly — a cast is translatable to SQL where a switch over a helper method is not. `PublicChannelEnumParityTests` fails the build if the two ever drift apart, which is what stops a new domain value from silently serialising as a bare number. B2C B2B Marketplace App
304 Tom body.
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
404 ProblemDetails No channel with that code.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl "https://api.fluit.cloud/preview/channels/{channelCode}"
Svar 200 
{
  "allowGuestPrices": true,
  "channelCode": "STD",
  "createdDate": "2026-06-11T09:24:13.418",
  "currencyCode": "SEK",
  "defaultLanguage": "string",
  "defaultPriceListCode": "STD",
  "defaultWarehouseCode": "MAIN",
  "isActive": true,
  "links": {
    "self": "string"
  },
  "modifiedDate": "2026-06-11T09:24:13.418",
  "name": "Acme AB",
  "orderTypeCode": "STD",
  "type": "B2C"
}

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

GET /channels/{channelCode}/items

List the items published on a channel

The channel's assortment: which items are published, in which order, with the channel-specific texts and SEO that override the item's own. This is the read a storefront builds its catalogue from.

Visa hela beskrivningen

Sorted by sort order, then item number and channel code. publishDate and unpublishDate are returned as stored and are not applied by this endpoint — a scheduled publication appears here before it goes live, so filter on them if you are rendering a live catalogue. Delta sync: ?modifiedSince= (ISO 8601 UTC datetime) returns records created or changed at or after that instant, and is the intended way to run an incremental sync. A change anywhere inside the record counts: editing a line moves the parent's modifiedDate too, so no change can hide below the resource level. Newly created publications are included even though they have no modifiedDate yet.

channels:read Paginerad Stödjer ?modifiedSince

Sökvägsparametrar

Fält Typ Beskrivning
channelCode Krävs string Code of the channel whose published items to list.

Frågeparametrar

Fält Typ Beskrivning
isActive boolean Filters on whether the publication is active.
isFeatured boolean Filters on whether the item is featured in the channel.
modifiedSince string(date-time) Returns only records created or changed at or after this instant (ISO 8601 UTC datetime). A change anywhere inside the record counts, including on its lines.
page integer Page to return, 1-based. Default 1.
pageSize integer Number of records per page. Default 50, max 200.

Svar

200 PagedResult_PublicItemChannelResponse

Paginerat svar: raderna nedan ligger i items[], omgivna av totalCount, page, pageSize, totalPages, hasPreviousPage och hasNextPage. Paginerad

Fält Typ Beskrivning
allowBackorder boolean · nullable Backorder override, or null to inherit from the item and then the channel.
channelCode Krävs string · nullable The channel it is published on.
createdDate Krävs string(date-time) When the publication was created (UTC).
description string · nullable Channel-specific long description, or null to use the item's own.
displayCategoryCode string · nullable Code of the category the item is displayed under here, or null to use its primary category.
isActive Krävs boolean Whether the publication is active. False hides the item without deleting the record.
isFeatured Krävs boolean Whether the item is featured in this channel.
itemNumber Krävs string · nullable The published item.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
metaDescription string · nullable SEO meta description for this channel, or null to fall back.
metaTitle string · nullable SEO meta title for this channel, or null to fall back.
modifiedDate string(date-time) · nullable When the publication was last changed (UTC), or null if never changed.
name string · nullable Channel-specific name, or null to use the item's own.
publishDate string(date-time) · nullable When the item becomes visible, or null for immediately.
shortDescription string · nullable Channel-specific short description, or null to use the item's own.
showStock Krävs boolean Whether stock is shown for this item in this channel.
slug string · nullable URL slug in this channel. Changing it creates a 301 redirect from the old one.
sortOrder Krävs integer Sort order within the channel.
stockDisplayMode enum How stock is presented for a published item. Mirrors `Domain.Ecom.StockDisplayMode` — see PublicApi.Preview.Channels.Queries.PublicSalesChannelType for why. ExactQuantity InStockOutOfStock LeadTime Hidden
unpublishDate string(date-time) · nullable When the item stops being visible, or null for never.
404 ProblemDetails No channel with that code.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl "https://api.fluit.cloud/preview/channels/{channelCode}/items"
Svar 200 
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "allowBackorder": true,
      "channelCode": "STD",
      "createdDate": "2026-06-11T09:24:13.418",
      "description": "string",
      "displayCategoryCode": "STD",
      "isActive": true,
      "isFeatured": true,
      "itemNumber": "WIDGET-A",
      "links": {
        "self": "string"
      },
      "metaDescription": "string",
      "metaTitle": "string",
      "modifiedDate": "2026-06-11T09:24:13.418",
      "name": "Widget A",
      "publishDate": "2026-06-11T09:24:13.418",
      "shortDescription": "string",
      "showStock": true,
      "slug": "string",
      "sortOrder": 42,
      "stockDisplayMode": "ExactQuantity",
      "unpublishDate": "2026-06-11T09:24:13.418"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137,
  "totalPages": 3
}

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

GET /items/{itemNumber}/channels

List the channels an item is published on

Publishing is opt-in: an item is only visible in a channel once a publication exists, so an empty list means the item is not for sale anywhere. Sorted by sort order, then item number and channel code.

Visa hela beskrivningen

Every content field is null when the channel uses the item's own value, so "not set" stays distinguishable from "set to the same text". Delta sync: ?modifiedSince= (ISO 8601 UTC datetime) returns records created or changed at or after that instant, and is the intended way to run an incremental sync. A change anywhere inside the record counts: editing a line moves the parent's modifiedDate too, so no change can hide below the resource level. Newly created publications are included even though they have no modifiedDate yet.

channels:read Paginerad Stödjer ?modifiedSince

Sökvägsparametrar

Fält Typ Beskrivning
itemNumber Krävs string Item number of the item whose publications to list.

Frågeparametrar

Fält Typ Beskrivning
isActive boolean Filters on whether the publication is active.
isFeatured boolean Filters on whether the item is featured in the channel.
modifiedSince string(date-time) Returns only records created or changed at or after this instant (ISO 8601 UTC datetime). A change anywhere inside the record counts, including on its lines.
page integer Page to return, 1-based. Default 1.
pageSize integer Number of records per page. Default 50, max 200.

Svar

200 PagedResult_PublicItemChannelResponse

Paginerat svar: raderna nedan ligger i items[], omgivna av totalCount, page, pageSize, totalPages, hasPreviousPage och hasNextPage. Paginerad

Fält Typ Beskrivning
allowBackorder boolean · nullable Backorder override, or null to inherit from the item and then the channel.
channelCode Krävs string · nullable The channel it is published on.
createdDate Krävs string(date-time) When the publication was created (UTC).
description string · nullable Channel-specific long description, or null to use the item's own.
displayCategoryCode string · nullable Code of the category the item is displayed under here, or null to use its primary category.
isActive Krävs boolean Whether the publication is active. False hides the item without deleting the record.
isFeatured Krävs boolean Whether the item is featured in this channel.
itemNumber Krävs string · nullable The published item.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
metaDescription string · nullable SEO meta description for this channel, or null to fall back.
metaTitle string · nullable SEO meta title for this channel, or null to fall back.
modifiedDate string(date-time) · nullable When the publication was last changed (UTC), or null if never changed.
name string · nullable Channel-specific name, or null to use the item's own.
publishDate string(date-time) · nullable When the item becomes visible, or null for immediately.
shortDescription string · nullable Channel-specific short description, or null to use the item's own.
showStock Krävs boolean Whether stock is shown for this item in this channel.
slug string · nullable URL slug in this channel. Changing it creates a 301 redirect from the old one.
sortOrder Krävs integer Sort order within the channel.
stockDisplayMode enum How stock is presented for a published item. Mirrors `Domain.Ecom.StockDisplayMode` — see PublicApi.Preview.Channels.Queries.PublicSalesChannelType for why. ExactQuantity InStockOutOfStock LeadTime Hidden
unpublishDate string(date-time) · nullable When the item stops being visible, or null for never.
404 ProblemDetails No item with that item number.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl "https://api.fluit.cloud/preview/items/{itemNumber}/channels"
Svar 200 
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "items": [
    {
      "allowBackorder": true,
      "channelCode": "STD",
      "createdDate": "2026-06-11T09:24:13.418",
      "description": "string",
      "displayCategoryCode": "STD",
      "isActive": true,
      "isFeatured": true,
      "itemNumber": "WIDGET-A",
      "links": {
        "self": "string"
      },
      "metaDescription": "string",
      "metaTitle": "string",
      "modifiedDate": "2026-06-11T09:24:13.418",
      "name": "Widget A",
      "publishDate": "2026-06-11T09:24:13.418",
      "shortDescription": "string",
      "showStock": true,
      "slug": "string",
      "sortOrder": 42,
      "stockDisplayMode": "ExactQuantity",
      "unpublishDate": "2026-06-11T09:24:13.418"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "totalCount": 137,
  "totalPages": 3
}

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

POST /items/{itemNumber}/channels

Publish an item on a channel

Publishing is opt-in: an item is only visible in a channel once this record exists. Every content field is an override — omit it and the channel uses the item's own value.

Visa hela beskrivningen

An item can only be published once per channel; publishing it again returns 409. Omitting the slug generates a unique one from the item's name; supplying one that another item in the channel already uses returns 409. The response body is the same representation as GET /preview/items/{itemNumber}/channels/{channelCode}; the canonical URL is returned in the Location header and in links.self.

channels:write Kräver Idempotency-Key

Sökvägsparametrar

Fält Typ Beskrivning
itemNumber Krävs string Item number of the item to publish.

Body krävs

Fält Typ Beskrivning
allowBackorder boolean · nullable Backorder override. Omit to inherit from the item, then the channel.
channelCode Krävs string Code of the channel to publish on. Required.
description string · nullable Channel-specific long description. Omit to use the item's own.
isActive boolean Whether the publication is live. Defaults to true.
isFeatured boolean Whether the item is featured here. Defaults to false.
metaDescription string · nullable SEO meta description for this channel.
metaTitle string · nullable SEO meta title for this channel.
name string · nullable Channel-specific name. Omit to use the item's own.
publishDate string(date-time) · nullable When the item becomes visible. Omit to publish immediately.
shortDescription string · nullable Channel-specific short description. Omit to use the item's own.
showStock boolean Whether stock is shown for this item here. Defaults to true.
slug string · nullable URL slug in this channel. Generated from the name if omitted.
sortOrder integer Sort order within the channel. Defaults to 0.
stockDisplayMode enum How stock is presented for a published item. Mirrors `Domain.Ecom.StockDisplayMode` — see PublicApi.Preview.Channels.Queries.PublicSalesChannelType for why. ExactQuantity InStockOutOfStock LeadTime Hidden
unpublishDate string(date-time) · nullable When the item stops being visible. Omit for never.

Svar

201 PublicItemChannelResponse
  • Location — URL of the newly created resource.
Fält Typ Beskrivning
allowBackorder boolean · nullable Backorder override, or null to inherit from the item and then the channel.
channelCode Krävs string · nullable The channel it is published on.
createdDate Krävs string(date-time) When the publication was created (UTC).
description string · nullable Channel-specific long description, or null to use the item's own.
displayCategoryCode string · nullable Code of the category the item is displayed under here, or null to use its primary category.
isActive Krävs boolean Whether the publication is active. False hides the item without deleting the record.
isFeatured Krävs boolean Whether the item is featured in this channel.
itemNumber Krävs string · nullable The published item.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
metaDescription string · nullable SEO meta description for this channel, or null to fall back.
metaTitle string · nullable SEO meta title for this channel, or null to fall back.
modifiedDate string(date-time) · nullable When the publication was last changed (UTC), or null if never changed.
name string · nullable Channel-specific name, or null to use the item's own.
publishDate string(date-time) · nullable When the item becomes visible, or null for immediately.
shortDescription string · nullable Channel-specific short description, or null to use the item's own.
showStock Krävs boolean Whether stock is shown for this item in this channel.
slug string · nullable URL slug in this channel. Changing it creates a 301 redirect from the old one.
sortOrder Krävs integer Sort order within the channel.
stockDisplayMode enum How stock is presented for a published item. Mirrors `Domain.Ecom.StockDisplayMode` — see PublicApi.Preview.Channels.Queries.PublicSalesChannelType for why. ExactQuantity InStockOutOfStock LeadTime Hidden
unpublishDate string(date-time) · nullable When the item stops being visible, or null for never.
400 ProblemDetails No channel with that code, or a field failed validation.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
404 ProblemDetails No item with that item number.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
409 ProblemDetails ItemChannel.AlreadyExists — the item is already published on that channel; patch the existing publication instead. ItemChannel.SlugNotUnique — another item in the channel already uses that slug.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl -X POST "https://api.fluit.cloud/preview/items/{itemNumber}/channels" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d @body.json
Full — channel-specific content, SEO and scheduling 
{
  "channelCode": "webshop-se",
  "isActive": true,
  "isFeatured": true,
  "metaDescription": "Proffswidget med 5 års garanti. Fri frakt över 500 kr.",
  "metaTitle": "Widget Pro 3000 | Köp online",
  "name": "Widget Pro 3000 – proffsmodell",
  "publishDate": "2026-09-15T00:00:00+02:00",
  "shortDescription": "Vår mest sålda widget.",
  "showStock": true,
  "slug": "widget-pro-3000",
  "sortOrder": 10,
  "stockDisplayMode": "InStockOutOfStock"
}
Minimal — publish with the item's own content 
{
  "channelCode": "webshop-se"
}
Svar 201 
{
  "allowBackorder": true,
  "channelCode": "STD",
  "createdDate": "2026-06-11T09:24:13.418",
  "description": "string",
  "displayCategoryCode": "STD",
  "isActive": true,
  "isFeatured": true,
  "itemNumber": "WIDGET-A",
  "links": {
    "self": "string"
  },
  "metaDescription": "string",
  "metaTitle": "string",
  "modifiedDate": "2026-06-11T09:24:13.418",
  "name": "Widget A",
  "publishDate": "2026-06-11T09:24:13.418",
  "shortDescription": "string",
  "showStock": true,
  "slug": "string",
  "sortOrder": 42,
  "stockDisplayMode": "ExactQuantity",
  "unpublishDate": "2026-06-11T09:24:13.418"
}

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

GET /items/{itemNumber}/channels/{channelCode}

Get an item's publication on a channel

Returns the channel-specific content, SEO, stock display and scheduling for one item in one channel. Every content field is null when the channel uses the item's own value. Responses carry a weak ETag; pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.

channels:read Stödjer ETag

Sökvägsparametrar

Fält Typ Beskrivning
itemNumber Krävs string Item number of the published item.
channelCode Krävs string Code of the channel it is published on.

Svar

200 PublicItemChannelResponse
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
Fält Typ Beskrivning
allowBackorder boolean · nullable Backorder override, or null to inherit from the item and then the channel.
channelCode Krävs string · nullable The channel it is published on.
createdDate Krävs string(date-time) When the publication was created (UTC).
description string · nullable Channel-specific long description, or null to use the item's own.
displayCategoryCode string · nullable Code of the category the item is displayed under here, or null to use its primary category.
isActive Krävs boolean Whether the publication is active. False hides the item without deleting the record.
isFeatured Krävs boolean Whether the item is featured in this channel.
itemNumber Krävs string · nullable The published item.
links Links Hypermedia links for a public API resource. Exposed as a computed `links` property on the public response DTOs so that create and read responses carry the same self-reference — the canonical URL is derived from the business key already present on the DTO and can never drift from the route it points at.
metaDescription string · nullable SEO meta description for this channel, or null to fall back.
metaTitle string · nullable SEO meta title for this channel, or null to fall back.
modifiedDate string(date-time) · nullable When the publication was last changed (UTC), or null if never changed.
name string · nullable Channel-specific name, or null to use the item's own.
publishDate string(date-time) · nullable When the item becomes visible, or null for immediately.
shortDescription string · nullable Channel-specific short description, or null to use the item's own.
showStock Krävs boolean Whether stock is shown for this item in this channel.
slug string · nullable URL slug in this channel. Changing it creates a 301 redirect from the old one.
sortOrder Krävs integer Sort order within the channel.
stockDisplayMode enum How stock is presented for a published item. Mirrors `Domain.Ecom.StockDisplayMode` — see PublicApi.Preview.Channels.Queries.PublicSalesChannelType for why. ExactQuantity InStockOutOfStock LeadTime Hidden
unpublishDate string(date-time) · nullable When the item stops being visible, or null for never.
304 Tom body.
  • ETag — Weak validator for this representation. Pass it back in If-None-Match to get 304 Not Modified while the record is unchanged.
404 ProblemDetails No item with that item number, no channel with that code, or the item is not published on that channel. The three are separate errors and the problem detail says which.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl "https://api.fluit.cloud/preview/items/{itemNumber}/channels/{channelCode}"
Svar 200 
{
  "allowBackorder": true,
  "channelCode": "STD",
  "createdDate": "2026-06-11T09:24:13.418",
  "description": "string",
  "displayCategoryCode": "STD",
  "isActive": true,
  "isFeatured": true,
  "itemNumber": "WIDGET-A",
  "links": {
    "self": "string"
  },
  "metaDescription": "string",
  "metaTitle": "string",
  "modifiedDate": "2026-06-11T09:24:13.418",
  "name": "Widget A",
  "publishDate": "2026-06-11T09:24:13.418",
  "shortDescription": "string",
  "showStock": true,
  "slug": "string",
  "sortOrder": 42,
  "stockDisplayMode": "ExactQuantity",
  "unpublishDate": "2026-06-11T09:24:13.418"
}

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

PATCH /items/{itemNumber}/channels/{channelCode}

Update an item's publication on a channel

Partially updates one publication. Only provided fields are updated (JSON Merge Patch semantics). Omitted fields are left unchanged. Pass null to clear a nullable field — which for the content fields means falling back to the item's own value. isActive, showStock, sortOrder and isFeatured cannot be set to null.

Visa hela beskrivningen

Unknown fields are rejected with 400, naming the field and listing the ones this endpoint accepts. Changing the slug changes the product's public URL and automatically creates a 301 redirect from the old one, so incoming links and their ranking are preserved. itemNumber and channelCode cannot be changed — they are the resource's address; moving a publication to another channel is a delete and a create.

channels:write

Sökvägsparametrar

Fält Typ Beskrivning
itemNumber Krävs string Item number of the published item.
channelCode Krävs string Code of the channel it is published on.

Body krävs

Fält Typ Beskrivning
allowBackorder boolean · nullable Backorder override. Pass `null` to inherit from the item, then the channel.
description string · nullable Channel-specific long description. Pass `null` to fall back.
displayCategoryCode string · nullable Category the item is displayed under here. Pass `null` to use its primary category.
isActive boolean · nullable Whether the publication is live.
isFeatured boolean · nullable Whether the item is featured here.
metaDescription string · nullable SEO meta description. Pass `null` to clear.
metaTitle string · nullable SEO meta title. Pass `null` to clear.
name string · nullable Channel-specific name. Pass `null` to fall back to the item's own.
publishDate string(date-time) · nullable When the item becomes visible. Pass `null` for immediately.
shortDescription string · nullable Channel-specific short description. Pass `null` to fall back.
showStock boolean · nullable Whether stock is shown for this item here.
slug string · nullable URL slug in this channel. Changing it creates a 301 redirect from the old one.
sortOrder integer · nullable Sort order within the channel.
stockDisplayMode enum How stock is presented for a published item. Mirrors `Domain.Ecom.StockDisplayMode` — see PublicApi.Preview.Channels.Queries.PublicSalesChannelType for why. ExactQuantity InStockOutOfStock LeadTime Hidden
unpublishDate string(date-time) · nullable When the item stops being visible. Pass `null` for never.

Svar

204 Tom body.
400 ProblemDetails The body is not a JSON object, contains a field this endpoint does not have, a field present in it failed validation, displayCategoryCode names a category that does not exist, or one of isActive, showStock, sortOrder and isFeatured was sent as null.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
404 ProblemDetails No item with that item number, no channel with that code, or the item is not published on that channel.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable
409 ProblemDetails ItemChannel.SlugNotUnique — another item in the channel already uses that slug.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl -X PATCH "https://api.fluit.cloud/preview/items/{itemNumber}/channels/{channelCode}" \
  -H "Content-Type: application/json" \
  -d @body.json
Svar 400 
{
  "detail": "string",
  "instance": "string",
  "status": 42,
  "title": "string",
  "type": "string"
}

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

DELETE /items/{itemNumber}/channels/{channelCode}

Unpublish an item from a channel

Removes the publication, so the item is no longer part of the channel's assortment. This discards the channel-specific content, SEO and slug along with it — to take an item out of the shop while keeping that work, patch isActive to false instead.

channels:write

Sökvägsparametrar

Fält Typ Beskrivning
itemNumber Krävs string Item number of the published item.
channelCode Krävs string Code of the channel to remove it from.

Svar

204 Tom body.
404 ProblemDetails No item with that item number, no channel with that code, or the item is not published on that channel.
Fält Typ
detail string · nullable
instance string · nullable
status integer · nullable
title string · nullable
type string · nullable

Standardfel: 401 403 Felhantering

Exempel

curl 
curl -X DELETE "https://api.fluit.cloud/preview/items/{itemNumber}/channels/{channelCode}"
Svar 404 
{
  "detail": "string",
  "instance": "string",
  "status": 42,
  "title": "string",
  "type": "string"
}

Bas-URL https://api.fluit.cloud/preview. 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.