How to migrate a CDiscount API to CDiscount V2

As part of CDiscount’s transition to Octopia, all CDiscount APIs must migrate to CDiscount V2 before March 31. This migration is required as existing CDiscount APIs will stop working after this date.

The new Octopia API improves speed and stability and provides significantly better error messages for offers and products.

Contents:

• Step 1: Find and note your seller credentials
• Step 2: Find and note your Seller ID
• Step 3: Create a new connection
• Step 4: Migrate your API
• Step 5: Map categories
• Step 6: Map attributes
• Step 7: Activate your API and resolve errors
  
  

Before you start

You’ll need:

• An Octopia seller account

Step 1: Find and note your seller credentials

1. Sign in to your Octopia seller account.
2. Open the API Credentials Management page.
3. Click ‘I’m using a Feed aggregator’ > My aggregator requires a clientId, clientSecret and SellerId.
4. Provide your client Id and a valid email address.
5. Click the checkbox to accept the Terms & Conditions.

6. Click Confirm Client Id and email.
7. Make note of your ClientId and ClientSecret, as you will need these later.
8. Click the checkbox to confirm you saved your credentials and click Proceed with seller authentication.
9. Click Yes, continue when asked to delegate your account access to the client id you provided.
   

Step 2: Find and note your seller ID

1. In your seller center, click Settings. Make note of your Seller ID, as you will need it later.

Step 3: Create a new connection

1. Navigate to [Your project] > APIs. 
2. Click +Add new API. This will redirect you to your company's connections page.
3. On the connections page, select +Add a new connection.
4. Search for the "CDiscount V2" connection by clicking through the pages and select it by clicking on it.
5. Fill in your connection details.
   1. For Label, add a descriptive name for your connection (e.g. CDiscount V2)
   2. For Client ID, fill in your client id obtained in Step 1.
   3. For Client secret, fill in your ClientSecret you obtained in Step 1.
   4. For Seller ID, fill in the Seller ID you noted from Step 2.
6. Click Connect with Cdiscount V2.

Step 4: Migrate your API

1. In [Your project], go to APIs and select [Your CDiscount API].
2. In [Your CDiscount API], go to the Settings step and click ⚠ Migrate your API.
3. In the sidebar, click APIs. You should see your new CDiscount V2 API.

Step 5: Map categories

1. In your new migrated API, go to the Categories step. 
2. Manually categorize any products that weren’t automatically migrated. 
3. Click Save.

Step 6: Map attributes

1. Go to the Build step.

2. In the ‘Shared attributes’ tab, ensure all fields marked as required by the marketplace are mapped to the appropriate field from your data. 

   1. If you’re uploading new product data that doesn’t exist on CDiscount, fill in the fields marked as Recommended.
   2. At the Shipping information section, click + Add. 
      1. At Delivery Type, make sure you’ve chosen your delivery type. You are required to have a shipping information row with the delivery type Tracked.
      2. For Shipping cost, select an appropriate field or create one if it doesn’t exist yet.

3. Click Save. 

4. Go to the ‘Attributes per category’ tab and fill in all mandatory fields.

5. Go to the Quality step. 

6. Review and resolve any items flagged with errors.

Step 7: Activate your API and resolve errors

1. When you’re ready to launch, return to the Settings step and click Activate API.
2. Click Run now to send your product listings to CDiscount. 
3. Go to the Result step to check if any products have errors. You can click on an error to get an error overview.
4. On the Attributes page, click the ‘?’ tooltip to learn more about the accepted values, or click the field and select Static values to view a list of acceptable inputs.

Step 8: Migrate your order connection

If you also have a CDiscount order connection, you’ll need to migrate it as well. 

To do this:

1. Go to Setup > Orders. In your CDiscount order connection, click Settings.
   
2. Click Upgrade your Order Connection.
3. Select the same V2 connection you used in Step 3 and click Migrate.