Track Proxy Warehouse Sync Tasks in GWMS
Updated: 2026-06-04
1. Scenario
The Sync Tasks page tracks the execution results of all proxy warehouse operations. After triggering inbound push, outbound push, cancel confirmation, inventory sync, or status callback, you can use this page to check task status, execution summary, HTTP logs, and inventory snapshots — and manually trigger a one-time 【Sync Now】 when needed.
This guide is for warehouse operations staff, implementers, and troubleshooting personnel. Common use cases include:
- Checking whether an inbound or outbound order has completed proxy warehouse sync
- Determining whether a task is waiting for retry, already successful, or requires manual handling
- Opening task details to view request logs and error messages
- Viewing the proxy warehouse inventory snapshot captured during an inventory sync task
- Manually running 【Sync Now】 on an unfinished task
This page is best used as the first stop in the operations workflow:
- After pushing a business operation, come here first to check the result.
- Use this page to decide whether to wait, click 【Sync Now】, or escalate to manual handling.
- If you need more specific failure details, go to Logs.
2. Steps
Prerequisites
- Your account can access
GWMS > Proxy Warehouse > Sync Tasks. - The target operation has already triggered a proxy warehouse interaction and a task has been created in the system.
- To run 【Sync Now】, confirm the task is not already in 【Success】 or 【Cancelled】 status.
2.1 Open the Sync Tasks Page
Menu path: GWMS > Proxy Warehouse > Sync Tasks
- After logging in to GWMS, open the 【Proxy Warehouse】 module in the left sidebar.
- Click 【Sync Tasks】.
- The page has three sections:
- Filter bar (top): search conditions
- Task overview (middle): quick statistics and navigation
- Task list (bottom): task detail table
Available filter conditions
- 【Status】: Select task status
- 【Business Type】: Select inbound, outbound, or other business types
- 【Task Type】: Select task category, including:
- Query task: poll the proxy warehouse for the latest order status
- Create task: confirm whether the inbound/outbound order was successfully created and processed by the proxy warehouse
- Cancel task: confirm whether the cancel operation was successfully executed by the proxy warehouse
- Inventory sync task: pull an inventory snapshot from the proxy warehouse and sync to GWMS
- 【Warehouse】: Select a specific warehouse
- 【Created Time】: Select a date range
Task type reference
The system supports 4 task types:
| Task Type | Purpose | Use Case |
|---|---|---|
| Query task | Poll for status | Auto-poll proxy warehouse for latest order status |
| Create task | Confirm creation | Confirm inbound/outbound order was created and processed |
| Cancel task | Confirm cancellation | Confirm cancel operation was executed by the proxy warehouse |
| Inventory sync | Sync inventory | Pull inventory snapshot from proxy warehouse and sync to GWMS |
2.2 Use the Task Overview to Find Exceptions
The task overview area is designed for risk-level-based quick filtering.
Overview card structure
- Top: 【Task Overview】 label and help icon
- Right side: 【Expand】/【Collapse】 toggle button
- Primary metrics area: key statistics
- Filter hint bar: shows the active filter after clicking a metric
- Expanded area: additional secondary metrics and action reminders
Primary metrics
Each metric card shows:
- Metric name
- Count
- Colour indicator: red (action needed), yellow (attention), blue (informational)
- Clickable filter: click to auto-filter the task list
Common metrics include:
- Backlog task count
- Running task count
- Tasks requiring manual handling
Recommended usage
Suggested workflow:
- Start with backlog, running, and manual handling metrics to quickly spot exceptions
- When a metric looks abnormal, click the corresponding card
- The system auto-filters the task list
- After handling, click 【Clear Filter】 to return to the full task list
If you are investigating an inventory sync issue, filter 【Task Type】 to "Inventory Sync Task" first, then check the overview.
Expanded area content
When expanded, the following are shown:
- Secondary metrics: additional statistical dimensions
- Action reminders: risk alerts that require attention
2.3 View the Task List
The task list has 6 main columns:
【Order No.】 column
Two lines:
- Line 1: Business order number (clickable for details, copyable)
- Line 2: Third-party order number (if available, copyable)
【Type】 column
Two lines:
- Line 1: Task type (create task, cancel task, query task, inventory sync task)
- Line 2: Business type (inbound, outbound, etc.)
【Status】 column
Current task status:
- Waiting (yellow)
- Running (blue)
- Success (green)
- Manual handling (red)
- Cancelled (grey)
【Route Info】 column
Configuration associated with the task:
- GWMS warehouse code
- Proxy warehouse code
- Proxy warehouse system code
【Execution Summary】 column
Result description or error message — used to quickly identify the cause of success or failure.
【Time】 column
Three timestamps:
- Created time
- Last executed time
- Next execution time (if the task is still waiting)
【Actions】 column
- 【Sync Now】 button: shown only for unfinished tasks
- Tasks that are already successful or cancelled will not show this button
2.4 View Task Details
- Click the business order number in the task list.
- The task details dialog opens.
- The default 【Task Details】 tab shows:
- Task ID
- Task type
- Task status
- Business type
- Business order number / Third-party order number
- Proxy warehouse system information
- Warehouse code / Proxy warehouse code
- Request ID
- Last executed time / Next execution time / Created time
- Execution result
- Error message
If the task has associated request records, the dialog also shows the 【Request Logs】 tab. Inventory sync tasks additionally show the 【Proxy Warehouse Inventory】 tab.
2.5 View Request Logs
- In the task details dialog, switch to 【Request Logs】.
- The list shows the API call records associated with this task.
- Expand a row to see: request content on the left, response content on the right.
Use this to confirm:
- Which API was called
- Whether the order number, warehouse code, and SKU are correct
- Whether the proxy warehouse returned success, failure, or an empty result
2.6 View Inventory Sync Task Snapshot
When the task type is "Inventory Sync Task", the details dialog includes an extra 【Proxy Warehouse Inventory】 tab.
This tab shows the proxy warehouse inventory snapshot captured at the time of the sync task execution:
| Field | Description |
|---|---|
| Proxy warehouse SKU | SKU code in the proxy warehouse system |
| GSKU | Global SKU in GWMS |
| Local SKU | Customer-side SKU code |
| Available inventory | Available quantity returned by proxy warehouse |
| Locked inventory | Locked quantity returned by proxy warehouse |
| Total inventory | Available + Locked |
| Inventory type | Qualified / Defective |
| Proxy inbound order | Inbound order number in proxy warehouse |
| Local inbound order | GWMS inbound order number |
| Inbound time | Inbound time recorded by proxy warehouse |
| Snapshot time | Time when this snapshot was captured |
| Proxy warehouse code | Proxy warehouse code |
| GWMS warehouse code | GWMS warehouse code |
How to interpret snapshot data
Important notes:
- This tab shows the inventory snapshot captured at the time of task execution — it is not a live query of the proxy warehouse
- Use it to trace "why did this sync produce this result"
- To see the latest inventory, trigger a new inventory sync task
Inventory quantity rules
- Total inventory = Available inventory + Locked inventory
- Do not treat "available inventory" as the GWMS total
- Always include locked inventory when calculating total
- Comparing only available inventory can lead to incorrect discrepancy conclusions
Inventory detail split rules
The proxy warehouse splits inventory by inbound batch. During GWMS sync, the following fields are used to match a specific batch:
- Warehouse
- SKU
- Inventory type (qualified / defective)
- Inbound order number
- Inbound time
Note:
- GWMS only corrects proxy-warehouse-managed dedicated locations (virtual putaway location, defective location) — it does not modify other general locations
2.7 Manually Trigger Sync Now
- On the row of an unfinished task, click the 【Sync Now】 button.
- A confirmation dialog appears: "Confirm execute this task immediately?"
- After confirming, the system shows "Execution request submitted".
- Refresh the list or wait a few moments, then check the task status and execution summary.
If execution fails, the page shows the failure reason directly.
How Sync Now works
Clicking 【Sync Now】 causes the system to execute the task immediately instead of waiting for the next scheduled execution time.
When to use Sync Now
Recommended scenarios:
- The proxy warehouse has finished processing, but the local task is still waiting for the next poll
- You just fixed a mapping, system configuration, or master data issue and want to re-run immediately
- You want to verify whether a fix has taken effect
Do not repeatedly click in these scenarios:
- The task is already successful or cancelled
- The task is still being processed
- The root cause has not been resolved, e.g. the configuration, mapping, or SKU data is still incorrect
What to observe after clicking
Clicking only submits the execution request. The task still needs to run, query, and write back. Watch for:
- Whether 【Last Executed Time】 updates
- Use 【Execution Summary】 together with the timestamp to judge the result
- If status remains "waiting", the task logic requires further retries
- If status changes to "manual handling", the task encountered a condition requiring human intervention
3. Additional Notes
3.1 Automatic Polling Intervals
The system schedules the next poll based on task type:
| Task Type | Polling Interval | Notes |
|---|---|---|
| Create task | 30 minutes | Inbound/outbound create task: polls every 30 min |
| Cancel task | 10 min → 20 min → 1 hour → 4 hours | Interval increases with retry count |
| Inventory sync | 12 hours | Scheduled trigger — no repeated polling needed |
| Query task | 24 hours | Status query task |
Notes:
- Create task (inbound/outbound): fixed 30-minute polling interval
- Cancel task: 10 min first time, 20 min second time, 1 hour third time, 4 hours from the fourth attempt onward
- To skip waiting, use 【Sync Now】 to trigger manually
3.2 Common Task Statuses
| Status | Meaning | Description |
|---|---|---|
| Pending | Awaiting dispatch | Task created, waiting to be scheduled |
| Running | Executing | Task is currently executing |
| Waiting | Awaiting retry | Task did not complete this round; system has scheduled a retry |
| Success | Completed | Task completed; business reached terminal state |
| Manual handling | Intervention needed | Possible causes: - Max retries exceeded - Proxy warehouse done but local action failed - Consecutive failures |
| Cancelled | Cancelled | Task cancelled; will not execute further |
3.3 When to Use Sync Now
Recommended scenarios:
- The proxy warehouse has finished processing, but the local task is still waiting for the next poll
- You just fixed a mapping, system configuration, or master data issue and want to re-run immediately
- You want to verify whether a fix has taken effect
Do not repeatedly click in these scenarios:
- The task is already successful or cancelled
- The task is still being processed
- The root cause has not been resolved, e.g. the configuration, mapping, or SKU data is still incorrect
3.4 Inventory Sync Tasks vs. Business Sync Tasks
Inventory sync tasks focus on inventory correction only — they do not correspond to a specific business order. Their main job is to:
- Capture a proxy warehouse inventory snapshot
- Compare against local inventory
- Record the proxy warehouse inventory details used in this sync
Business sync tasks focus on whether a specific inbound order, outbound order, or cancel operation has been completed.
4. Common Questions
Q1: Why is there no 【Sync Now】 button in the list?
A1: The task is likely in a terminal state such as 【Success】 or 【Cancelled】. The page only provides 【Sync Now】 for unfinished tasks.
Q2: I clicked 【Sync Now】 — why didn't the status change to success immediately?
A2: Clicking only submits the execution request. The task still needs to run, query, and write back. First check whether 【Last Executed Time】 updated, then use 【Execution Summary】 to judge the result.
Q3: Why can't I see the 【Proxy Warehouse Inventory】 tab in task details?
A3: This tab only appears for inventory sync tasks. Confirm that you are viewing an inventory sync task.
Q4: The task status stays at "waiting" — where should I look first?
A4: Check 【Execution Summary】 and 【Error Message】 first. If the error is interface-related, go to Logs to see the original request and response. If the error is about warehouse, channel, SKU, or system configuration, return to Proxy Warehouse System to check the mapping.
Q5: Why does the inventory in the snapshot differ from what I see on the proxy warehouse page now?
A5: The inventory data in task details is a snapshot saved at the time of task execution — it does not update as the proxy warehouse changes afterward. It is used to trace "what inventory was seen at that point in time", not as a live inventory dashboard.