Logiwa streamlines your warehouse management with a user-friendly self-onboarding process for sales channels. This article walks you through the prerequisites, setup, and operational rules for your BigCommerce sales channel.
Prerequisites: Creating a Store-Level API Account in BigCommerce
Before connecting BigCommerce to Logiwa, you must create a dedicated API account in your BigCommerce control panel to generate the secure credentials (Store Hash and API Key) Logiwa needs to communicate with your store.
ℹ️ Note: This setup is a one-time process and must be performed by a user with Store Owner or Admin access to your BigCommerce control panel.
Sign In to Your BigCommerce Control Panel
Log in to your BigCommerce store's admin panel.
Create a Store-Level API Account
Go to Settings > Store-level API accounts.
Click Create API Account.
Set API Scopes
Select the following OAuth Scopes for modification:
Category | Requirement | Details / Example |
Orders | modify | Read sales orders and update status / shipments. |
Products | modify | Update inventory levels and read the product catalog. |
Information & Settings | read-only | Read general store time and settings. |
Click Save.
Retrieve Your Credentials
Upon creation, BigCommerce downloads a file containing your Store Hash and API Key (Access Token).
Save the API Key securely — it is only shown once.
The Store Hash can also be found within the API path URL, for example:
https://api.bigcommerce.com/stores/{store_hash}/v3/
🔒 Credential Security: Treat the API Key as a password. Store it securely and only share it with authorized integration administrators.
Connect BigCommerce in Logiwa
Connecting your BigCommerce store to Logiwa is entirely self-service. You'll select and enter everything below directly on the connection screens — there's nothing you need to send to Logiwa in advance beyond the Store Hash and API Key you generated above.
Connect & Authorize
Go to Integrations > Store and Marketplace in Logiwa and click BigCommerce > Connect Now.
Integration Management: locate BigCommerce among the available Store and Marketplace integrations and click Connect Now.
Connect BigCommerce Integration: Big Commerce Store Name, Client, Warehouse, Shipment Order Type, Product UOM, and Contact Email.
Field | Description |
Big Commerce Store Name | The name of your BigCommerce connection in Logiwa. |
Client | Select the client entity this connection belongs to. |
Warehouse | Select the warehouse this BigCommerce store should be linked to. |
Shipment Order Type | Select the order type to apply to orders imported from BigCommerce. |
Product UOM | Select the Unit of Measure to apply to products synced from BigCommerce. |
Contact Email | The address that receives integration notifications, status updates, and errors. |
Select the processes (flows) you'd like to activate, then click Install. Enable the workflows this store needs — you can leave a workflow off if that store should not sync that data.
Select the features to install: Download Orders, Send Shipment Information, Sync Inventory, Download Products.
Workflow | Direction | Cadence |
Product Sync (Download Products) | BigCommerce → Logiwa | Every 10 minutes |
Order Sync (Download Orders) | BigCommerce → Logiwa | Every 10 minutes |
Inventory Sync | Logiwa → BigCommerce | Every 10 minutes |
Order Fulfillment (Send Shipment Information) | Logiwa → BigCommerce | Every 10 minutes |
Fill in the fields below, then click Connect to BigCommerce.
Authenticate: enter the API Key and Store Hash generated in the Prerequisites section, then click Connect to BigCommerce.
Field | Description |
API Key | Enter the Access Token (API Key) from your BigCommerce API account (see Prerequisites above). |
Store Hash | Enter the Store Hash from your BigCommerce API account (see Prerequisites above). |
Once connected, you can close the window — Logiwa manages the connection from here.
Shipping Method Mapping
Map your storefront's shipping method names (e.g., "Free Shipping") to the matching Logiwa carrier services, so tracking updates are sent back to BigCommerce correctly.
💡 Post-Activation Configuration: Shipping Method Mapping is set up after your connection is activated, via Manage Configuration in Logiwa — you don't need to have this ready beforehand.
Operational Rules & Edge Cases
To prevent fulfillment delays and inventory discrepancies, review these operational business rules.
Inventory Sent to BigCommerce Is "Available to Sell," Not Total On-Hand
To prevent overselling, Logiwa sends the Available to Sell quantity to BigCommerce, not the total physical On-Hand count. For kit items, Logiwa syncs inventory using the Net Kitting Capacity quantity instead.
💡 Why this matters: This ensures that inventory already reserved for other customers is never listed as available on BigCommerce. You can confirm these numbers yourself in the Logiwa UI by navigating to Reports > Inventory > Available to Promise (ATP).
Kit & Bundle Items
⚠️ Known Limitation — Kit Components Are Not Received From BigCommerce: BigCommerce does not support defining kit or bundle components, so Logiwa can only pull the kit item itself (the parent SKU) from BigCommerce during Product Synchronization. Component details are not received from BigCommerce and must be configured directly in Logiwa before the kit item can be fulfilled correctly.
Carrier Must Exist in Logiwa
For a shipment update to transfer successfully to BigCommerce, the carrier used must already exist in Logiwa as a Carrier or Custom Carrier. If it doesn't, the shipment update will fail (see Error Handling below).
Canceled or Refunded Orders
BigCommerce will reject a shipment update for an order that has already been canceled or refunded on the storefront.
Integration Flows & Field Mappings
ℹ️ Reading these tables: Fields shown in parentheses are technical BigCommerce or Logiwa field names used by the system. The text before the parentheses is the everyday, user-facing label.
Order Download (BigCommerce → Logiwa)
Cadence & Trigger: Scheduled automation running every 10 minutes. Logiwa pulls orders with an "Awaiting Fulfillment" status.
Business Rules: Automatically brings new orders from BigCommerce into Logiwa, ready for your warehouse team to pick, pack, and ship — no manual entry required.
Source (BigCommerce) | Target (Logiwa) | Logic / Notes |
Billing Name & Email (billing_address) | Customer Fields | Identifies the customer placing the order. |
Shipping Address (shipping_addresses) | Shipment & Billing Address (Street, City, State, Zip, Phone) |
|
Order Creation Date (date_created) | Shipment Order Date |
|
Customer Message (customer_message) | Note |
|
Order Line Items (products) | Shipment Order Line List (SellerSKU, Quantity, Price) |
|
Order Id (id) | Shipment Order Code & Channel Order Number | Serves as the primary reference number for fulfillment. |
Shipping Cost (shipping_cost_ex_tax) | Freight Amount |
|
Send Shipment Info (Logiwa → BigCommerce)
Cadence & Trigger: Scheduled automation running every 15 minutes, once an order's status changes to Shipped in Logiwa.
Business Rules: Once an order has shipped from your warehouse, Logiwa automatically sends the shipment details to BigCommerce, updating the order status and providing tracking information to your customer.
Source (Logiwa) | Target (BigCommerce) | Logic / Notes |
Channel Order Number | order_id |
|
Master Tracking Number | tracking_number |
|
Carrier Name / SCAC | shipping_provider | Must map to a carrier code BigCommerce recognizes (see Operational Rules above). |
Order Line Items (ID & Qty) | items (order_product_id, quantity) |
|
Shipment Address Id | order_address_id |
|
⚠️ When Shipment Updates Can Fail: To successfully update a shipment, the request must include a valid Order ID, the line items shipped, and tracking information. Missing or invalid data — or an order that has already been canceled or refunded — will cause the update to fail.
Inventory Synchronization (Logiwa → BigCommerce)
Cadence & Trigger: Scheduled sync running every 10 minutes.
Business Rules: Updates your BigCommerce listings to reflect current stock levels. As described above, the quantity sent is Available to Sell, not total On-Hand (Net Kitting Capacity for kit items).
ℹ️ Note: Inventory tracking must be enabled on the corresponding product in BigCommerce for these updates to be applied.
Source (Logiwa) | Target (BigCommerce) | Logic / Notes |
Listing / Product ID | id (Product ID) |
|
Variant ID (if applicable) | variants → id |
|
SellerSKU | sku |
|
Sellable Quantity | inventory_level | Calculated as On-Hand minus Open Sales Order Commitments (Net Kitting Capacity for kits). |
Product Synchronization (BigCommerce → Logiwa)
Cadence & Trigger: Scheduled sync running every 15 minutes.
Business Rules: Retrieves all active products, establishing the SKU master data in Logiwa.
Source (BigCommerce) | Target (Logiwa) | Logic / Notes |
sku | Sku |
|
name | Name / Item Description |
|
upc | UPC |
|
price | Sales Price |
|
id | CustomFieldTextBox3 → Product ID | Stored in Logiwa for reference. |
weight | Weight |
|
width, height, depth | Dimensions (Width, Height, Length) |
|
⚠️ Known Limitation — Kit Items: As noted above, kit item components cannot be created by BigCommerce. Product Synchronization pulls only the parent (kit) SKU — component assignment must be configured directly in Logiwa.
Log Access & Support
Error Classifications & Diagnostics
Error Type | Common Causes | System Behavior |
API Connection Failures | Invalid or expired API token (X-Auth-Token), or BigCommerce API rate limits. | The error is logged and an alert notification is sent. You may need to generate a new token via the BigCommerce control panel. |
Inbound Errors (BigCommerce → Logiwa) | Missing required details (such as SKU or a valid shipping address), or a duplicate order (Order ID) already received and processed. | The order is rejected automatically, flagged for manual review, and an error email is sent with details about the issue. |
Outbound Errors (Logiwa → BigCommerce) | Missing required details (such as tracking_number or order_address_id), an order that is already canceled or refunded, or an invalid shipping_provider code. | The update is skipped, flagged with an error, and the details are logged and emailed to you. |
Every system event captures the following diagnostic markers (where applicable):
Timestamp
API Endpoint
Status (Success / Failed)
HTTP Status Code (e.g., 200 OK, 400 Bad Request)
Error Description — the full response body from BigCommerce, to aid in debugging
💡 Note on Log Access: Processing logs are not accessible via the Logiwa user interface dashboard, though log details for specific transactions can be shared upon request. All troubleshooting inquiries must be directed to the Support team by opening a ticket through HubSpot.
Flow-Specific Error Scenarios
Flow | Example Error Scenario | System Behavior |
Order Download | Line Item SKU not found in Logiwa's product catalog. | Order is rejected; other orders in the batch continue processing; error notification email is sent. |
Send Shipment Info | shipping_provider code not recognized by BigCommerce. | Shipment update is skipped and flagged; error notification email is sent. |
Inventory Synchronization | Inventory tracking is not enabled on the BigCommerce product. | Inventory update is not applied; error is logged. |
Product Synchronization | A required product field (e.g., SKU) is missing or invalid. | Product is not created or updated; error is logged. |
ℹ️ When opening a support ticket, include: your BigCommerce Store Hash / store name; the time of the error; the BigCommerce Order ID (if applicable); the subject line of the error email; and any error message shown in the email.
Operational Best Practices
Maintain Exact SKU Alignment: Ensure product SKUs match exactly between BigCommerce and Logiwa before activating synchronization flows.
Configure Kit Components in Logiwa: Since BigCommerce doesn't provide kit component details, define accurate component assignments directly in Logiwa.
Enable Inventory Tracking: Make sure inventory tracking is turned on for every product you want Logiwa to keep in sync.
Verify Carrier Mapping: Confirm each shipping carrier you use is set up in Logiwa as a Carrier or Custom Carrier before going live.
Manage API Credentials: Keep your Store-level API account active, and regenerate the API Key promptly if the connection reports an authentication failure.
Go-Live Test Checklist (UAT)
⚠️ Testing runs against your live BigCommerce Store: This integration does not use a BigCommerce sandbox environment, so the UAT steps below run against your live store. To avoid leaving test data in your live catalog, use clearly-labeled test customer and product names (e.g., "ZZ-TEST Customer"), and delete or deactivate them once UAT is complete.
Test Order Download
In BigCommerce, create a test order for a test product, and ensure it reaches Awaiting Fulfillment status.
Wait 10 minutes.
Confirm the order appears in Logiwa with the correct customer, SKU, and quantity.
Expected Result: Order appears in Logiwa as a shipment order.
Test Send Shipment Info
In Logiwa, complete the test shipment order (mark as Shipped) with a valid tracking number and a carrier that exists in Logiwa.
Wait 15 minutes.
In BigCommerce, confirm the order shows tracking details and an updated shipping status.
Expected Result: BigCommerce order is automatically updated with tracking details.
Test Inventory Synchronization
In Logiwa, confirm the Available to Promise (ATP) quantity for the test SKU.
Wait 10 minutes.
In BigCommerce, confirm the product's inventory level matches the ATP quantity from Logiwa.
Expected Result: BigCommerce inventory level reflects the Available to Sell quantity from Logiwa.
Test Product Synchronization
In BigCommerce, create or update a test product.
Wait 15 minutes.
Confirm the product appears in Logiwa with the correct SKU, name, and price.
Expected Result: Product appears (or updates) in Logiwa.
💡 If any test fails, refer to the Flow-Specific Error Scenarios above. If the issue persists, open a support ticket with the details listed in that section.
Known Limitations
Kit Item Components: BigCommerce does not provide kit/bundle component data. Only the parent SKU is synced from BigCommerce; component assignment must be configured manually in Logiwa.
Log Access: Currently not available via the Logiwa UI. All diagnostics require a support ticket through HubSpot.
