Share
Explore

icon picker
SAIZ Integration Documentation

SAIZ being a holistic sizing solution requires two main integration pillars: for (1) product data to retrieve the detailed product information from the PLM/PIM systems and (2) on the PDP page for the SAIZ widget. In a first step, it’s integral we start with the product information, before we move on to the PDP integration.

PLM data (product integration)


1. Product data (PLM/PIM)

SAIZ requires detailed measurements from each product in the form of a graded measurement table. These data points are typically available in PLM/PIM systems (e.g. common systems are Centrics, WFX, Koppermann, etc.), that are primarily used to facilitate the data exchange between product development teams and production facilities. Given that these data points are available in each organization, it makes it the perfect base layer for SAIZ.

These PLM/PIM systems offer the option to export the data in CSV or XML files. Please export the files for all products that you want SAIZ to be active on. Those will typically be only the products that are fully developed and a certain “status” within the PLM/PIM system. Your SAIZ project team will be happy to facilitate a discovery call on this point in case there are any open questions. You can find an overview of the required data points and exemplary structure in the table below:
1
Product/PLM data
2
Product ID
Product Name
Status (active?)
Dimensions
Size
Measurements (cms/?)
Warengruppe/ Garment type (category)
3
Product A
4
Product B
5
Product c
6
There are no rows in this table

Here is another example of what data points are typically included in a graded measurement table (in this case for a pant).
Graded Measurment table for pants example.png


1.a. PLM/PIM data exchange via SFTP server

As a new client, you will be provided with login credentials for a dedicated and secure SFTP server that will be used for the product data exchange.
Depending on your product and system set-up, you have 2 options to provide the product data that will be uploaded to the SFTP server:
Single-file upload
You upload one single file including all relevant products and their detailed measurements to the SFTP server.

Multi-file upload
You upload multiple files including all relevant products and their detailed measurements to the SFTP server.
The files can also have different layouts, languages, etc., e.g. in case you have different brands or product development teams.

Depending on your IT set-up, you have 2 options to upload the product data on the SFTP server:
Automatic integration
Your IT team builds an integration to your PLM/PIM system that will automatically push the required product data files to the SFTP server on a regular basis.
Manual upload
Your dedicated product team manually uploads the files 1-2x per month to the SFTP server.


If you think that neither of those options work for you, please contact and we’ll set up a discovery call to find the best way to retrieve your product data in the most efficient way.


PDP integration (E-commerce)


2. E-comm data

For an optimal SAIZ functionality, we require 2 separate files for the e-commerce data integration:
(1) active product list and
(2) order/return feed.

The data exchange is done via CSV or XML files once before Go-live, and then on a regular basis (cadence to be defined, but we strongly recommend a 1x per month data exchange) after go-live. You can find an overview of the required data points and exemplary structure below.
If you have a feed (with link) even better, then we only need that once.
1
(1) Active product list

2
Product ID
URL (in case available)
Thumbnail URL (photo)
Product Name
Available sizes
3
Product A
4
Product B
5
Product C
There are no rows in this table

1
(2) Order/ returns data

2
Order ID
Order Date & Timestamp
User ID/ Visitor ID (sessions)
Amount (Number of products)
Product ID(s)
Order amount/ Price
Size(s) ordered
Status (returned/paid/ partially returned)
Article ID returned
return date/time
Amount (EUR) returned
3
Order A
4
Order B
5
Order C
There are no rows in this table


3. SAIZ Widget integration (using HTML code)


STEP 1
Add below script which goes to head section of HTML page.
<head>
<script src=https://saiz-recommender-staging.com/static/js/saiz-widget.js ></script>
<link href= https://saiz-recommender-staging.com/static/css/saiz-widget.css rel="stylesheet"/>
</ head >

STEP 2
Add below HTML code in the body section of HTML page.
<body>
<div id="saiz-widget-container" data-lang="{{language}}" data-brandcode="{{brandCode}}" data-productcode="{{productCode}}" data-visitorid={{username}}></div>
</body>

Et voilá. That’s it. We are of course happy to assist you at any step of the integration process, or if you have any additional questions on this documentation. Please contact us at .

3. Ongoing Data fetching

Data fetching schedule
Data source
data format
Data pull schedule
What Data
1
Return feed
url: feed (updated automatically)
first of each month (1st of July)
historic data: For the previous month (1.5-31.5)
2
E-comm feed (live products)
url: feed (updated automatically)
daily
real-time data
3
PLM data (product measurements)
files in blob storage
First of each month & 15th of each month
real-time data
There are no rows in this table

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.