1. Home
  2. »
  3. Documentation
  4. »
  5. Channel Guide
  6. »
  7. Maropost MyDeal App

Maropost MyDeal App

SUMMARY

MyDeal is Australia’s most trusted online marketplace, giving our customers the best products from their favourite retailers, all in one place.

https://www.mydeal.com.au 

Connecting to MYDEAL via Maropost Commerce Cloud 

Customers of Maropost Commerce Cloud can connect to MyDeal using the MyDeal Addon App (powered by CrescoData) available in the Maropost Commerce Cloud Add-on Store.

If you require support on how to connect your Maropost Commerce Cloud account to MyDeal, please visit the Maropost Commerce Cloud support page – https://www.netohq.com/support/s/ask-us


Overview

The MyDeal addon allows you to sell products on MyDeal.com.au while taking advantage of Maropost Commerce Cloud’s powerful back-end system for order management.

Orders placed on MyDeal.com.au are downloaded into Maropost Commerce Cloud for processing. Once they are dispatched, Maropost Commerce Cloud sends the status back to your website so that customers are notified of fulfilment and can track the delivery.

In addition, stock levels maintained in Maropost Commerce Cloud are automatically synced to MyDeal.com.au.

Setup Video


Connect Maropost Commerce Cloud (neto) to MYDEAL

  1. In your Maropost Commerce Cloud (neto) control panel, select the Addons menu.
  2. Locate the MyDeal addon in the Sales Channels section and click the Install button.
  3. Confirm any additional costs by clicking the Install and Confirm button.
  4. This will redirect you to the MyDeal app to configure your setup.
  5. The MyDeal App is powered by CrescoData, so you will first need to accept their terms of service and privacy policies.


Sync Timing

Products, Orders and Order Status are synced every 10 minutes.


Product Settings



Connection details

This information would have been provided by MyDeal, upon acceptance of your merchant account. If you do not have these details please contact your MyDeal account manager.


Image Mappings

The mapping of how you want to order Maropost Commerce Cloud (neto) images to MyDeal images. MyDeal has a limit of 30 images per product, with a maximum of 15 images per variant.


Product Details
  1. Categorisation Method – What Maropost Commerce Cloud (neto) product category should be used to map to a MyDeal category.
    1. Map From Content Type – The Maropost Commerce Cloud (neto) category attribute to map to a MyDeal Category would be one of the “/_cpanel/content_types” attributes.
    2. Map From Custom Field – The Maropost Commerce Cloud (neto) category attribute to map to a MyDeal Category would be one of the “/_cpanel/miscfield_inventory” attributes.
  2. Category Attribute – This dropdown will change based on the “Categorisation Method” selected and based on what attribute is selected, this will be used to map to MyDeal categories.
  3. Description Attribute – Maropost Commerce Cloud’s (neto) description attribute to use when syncing products. Only applicable if you have a custom description attribute you want to use over the default one.
  4. Name Attribute – Maropost Commerce Cloud’s (neto) product name attribute to use when syncing products. Only applicable if you have a custom name attribute you want to use over the default one.
  5. Weight Attribute – Maropost Commerce Cloud’s (neto) weight attribute used to sync to MyDeal, if you are using a custom attribute.
  6. Condition Attribute – Maropost Commerce Cloud’s (neto) condition attribute used to sync to MyDeal – Note the values allowed are only – New, Used or Refurbished.
  7. Default Condition – The default condition to set for products, if a “Condition” attribute is not set.
Configurable Delivery Details
  1. Ships From Overseas Attribute – Maropost Commerce Cloud (neto) attribute used to sync to MyDeal, to define if the product ships from outside of Australia. Set to True or False on products page.
  2. Delivery Time Attribute – Maropost Commerce Cloud (neto) attribute text field to define shipping details – Preferred format is “_ business days.”, eg. 5 – 10 business days.
  3. Max Delivery Days Attribute – Maropost Commerce Cloud (neto) attribute used to get the products maximum delivery time (in days). Must be a positive number.
Default Shipping Cost Arrangement
  1. Shipping Category – Default shipping category for all products if “Shipping Category” attribute is not defined.
  2. Freight Scheme ID – Required for products with shipping category 2 (Custom) and applied to products if “Custom Freight Scheme ID” attribute is not defined. Custom / Maropost Commerce Cloud (neto) Freight Scheme ID will be provided by MyDeal team.
  3. Shipping Cost – A default shipping cost to apply to all products we create and update if your product does not have a Shipping Cost attribute. Required for products with shipping category 1 (Flat) or 3 (Flat Any Qty) and applied to products without a Shipping Cost Attribute (above).
  4. Maropost Commerce Cloud (neto) Shipping Category – Required for products with shipping category 2 (Custom) AND a Maropost Commerce Cloud (neto) Freight Scheme ID. Please populate with Neto’s Shipping Option ID on https:///_cpanel/ship. If left empty and “Maropost Commerce Cloud (neto) Shipping Category” attribute is not defined, MyDeal will fetch the cheapest shipping cost across all available Maropost Commerce Cloud (neto) Shipping Methods for the product.
Configurable Shipping Cost Arrangement
  1. Shipping Category Attribute – Maropost Commerce Cloud’s (neto) shipping category attribute used to sync to MyDeal, if you are using a custom attribute. Note the values accepted are only 1, 2 or 3.
      • 1 = Flat
      • 2 = Custom
      • 3 = Flat Any Qty.
  2. Custom Freight Scheme ID – A custom Neto attribute to be applied to products with shipping category 2 (Custom). Enter the FreightSchemeID provided by MyDeal team.
  3. Shipping Cost Attribute – A custom Maropost Commerce Cloud (neto) attribute to get product’s fixed shipping cost from. Required for products with shipping category 1 (Flat) or 3 (Flat Any Qty).
  4. Maropost Commerce Cloud (neto) Shipping Category Attribute – A custom Maropost Commerce Cloud (neto) attribute to be applied to products with shipping category 2 (Custom) AND a Maropost Commerce Cloud (neto) Freight Scheme ID. Please populate with Neto’s Shipping Option ID on https:///_cpanel/ship.
Price & Quantity
  1. Virtual Stock Qty – The quantity to set on the marketplace for virtual Maropost Commerce Cloud (neto) products.
  2. Stock Buffer – If set, we will subtract this amount from the available stock quantity we import from Maropost Commerce Cloud (neto) .
  3. Price Group – Maropost Commerce Cloud’s (neto) price group to use when syncing the price. You can leave this empty and enable Allow Default Price Fallback to use the default price group.
  4. Allow Default Price Fallback – Whether to fallback to the product’s default price when syncing products that do not have your selected Price Group. If false, we will raise an error instead of using the default price.
  5. Use Promo Price – Whether to sync promotional pricing from the selected Maropost Commerce Cloud (neto) price group, to MyDeal.

Order Settings



Order Status Mapping

New Orders – The status to set orders on Maropost Commerce Cloud (neto) when the order we import is not yet fulfilled.


Shipping Service Mappings

The shipment service mappings for order fulfillments. This is required so we can select the correct shipping service when fulfilling orders on the marketplace.


Configuration
  1. Maropost Commerce Cloud (neto) Payment Method – The payment method to use when creating orders on Maropost Commerce Cloud (neto).
  2. Maropost Commerce Cloud (neto) Shipping Method – The shipping method to use when creating orders on Maropost Commerce Cloud (neto). Leave blank to not set any shipping methods during order creations.
Notification Settings

Allows you to opt into receiving key email alerts that require action within the App.

  1. Notification Hour – When you would like to receive the daily email summary.
  2. Order Sync Errors – Opt in to receiving a summary of all order errors between Maropost Commerce Cloud (neto) and MyDeal.
  3. Product Sync Errors – Opt in to receiving product error notifications when publishing to MyDeal.
  4. Mapping Errors – Opt in to receiving category mapping errors that requires action.

You can unsubscribe to these notifications at any time, either within the app or via a link in the email.


Product Sync

Upon clicking “Save” on the “Settings” page, this will validate your MyDeal credentials and trigger the downloading of products from Maropost Commerce Cloud (neto) for mapping. This process will take 5-10mins, so please review after this period of time.

NOTE – All your existing MyDeal products will be deactivated, until you complete the Product mapping steps below.

Once products have been downloaded from Maropost Commerce Cloud (neto) , click “Next” from the top right.

Products will only be synced if “Approved To Show On MyDeal” is set to approved in Maropost Commerce Cloud (neto) , so please complete this step first before proceeding with Category mapping.


Category Mapping
  1. Once all products are downloaded, click “Next” from the settings page.
  2. Here we will summarise all unique Neto categories across all products under the “Source Categories” column.
  3. For every “Source Category” click into “Select Category Mapping” to select the most appropriate MyDeal category.
    1. NOTE – Click on the source category will link you to all products allocated to this Maropost Commerce Cloud (neto) category.
  4. Once all categories have been mapped, products will be synced to MyDeal.
Preview Products
  1. Once categories have been mapped you can click on the “Preview” link to review how products will look in MyDeal – This will include how product variants will be grouped and the category allocation.
  2. Under a product listing we also have two other tabs:
    • Overview – If you want to review the payloads from Neto and sent to MyDeal.
    • History Log – Provides a summary of all updates from Neto and how this then updated MyDeal. This is useful to see how stock has changed over time.
Exports

This is to show the products we have attempted to sync to MyDeal – Either successfully or unsuccessfully.

Diagnostics
  1. This tab summarises the updates we receive from MyDeal upon product sync.
  2. Clicking into a specific error category will show what the issue is for resolution. Key ones are:
    1. Category missing.
    2. Attribute missing.
    3. No images
    4. No price.
Publishing Products

If you want to republish your products after a settings change, follow the below steps:

  1. Go to the “Settings” page, change the settings required and click “Save”. This will highlight a prompt on how you can republish your products with the reflected setting.
  2. Go to the “Product Sync” page and click on the “Republish” button.
  3. This will popup a warning for you to finally click the “Re-publish” button.
  4. This will sync all updates to MyDeal.

Note – There is a daily limit on how many times you can republish.


Order Sync

Imports
  1. This will show all imports received from MyDeal and Maropost Commerce Cloud (neto) .
  2. Here you can also filter on a number of key attributes like Order # and order status. We also recommend to filter on “Integration” to see what has been imported from MyDeal or Maropost Commerce Cloud (neto) .
  3. Clicking into a specific order will show:
    1. Overview – If you want to see the last payload received from MyDeal to Maropost Commerce Cloud (neto) .
    2. History Tab – A summary of changes to the order over time.
    3. Listing – A simplified view of the order and items ordered.
Exports
  1. This will show all exports to MyDeal and Maropost Commerce Cloud (neto) .
  2. Here you can also filter on a number of key attributes like Order # and order status. We also recommend to filter on “Integration” to see what has been exported to MyDeal or Maropost Commerce Cloud (neto) .
  3. Clicking into a specific order will show:
    • Overview – If you want to see the last payload received from MyDeal to Maropost Commerce Cloud (neto) .
    • History Tab – A summary of changes to the order over time.
    • Listing – A simplified view of the order and items ordered.
Health Dashboard

The Health Dashboard is about providing transparency through a one-page summary of a merchant’s CrescoData setup, providing key actionables and a summary of performance at a glance.


Key Sync Types

Products
  1. No. of Products – Based on the number of products synced to a destination channel within the last 30 days. It is not the total number of products under your setup, only the products that have updated in the last 30 days.
  2. Percentage of Products with success – Based on a success response at a variant level as a percentage of all responses received over the past 30 days.
  3. Percentage of Products with warning  – Based on a warning response at a variant level as a percentage of all responses received over the past 30 days.
  4. Percentage of Products with error – Based on an error response at a variant level as a percentage of all responses received over the past 30 days.
  5. Error Summary – Shows all error responses by high level category, with the ability to click into each category to see what actions are required to fix the error.
Orders
  1. New Orders – Last 7 Days – Total number of orders over the last 7 days, with a comparison to the last 7 days to see if sales have increased or decreased. Both numbers are clickable to review the specific orders within each time period.
  2. New Orders – Last 30 Days – Total number of orders over the last 30 days, with a comparison to the last 30 days to see if sales have increased or decreased. Both numbers are clickable to review the specific orders within each time period.
  3. Order Value – Last 30 Days – Total order value over the last 30 days, with a comparison to the last 30 days to see if sales have increased or decreased.
  4. Order Status – A summary of orders from the last 30 days and what status they are in.
  5. Total New Orders This Week – Graph showing order numbers per day, over the last 7 days.
  6. Error Summary – Shows all error responses by high level category, with the user clicking into each to see what actions are required to fix the error.

Diagnostics

  • Will summarise the messages from MyDeal or Maropost Commerce Cloud (neto) and if any issues have occurred.
Why is the shipping carrier name sent to MyDeal “Other”?
This can be because:
  1. the carrier name on the consignment note is not mapped to a MyDeal carrier code in the Cresco Settings page
  2. or, the carrier name on the consignment note does not match an existing service/rate table in MCC (if the shipping label was not created through Maropost).
  3. IMPORTANT: if the carrier name on the consignment does match a MyDeal carrier code (e.g “Australia Post“), it still needs to exist as a service/rate table in Maropost, and be mapped in the addon’s settings page. This is specific to the MyDeal integration as MyDeal requested that non-mapped services are sent as “Other”.

Instructions to solve:

  1. Check that the shipping service on the consignment in Neto is mapped to a MyDeal supported carrier in the Cresco settings page
  2. If it’s not mapped but you can’t find that service in the Cresco settings page, then it might be that this service does not exist as a “shipping service / rate table” in Neto.
    For a shipping service to show up in the “Shipping Service / Courier Mappings” section of Cresco settings page, it needs to exist as a shipping service in Neto, under “Shipping Services & Rates”.
    When consignments are created outside Neto, for example through a CSV import or through the API (shipping aggregators such as Shippit, ReadyToShip…), the service name on the consignment may not match the name of an existing service in Neto. What you need to do is:
    1. create a “rate table” with a name matching the “service” name seen on the consignment notes in Neto.
      For example: “Fastway Couriers”.
      Note that the point of this is not to create an actual rate schedule in Neto but just a “container” for this service so that it can be mapped to a shipping service (Fastway) on MyDeal’s side.
      To create the rate table in Neto, go through steps 1 – 4 of the below guide:
      Support Hub | Maropost Commerce Cloud
      All you really need is
      1. Name: copy paste the Shippit “service” name, e.g “Fastway Couriers”;
      2. Status: Active

In Cresco, refresh the Settings page and complete the mapping for the service that you just created.