Functional documentation

Fulfillment feature V2 – Stock

How to manage your fulfillment stock

Warehouse Supply
Stocks
Outbound Orders
Managing Returns

Please notice : this API is for Octopia fulfillment sellers only.
you can not use it if you are a fulfilment legacy seller front Cdiscount.

API Stock Feature

The fulfillment API is designed for sellers aiming to delegate the storage of their products and the shipping of their orders.

You can use the fulfillment service to deliver to your Cdiscount customers or as a 3PL to deliver to your clients, regardless of the marketplace or your own shop.

The fulfillment API works differently for each scenario.

  • Post your products to be managed
  • Post/Retrieve supply orders and retrieve your delivery note
  • Retrieve warehouse stocks
  • Post and/or Retrieve shipping orders
  • Request a return for your customer

Endpoint

What is the fulfillment ?

In order to understand what “fulfillment” means for Octopia you can read the help center documentation. You will find :

  1. What is fulfillment (FFM) pricing and invoicing
  2. What is FFM order
  3. How to take back or yield your products
  4. How to activate/desactivate FMM product

Help center documentation

Retrieve warehouse stocks

If you are a Cdiscount seller:

Currently, stock information is available through the SOAP API (GetProductStockList), but this service will be deprecated by summer.

You will need to switch to the REST API (GET/stocks), which does not include some data:

  • IncomingShipment
  • LogisticFees
  • StockCategory
  • Warehouse
  • WarehouseCode
  • SellerReference: If you or your flow integrator use this key to display stock quantities on an external website or for quantity control at order receipt, this could be an issue. 
  • Warehouse / WarehouseCode: This could impact your inbound management for bulky products, as you won’t be able to identify whether to send quantities to the north or south warehouse.

If you are a Cdiscount seller operating in other countries (such as Spain or the United Kingdom):
You will be able to retrieve all your stock via the REST API, but with the same information limitations as described above.

If you use the fulfillment service as a 3PL:
You will be able to retrieve all your stock via the REST API (GET/stocks) as well.

=> Synchronise de sellerReference (SOAP API) to the sellerProductReference (REST API) so you retrieve the same data on both endpoint. 

How it works

REST API – GET stocks is designed specifically for sellers.

Please note: This API is suitable for all scenarios 

This API allows sellers to retrieve warehouse stocks

Examples of use cases

  • Retrieve warehouse stock without any filters 
  • Retrieve warehouse stock for a specific product (sellerProductReference or productId)
  • Retrieve warehouse stock including or not sellerProductReference
  • Retrieve warehouse stock from a specific storage country 
  • Retrieve warehouse stock that can be use for a delivery country
  • Retrieve warehouse stock that have been updated before, between or after a date time. 
  • Retrieve and sort warehouse stock by a type of quantities 

Before retrieving any stock, you need to go to theses step : 

Once your supply is receipt and treated on the warehouse , you’ll be able to retrieve your stocks. 

The API includes the following information:

  • Product identity information: productId, sellerProductReference, productCondition.
  • Quantities for a specific storageCountry (available, allocated, litigious, operation logistic, etc.)

Management rules

Regarding delivery country filters :

You will retrieve the quantities for storage country that can deliver the country you filled in deliveryCountry.  

Stock workflow

Scroll to Top