Technical Documentation of Spartoo marketplace

Presentation

This document was written to help guide you through the process of integrating your merchant website on Spartoo.

  1. The first step consists of choosing a product integration method

  2. The second step consists of choosing how you are going to retrieve the orders generated by Spartoo

To build your product flux and manage your orders, you can see the different codes used on Spartoo here:
> See all provisioning codes

Choosing your product integration method

We provide multiple integration methods:
  • Integration by CSV or XML flux
  • Integration by webservice

Integration by CSV or XML flux

With this method, you must provide us with a URL that links to a file which contains all the information about your products.

The file should be either in CSV format or XML format.

In both cases, the file format is not imposed, but it must contain all of the information about the products.

After the file has been integrated, your product information will be automatically uploaded in approximately one time per hour. The product information will then be automatically updated on Spartoo.

One of the benefits of this system is that it is very easy to set up.
One of the inconveniences of this system is that the information is not updated in real time.

> More information

Webservice integration

The Spartoo marketplace webservices allow you to update, in real time, our database from your servers.

They allow you to create / modify products, receive orders and returns.

For products, there are 3 webservices:
- one for product creation and modification
- one for updating stock
- one for verifying the state of a product on the website

The advantage of this solution is that it allows you to update product information in real time.
A disadvantage is that you must anticipate additional changes to integrate the webservice.

> More information

Configuration of sales and discounts


To register a discount for your products, here you will find all the necessary information

Choosing an order integration method

Just like product integration, there are two methods for integrating orders.
  1. The first consists of going into the backoffice and manually retrieving the orders.
    > See list of orders
  2. The second, more automated method, has the orders retrieved directly by the webservices.
    > More information