Catch Account Integration

Catch Account Integration

Overview

Catch is an Australian online retailer that offers a wide range of products, including electronics, fashion, beauty, home goods, sports equipment, and more. Catch operates on a "daily deals" model, where new products are offered at discounted prices each day for a limited time. Other than daily deals, the website also features a range of products available at regular prices. Integrating Catch into your Sellercloud account allows you to seamlessly import orders and RMAs, upload tracking information, and ensure your listings are always up-to-date with the latest inventory data. This integration works through API, transmitting information between the two services via plugins and Scheduled Tasks. The communication is facilitated through Mirakl, a third-party platform. If necessary, open a ticket with Sellercloud Support to request additional customizations or other plugins for this integration. Note that these customizations are billable, and you will be provided a quote.

To have a dedicated representative complete the testing for your account and ensure that the setup is configured correctly, opt in for Premium Support.

Prerequisites

Before you can integrate Catch into Sellercloud, complete the following requirements.

We recommend creating a new Company where you will set up the Custom Company Settings and automate the plugins with Scheduled Tasks.

Sellercloud imports Mirakl orders as Website. Due to this, we generally do not recommend more than one plugin integration per company, as it may be difficult to differentiate orders coming in from multiple sales channels.

Alternatively, you can use the Plugin Wizard to simplify the setup of Channel Plugin Integrations through Scheduled Tasks. The wizard guides you through the required steps and helps you create:

Once configured, you can manage all integrations created through the wizard on the Manage Plugin Channels page. The workflow outlined below describes the manual configuration process, which does not create a plugin channel on the Manage Plugin Channels page.

Mirakl API Key

To obtain your Mirakl API key and access the integration details:

  1. Log into your Mirakl account using your Master credentials. Only the Master Account has permission to generate an API key.
  2. Click on your username at the top right corner of the dashboard.
  3. Navigate to My User Settings → API Key. If no key is present, click Generate.

Sellercloud Support

Open a ticket with Sellercloud Support and request that the following plugins be installed on your server:

Custom Company Settings

Create the following Custom Company Settings: Integration and API Configuration

Order Management

Inventory Management

Additional Settings

Custom Order Columns

Create the following Custom Order Columns:

Custom Product Columns

Create the following Custom Product Columns: Listing Management

Inventory Management

Pricing

MIRAKL_AVAILABLE_STARTED and MIRAKL_AVAILABLE_ENDED can be in the past as long as the start date is before the end date. Otherwise, Mirakl will reject the inventory and price update for the relevant product.

Offer State and Tax

Logistic and Description

Order Import

This plugin downloads Catch orders through the API and imports them as Website orders in Sellercloud. Orders will be created with the email customer_id@catch.com. The plugin will send order acceptance to Mirakl if all your ordered items have enough inventory to fulfill the order. If an item has insufficient inventory, orders will be canceled on Sellercloud and Mirakl. Note the following important details describing how the plugin interacts with orders with different statuses:

For each imported order, the ordered products must exist in Sellercloud with either the same SKU or with the Mirakl product ID in the MIRAKL_SKU custom column. Otherwise, order items will be Unknown, their inventory on hand will be considered 0, and the order will be rejected on Mirakl.

Automate Order Import

To create a Scheduled Task that regularly imports orders from Catch to Sellercloud:

  1. Go to Settings > Scheduled Tasks > Manage Scheduled Tasks.
  2. Click the green + icon: Create New Scheduled Task.
  3. Complete as follows:
    1. Click Task Type and select Import Orders.
    2. Set the Task Name.
    3. Select the Company.
    4. Select the Start Time.
  4. Click Create, and the new Scheduled Task page will load on your screen.
  5. Click the Edit button on the top right.
  6. In the Details section:
    1. Click the Create Orders For Company menu and select the company you designated for this integration.
    2. Click the Plugin menu and select Mirakl Order Import.
  7. In the Import Options section, set Import From to None.
  8. In the Frequency section, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
  9. In the General section, click the Enable toggle button.
  10. Click Save on the top right.

Tracking Export

This plugin exports the shipping carrier and tracking number and then marks the order as shipped on Mirakl. The tracking confirmation is saved to the order action documents as a TrackingUpload_PreShip. If it's successful, the plugin will skip tracking updates for this order and try sending a shipping confirmation. The shipping confirmation is saved to the order action documents as a TrackingUpload. If it's successful, the plugin will skip sending it again. Before you move on, create a Saved Search for orders filtered by:

Automate Tracking Export

To create a Scheduled Task that regularly exports order tracking from Sellercloud to Catch:

  1. Go to Settings > Scheduled Tasks > Manage Scheduled Tasks.
  2. Click the green + icon: Create New Scheduled Task.
  3. Complete as follows:
    1. Click Task Type and select Export Orders.
    2. Set the Task Name.
    3. Select the Company.
    4. Select the Start Time.
  4. Click Create, and the new Scheduled Task page will load on your screen.
  5. Click the Edit button on the top right.
  6. In the Details section:
    1. Click the User ID menu and select your ID.
    2. Click the Saved Search menu and select the saved search you created earlier.
    3. Click the Export Via menu and select Mirakl Order Tracking Export.
    4. Check Mark Orders As Exported.
    5. Check This Is Tracking Export.
  7. In the Export Options section, set Export To to None.
  8. In the Frequency section, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
  9. In the General section, click the Enable toggle button.
  10. Click Save on the top right.

Inventory Export

This plugin exports available inventory, prices, and offer start and end dates from Sellercloud to Catch. It matches products by Mirakl SKU (the Sellercloud product ID is used if Mirakl_SKU is missing). Here are some key details:

Safety Quantity Workflows

There are two Safety Quantity workflows that function as follows:

The Basic and Advanced Safety Qty workflows will never export negative values. In such a case, they will export 0 instead.

Prepare Products

Make sure to enable your products for Catch by setting their Catch_Enabled Custom Column for Products to True:

Before you move on, create a Saved Search for products filtered by Catch_Enabled– True. Optionally, you can add more filters to the search.

Unlike core integrations, plugin integrations don’t require products to be in the company where the scheduled tasks are. The export will include the products you select with your Saved Search.

Automate Inventory Export

To create a Scheduled Task that regularly exports inventory from Sellercloud to Catch:

  1. Go to Settings > Scheduled Tasks > Manage Scheduled Tasks.
  2. Click the green + icon: Create New Scheduled Task.
  3. Complete as follows:
    1. Click Task Type and select Export Products.
    2. Set the Task Name.
    3. Select the Company.
    4. Select the Start Time.
  4. Click Create, and the new Scheduled Task page will load on your screen.
  5. Click the Edit button on the top right.
  6. In the Details section:
    1. Click the User ID menu and select your ID.
    2. Click the Saved Search menu and select the saved search you created earlier.
    3. Click the Export Via menu and select the Mirakl Inventory Export Plugin.
  7. In the Export Options section, set Export To to None.
  8. In the Frequency section, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
  9. In the General section, click the Enable toggle button.
  10. Click Save on the top right.

RMA Import

This plugin downloads completed refunds from Mirakl and creates them in Sellercloud. Orders that are in process and with a closed full refund will be marked as completed.

Even though Sellercloud imports returns, you must always process them on Mirakl.

Automate RMA Import

To create a Scheduled Task that regularly imports RMAs from Catch to Sellercloud:

  1. Go to Settings > Scheduled Tasks > Manage Scheduled Tasks.
  2. Click the green + icon: Create New Scheduled Task.
  3. Complete as follows:
    1. Click Task Type and select Import RMA.
    2. Set the Task Name.
    3. Select the Company.
    4. Select the Start Time.
  4. Click Create, and the new Scheduled Task page will load on your screen.
  5. Click the Edit button on the top right.
  6. In the Details section, click the Plugin menu and select Mirakl RMA Import.
  7. In the Import Options section, set Import From to None.
  8. In the Frequency section, specify the task frequency. For optimal performance, select a range between thirty minutes and one hour.
  9. In the General section, click the Enable toggle button.
  10. Click Save on the top right.