Fnac Product Module Functional Scope - IN PROGRESS
General overview of the marketplace
Fairly straightforward marketplace. Simple RESTful API with JSONs. The required calls we need to use are:
From our account, will use calls 3 different API :
- The one to gather the hierarchy (H11) -The one to gather attributes linked to hierarchy (PM11) -And a last one to gather list of value for some attributes (VL11)
From the account of the seller, we will have to use the API to send product and the fewer other to get the status of product creation.
API to send product : P41 Gather status of a product import P42 Based on the result, you have to call P44, P45, P46, P47 or P51
Flows to be used
| Product flows: | Order flows: | Other: |
|---|---|---|
| • Create Product | ||
| • Taxonomy | • | • |
Authentication - specifics
Fnac uses API KEY for the call and if we have more that one shop we have to use the shop_id. There is no sandbox thus we have to use their production end point https://fnac-dev.mirakl.net/api The API KEY is generated within the account in MIRAKL (4b06c153-26a1-41a3-8b0b-c756a7b62b7e)
Product flows - specifics
Taxonomy flows - specifics
Which returns all available values per attribute for Fnac. We have to get that data and save it in MARKETPLACE PROPERTY VALUE table in WAP with the relevant information.
Once we have save the taxonomy in WAP if we would like to update it the process should be delete the old one and get the new one. We should be able to generate category mapping files used for mapping in MIRAKL.
Other - specifics
This integration must work with the standard Fnac API integration thus some changes are required in the standard integration as well. The current calls we have are: OrdersShip - Ship ready for shipping orders OrdersGet - Get new orders OfferUpdateAbstract - Update whole offer ListingUpdate - ListingUpdate extends OfferUpdateAbstract ItemQuantityUpdate - Stock updates ItemPriceUpdate - Price updates FeedResultGet - Get feed response
THE STATUS WE HAVE TO USE:
DefaultProduct status - Inactive Listing Status - Awaiting Creation
Product Created: Product status - Inactive Listing Status - Product created
Offer Created Product status - Active Listing Status - Product Published + Product status - Inactive Listing Status - Product Removed
End Item Product status - Inactive Listing Status - Product Published
End Listing Product status - Inactive Listing Status - Product Removed
Offer Update - Product status - Inactive Listing Status - Product Published + Product status - Active Listing Status - Product Published
Outstanding questions
Things which have to be discussed: Shall we still use the channel status or swap to Listing / Product Statuses? - We are migrating to Listing / Product Status instead of ChannelStatus How Fnac offers update work? Does it update products by SKU or channelItemID? Fnac are updating listings by SKU Shall we send products for creation using the Category, Attributes, Values IDs intead actual values? We will match values and send ID to MIRAKL which will automatically match the categories, attributes, values What need to be changed in the current Fnac Integration? TBA