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:
| Method | Setup | Best For |
|---|---|---|
| App Install | 1-click | Most users |
| API Keys | Manual | Custom setups |
Installing via BigCommerce App
Quick Setup:
- Log in to BigCommerce
- Go to Apps → Marketplace
- Search "AtoShip"
- Click Install
- Authorize permissions
- Configure settings
Manual API Connection
Step-by-Step:
- BigCommerce → Settings
- API Accounts → Create
- Set permissions:
- Orders: Read/Modify
- Products: Read
- Customers: Read
- Copy credentials
- 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:
| BigCommerce | Action |
|---|---|
| Awaiting Fulfillment | Import |
| Awaiting Shipment | Import |
| Partially Shipped | Import |
| Pending | Skip |
| Shipped | Skip |
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:
- Create label in AtoShip
- Tracking number captured
- BigCommerce updated
- Order marked shipped
- 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:
| Error | Cause | Solution |
|---|---|---|
| Auth failed | Token expired | Reconnect app |
| Order not found | Already fulfilled | Skip |
| Rate limit | Too many requests | Wait & retry |
Testing Your Connection
Verification Steps:
- Place test order
- Check import in AtoShip
- Create test label
- Verify BigCommerce update
- Confirm tracking sync
Best Practices
For BigCommerce:
- Set consistent shipping zones
- Enable webhook notifications
- Review order queue daily
- Keep inventory accurate
- Monitor sync status
Troubleshooting
Orders Not Importing:
- Check order status filter
- Verify API credentials
- Review webhook settings
- Test connection
Disconnecting
To Remove Integration:
- AtoShip → Settings
- Integrations → BigCommerce
- Disconnect
- Optionally revoke API keys