Integration Overview
Hive's integration with WooCommerce is native, offering real-time updates via webhooks. Any update in your shop will be reflected in the Hive app a few seconds later.
How to integrate WooCommerce into Hive
To connect your WooCommerce shop to the Hive App, you will need to create a new "REST API" key in your WooCommerce Shop and share the "URL," "Customer Key," and "Customer Secret " with Hive by creating a ticket on the Hive App in your “support” page.
To create a "REST API" key in your WooCommerce, please follow the steps below:
- In Woocommerce, navigate to the WooCommerce tab, look for the Woo icon, and select "Settings"
- Navigate and click on the "Advanced" tab
- Under page set up, find the "REST API" tab
- Click on "Add key"
- Add "Hive Technologies" as a description and give "Read/Write" permissions, then click on "Generate API key"
- Please copy and send your "URL," "consumer key," and "consumer secret" to Hive by creating a ticket on the Hive App on your “support” page.
⚠️ If you’re integrating another WooCommerce shop after we started fulfilling your orders, please inform Hive via Customer Support to align on when order fulfillment should be started for this additional shop.
How to import your catalog into Hive
For Hive to know what SKUs to fulfill from a shop, mapping them to Hive SKUs is required.
After integrating your WooCommerce, your products will be imported via webhooks a few seconds later in the Hive app. Please start mapping your products in the Hive app as soon as your shop products have been imported so Hive knows what physical products to ship from orders syncing from this new shop.
For more information about how to map shop products to Hive SKUs, please click here.
How to set up Inventory sync
Hive can sync the inventory quantities back to your WooCommerce. This way, you have an accurate overview of your inventory in WooCommerce, and you can prevent overselling. The inventory numbers are synced back to WooCommerce on an hourly basis. Inventory sync will be enabled only once Hive has started fulfilling your orders. If you do not want this feature enabled, please contact Customer Support.
-
Note: inventory sync and order sync are unrelated. Without inventory sync, orders will still come into Hive. Inventory sync is dedicated to sending inventory counts back to WooCommerce.
How does tracking information get transmitted to WooCommerce?
Tracking information from the shipments will be transmitted to WooCommerce as soon as the order is marked as "shipped" in Hive. When Hive fulfills an order in the fulfillment center, we mark the order as “completed” and send the carrier name, tracking URL, and tracking number of the shipment to your WooCommerce.
Integration Details
- SKU data imported from WooCommerce
The following SKU fields are imported from WooCommerce into Hive:
- Weight
- Cost/Production Cost
- Status
The production cost is an important field to fill out in WooCommerce. Along with the HS code and the country of origin, it is needed to pass customs authorities to ship outside the EU. Without one of these fields, the order will be blocked in the Fulfillment Center until you update the SKU’s information.
- Note: The SKU fields "Country of origin" and "HS Code" aren't yet imported from WooCommerce. If you are considering shipping outside of the EU, please fill them out directly in the Hive app.
- Note: Currently, we don't import the "Barcode" (EAN) field from WooCommerce. To help us better identify your SKUs please populate these fields in the Hive App.
- Order and product sync details
Orders and product updates with the WooCommerce integration are done in real time, as the connection is made via webhooks.
These are the API Endpoints that we currently use:
GET /wp-json/wc/v3/settings/products/<id>
- To import product settings
GET /wp-json/wc/v3
- To test that the URL and API key work correctly
GET /wp-json/wc/v3/products
- To import products
GET /wp-json/wc/v3/products/<product_id>/variations
- To import variations of a product
POST /wp-json/wc/v3/products/<product_id>/variations/batch
- To update the inventory count
GET /wp-json/wc/v3/orders
- To import orders
GET /wp-json/wc/v3/orders/<id>
- To import a specific order
PUT /wp-json/wc/v3/orders/<id>
- To update the order status
GET /wp-json/wc/v3/orders/<id>/notes
- To retrieve the order notes
POST /wp-json/wc/v3/orders/<id>/notes
- To create a new order note with the tracking number/URL
GET /wp-json/wc-shipment-tracking/v3
- To detect the presence of the paid shipment tracking plugin
GET /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/
- To get all shipments
POST /wp-json/wc-shipment-tracking/v3/orders/<order_id>/shipment-trackings/
- To create a new shipment
GET /wp-json/wc/v3/webhooks
- To check if our webhook URLs are registered
POST /wp-json/wc/v3/webhooks/batch
- To register our webhook URLs, if they are missing
On this page from WooCommerce, you can find more information about the API Endpoints that we use.
- Can we enable FIFO?
We receive time and date timestamps from WooCommerce, which allows us to follow a First-in-First-out (FIFO) logic for orders imported from WooCommerce.
Not supported features
The integration currently does not support the following features:
- Batch tracking information transfer from Hive to WooCommerce
- Serial number tracking information transfer from Hive to WooCommerce
- Document uploading from WooCommerce to Hive for B2B orders You can alternatively add documents manually in the Hive app. All steps are explained in this FAQ.
- Announcing Restocking Shipments
-
Marking items “on hold” in WooCommerce
- You can alternatively use the “order actions” in the Hive App to mark orders “on hold”
Uninstallation Guide
You can revoke our API key from your WooCommerce to end our collaboration. To do so, follow the following steps:
- In Woocommerce, navigate to the WooCommerce tab, look for the Woo icon, and select "Settings"
- Navigate and click on the "Advanced" tab
- Under page set up, find the "REST API" tab
- Find the "Hive Technologies" key
- Click on "Revoke"