Square Online Integration

Square Online Integration

Integrate your Square Online store with AtoShip to streamline shipping for your e-commerce orders.

Prerequisites

Before You Begin:

• Square Online store
• Square account (any plan)
• AtoShip account
• Admin access to Square

Square Ecosystem

Square Products:

Connecting Square

OAuth Connection:

1. Go to AtoShip Settings
2. Select Integrations
3. Click Square Online
4. Log in to Square
5. Authorize AtoShip
6. Select locations

Permission Scopes

What We Access:

• Orders (read)
• Fulfillment (update)
• Items (read)
• Customers (read)
• Locations (read)

Order Import

What's Imported:

• Order details
• Customer address
• Item information
• Shipping method selected
• Order notes

Order Filtering

Import Conditions:

Location Management

Multi-Location:

• Connect specific locations
• Ship from different origins
• Per-location inventory

Shipping Methods

Map Square to Carriers:

Square Method → AtoShip Service
Free Shipping → USPS Ground
Standard → USPS Priority
Express → UPS Ground
Next Day → FedEx Priority

Product Sync

Item Information:

• Product name
• SKU (if set)
• Weight
• Price
• Variations

Fulfillment Updates

Automatic Process:

1. Order imported
2. Create label in AtoShip
3. Tracking captured
4. Square updated
5. Customer notified

Real-Time Webhooks

Event Notifications:

• New order created
• Order updated
• Order canceled
• Payment completed

Inventory Considerations

Stock Management:

• Square tracks inventory
• Ship from available stock
• Update after shipping

Pickup vs Shipping

Order Types:

• Ship orders → Use AtoShip
• Pickup orders → Handle in Square
• Delivery orders → Local courier

Customer Communication

Notification Flow:

• Square sends order confirmation
• AtoShip sends shipping confirmation
• Tracking auto-updates
• Delivery notifications

Multi-Channel Sellers

Unified Shipping:

• Square Online orders
• Other channel orders
• Single shipping queue

Common Configurations

Setup Tips:

1. Set default shipping method
2. Configure weight defaults
3. Enable auto-import
4. Set up notifications

Error Handling

Common Issues:

Testing Integration

Verify Setup:

1. Place test order
2. Check import
3. Create test label
4. Verify Square update

Best Practices

For Square Sellers:

1. Keep item weights updated
2. Use consistent SKUs
3. Monitor order queue
4. Review shipping daily

Limitations

Current Constraints:

• US shipping only
• No Square Invoices
• E-commerce orders only

Troubleshooting

Orders Missing:

1. Check order status
2. Verify ship vs pickup
3. Review location filter
4. Test webhook connection

Disconnecting

To Remove:

1. AtoShip → Settings
2. Integrations → Square
3. Disconnect
4. Revoke in Square Dashboard