Skip to main content

BigCommerce Integration

Connect BigCommerce to Logiwa and synchronize orders, products, inventory, and shipment confirmations.

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

  1. Upon creation, BigCommerce downloads a file containing your Store Hash and API Key (Access Token).

  2. Save the API Key securely — it is only shown once.

  3. 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.

  • Fill in the fields, then click Continue.

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

  1. In BigCommerce, create a test order for a test product, and ensure it reaches Awaiting Fulfillment status.

  2. Wait 10 minutes.

  3. 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

  1. In Logiwa, complete the test shipment order (mark as Shipped) with a valid tracking number and a carrier that exists in Logiwa.

  2. Wait 15 minutes.

  3. 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

  1. In Logiwa, confirm the Available to Promise (ATP) quantity for the test SKU.

  2. Wait 10 minutes.

  3. 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

  1. In BigCommerce, create or update a test product.

  2. Wait 15 minutes.

  3. 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.

Did this answer your question?