Order Synchronization
Fenicia automatically synchronizes orders from all your connected sales channels. This allows you to manage orders from Shopify, Amazon, MercadoLibre, and other marketplaces from a single place.
Automatic Sync
Once you connect a sales channel, orders begin flowing into Fenicia automatically. You don't need to take any manual action to receive new orders.
Sync Frequency
| Channel | Method | Frequency |
|---|---|---|
| Shopify | Webhooks (real-time) | Instant |
| Amazon | Polling | Every 15 minutes |
| MercadoLibre | Webhooks + Polling | Instant with periodic verification |
| Walmart | Polling | Every 15 minutes |
| TikTok Shop | Webhooks | Instant |
Tip
Channels using webhooks deliver orders in real time. Channels with polling have a small delay but guarantee that no orders are missed.
What Gets Synced?
Synchronization includes the following information:
- Order status: pending, accepted, shipped, delivered, cancelled
- Payment status: pending, paid, partially or fully refunded
- Tracking information: tracking number and carrier
- Customer data: name, email, phone, address
- Ordered products: SKU, quantity, price, variants
- Notes and tags: additional information from the channel
Sync Direction
Synchronization is bidirectional:
| Action in Fenicia | Reflected in the channel |
|---|---|
| Mark as shipped | Updates status + tracking in the marketplace |
| Cancel order | Notifies cancellation to the channel |
| Add tracking number | Sends tracking to the channel and customer |
| Action in the channel | Reflected in Fenicia |
|---|---|
| New order | Appears automatically in Fenicia |
| Customer modifies order | Updated in Fenicia |
| Customer cancellation | New status reflected |
Note
Not all channels support all bidirectional operations. Check the specific documentation for each channel to learn about limitations.
Manual Sync
Sync an Individual Order
If you need to refresh the information for a specific order from the channel:
Open the order detail
Navigate to Orders and select the order you want to sync.
Click Sync
Press the Sync button at the top of the detail view. Fenicia will query the source channel and update all information.
Bulk Sync
To sync all orders from a channel at once:
Go to Channels
Navigate to Channels from the sidebar menu.
Select the channel
Click on the channel from which you want to sync orders.
Run bulk sync
Click Sync orders to import or update all recent orders from the channel.
Warning
Bulk synchronization may take several minutes depending on order volume. Avoid running it repeatedly in short intervals to prevent hitting the channel's API rate limits.
Sync Errors
When synchronization fails, Fenicia logs the error and notifies you. The most common causes are:
| Error | Cause | Solution |
|---|---|---|
| Network timeout | Unstable connection | Retry after a few minutes |
| API rate limit reached | Too many requests to the channel | Wait for the limit to reset |
| Permission error | Expired token or insufficient permissions | Reconnect the channel in Settings |
| Order not found | Deleted in the source channel | Verify directly in the marketplace |
Troubleshooting
Check Sync Status
Review the timeline
In the order detail, the timeline shows all sync events, including successes and errors.
Check channel status
In Channels, each channel displays its connection status and last successful sync.
Retry Failed Syncs
If a sync failed:
- Verify that the channel is properly connected
- Check that you haven't reached the marketplace's API limits
- Click Sync on the affected order to retry
- If the issue persists, reconnect the channel from Settings > Channels
Channel-Specific Behaviors
Shopify
- Method: Real-time webhooks
- Advantage: orders appear instantly
- Tracking: automatically sent to the customer when you mark the order as shipped
- Cancellations: bidirectional
Amazon
- Method: Polling every 15 minutes
- Advantage: high reliability, Amazon guarantees data delivery
- Tracking: required to mark as shipped
- Note: Amazon requires shipping confirmation within specific timeframes
MercadoLibre
- Method: Webhooks with polling verification
- Advantage: combines speed with reliability
- Messaging: buyer messages are also synced
- Note: MercadoLibre statuses are mapped to Fenicia's standard order states
Tip
If you notice an order hasn't synced after the expected time, use the manual sync button before reporting an issue. In most cases, a manual retry resolves the problem.
Tips for Efficient Synchronization
- Keep channels connected: periodically verify that credentials haven't expired
- Don't modify orders directly in the marketplace: make changes from Fenicia to maintain consistency
- Address sync errors promptly: resolve errors quickly to avoid accumulated desynchronization
- Use consistent SKU names: makes product mapping between channels easier