Skip to content

Guidelines for Product Mapping

As part of the integration process, Gelato will define what product models will be activated/available for a given Connect API account/partner.

The product model will differ slightly from product category to product category - depending on the product complexity and the number of variations that are available.

  • Each product model can be identified by a unique "modelUid";
  • Each product model has a unique list of related product attributes;
  • Each attribute has a related "value" and related "properties".

Let us use a simple product as an example - Mugs.

  • The product model is defined by the "modelUid" - in this case the value would be "mug_product"
  • The associated product attributes would be as follows:
  • "MugSize"
  • "ColorType"
  • "MugMaterial"
  • The attribute "mugSize" has the following associated "value" and "properties" (examples - depends on the mug product):
  • "value" : "11-oz"
  • "properties" :
    • "name": "ImageHeightMm","value":"100"
    • "name": "HeightMm","value":"96"
    • "name": "VolumeOz","value":"11"
    • "name": "DiameterMm","value":"80"
    • "name": "Description","value":"11 oz Mug"
    • "name": "ImageWidthMm","value": "200"

We recommend our partners to base their mapping on the "modelUid", the corresponding attributes and the related attribute values. This will always give you the basic information needed to map the product characteristics that are needed for production.

Using the a specific mug product as an example:

  • "modelUid": "mug_product"
  • "MugSize" => "value":"11-oz"
  • "ColorType" => "value":"4-0"
  • "MugMaterial" => "value":"ceramic-white"

Wood

Model Uid: "wood_print_product"

Attributes:

  • "ColorType"
  • "Orientation"
  • "WoodGrainDirection"
  • "WoodFormat"
  • "WoodProperties"

Foam

Model Uid: "foam_print_product"

Attributes:

  • "ColorType"
  • "FoamFormat"
  • "FoamProperties"
  • "Orientation"

Mugs

Model Uid: "mug_product"

Attributes:

  • "MugSize"
  • "ColorType"
  • "MugMaterial"

Metallic

Model Uid: "metallic_print_product"

Attributes:

  • "ColorType"
  • "MetallicFormat"
  • "MetallicGrainDirection"
  • "MetallicProperties" *"Orientation"

Canvas

Model Uid: "canvas_product"

Attributes:

  • "CanvasFormat"
  • "CanvasFrame"
  • "CanvasMaterial"
  • "ColorType"
  • "Orientation"

Flat Print (traditional printing of single page / non folded paper products)

Model Uid: "flat_product"

Attributes:

  • "CoatingType"
  • "ColorType"
  • "Orientation"
  • "PaperFormat"
  • "PaperType"
  • "ProtectionType"
  • "ShapeEdgeType"
  • "SpotFinishingType"
  • "Variable"

Wall Calendar (traditional printing of single page / non folded paper products)

Model Uid: "wall_calendar_product"

Attributes:

  • "BindingType"
  • "CoatingType"
  • "ColorType"
  • "Orientation"
  • "PaperFormat"
  • "PaperType"
  • "ProtectionType"

Wallpaper

Model Uid: "wallpaper_product"

Attributes:

  • "WallpaperSize"
  • "PanelsQuantity"
  • "WallpaperMounting"
  • "ColorType"
  • "PaperType"
  • "ProductStatus"
  • "PanelSize"

Phone cases

Model Uid: "phonecase_product"

Attributes:

  • "PhonecaseMaterial"
  • "ColorType"
  • "PhonecaseModel"
  • "PhonecaseFinish"

Submit Order JSON Examples

Acrylic print

Apparel print on back

Apparel print on front

Apparel print on front and back

Apparel print on front, back, left, right and inner label

Apparel print on front, left, right and back label

Apparel print on left and right

Bags print on back

Bags print on front

Bags print on front and back

Canvas

Desc calendar

Flat

Foam

Frame and flat

Metallic print

Mug

Photobook hard cover

Photobook soft cover

Photobook layflat

Wall calendar

Print on wood

Wallpaper

Phone cases - Flexi case

Phone cases - Clear case

Phone cases - Eco case

Phone cases - Slim case

Phone cases - Tough case

Mounted poster

Mounted canvas