In order to create a kit, all of its components must first exist. For example, if we're going to create a skateboard kit composed of a deck, trucks and wheels, the deck, the trucks and the wheels must already individually exist in SureDone and have unique GUIDs for each component.
Please note that you CANNOT include a kit or bundle inside another kit at this time. For example, if you want to create a wheel and tire kit consisting of four wheels and four tires, you cannot use a bundle of wheels and a bundle of tires to create this. Instead, you will create the kit with 4 wheels and 4 tires.
The primary steps for creating a kit are:
- Make sure each of your components exists
- Create a bulk file and fill out a row like you would for a normal product (i.e. SKU, Title, Description, etc.)
- Add two new columns - "iskit" and "kitlinks"
- Set the value of the "iskit" column to 1 for the product
- Put the components and quantities of each into the "kitlinks" column in a JSON format
- Submit the bulk file
Now comes the fun part where we actually build the kit.
If you look at our picture above of the deck, truck and wheels, you'll see that each one has a defined GUID:
- Deck - 101001079001a
- Truck - INDETRUCK
- Wheels (Package of 2) - 608ZZ
The second is (quantity 2 of INDETRUCK):
And the third one is (quantity 2 of 608ZZ):
You separate each of these elements with commas and wrap the whole thing in brackets so it looks like:
The order of these elements does not matter. The important part is associating each GUID with its correct quantity.
Note that you aren't limited to just 3 items in a kit. You can have as many as you want. We just happen to be using 3 items for our particular kit.
As we mentioned before, we're using a special format called JSON to show what goes into a kit. When you have a lot of items in your kit it may become a big jumble. 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.
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 kit. At this point there will not be an indicator that this is a kit, but this will be adjusted at a later time once we build kits and bundles into our standard user interface.