The Craftpeak<>ShipCompliant integration Overview

The Craftpeak<>ShipCompliant integration, once configured, primarily does three things:

  1. Handles real-time tax calculations so that customers are always taxed correctly
  2. Ensures that all e-commerce orders are fully compliant by checking laws for every single product ordered in your store
  3. Sends order information to ShipCompliant so that all your compliance reporting can be done within their platform.

All of the above relies on your ShipCompliant account being set up correctly, as this integration relies on product SKUs in your ShipCompliant account matching the SKUs entered into your Craftpeak shop to determine compliance.

There are three pieces of technology at work:

1. Your Craftpeak shop

That's us!

2. Alcohol 2 Consumer ("A2C")

Alcohol 2 Consumer, owned and developed by iFuel, is the middleware technology behind this integration. The integration first sends information to Alcohol 2 Consumer which then reaches out to ShipCompliant's platform. Once you are fully onboarded you will have access to your own Alcohol 2 Consumer account.

3. ShipCompliant

ShipCompliant is the platform/technology that manages all compliance. They stay on top of every compliance law and - via A2C - will check every order's details against said laws to determine if anything is non-compliant.

Please note that Craftpeak does not manage your relationship with ShipCompliant. While we are happy to give you advice and answer your questions, ultimately it is your responsibility to ensure that your ShipCompliant account has been fully set up. Issues related to ShipCompliant should be handled by your ShipCompliant rep.

Let's walk through what each of the three major features look like:

Features

Real-Time Tax Calculation

When enabled, this feature will use your shop's tax settings to automatically calculate taxes using ShipCompliant's real-time tax calculation service. This means that no matter the fulfillment method your customers choose, they will always be automatically taxed correctly. No need to enter tax rates yourself!

Also handy: taxes will be calculated for shipping separately from products. When looking at their cart or during checkout, your customers will now see:

To ensure tax calculations are correct, make sure your shop's tax settings are configured correctly. We recommend the following settings:

Real-Time Order Compliance Check

Birthday Validation

When enabled, customers will be required to enter their birthday during checkout. If they are under 21 they will not be able to place an order.:

This setting is enabled or disabled shop-wide. If it is enabled globally, it cannot be disabled for specific product types (such as merch).

Compliance Validation

When a customer attempts to place an order, the integration will check with ShipCompliant to confirm that said order is fully compliant. If it is deemed non-compliant for any reason, the order will not be placed, and the customer will see an error message. If the customer does not understand why the order is not compliant, they can copy-paste the error message and send it to you, and you can look it up in your Alcohol 2 Consumer account to see exactly what happened.

If an order is deemed compliant, it will be placed and processed!

Order Information in ShipCompliant

A few minutes after an order has been successfully placed it will appear in your ShipCompliant account. Your ShipCompliant fulfillment workflow is likely specific to your business, but be sure to update your order's status in ShipCompliant once it has been fulfilled as this is not done automatically.

Using the Integration

In WooCommerce

Add SKUs to all products

For any products that must pass compliance (i.e. any products that you want to work within this integration), you must be sure to enter a product SKU that exactly matches the same SKU for the corresponding product in ShipCompliant. If a SKU does not match, then any time a customer orders that product, their order will fail compliance since the integration cannot find a match.

You can find a product's SKU in ShipCompliant by:

  1. Log into ShipCompliant
  2. In the top navigation bar, click Setup>Products
  3. Edit an existing product
  4. The SKU is in the "Key/SKU" field

Changes to WooCommerce orders

Your orders in WooCommerce will now have two small changes to be aware of:

  1. Taxes on products are split from taxes on shipping. Since this integration correctly taxes each at different, compliant rates, your orders will also show the correct taxes:
  2. If you mark an order as "Shipped" within ShipCompliant's platform and add a tracking number to the shipment, that tracking number will be sent back to the order in WooCommerce.

In Alcohol 2 Consumer

From your A2C dashboard you can review the details of any compliant orders (note that if you disable realtime compliance checking, non-compliant orders will also be sent to A2C). Clicking on an individual order shows typical order information, plus:

  • Customer's birthday
  • Compliance determination
  • Status of the order in WooCommerce
    • This will not update automatically, so for now it will always show the order status at the time the order was sent to A2C
  • Status of the particular order in ShipCompliant's platform
  • Details for everything that ShipCompliant check to determine compliance. See screenshot below; you can click on any one of the compliance checks to read details about the determination.

Quote Lookup

If one of your customers attempts to place an order that is not compliant, they will see an error message that gives them a "quote" number. If they provide that number to you, you can enter it in A2C's Quote Lookup field, hit "search", and then see the compliance check results for that particular order. This is very useful to understand why an order that maybe should have been compliant was deemed non-compliant, and is a way to quickly explain what happened to your customer. Since non-compliant orders are not submitted to A2C, this is the only way to review non-compliant order issues.

In ShipCompliant

Reviewing and editing orders in ShipCompliant

Once you are logged into your ShipCompliant account, you can search, view, and edit orders sent to ShipCompliant via this integration. This is where you will need to mark orders as "shipped" and add shipping tracking information so that your ShipCompliant reports are accurate. To do so:

  1. In the top navigation bar, click Orders>Search
  2. If you know an order's order number, enter it into the search bar and click "Search"
    1. Otherwise, you can search all orders by date range or by any number of filters as seen on the Search page
  3. In the search results, click on an order to expand it and review its basic details
  4. To edit or update an order, click the "More" dropdown and then click "Edit"
    1. The "More" dropdown also provides a way to print an invoice of the order by clicking "Print"
  5. On the "Edit Order" window you can edit the order's details. Note that none of the changes you make here will be sent back to WooCommerce, so you will need to update both platforms separately.
  6. To mark an order as "Shipped", scroll down to "History". Here you can change the Shipping Status.
    1. Currently, changing the Shipping Status in ShipCompliant does not change the order status in WooCommerce for a given order.
  7. To add a tracking number to an order, scroll all the way down to the "Order Information" section and add a tracking number to the Tracking Numbers field. When you save the order, the tracking number will be sent back to WooCommerce.

FAQs

What do I need to provide to Craftpeak in order to get the ShipCompliant integration working?

In order for us to configure the integration, we will need the following from you:

  • Your ShipCompliant account configured and ready to go
  • All products configured in your ShipCompliant account, with SKUs
    • We will need you to provide these SKUs to us to "link" your products in our platform to the same ones in ShipCompliant
  • The username and password to your designated ShipCompliant Web Service User account intended to be used for this integration
    • If you do not know how to create a ShipCompliant Web Service User, contact your ShipCompliant account rep
  • Your Alcohol 2 Consumer username (the email address on the account). If you do not have an Alcohol 2 Consumer account yet, please create one at https://app.alcohol2consumer.com/app/register
  • The "Tax API Username" and "Tax API Password" found in your Alcohol 2 Consumer settings (in Settings>General)
Can I enable or disable compliance checking on a per-product basis?
Not yet, no. Either every product is checked or none are. This means you need to have products configured in your WooCommerce store and your ShipCompliant account 1:1, and that SKUs must match exactly.
Do I have to have all non-alcoholic products configured in ShipCompliant?
Yes - see above! If any of your products are not in ShipCompliant, orders containing such products will fail compliance.
Can I disable birth date validation?
No - ShipCompliant requires birth date validation for all orders. See their best practices here. For the time being, this means that even if an order does not contain alcoholic products, customers must enter their birth date to confirm they are 21 or older.