Brandboom-Blast Ramp FAQ

Requirements

Brandboom Unlimited Yearly account
  • API Public Key
  • API Secret Key
Blast Ramp account
  • Vendor Code
  • Vendor Access Key

Integrated Components

  • Orders
  • Inventory
  • Products
  • Customers* (manual importing/exporting required)

Setting Up Credentials

  1. Contact Brandboom to enable integration for your account. Brandboom Unlimited Yearly Subscription is required for API use.
  2. Once a Brandboom customer service representative has enabled your account for integration, you will see all the information you need for integration on your Account page. Your API Public Key, API Secret Key, Account ID, etc, should now be listed under the section Integration.
  3. As the administrator of your Blast Ramp account, log into Blast Ramp and navigate to the following section: Advanced > Administration > DC Settings > Integration
  4. Locate and take note of the Vendor Code and Vendor Key under the section Web Service Credentials.
  5. Locate the section Brandboom Inventory Integration. Fill out the section as follows:
    • Brand Boom Public Key: Your API Public Key listed on your Brandboom account page.
    • Brand Boom Secrete Key: Your API Secret Key listed on your Brandboom account page.
    • Brand Boom Brand ID: *No longer required; leave blank or -1.
    • Brand Boom ShowroomID: Showroom ID listed inside of the Showroom Settings popup. API access must be enabled to see this.
    • Brand Boom Wholesale Pricelist Code: The Blast Ramp Price List that you want to use as the Brandboom wholesale price. On Brandboom, you will need to already have a Price Tier that corresponds to the same currency code.
    • Brand Boom Retail Pricelist Code: The Blast Ramp Price List that you want to use as the Brandboom retail price. On Brandboom, you will need to already have a Price Tier that corresponds to the same currency code.
    • Brand Boom Sync Mode: By default, Blast Ramp will act as the authoritative source of product information. It will push all product details to BrandBoom, overwriting any manual product changes that you might have made on BrandBoom. If you don’t want this to happen, you should change it to “Inventory Quantities Only.” This will force Blast Ramp to only update the inventory counts of products that already exist on Brandboom while not creating/modifying any products.
    • Use TEST Environment: If you’re planning to test out your account with the Brandboom sandbox environment first (brandboom.net), have this checkbox checked. For production use, make sure you uncheck this.
  6. Locate your Blast Ramp current Warehouse ID. You could find this Warehouse ID under Advanced > Administrator > DC Settings > Address Information
  7. Provide Brandboom with your Blast Ramp Vendor Code and Vendor Key and your Blast Ramp Warehouse ID.
  8. On Brandboom, update your Order Settings located on the orders page. Under Export Requirements, make sure the following items are checked off:
    • Buyer Name
    • Buyer Phone Number
    • Buyer Fax Number
    • Billing Address
    • Shipping Address

Setting Up Sizes

It’s crucial that proper size scales are set up before you can import products/orders into Blast Ramp from Brandboom. Otherwise, orders imported might have line items that have zero sizes/quantities. In Blast Ramp, navigate to: Advanced > Administration > Sizescale. Make sure there’s a size scale that already contains the sizes you have on Brandboom. If not, click new … and create a new scale with the sizes separated by commas. Save the size scale.

Setting Up Products

You can either use Brandboom or Blast Ramp as the initial source of products.

Import Products from Blast Ramp to Brandboom

  • You can initiate an automatic product push.
    1. In Blast Ramp, navigate to: Advanced > Administration > DC Settings > Integration
    2. Hit "Push Inventory Sync" and it should start pushing product information over
  • If the automated push doesn’t work for one reason or another, you can still import manually via Excel with these steps:
    1. In Blast Ramp, navigate to: Advanced > Export > Export linesheet in standard Blast Ramp format
    2. Export and download the list you wish to import into Brandboom.
    3. Open the Excel file and delete the first 5 rows (not the 6th row where the header line is)
    4. Since you can only import a pair of retail/wholesale prices at a time, delete columns of the pricelists that you don’t need to import.
    5. Rename the remaining desired retail and wholesale prices columns to Retail(USD) and Wholesale(USD) assuming that the Price Tier you have set up on Brandboom is called “USD”.
    6. On Brandboom, go to the products page, click the SKU button to open the sku list and proceed to import using the Excel sheet.
    7. Products should now be added to your showroom.
    8. To upload another set of pricelists from Blast Ramp, repeat the process but with the Wholesale and Retail columns renamed to the corresponding Price Tier name on Brandboom.

Import Products Brandboom to Blast Ramp via Excel

  1. Make sure that a Linesheet/Season has been created for Brandboom in Blast Ramp. Navigate to: Advanced > Administration > Linesheet/Seasons.
  2. Fill out the Linelist Code and Linelist Name and press create:
    Linelist CodeFALL15
    SeasonFall Collection for 2015
  3. Make sure that a Price List has been created for Brandboom for each type of pricing (ex: Wholesale, Retail) in Blast Ramp. Navigate to: Advanced > Administration > Pricelists. Click new… and fill out information for the new price list.
    IDWHSLWhile the ID doesn’t have to be the same, this set should correspond to the same Price Tier that you have created inside of Brandboom (ex: USD1). Make sure you have filled out the Brandboom Price Tier name in the Brand Boom Pricelist Wholesale Code field under the Brand Boom Inventory Integration section of your Blast Ramp setup
    DescriptionWholesale
    ISO Currency CodeUSDThis should be the currency set for this showroom in Brandboom
    IDRTLWhile the ID doesn’t have to be the same, this set should correspond to the same Price Tier that you have created inside of Brandboom (ex: USD1). Make sure you have filled out the Brandboom Price Tier name in the Brand Boom Pricelist Retail Code field under the Brand Boom Inventory Integration section of your Blast Ramp setup
    DescriptionRetail
    ISO Currency CodeUSDThis should be the currency set for this showroom in Brandboom
  4. Navigate to: Advanced > Utilities > Upload Linelist via Copy and Paste from Excel.
  5. With the products list exported from Brandboom’s Products page, paste the content into the first section. Do not include the header row.
  6. Fill out the second section as indicated below:
    FieldColumn in ExcelInstructions
    SKU1Must be in the hyphenated format of the style-option-size. If not filled out, Brandboom will automatically generate this upon product export from Brandboom
    Product Description2
    Color Description3
    Season/Linelist Code4
    Are these SKUs in apparel format (style-color-size)?YES
    UPC Code5
    Suggested Retail Price6
    Product Category 17
    Product Category 28
    Product Category 39
    Product Category 410
    Product Category 511
    WHSL*12*Assuming the name of your target wholesale price list is the WHSL price list
    RTL*13*Assuming the name of your target retail price list is the RTL price list
    Select warehouse(s) to post linesheet to:You should choose the warehouse that you have set up integration for
* Contact Blast Ramp for help should you need help locating the section

Setting Up Customers

You can import customers manually from Blast Ramp to Brandboom via Excel.
  1. In Blast Ramp, navigate to: Customers > Export Customers to Excel
  2. On Brandboom, download the Customer Import Template. Paste in the shipping formation (Ship To Name, Ship To Address, etc) from the Blast Ramp worksheet into corresponding column of the Brandboom worksheet.
  3. Fill the entire Type column of the Brandboom worksheet with “S”
  4. Proceed to import the worksheet into Brandboom
  5. Repeat the process for the billing information, except now when you import for a second time, the Type column should be “B”

General Ordering Workflow

  1. Buyer visit presentations on Brandboom, and he places his orders.
  2. Seller reviews and edits orders on Brandboom.
  3. Seller sets the order statuses to complete. Inventory counts are tentatively reserved on Brandboom.
  4. Seller has finished and finalized changes to orders.
  5. Seller sets the order statues to export. (If you have made more changes on Brandboom thereafter, you can re-upload the order to Blast Ramp by setting the order status back to complete and export again.)
  6. Orders are collected and sent to Blast Ramp every minute. If an order fails the requirements in Blast Ramp, the error is displayed in its order history on Brandboom. Alternatively, you can select orders, choose "More" and "Blast Ramp Transfer Results" on the Brandboom orders page to initiate a push of the orders to Blast Ramp. If the order is accepted, it should show up in Blast Ramp. Note that there’s a delay (up to 30 minutes) for the following fields to populate even after an order has been imported into Blast Ramp: Shipping Cost, Brandboom Credit, and Brandboom Discount fields.
  7. Seller processed and completed orders in Blast Ramp.
  8. Product and inventory information will be updated from Blast Ramp within 15 minutes.
  9. Inventory level on Brandboom should now reflect the latest counts.

Advanced Order Settings

Re-submitting specific orders to Blast Ramp
  • Should order(s) fail to transfer, you can always manually initiate the transfer again:
    1. Go to the orders page on Brandboom
    2. Select the orders
    3. Choose the "More" dropdown of the toolbar
    4. Choose "Blast Ramp Transfer Results
  • This should re-submit those orders and display the result in the popup
Passing season to Blast Ramp
  • In order for a season to show up in Blast Ramp, you must tag the order with a tag in the format of "Season: XXX" inside of Brandboom (where XXX is the name of the season). Alternatively, you can also create a custom order form field on Brandboom named "Season" and it should get passed to Blast Ramp properly.
Passing the commission rate to Blast Ramp
  • In order for the commission rate to show up in Blast Ramp, you have to create a custom order form field on Brandboom named "Commission" and it should get passed to Blast Ramp properly.

Troubleshooting

My orders that are set to export on Brandboom don’t show up in Blast Ramp.
  • Make sure you have filled out your Vendor Key, Vendor Code, and Warehouse ID on your Brandboom Account page.
  • Click on the down arrow next to the order line on the Brandboom Orders page. Check the order history to see if there were errors while the order was being transferred.
When I try to push an order to Blast Ramp, it says the order isn’t editable.
  • The order has already been set to release inside of Blast Ramp (ex: sent to warehouse); Brandboom no longer has access to modify the order.
Some of the line items of the imported orders don’t have any prices/quantities/sizes.
  • Make sure that you already have a size scale in Blast Ramp that corresponds to the sames sizes used on the order form on Brandboom. See SETTING UP SIZES on how to set up a size scale.
The season isn't showing up on my Blast Ramp.
  • In order for a season to show up in Blast Ramp, you must tag the order with a tag in the format of "Season: XXX" inside of Brandboom (where XXX is the name of the season)
The shipping Cost/Brandboom Credit/Brandboom Discount are not showing on my Blast Ramp.
  • There’s a delay for these fields to populate even after an order has been imported into Blast Ramp. These fields should show up within 15 minutes or so.
The order date shown inside of Blast Ramp is different from what it says on Brandboom.
  • The order date in Blast Ramp is when the buyer clicked on the Place Order button inside of Brandboom. However, on Brandboom, as the seller, you are allowed to change the Order Date to any date you desire. You should double-check to see if the order date has been manually updated inside of Brandboom since.
When I click “push inventory sync” on the Blast Ramp side, nothing shows up on Brandboom.
  • Make sure the Brandboom Inventory mode inside of Blast Ramp is set to “All Product Information” and not just “Inventory Only.”
  • Make sure all price lists inside of Blast Ramp have a currecy code set.
  • Make sure the Brandboom Wholesale Pricelist Code / Retail Pricelist Code inside of Blast Ramp isn't set to a price tier or currency that doesn’t exist on Brandboom.

Here you can create the content that will be used within the module.