WooCommerce Integration Guide

WooCommerce Integration Guide

Connect WooCommerce with AtoShip to automate your WordPress store's shipping workflow.

Prerequisites

Before Connecting:

• WordPress with WooCommerce installed
• WooCommerce 5.0+ recommended
• AtoShip account
• WordPress admin access

Installation Methods

Option 1: WordPress Plugin

1. Go to Plugins → Add New
2. Search "AtoShip Shipping"
3. Click Install Now
4. Activate plugin
5. Configure in Settings

Option 2: REST API Connection

1. Generate WooCommerce API keys
2. Enter in AtoShip dashboard
3. Configure sync settings

Generating API Keys

In WooCommerce:

1. Go to WooCommerce → Settings
2. Click "Advanced" tab
3. Click "REST API"
4. Add Key:
   • Description: AtoShip
   • User: Admin
   • Permissions: Read/Write
5. Generate API Key
6. Copy Consumer Key & Secret

Connecting to AtoShip

In AtoShip Dashboard:

1. Go to Settings → Integrations
2. Click "Add Store"
3. Select WooCommerce
4. Enter:
   • Store URL
   • Consumer Key
   • Consumer Secret
5. Click Connect

Sync Configuration

Order Import Settings:

Webhook Setup

Automatic Updates: Webhooks enable real-time sync.

Setting Up:

1. WooCommerce → Settings → Advanced → Webhooks
2. Add webhook:
   • Name: AtoShip Order Update
   • Topic: Order updated
   • Delivery URL: (from AtoShip)
   • Secret: (from AtoShip)

Data Mapping

What's Imported:

• Order number
• Customer details
• Shipping address
• Product info
• Order notes
• Shipping method

Weight Handling:

• Product weight from WooCommerce
• Override via SKU mapping
• Default weight fallback

Shipping Method Mapping

Map WC Methods to Carriers:

WC "Flat Rate" → USPS Priority Mail
WC "Free Shipping" → USPS Ground Advantage
WC "Local Pickup" → Do not import

Order Workflow

Standard Process:

WC Order (Processing) → Import → Ship → Update to Completed

Status Updates:

Multi-Site Support

WordPress Multisite:

• Connect each site separately
• Individual API keys per site
• Unified view in AtoShip

Handling Variations

Product Variations:

• Full variation title imported
• SKU for mapping
• Attributes visible

Custom Fields

Adding Custom Data: WooCommerce custom fields can be:

• Passed to label notes
• Used for shipping rules
• Mapped to package details

Testing the Connection

Verify Setup:

1. Create test order in WC
2. Check import in AtoShip
3. Create test label
4. Verify WC status updates

Common Issues

Connection Errors:

Orders Not Syncing:

1. Verify order status
2. Check webhook delivery
3. Review error logs
4. Test API connection

Performance Tips

For Large Stores:

• Use webhooks (not polling)
• Batch process orders
• Schedule during off-peak
• Clean old orders periodically

Security Considerations

Best Practices:

• Use HTTPS only
• Rotate API keys periodically
• Limit IP access if possible
• Monitor API usage

Plugin Compatibility

Known Compatible:

• WooCommerce Subscriptions
• WooCommerce Bookings
• WPML
• Most shipping plugins

May Need Configuration:

• Custom checkout plugins
• Order management plugins
• Some page builders

Updating the Integration

When WooCommerce Updates:

• Test after updates
• Check webhook status
• Verify API still works
• Review any deprecations

Disconnecting

To Disconnect:

1. Deactivate plugin (if used)
2. Remove in AtoShip settings
3. Delete API keys in WC
4. Remove webhooks

Support Resources

Getting Help:

• WooCommerce docs
• AtoShip integration guide
• WordPress support forums
• [email protected]