SecretSales User Guide
Secret Sales is a global marketplace platform based in the UK.
Secret Sales is API integrated through MIRAKL and we have to integrate the account in hemi.
The sellercentral is found on https://secretsales-prod.mirakl.net/marketplace-dashboard/
1.Account set up
There is nothing specific in the general account creation in the Main fields and Exchange Rate Calculator fields.
We have introduced a new table called SecretSales Accounts. In this table we need to put the host which is a link to the MIRAKL api - https://secretsales-prod.mirakl.net/api/ and Mirakl API KEY which is a token that needs to be generated from the seller central → click on the username(top right corner, make sure you are in the correct user if the account is a multiuser) → API key → Generate a new key.
Shop ID: This is the unique ID of the shop, if the account you are using is a multi shop account.
Once you are in the correct shop, you can get the Shop ID from My account → Settings → ID (will be in the top of the screen)
Note: We only need to add the Shop ID if the account we are using is a multishop account, if it is a single shop account, then there is no need for Shop ID to be added.
Nb! : Dont forget to add the standart tables when setting up new account : Account Sellers, Shipping Templates,Account Locations, Payments.
2.Products
There are no any required specific fields for this MP for products update. Besides the regular requried fields (marked with Red) there is a table SecretSales Product Accounts introduced which is used for promotios.
The MP supports the following status updates :
Update Price - updates both price and quantity
Update Quantity - updates both quantity and price
The fields being updated with those two updades are :
>
**List/Update the whole item** is used for two scenarios :
1. To create the product - if the product is not created on the marketplace it should be with product status awaiting creation and listing status inactive.**ChannelItemId should be empty as well**. When we raise the flag to Pending , the cron will send the product for creation to the marketplace and will change the product status to Product created.
2. To create the offer - once the product status is set to Product created, the cron will automatically raise the flag to Pending and will create the offer. *Note : product status needs to be on product created and listing status needs to be Inactive*
Once we have put the relevant status on *Pending* if successful, will change to *Not Needed* or if there is an error, it will return *Error* with the relevant error text.
**End Item** - sends 0 quantity to the marketplace and makes it OOS.
The updated fields are :
## 3. Orders
Once we download the order it will be with status Pending, we have to accept the order and send the acceptance back to the marketplace. Then SecretSales will check if payment is clear and provide us with an update. If the payment is cleared, we will update the status to ready for shipping and the order will be ready to be shipped.
## 4.Taxonomy
SecretSales uses taxonomy which can be found in table 2500 and there are some required specifics and attributes. The taxonomy can be found here :
[taxonomyExport_secret_sales_20210824_092115.csv](SecretSales%20User%20Guide%202aeaacf71bdc4976a3213d7c282fe523/taxonomyExport_secret_sales_20210824_092115.csv)
The internal validation we do is based on:
PrimaryCategoryID - Category Full Navigation Path
IS / VS Name - MP name of the attribute
IS / VS Value - MP name if any attribute properties available
**Required Item Specifics is marque!Additional required attribute are:Primary category ID (Item Account)SKU (Item)**
Title **(Item Account)**
EAN **(Item)**
Short Description 170 characters long no html **accepted (Item Account Go Sport)**
Description Long Text HTML accepted **(Item Account)**
Main Image **(Item)**
## 5. Additional details
There are currently 11 crons that are working for SecretSales :
- *listing_create - works every 15 minutes*
- *listing_response_read - works every minute*
- *offer_create - works every 15 minutes*
- *offer_update - works every 15 minutes*
- *offer_stock_price - works every 15 minutes*
- *offer_end_item - works every 15 minutes*
- *offer_read - works every 30 minutes*
- *get_orders - works on 3,13,23,33,43,53 minute*
- *get_updated_orders - 8,18,28,38,48,58*
- *accept_orders - works every 10 minutes*
- *ship_orders - works every 30 minutes*
We also have a Taxonomy cron which is only activated when needed, for example a new taxonomy to be downloaded/exported.
