Products - Rewix dropshipping API

These methods allow to get the information of all the products available in the catalogue. APIs are designed to support XML and JSON format. API also come in multiple versions. The current version is "TEAL". The older versions are provided only to support existing customers all new customer should implement only the latest version available. Support for older format will be gradually phased out

Use

Method	Url	Format
GET	`/restful/export/api/products.xml`	XML format
GET	`/restful/export/api/products.json`	JSON format

Authentication

Remember to authenticate properly, using HTTP Basic Authentication with your API-Key as username and your password.

Query Params

Name	Description	Values	Mandatory
v	Feed version to be returned	LEGACY, TEAL	No
acceptedlocales	Locale code for languages. The comma separated list of values	it_IT, en_US, fr_FR...	Yes
since	the timestamp of the last update	ISO8601 date format	No
tag_1	product's brand	Any brand name	No
tag_4	product's category	“clothing”, “accessories”, “bags”, “cosmetics”, “underwear”, “shoes”	No
tag_26	product's gender	“kids”, “women”, “unisex”, “men”	No
tag_11	product's season	“fw” (fall/winter), “ss” (spring/summer), “all-year”	No

Response Body (XML/JSON Format)

The main tag (page) shows the information about the number of results and the pagination:

totalPages : page availability (Deprecated, always 1 to support backward compatibility)
totalNumberOfElements : product availability
pageSize : number of products per page (Deprecated, always the same as totalNumberOfElements to support backward compatibility)
currentPage : sequence number of the current page. (Deprecated, always 1 to support backward compatibility)

This tag (items) contains a collection of items, which show product's informations.

Each tag has many child elements, corresponding to a product's property. The most important ones are:

availability : product availability
brand : product brand; also available as product tag
code : product code (unique string code)
currency : currency used to show prices
id : product id (unique numeric id)
pictures : a list of the picture available for the product's models; for each picture its id, name and path are also available
intangible : true for products which do not require shipping, otherwise false.
intra ( hs in json format): intra or Harmonized System code of product
localizations ( productLocalizations in json format): (since TEAL Version) products locale-specific attributes. You may find those tags: description, productName, metaDescription, metaKeywords, metaTitle, urlKey
models : the list of all the models
name : product name
tags : a list of the tag assigned to the product
taxable : the product taxable
streetPrice : product retail price tax included
suggestedPrice : product suggested retail price tax included, may not be available on all products
weight : product weight.

Tag only available in LEGACY version. Check how to migrate to TEAL format - brand : product brand. In TEAL version use brand product tag. - descriptions : a list of the description with i18n; for each description the locale code is also available. In TEAL version you will find the description within the new localizations tag.

Each model element those attributes: - availability : model availability - backorder : model available to be order even if not available at this time - barcode : model barcode - bestTaxable : the model currently discounted taxable - code : model code - color : model color (may contain not accurate data for some product) - id : model id (unique numeric id) - lastUpdate : model last update date - size : model size. - streetPrice : model retail price tax included - suggestedPrice : model suggested retail price tax included - taxable : the model taxable - localizations : (since TEAL Version) model locale-specific attributes. You may find those tags: size, color - model : (deprecated not to be used) model name

A specific model can be identified by it's id or by product code/product id + size + color.

Response Body XML (TEAL) Example

Request example query: /restful/export/api/products.xml?acceptedlocales=en_US,it_IT&tag_5=black&v=TEAL

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<page totalPages="4" totalNumberOfElements="345" pageSize="100" lastUpdate="""2017-10- 31T14:05:12.322+01:00""" currentPage="1">
    <query/>
    <items>
        <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="product">
            <availability>74</availability>
            <bestTaxable>39.9</bestTaxable>
            <code>GD6423</code>
            <currency>EUR</currency>
            <id>82105</id>
            <pictures>
                <image>
                    <id>164457</id>
                    <url>/prod/stock_pGD6423.jpg</url>
                </image>
            </pictures>
            <intangible>false</intangible>
            <intra>64035119</intra>
            <madein>Italy</madein>
            <models>
                <model>
                    <availability>5</availability>
                    <backorder>false</backorder>
                    <barcode/>
                    <bestTaxable>39.9</bestTaxable>
                    <code>GD6423_36</code>
                    <color>black</color>
                    <id>234225</id>
                    <lastUpdate>2020-07-23T11:57:46.090+02:00</lastUpdate>
                    <localizations>
                        <color/>
                        <size/>
                    <localizations>
                    <model>36</model>
                    <size>36</size>
                    <streetPrice>159</streetPrice>
                    <suggestedPrice>79.9</suggestedPrice>
                    <taxable>39.9</taxable>
                </model>
                <model>
                ...
                </model>
            </models>
            <name>Stivaletto donna</name>
            <online>true</online>
            <localizations>
                <description>
                    <localevalue localecode="it_IT">Stivaletto donna, gambale stretch, zip frontale <br/>- 100% VERA PELLE <br/>- materiale tessile <br/>- Suola: gomma <br/>- Suola altezza: 4 cm</localevalue>
                    <localevalue localecode="en_US">Women's ankle boots, stretch shaft, front zip <br/>- 100% REAL LEATHER <br/>- textile material <br/>- Sole: rubber <br/>- Sole height: 4 cm</localevalue>
                </description>
                <metaDescription/>
                <metaKeywords/>
                <metaTitle/>
                <name/>
            </localizations>
            <streetPrice>159</streetPrice>
            <suggestedPrice>79.9</suggestedPrice>
            <tags>
                <tag>
                    <hidden>false</hidden>
                    <id>5</id>
                    <localevalue localecode="it_IT">Colore</localevalue>
                    <localevalue localecode="en_US">Color</localevalue>
                    <name>color</name>
                    <priority>0</priority>
                    <value>
                        <localevalue urlKey="nero" localecode="it_IT">Nero</localevalue>
                        <localevalue urlKey="black" localecode="en_US">Black</localevalue>
                        <value>black</value>
                    </value>
                </tag>
            </tags>
            <taxable>39.9</taxable>
            <weight>2.0</weight>
        </item>
        <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="product">...</item>
            ...
    </items>
</page>

Response Body JSON (TEAL) Example

Request example query: /restful/export/api/products.json?acceptedlocales=en_US,it_IT&tag_5=black&v=TEAL

{
    "pageItems": [
        {
            "id": 82105,
            "name": "Stivaletto donna",
            "code": "GD6423",
            "streetPrice": 159,
            "suggestedPrice": 79.9,
            "taxable": 39.9,
            "bestTaxable": 39.9,
            "currency": "EUR",
            "weight": 2,
            "availability": 74,
            "madein": "Italy",
            "hs": "64035119",
            "online": true,
            "intangible": false,
            "images": [
                {
                    "id": 164458,
                    "url": "/prod/stock_GD6423.jpg"
                }
            ],
            "models": [
                {
                    "id": 234225,
                    "model": "36",
                    "code": "GD6423_36",
                    "color": "black",
                    "size": "36",
                    "barcode": "",
                    "streetPrice": 159,
                    "suggestedPrice": 79.9,
                    "taxable": 39.9,
                    "bestTaxable": 39.9,
                    "availability": 5,
                    "backorder": false,
                    "lastUpdate": "2020-07-23T09:57:46.090087Z",
                    "modelLocalizations": {
                        "color": {},
                        "size": {}
                    }
                },
                {
                    ...
                },
            ],
            "productLocalizations": {
                "description": {
                    "it_IT": {
                        "value": "Stivaletto donna, gambale stretch, zip frontale <br/>- 100% VERA PELLE <br/>- materiale tessile <br/>- Suola: gomma <br/>- Suola altezza: 4 cm"
                    },
                    "en_US": {
                        "value": "Women's ankle boots, stretch shaft, front zip <br/>- 100% REAL LEATHER <br/>- textile material <br/>- Sole: rubber <br/>- Sole height: 4 cm"
                    }
                },
                "productName": {},
                "metaDescription": {},
                "metaKeywords": {},
                "metaTitle": {}
            },
            "tags": [
                {
                    "id": 5,
                    "name": "color",
                    "hidden": false,
                    "priority": 0,
                    "value": {
                        "value": "black",
                        "localeValues": {
                            "it_IT": {
                                "value": "Nero",
                                "urkKey": "nero"
                            },
                            "en_US": {
                                "value": "Black",
                                "urkKey": "black"
                            }
                        }
                    },
                    "localeValues": {
                        "it_IT": {
                            "value": "Colore"
                        },
                        "en_US": {
                            "value": "Color"
                        }
                    }
                },
                {
                    ...
                }
            ]
        },
        {
            ...
        }
    ],
    "totalItems": 209,
    "lastUpdate": "2020-08-03T13:48:50.910Z",
    "query": ""
}

Incremental updates(XML and JSON format)

Once you download the whole catalog, you can ask for updates only. The “since” query parameter is used to ask for quantity modifications after a given timestamp. The last update timestamp is retrieved from the “lastUpdate” attribute of the XML “page” tag or JSON root object.

Pay attention:

The update list is renewed every 3 minutes.
The modification window lasts 4 hours. If you ask for the update of the catalog called over 4 hours before, the service answer with 412 status code.
The + character is a reserved character therefor if you're writing your url manually encoding it is mandatory.

Response Body XML (LEGACY) Example

Request example query: /restful/export/api/products.xml?acceptedlocales=en_US,it_IT&tag_5=black&v=LEGACY

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<page totalPages="4" totalNumberOfElements="345" pageSize="100" lastUpdate="""2017-10- 31T14:05:12.322+01:00""" currentPage="1">
    <query/>
    <items>
        <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="product">
            <availability>74</availability>
            <bestTaxable>39.9</bestTaxable>
            <code>GD6423</code>
            <currency>EUR</currency>
            <description>Stivaletto donna, gambale stretch, zip frontale <br/>- 100% VERA PELLE <br/>- materiale tessile <br/>- Suola: gomma <br/>- Suola altezza: 4 cm</description>
            <descriptions>
                <description>
                    <description>Stivaletto donna, gambale stretch, zip frontale <br/>- 100% VERA PELLE <br/>- materiale tessile <br/>- Suola: gomma <br/>- Suola altezza: 4 cm</description>
                    <localecode>it_IT</localecode>
                </description>
                <description>
                    <description>Women's ankle boots, stretch shaft, front zip <br/>- 100% REAL LEATHER <br/>- textile material <br/>- Sole: rubber <br/>- Sole height: 4 cm</description>
                    <localecode>en_US</localecode>
                </description>
            </descriptions>
            <id>82105</id>
            <pictures>
                <image>
                    <id>164457</id>
                    <url>/prod/stock_pGD6423.jpg</url>
                </image>
            </pictures>
            <intangible>false</intangible>
            <intra>64035119</intra>
            <madein>Italy</madein>
            <models>
                <model>
                    <availability>5</availability>
                    <backorder>false</backorder>
                    <barcode/>
                    <bestTaxable>39.9</bestTaxable>
                    <code>GD6423_36</code>
                    <color>black</color>
                    <id>234225</id>
                    <lastUpdate>2020-07-23T11:57:46.090+02:00</lastUpdate>
                    <model>36</model>
                    <size>36</size>
                    <streetPrice>159</streetPrice>
                    <suggestedPrice>79.9</suggestedPrice>
                    <taxable>39.9</taxable>
                </model>
                <model>
                ...
                </model>
            </models>
            <name>Stivaletto donna</name>
            <online>true</online>
            <streetPrice>159</streetPrice>
            <suggestedPrice>79.9</suggestedPrice>
            <tags>
                <tag>
                    <hidden>false</hidden>
                    <id>5</id>
                    <name>color</name>
                    <priority>0</priority>
                    <translations>
                        <translation>
                            <description>Colore</description>
                            <localecode>it_IT</localecode>
                        </translation>
                        <translation>
                            <description>Color</description>
                            <localecode>en_US</localecode>
                        </translation>
                    </translations>
                    <value>
                        <translations>
                            <translation>
                                <description>Nero</description>
                                <localecode>it_IT</localecode>
                                <urlKey>nero</urlKey>
                            </translation>
                            <translation>
                                <description>Black</description>
                                <localecode>en_US</localecode>
                                <urlKey>black</urlKey>
                            </translation>
                        </translations>
                        <value>black</value>
                    </value>
                </tag>
                <tag>
                ...
                </tag>
            </tags>
            <taxable>39.9</taxable>
            <weight>2.0</weight>
        </item>
        <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="product">...</item>
            ...
    </items>
</page>

Keys	Action
`?`	Open this help
`←`	Previous page
`→`	Next page
`s`	Search