We're software that helps growing brands & retailers grow and scale. Sync, sell and ship your products and inventory on online marketplaces and storefronts faster, easier and more accurately.

Learn more now

Creating a new bundle via bulk

Creating bundles are pretty much the equivalent to creating kits. The only difference is that bundles are quantities of a single component as opposed to multiple components.

Please note that you CANNOT include a kit or bundle inside another bundle at this time. For example, if you want to create a wheel bundle consisting of four wheels, you cannot use two bundles of two wheels to create this. Instead, you will create the bundle with 4 wheels.

Also note - the stock level of a bundle is automatically determined by SureDone based upon the stock level of the bundle's components in SureDone. At this time, we ONLY use the stock field in determining this. We do not incorporate custom fields that may be used by automations or other sources for stock.

In order to create a bundle, the component included in the bundle must first exist. For example, if we're going to create a bundle of four tires, the tire needs to exist first.

The primary steps for creating a bundle are:

  1. Make sure the component exists in SureDone
  2. Create a bulk file and fill out a row like you would for a normal product(i.e. SKU, Title, Description, etc.)
  3. Add two new columns - "iskit" and "kitlinks"
  4. Set the value of the "iskit" column to 1 for the product
  5. Put the component and quantity into the "kitlinks" column in a JSON format
  6. Submit the bulk file
We'll walk you through each step here. Let's create a bundle of four tires.

Step 1

First, we make sure our component exists inside our SureDone account. It does!


Step 2

Now we need to create a bulk file containing a line for the finished product. This gets filled out just like we normally would.


Step 3

We've added "iskit" and "kitlinks" as columns to this bulk sheet (as seen above).

Step 4

Set the value of "iskit" to 1 so that SureDone knows this line represents a kit.


Step 5

Now comes the fun part where we actually build the bundle.

If you look at our picture above of the tire, you'll see its GUID is tirez-awesome-255-55-18-Z.

We need to create an entry for the kitlinks column that ties these part together with the quantity of the part. We're going to use a special format called JSON in order to do this.

This is a bit easier than kits. We only have one part, so the end entry will look like:


Breaking that down, we have an element contained within square brackets. It contains one GUID, in quotes, and one quantity. The GUID tells SureDone which of your existing components should be part of the bundle, and the quantity tells SureDone how many of that component are included in every bundle.

Unlike a kit, there is only one element in the kitlinks field above.


You wrap the whole thing in brackets so it looks like:


Note that you aren't limited to just 1 items in a bundle. If you want more, just build a kit.

As we mentioned before, we're using a special format called JSON to show what goes into a bundle. To verify that your JSON is correct, you can go to http://jsonlint.com/, paste in your complete JSON entry and click on the "Validate JSON" button at the bottom. It will then tell you whether you have an error or whether everything is great.

Also, be sure when creating your CSV files that the editor you're using isn't replacing your straight quotes (") with angled quotes. This can cause you to receive the following error: "kitlinks:96 - Incorrect format for linking items to kits, must be valid JSON" when you upload the file. If you are receiving this error and you've confirmed that the value in the kitlinks field is valid JSON, this may be an indication that something has gone wrong with the formatting of the straight quotes (") in your CSV file.

So now we're going to paste our JSON into our bulk sheet:


Now, as usual, we'll save this file as a CSV.

Step 6

Upload the bulk file to SureDone like you normally would (see Bulk Processing for more information if you haven't done bulk, or visit our online learning center for comprehensive training on bulk).



Go back into your All Products view of SureDone and you should see your new bundle. At this point there will not be an indicator that this is a bundle, but this will be adjusted at a later time once we build kits and bundles into our standard user interface.


Creating a bundle via bulk - with items already existing in SureDone.

While creating a bundle with items already existing in SureDone, you need to use the bulk file in below format (action=edit) and ensure that "Force" option is checked on Bulk upload page - while submitting your bulk file.