When creating a print-on-demand order item, the caller needs to communicate both what item blank is being used as well as what decoration is being applied. Each of these can be done in different ways depending on what the calling system can support.
Item Blank
For the blank, either a GTIN (Global Trade Item Number) or the Fulfill Engine SKU id must be provided. These values should be set via the order item group's sku
or gtin
property respectively, but only one should be supplied.
Fulfill Engine manages a catalog of styles and SKUS for supported print-on-demand products. Because this is a large dataset, a CSV can be downloaded with these SKU ids as well as associated ids from other vendors. This can be used to map the SKUs to your internal system and place ordered. The Catalog Product SKUs CSV endpoint can be used to obtain the latest copy of this CSV. It will return a URL to a temporary blob storage access URL to download the CSV.
Item Decoration
The decoration information is provided either by specifying a designId
or inline via the designData
property, which contains an array property called artwork
. Each artwork
represents a decoration that should be applied to the blank product. The most important field in the artwork is originalFileUrl
, which should be a URL to the image to be printed
Artwork placement
Artwork placement information is critical. It is required for the decorator to place the item properly on the product.
The system supports several different approaches to conveying the placement information, depending on what may be available in the calling system. Read more about artwork placement here.
Decoration methods
The last key piece in describing the decoration is the method being used.
printingMethod
- Required. Allowed values:dtf
,dtg
,embroidery
,engraving
,uv