Sync Channel Data Manually
Manually trigger channel listing synchronization from external sales platforms by calling Linnworks API for selected channels.
Overview
The RIS-SM-1021 – SyncChannelDataManually macro allows manual triggering of channel data synchronization, specifically for downloading product listings.
It is useful when automatic sync fails or when an on-demand refresh of channel listings is required.
Ensure valid channel IDs, source names, and session authorization are configured before running this macro.
Purpose
This macro:
- Triggers listing download from external channels
- Supports multiple channels in a single execution
- Uses direct API calls for synchronization
- Provides manual control over channel data
👉 In short:
Manually sync product listings from external sales channels.
When It Runs
Used for channel synchronization and troubleshooting
Typically runs:
- Manually triggered
- When automatic sync fails
- When immediate data refresh is required
Parameters
Comma-separated list of channel IDs.
Comma-separated list of channel source names.
Example:
channelIds = "1,2"
sourceNames = "ebay,amazon"
Meaning:
Each channelId corresponds to the respective sourceName by index.
How It Works
Prepare Input Data
Split comma-separated channelIds and sourceNames into structured lists.
Loop Through Channels
Iterate through each channel and map channelId with corresponding sourceName.
Prepare API Request
Configure API endpoint, method (POST), and headers including authorization.
Build Request Payload
Prepare request body with:
- channelId
- source
- propertyName = DownloadListings
- functionName = DownloadListings
Execute API Call
Send HTTP POST request to Linnworks API and wait for response.
Repeat for All Channels
Perform synchronization for each provided channel.
Log Execution
Track execution process (response logging currently disabled).
Final Result
- Channel listing download triggered successfully
- Listings synced from external platforms
- Multiple channels processed in one run
Usefulness
This macro is highly beneficial for:
- Manually controlling channel synchronization
- Fixing delayed or failed listing updates
- Supporting multi-channel operations
- Reducing dependency on UI-based sync
- Improving data consistency across platforms
Important Notes
- channelIds and sourceNames must align correctly
- Supports only listing download (DownloadListings)
- No validation for mismatched parameter lengths
- No retry mechanism for failed API calls
- Requires valid Linnworks session token
- API response logging is currently disabled
Example Scenario
Key Insight
Direct API-triggered synchronization ensures reliable control over channel data updates, improving consistency and reducing delays across integrated sales platforms.
Last updated today
Built with Documentation.AI