CreatorSE.PassthroughItem Data Type

A simple warehouse product that passes through production untouched. No printing, no decoration, no sewing. Just pick from warehouse and include in the package.

The product definition lives directly in the order JSON (not in the system catalog), avoiding pollution of the complex standard product system with simple items.

Available Since
1.4.267
Properties
Name Type Description
metadata string Free-form JSON object for any additional information about the product. The system does not interpret the content — it is stored as-is and displayed to production staff. Max 10KB.

Commonly used fields:

 {
   "ean": "8590123456789",
   "productReference": "SUP-MUG-78432",
   "supplier": "MugWorld s.r.o.",
   "weight_g": 340,
   "dimensions_mm": { "width": 120, "height": 95, "depth": 82 },
   "material": "ceramic",
   "custom_fields": {
     "fragile": true,
     "packaging_note": "Wrap individually in bubble wrap"
   }
 }
previewImage string Product photo for visual identification by warehouse/production staff. Stored and rendered in the production dashboard.
  • Accepted formats: JPEG, PNG, WebP
  • Max size: 500KB after base64 encoding (~375KB original image)
  • Recommended resolution: 600×600px max
name string Human-readable product name, displayed to warehouse/production staff. Required, max 255 chars.
description string Detailed product description, handling notes, specifications. Optional, max 2000 chars.
sku string Stock Keeping Unit — unique product identifier for warehouse lookup. Required, max 100 chars.
referenceId string External reference ID — client's own product code, supplier code, or any cross-system identifier. Optional, max 100 chars.
quantity number Number of units to include in the package. Required, must be >= 1.
brand string Product brand or manufacturer name. Optional, max 100 chars.
color string Product color (e.g. "white", "black", "red"). Optional, max 50 chars.
size string Product size or variant (e.g. "330ml", "XL", "A4"). Optional, max 50 chars.
CreatorSE.PassthroughItem (JSON) 
{
  "creatorse_passthroughItem" : {
    "metadata" : "...",
    "previewImage" : "...",
    "name" : "...",
    "description" : "...",
    "sku" : "...",
    "referenceId" : "...",
    "quantity" : 12345,
    "brand" : "...",
    "color" : "...",
    "size" : "..."
  }
}
CreatorSE.PassthroughItem Data Type

A simple warehouse product that passes through production untouched. No printing, no decoration, no sewing. Just pick from warehouse and include in the package.

The product definition lives directly in the order JSON (not in the system catalog), avoiding pollution of the complex standard product system with simple items.

Available Since
1.4.267
Properties
Name Type Description
brand string Product brand or manufacturer name. Optional, max 100 chars.
color string Product color (e.g. "white", "black", "red"). Optional, max 50 chars.
description string Detailed product description, handling notes, specifications. Optional, max 2000 chars.
metadata string Free-form JSON object for any additional information about the product. The system does not interpret the content — it is stored as-is and displayed to production staff. Max 10KB.

Commonly used fields:

 {
   "ean": "8590123456789",
   "productReference": "SUP-MUG-78432",
   "supplier": "MugWorld s.r.o.",
   "weight_g": 340,
   "dimensions_mm": { "width": 120, "height": 95, "depth": 82 },
   "material": "ceramic",
   "custom_fields": {
     "fragile": true,
     "packaging_note": "Wrap individually in bubble wrap"
   }
 }
name string Human-readable product name, displayed to warehouse/production staff. Required, max 255 chars.
previewImage base64Binary Product photo for visual identification by warehouse/production staff. Stored and rendered in the production dashboard.
  • Accepted formats: JPEG, PNG, WebP
  • Max size: 500KB after base64 encoding (~375KB original image)
  • Recommended resolution: 600×600px max
quantity int Number of units to include in the package. Required, must be >= 1.
referenceId string External reference ID — client's own product code, supplier code, or any cross-system identifier. Optional, max 100 chars.
size string Product size or variant (e.g. "330ml", "XL", "A4"). Optional, max 50 chars.
sku string Stock Keeping Unit — unique product identifier for warehouse lookup. Required, max 100 chars.
CreatorSE.PassthroughItem (XML) 
<creatorse_passthroughItem>
  <metadata>...</metadata>
  <previewImage>...</previewImage>
  <name>...</name>
  <description>...</description>
  <sku>...</sku>
  <referenceId>...</referenceId>
  <quantity>...</quantity>
  <brand>...</brand>
  <color>...</color>
  <size>...</size>
</creatorse_passthroughItem>