API DocsCreate Ticket

BigCommerce Integration Guide

BigCommerce Integration Guide

Connect your BigCommerce store to AtoShip and automate your shipping workflow with real-time order syncing.

Prerequisites

Before You Begin:

  • BigCommerce store (any plan)
  • Store owner or admin access
  • AtoShip account
  • API credentials enabled

Connection Methods

Two Options:

MethodSetupBest For
App Install1-clickMost users
API KeysManualCustom setups

Installing via BigCommerce App

Quick Setup:

  1. Log in to BigCommerce
  2. Go to Apps → Marketplace
  3. Search "AtoShip"
  4. Click Install
  5. Authorize permissions
  6. Configure settings

Manual API Connection

Step-by-Step:

  1. BigCommerce → Settings
  2. API Accounts → Create
  3. Set permissions:
    • Orders: Read/Modify
    • Products: Read
    • Customers: Read
  4. Copy credentials
  5. Enter in AtoShip

Required Permissions

API Scopes:

  • Orders (read, modify)
  • Fulfillment (create)
  • Products (read)
  • Customers (read)

Order Import Settings

Configure Import:

  • Auto-import frequency
  • Order status filter
  • Date range selection
  • Include/exclude rules

Order Statuses

Status Mapping:

BigCommerceAction
Awaiting FulfillmentImport
Awaiting ShipmentImport
Partially ShippedImport
PendingSkip
ShippedSkip

Shipping Methods

Map Carriers:

BigCommerce Method → AtoShip Service
Standard Shipping → USPS Ground
Express Shipping → UPS Ground
Priority Shipping → UPS 2nd Day
Overnight → FedEx Priority

Multi-Storefront Support

Enterprise Feature:

  • Connect multiple storefronts
  • Separate or unified orders
  • Per-storefront settings

Product Information

What's Synced:

  • Product name
  • SKU
  • Weight
  • Dimensions
  • Custom fields

Fulfillment Updates

Automatic Sync:

  1. Create label in AtoShip
  2. Tracking number captured
  3. BigCommerce updated
  4. Order marked shipped
  5. Customer notified

Shipping Zones

Zone Configuration:

  • Match BigCommerce zones
  • Different rates per zone
  • International options

Order Notes

Data Transfer:

  • Customer notes imported
  • Gift messages included
  • Special instructions synced

Inventory Sync

Optional Feature:

  • Two-way inventory sync
  • Stock level updates
  • Low stock alerts

Multi-Channel Orders

Unified Workflow:

  • Combine with other channels
  • Single shipping queue
  • Consistent process

Webhook Events

Real-Time Updates:

  • New order notification
  • Order update alerts
  • Cancellation notices

Error Handling

Common Issues:

ErrorCauseSolution
Auth failedToken expiredReconnect app
Order not foundAlready fulfilledSkip
Rate limitToo many requestsWait & retry

Testing Your Connection

Verification Steps:

  1. Place test order
  2. Check import in AtoShip
  3. Create test label
  4. Verify BigCommerce update
  5. Confirm tracking sync

Best Practices

For BigCommerce:

  1. Set consistent shipping zones
  2. Enable webhook notifications
  3. Review order queue daily
  4. Keep inventory accurate
  5. Monitor sync status

Troubleshooting

Orders Not Importing:

  1. Check order status filter
  2. Verify API credentials
  3. Review webhook settings
  4. Test connection

Disconnecting

To Remove Integration:

  1. AtoShip → Settings
  2. Integrations → BigCommerce
  3. Disconnect
  4. Optionally revoke API keys

Was this article helpful?