A product is an item sold by your organization and thus being the building block of an order. Product data is important for ensuring the accuracy of various Skrym
functionality such as optimization and shipping cost calculations.

It is important to ensure that the data provided is accurate and up-to-date.
Warnings will be displayed in  for products that have suspected data quality issues, such as:

One or more dimensions are 0
The weight is 0
The product has an abnormal density or suspicious dimensions (e.g. 1x1x1 mm)

We recommend continously monitoring and adjusting such cases since they may cause issues otherwise.

Below follows a more detailed description of the product object and the available endpoints.
Fetch products
The GetProductByExternalId function retrieves a product using its external ID, e.g. a SKU.

Insert / update products
The UpsertProducts function is designed to insert new products or update existing ones, based on the provided product details.
It accepts a list of products, each with unique identifiers and various attributes, returning a count of successfully updated or inserted products.
It requires each product to have a mandatory externalId and non-negative dimensions for successful processing.

It is also possible to insert products in bulk by uploading a CSV file on .
This is still an experimental feature and comes with some requirements:

File format must be CSV
Units must be millimeters (mm) and grams (g)
The first row must contain the column names

Note that doing this will overwrite any existing data in the system, so make sure to only upload correct data, or to properly test in a sandbox environment first.

Products

At Skrym, we prioritize the safety of your fragile products by ensuring space for padding material in your packages. Here's how you can leverage our system to ensure your products stay in pristine condition during transit. 🏭🔍
Configuring Fragility for Optimum Protection
🛡️ To configure the fragility levels, follow these two essential steps:


Define Fragility Indices and Padding Materials 📊
Begin by adding data about fragility indices, including the type and thickness of the padding material needed for secure packaging.
Here it is important to remember that the specified paddingThickness applies to all sides of the product.
Support for fragile object padding is only for regular products for now. Padding for irregular shapes, textiles and stackable products will be supported shortly.


Associate Fragility Indices with Products 🔗
Next, link the defined fragility indices with the specific products they are associated with for seamless packing operations.


Ways to Configure:
On Scope:
Visit the  and fill out the form with the fragility index details you use.


Register Fragility Data 🖊️



Access All Fragility Data 👁️



Update Product Fragility Indices 🔄



Insert New Products with Fragility Data 🆕




For more details and step-by-step guides, contact our support team for personalized assistance. 📚👩‍💻

Fragility

Configurability of different product attributes

At Skrym, we provide you with the flexibility to configure various attributes of your products to ensure that they are packed and shipped efficiently. Here's how you can leverage our system to customize your products according to your requirements.
Supported Product Attributes
| Attribute | Description |
| --- | --- |
| in-box | The product can be packed in a box package. |
| in-bag | The product can be packed in a bag package. |
| digital | The product is a digital product and does not require physical packaging. |
| as-is | The product is shipped as-is and does not require any additional packaging. |
Attribute Combinations
For products that have multiple attributes, you can combine them to define the packaging requirements for different scenarios. Here are some common attribute combinations and how it will affect the package recommendations provided by Skrym:
| Combination | Affect on package recommendations |
| --- | --- |
| as-is + in-box | If the products is sent alone, it is shipped as-is. If it is sent with other products, it is packed in a box. |
| as-is + empty space | If the product is sent with other products, we will try to fit the products inside the empty space of the as-is product. If they do not fit, we will pack the other products in a box and the as-is product as-is. |
| as-is + in-box + empty space | If the product is sent with other products, we will try to fit the products inside the empty space of the as-is product. If they do not fit, we will pack all the products inside a box. |
See  for more information on how empty spaces can be configured.
How to Configure
On Scope:
Visit the  and open the product to configure. Choose the attributes that apply to the product.
<IframeComponent src={"https://app.supademo.com/demo/clw4opn7926q9kzemcwimmao6"} title="Adding Product Attributes"/>
Using the API:

1. Fill the `attributes` list with appropriate values.

Attributes

At Skrym, we enhance the efficiency of shipping textiles by optimizing space with adjustable compressibility factors, reducing air and ensuring efficient transit. 🌿📦
Configuring Compressibility for Products:
🛡️ To configure the compressibility factors, follow these two essential steps:


Tag the compressible product as a textile 📊
When inserting products, tag the compressible products as textiles to enable the compressibility feature. This can be done by setting the type in the family field to textile.


Assign an appropriate compression factor 🔗
Next, add the compressibility factor to the product by setting the volumeCompressionFactor field in the family object. This factor is a decimal value in the range (-1.0, 1.0). An appropriate value for the compression factor can be determined based on the table below,


| Compression Factor                                | Compressibility      |
|---------------------------------------------------|----------------------|
| -1                                                | Incompressible       |
| Less than 0 but greater than -1     | Low compressibility  |
| 0 up to and including 1           | High compressibility |
Configure Compressibility Using our API:

Insert and Update Products with Compressibility Data 🆕



Compressibility

Stackable products are those that can be placed on top of each other, reducing the amount of space they occupy when packed.
Stackability Parameters
| Parameter           | Description                                                                 |
|---------------------|-----------------------------------------------------------------------------|
| Stacking Delta  | Determines how much each product extends beyond the one below it in the specified stacking direction (in mm). |
| Stacking Direction | The direction in which the product is stacked (0: Largest dimension, 1: Mid dimension, 2: Smallest dimension). |
Handling Stackable Products


Priority of Stackable Products:

In the case of multiple stackable and irregularly shaped products in an order, stacking is prioritized over handling them as irregular shapes.



Maximum Stack Size:

A maximum of 4 items are allowed per stack to ensure stability and optimize space usage.



Stackable products with empty spaces:

For stackable products that have been configured to have empty spaces, only the topmost product in each stack is considered to have these empty spaces.



Configure Stackability With Skrym
Using out API:

Insert and Update Products with Stackability Data



On Scope:
Visit the  and click on the product you want to add stability for. Click on Stackability and enter the required parameters.

Stackability

At Skrym, we optimize the packing and placement of products by utilizing every inch of space - including the empty spaces within the bounding box of the product.

    

Configuring Empty Space for Products:
To configure empty spaces within products, follow these essential steps:

Measure the size of the empty space 📏
Measure the Length x Width x Height of the empty spaces within the product. If there are several different empty spaces, measure each one separately since this
will allow for more accurate placement of other products within the empty space.
Configure the empty space for the product📦
This can be done through Scope, on the individual product page, or through our API.

How to Configure:
On Scope:
Visit the  and open the product to configure. Fill out the form with the empty space details you have measured.
<IframeComponent src={"https://app.supademo.com/demo/clw4nd4ci260mkzem71k1kk8a"} title="Adding Empty Space to Product"/>
Using the API:

1. Define `type` as `emptySpace` in the `family` object.
2. Fill in the `emptySpace` object with appropriate values.

    If you need any help with configuring empty spaces, do not hesitate to reach out to us at{' '}
    .


Empty Space

At Skrym, we offer a unique bundling feature that allows you to pair products that are often purchased together,
or that are efficient to pack together. Here's how you can leverage our system to enable bundling of products. 📦🔗
How it Works

A bundle is a group of products that are treated as a single unit during the Skrym optimization.
When an order is optimized, the system will see if any of the configured bundles can be created from the products in the order.
If a bundle can be created, the system will optimize it together with the other products in the order.

Ways to Configure:
On Scope:
Visit the  and configure a new bundle by pressing the "Add product" button.
Using API:


Register Bundles 🖊️



Access All Bundles 👁️




Bundling

Handle products that can be folded, such as textiles

Skrym has full support for products that are folded before they are packed for shipping. This can be helpful in a few different scenarios:

Cut-to-order textile pieces that are then folded before packing
Textile products that only have their "folded out" dimensions available, but are folded at the warehouse.

Making a product foldable


Tag the product as a textile
When inserting products, tag the compressible products as textiles to enable the compressibility feature. This can be done by setting the type in the family field to textile.


Assign a value for the max number of folds
Next, assign a value greater than 0 for the number of folds available for the product.


If you need help with setting up foldable products, please reach out to us at 