Summary

Woolworths MarketPlus allows you to gain visibility on leading websites such as Big W, Woolworths, and the Everyday Rewards App, ensuring your products are seen by a diverse and active customer base.

This help guide will walk you through how you can onboard yourself on to the Woolworths MarketPlus in order to sync products, stock, orders and order updates via Shopify.

Service Fee

The first thing you need to do is to pay for the service fee to use this application.

• When you first login to https://marketplus.crescodata.com/ you will see a warning message – “Payment is required to activate your services. Click here to make your payment.”
  • The quarterly subscription is AUD$165 inc GST and will automatically be charged quarterly.
  • Service can be terminated at any time. There is no refund offered for this service.
• This is required before any services can be activated.
• Clicking the link, will take you through to a payment page.
  • Please note this is a quarterly payment, with a minimum term of 12 months.
• Once payment has been made, this will redirect you to our Branded Portal to complete setup.

Manage Billing

You can edit your credit card details by clicking on the top right icon and selecting Manage Billing.

This will direct you to a Stripe hosted page to change / update your credit card details.

It also allows you to view your previous billing history.

Settings

Connection details

Upon logging into https://marketplus.crescodata.com/, first go to “Settings” from the left navigation.

Here you will be asked to add in your connections details for Shopify and Woolworths MarketPlus. Please review the below on how you can access these details.

Woolworths MarketPlus

• Seller ID & Seller Token – This will be provided by your Woolworths MarketPlus account manager.

Shopify

• Log in to your Shopify admin account: https://www.shopify.com/login
• Click your Name –Top Right Corner.
• Select Dev Dashboard from the dropdown.
• Click on Create app
• Name the app “MarketPlus App”, then click Create.
• For the App URL add – https://marketplus.crescodata.com/ 
• Check Embed app in Shopify admin
• Then select the Webhook API version as 2025-01 from the dropdown.
• Under the Scopes box, copy and paste the below:
  • read_assigned_fulfillment_orders, write_customers, read_customers, read_fulfillments, read_inventory,read_locations, write_orders, read_orders, read_products
• Click on the Release button.
• Confirm again by clicking the Release button.
• Go to Home and click Install app at the top-right corner.
• Select the store and click Install.
• After installation, go back to the Dev Dashboard, Select the Marketplus app, then go to Settings on the left side
• Copy the Client ID and Client Secret, into the Authentication boxes within the Woolworths MarketPlus Branded portal.

Once completed, click “Next“

Products

Shopify

• Product Level Category Method – Categorisation Method is an option to define which attribute/field CrescoData should consider for taking the product category value from Shopify Payload.
  • Map from Tags – CrescoData will use the category id value from tags provided by the customer against the product.
  • Map from Metafields – CrescoData will use the category id value from meta fields name/key provided by the customer against the product.
• Pull Location Inventory Levels – If you have multiple stock locations. If selected you have the option to define what stock locations you want to use to send stock numbers to Woolworths MarketPlus.
• Pull metafields – Turn the toggle on, if you want to pull the metafields information inside the payload against the product. By default, this will be off.

Woolworths MarketPlus

• Product Sync Flags
  • Products – Whether to sync product attributes.
  • Status – Whether to update product status.
  • Stock – Whether you want to sync stock updates.
  • Price – Whether prices should be synced.
• Create Products – Whether you want to create new products into Woolworths MarketPlus.
• Next toggle both of the Shopify and Woolworths MarketPlus services from “Not Active” to “Active”.
• Click “Next”.

Orders

• Toogle both of the Shopify and Woolworths MarketPlus services from “Not Active” to “Active”.
• Sync Order Number – If yes then we will use the Woolworths MarketPlus order number. If no, we will use Shopify’s default order incremental number.
• Default Stock Fulfillment Location – The default stock location to decrement quantities from when fulfilling or refunding orders if a location mapping is not found. Defaults to the first location on your Shopify account otherwise.
• Inventory Behaviour
  • bypass: Do not claim inventory.
  • decrement_ignoring_policy: Ignore the product’s inventory policy and claim inventory.
  • decrement_obeying_policy: Follow the product’s inventory policy and claim inventory, if possible.
• Allow Cancellations – If you want to sync cancellations from Woolworths MarketPlus to Shopify or vice-versa.
• Allow Refunds – If you want to sync refunds from Woolworths MarketPlus to Shopify.
• Allow Fulfillment – If you want to sync fulfillment details from Shopify to Woolworths MarketPlus.
• Click “Save” to complete the setup.

This will schedule the download of products from Shopify. Also sync any future orders from Woolworths MarketPlus to Shopify.

Publishing products to Woolworths MarketPlus

Below is the process of how you publish products from Shopify to Woolworths MarketPlus . These steps must be taken in order for products to publish, so please follow them carefully.

Category allocation

Category mapping can be done in three different ways – Bulk Mapping, Tags or Meta Fields.

Noting that Bulk Mapping is the default allocation, with the ability to overwrite at a product level with a tag or Meta Field. This is based on the Product level Category Method selection in the Product settings.

Bulk Mapping

This allows you to map the Product Type from Shopify to an Woolworths MarketPlus category by doing the below:

• Go to “Products”
• Go to the “Mappings” tab.
• Here you will see all unique Source Categories to map to an Woolworths MarketPlus  category.
• Noting you can:
  • Filter Source Categories by keyword.
  • You can copy an Woolworths MarketPlus category mapping and paste to other Source Categories that will use the same category.
  • You can filter an Woolworths MarketPlus category by keyword or drill down.

If you want to change the category of a specific product, you can use a tag or Meta field as below which will take priority over a Bulk Mapping.

Using tags

Below is how you can create a Shopify “tag” to define what category the product should be published to in Woolworths MarketPlus.

Products will only be published to Woolworths MarketPlus, if it has one of these tags.

• Go to the “Categories” link from the left navigation.

• Click on the “Export” button to export all category.

• This will link you to “Exports” where you can download the Woolworths MarketPlus category list.

• Review the category list and find the categories most relevant to your products.

• Go into Shopify and filter on products that should go to the same Woolworths MarketPlus category. Bulk apply the tag to products in Shopify. Tag format is:

  • MP-ID_<Category ID> (Column from the category list export).

  • Example – If we want to list a product under “Appliances > Coffee Makers > Coffee Grinders” in Woolworths MarketPlus, we would apply the tag “MP-ID_2687”

     

• We will then sync the product to Woolworths MarketPlus automatically – No additional action required.

Using Meta Fields

Below is how you can create a Shopify Metafield to define what category the product should be published to in Woolworths MarketPlus.

• Under Categorisation Method select – Map From Metafields.
• Also toogle on Pull metafields

Products will only be published to Woolworths MarketPlus, if it has a value under the Metafield marketplus_category

• Go to the “Categories” link from the left navigation.

• Click on the “Export” button to export all category.

• This will link you to “Exports” where you can download the Woolworths MarketPlus category list.

• Review the category list and find the categories most relevant to your products.

• Follow the help guide HERE on how to create a Meta Field.
• Name the meta field – marketplus_category
• Once created you can go into a product and find the meta field section to add the Woolworths MarketPlus category ID.
  
  • Example – If we want to list a product under “Appliances > Coffee Makers > Coffee Grinders” in Woolworths MarketPlus, we would enter the value “2687” under the marketplus_category metafield.

Rules

• Go to Products from the left navigation.
• Then the Rules tab
• For the Cresco Attributes – This is to setup rules for common attributes like Title, Price or Stock. See examples HERE

• Go to Products from the left navigation.
• Then the Rules tab.
• And the Destination Rules sub-tab.
• Here you will see a list of all required attributes that require rules before syncing to Woolworths MarketPlus:
  • Condition
  • Weight Unit
  • Dimension Unit
  • Requires Shipping
  • Shipping Cost Category
    • 1 – If Flat fee per order.
    • 2 – If using a Custom Freight Scheme.
    • 3 – If Flat per qty.
  • Custom Freight Scheme Id – Provided by Woolworths MarketPlus team.
  • Shipping Cost Standard – If using 1 or 3 Shipping Cost Category.
  • Request Freight Quote
  • Has 48 Hours Dispatch
  • Is Direct Import
  • Delivery Time
  • Max Days For Delivery

Deactivate a product

If you have previously created a product and want to deactivate the product, you can deactivate either by:

• Removing the category tag or meta field.

Product Diagnostics

The below video explains the Diagnostic tab of the Product Sync area.

Noting that the below video portal is slightly different in that:

• Integration Diagnostics is the same as Diagnostics in the Woolworths MarketPlus portal.
• Results is the same as Sync Results in the Woolworths MarketPlus portal.

Orders

• Once an order is placed on Woolworths MarketPlus it will sync to Shopify.

  • We will use the same Shopify order sequence when creating orders.
  • If you want to reference the original Woolworths MarketPlus customer order number, this is located in the Shopify order notes.
• Orders will be auto-acknowledged back to Woolworths MarketPlus.

• You can then go into Shopify and fulfill the order, ensuring a  tracking number and carrier is added.

  • Click on “Fulfill items”
  • Add a Tracking Number and Carrier.

• This will then publish a shipment update to say the order has been fulfilled.

Order Rules

We can use this to map Shipping Carriers between Shopify and Woolworths MarketPlus:

• Go to Orders from the left navigation.
• Then the Rules tab.
• Click Add Attribute and find Shipping Provider from the dropdown and click Create Rule
• Select Map and click Add Mapping
• Here you can define the Provider from Shopify and what you want to send to Woolworths MarketPlus.
• Once mapped click Apply, then Continue and finally Save Changes

Order Diagnostics

The below video explains the Diagnostic tab of the Order Sync area.

Noting that the below video portal is slightly different in that:

• Integration Diagnostics is the same as Diagnostics in the Woolworths MarketPlus portal.
• Results is the same as Sync Results in the Woolworths MarketPlus portal.

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.

Video Overview

Key Sync Types

Products

• 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.
• 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.
• 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.
• 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.
• 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

• 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.
• 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.
• 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.
• Order Status – A summary of orders from the last 30 days and what status they are in.
• Total New Orders This Week – Graph showing order numbers per day, over the last 7 days.
• 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.

Troubleshooting

Why is the shipping carrier name sent to Woolworths MarketPlus “Other”?

1. 1. The carrier name on the consignment note is not mapped to a Woolworths MarketPlus 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 Woolworths MarketPlus 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 Woolworths MarketPlus integration as Woolworths MarketPlus requested that non-mapped services are sent as “Other”.