This section details the endpoints you can use to modify your package data within Skrym

Package data is one of the most important parts of logistics, it ties into costs, emissions and overall customer satisfaction.
What kinds of packaging is there? 📦
At Skrym we deal with different kinds of packaging be it regular boxes, plastic bags or height adjustable packaging with machine cutting/folding.

Fixed: Rigid packages that might have a fold/cut-down-point which we refer to as a variation
Height Adjustable: A pre-set base area with walls that are either cut or folded down to a specified height
Fully adjustable: Fully customizable per-order packaging that can create a package (within a span)
Plastic bags: Popular in fashion and pharmacies and is deformable to a certain extent
Envelopes: A little less rigid than a fixed package but slightly less deformable compared to a plastic bag

What is a package made of? 📦
The material of a package is important for both the environment and the cost of the package. Skrym works with packaging manufacturers to get the most accurate data possible.
We have broken down the material of a package into the following categories enabling you to select the correct material for your package.

Name: The name of the package material
Material type: The material type of the package, currently Skrym allows it to be one of the following materials

Cardboard This is the most common material type and is used for most packages.
Plastic Commonly used for bags
Paper Mainly used for envelopes and other paper-based packaging
Unknown: This is a default value and is selected when the material type is unknown


Recycled Percentage: This constitutes the percentage of the package that is made from recycled materials. As default we set this to 0%
CO2e: This is the amount of CO2 equivalent that is emitted when producing the package, measured in grams
Density: The density of the material, measured in kilograms per cubic meter

What fold is used for a package? 📦
The fold of a package is important for both the environment and the structural integrity of the package.
At Skrym we follow FEFCO standards for the folds of a package.

Packages

This page details the endpoints you can use to modify your fixed package data within Skrym

Package variations
Skrym allows for having multiple variations of a fixed package with the same ID. This may happen in cases where a package can be cut down at multiple known heights.
In such cases, each of the different possible heights of the package, along with the fixed length and width are represented as multiple variations of the same package with differing dimensions.
 
Each package variation may have its own alias and dimensions, but other details must be ensured to be the same across all package variations in order to guarantee meaningful results.


  
    Inserting
    Fetching
  
  
    
    In order to insert a package for your organization, you can use the following endpoint:

</TabPanel>
<TabPanel>
If you want to fetch a specific package, you can use the following endpoint:


It is also possible to fetch all your fixed packages using this endpoint:

    
  


Fixed

This page details the endpoints you can use to modify your height adjustable package data within Skrym


  Skrym uses bearer tokens to authenticate client requests. Further information
  on how users are onboarded and provided a bearer token can be found in{' '}
  .

Inserting a height adjustable package

Additional Request Information
| Data field       | Description                                                                                                                                                                                                                         |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| material       | Material the package is made of. Expects "Cardboard", "Plastic, "Paper" or "Unknown". Defaults to "Unknown" if not provided or unrecognized.                                                                                        |
| stock          | Only required if package stock keeping feature is requested.                                                                                                                                                                        |
| stockThreshold | Only required if package stock keeping, and low package alerting features are requested. Denotes the stock level at which warning emails are to be sent to subscribed users. Can set to -1 to disable alerts for specific packages. |
Ensure that minimum heights are strictly lesser than maximum heights, and that (inner) dimensions are lesser than outer dimensions.
Response
| Code                      | Description                                                  |
| ------------------------- | ------------------------------------------------------------ |
| ✅ - 200     | Successful.                                                  |
| 🚨 - 400 | Invalid argument provided.                                   |
| 🚨 - 401 | Unauthenticated user, token may not be valid or has expired. |
| 🚨 - 409 | A package with the given ID already exists.                  |
| 🚨 - 500 | Internal error, contact Skrym staff if persistent.           |
400 Response
{
  "code": "invalid_argument",
  "message": "Invalid package entered. Please retry with valid values.",
  "details": [
    "Invalid dimensions entered. Expected dimensions greater than 0.",
    "Fewer than 3 outer dimensions entered. Expected 3 outer dimensions."
  ]
}

401 Response
{
  "code": "unauthenticated",
  "message": "invalid auth param",
  "details": null
}

409 Response
{
  "code": "already_exists",
  "message": "Looks like a package with the same ID already exists in our system. Please try again with a different package.",
  "details": null
}

500 Response
{
  "code": "internal",
  "message": "Sorry, something went wrong on our side. Please try again or contact us if the issue persists.",
  "details": null
}

Height adjustment in optimization
The Skrym optimization will estimate the resulting dimensions of the package,
including the adjusted height. This is to facilitate connected calculations such
as emission and cost estimates.

  If you have one or more height adjustable packages with overlapping possible volume intervals, the Skrym optimization will choose the package with the smallest resulting volume. 
  This means that if it is possible to place the products in a package with a larger base area (but lower height) in order to get a lower volume of the resulting package, Skrym will follow such behavior.


Height adjustable

This page details the endpoints you can use to modify your fully adjustable package data within Skrym