EC Account Detail
Table of Contents
Section 1: Features
The EC account detail page presents an account's integration status and settings in full: the left half is "Connection", the right half is "Settings". Beyond viewing, you can run several manual sync actions here (schedule fetch, sync mapped products, manual stock sync), as well as enter Edit or delete the account. The sync history at the bottom of the page lets you look back at the result and failure reasons of every automatic sync.
Quick Jump: Connection Info | Function Settings | Manual Sync Actions | Automatic Real-Time Notification Check | Sync History
1.1 Connection Info (left half)
Shows the account's basic details and integration credentials: the platform, Display Name, the bound sales channel, and the platform's integration info (key fields are masked to protect secrets). The tag in the top right shows the current connection status; for the meaning of the three states, see EC Integrations list.
When the account is "Disconnected", a red alert appears at the top of the page: authorization-based platforms offer a "Re-authorize" button, key-based platforms offer an "Edit" button, so you can restore the connection directly.
1.2 Function Settings (right half)
| Block | What It Shows |
|---|---|
| Order Fetching | Whether enabled, the configured fetch slots, and the next fetch time; Shopee accounts also show whether "Realtime New Order Fetch" is on |
| Inbound Push | Whether enabled, the Push Percentage, the number of mapped products, and the last sync time |
| Shipping Type Mappings | The list mapping platform shipping codes to warehouse-side shipping methods |
Adjustments to these settings happen on the Edit page; the detail page is for viewing and running the manual syncs below.
1.3 Manual Sync Actions
The detail page offers three manual actions, shown depending on the account's status and settings:
| Action | When It Appears | Effect | Reversibility |
|---|---|---|---|
| Fetch Orders Now | Connection healthy and order fetching enabled | Queues a fetch immediately, without waiting for the next scheduled slot | Just fetches earlier; no side effects |
| Sync Product Mappings | Connection healthy, inbound push enabled, and the platform supports it | Re-matches the relationship between platform products and warehouse products | Updates the mapping table only; doesn't touch stock |
| Manual Stock Sync | Connection healthy, inbound push enabled, and the platform supports it | Overwrites platform stock in batch with current warehouse stock, by push percentage | Directly rewrites platform stock; a confirmation dialog appears before it runs |
📌 Note: "Manual Stock Sync" differs from day-to-day inbound push — inbound push only increases platform stock on restock, while manual sync overwrites the platform's numbers in batch with current stock, suitable for a one-time correction when the figures don't match.
1.4 Automatic Real-Time Notification Check
Every time you open this page, the system automatically checks with the e-commerce platform whether this account's real-time notification is set up, and fixes it on the spot if it is missing or no longer working. The check runs in the background, so it does not slow the page down, and there is no button to press.
Real-time notification is what makes the platform tell us the moment an order changes, so orders no longer have to wait for the next scheduled fetch. Accounts integrated before real-time order intake shipped — and accounts whose notification permission was granted later — used to need someone to go back and press the connection test again; now one visit to this page fixes them automatically.
| Result of this check | What you see |
|---|---|
| Not on the platform yet → created | A floating message saying it is now enabled, listing which notification events are covered |
| Expired or missing some events → rebuilt | A floating message saying the previous setup had stopped working and has been recreated, with the same event list |
| Already present and correct → nothing done | No message at all. Reloading the page still runs a real check, but with no new change there is no repeated message |
| The key lacks real-time notification permission | A message that does not close by itself, guiding you to grant the permission on the platform and regenerate the key |
| The platform refuses this system's connection source (our IP is not on its allowlist) | A message that does not close by itself, saying to contact support. Regenerating the key does not help here — this system's connection IP has to be added to the platform's allowlist |
| Platform timeout, error, or rate limit | No message at all. Scheduled order fetching is unaffected and the next visit retries automatically |
The check is not triggered at all when: the account is not "Connected" (never tested or disconnected accounts never call the platform), your account only has view permission for e-commerce integrations, or the platform has no real-time notification we can configure.
1.5 Sync History
"Sync History" at the bottom of the page lists the results of this account's most recent automatic syncs, one row per run. A run that had nothing to process and hit no failures leaves no record, so every row you see means the system actually did something or ran into a problem.
| Column | What it tells you |
|---|---|
| Type | What was synced: "Order Fetch" pulls platform orders in, "Return Order Sync" turns platform returns into return orders, "Stock Push" pushes stock to the platform, and "Product mapping" rebuilds the product mapping. The four run independently — a failed return order sync does not affect order fetching |
| Status | "Success" everything went through; "Partial Failure" some succeeded and some failed; "Failed" nothing succeeded in this run, usually a credential or connection problem |
| Result | How many succeeded and how many failed in this run |
Rows with failure details can be expanded. Each expanded row is one failure: "Target" points at what failed (for return order syncing this is the platform's return order number, which you can look up directly in the store admin), "Error" is the reason, and where a "View API Log" link is shown you can open the full record of that call. A row marked "Entire run" means the whole run never got going, rather than one item failing. You also get a notification when a sync fails; opening it brings you back to this page with that run expanded.
Failures under "Return Order Sync" and what to do about them:
| Failure | What to do |
|---|---|
| A returned item could not be matched to a product | The whole return order is not created. The message contains the platform item codes that could not be matched, which you can look up in the store admin. Fix the mapping — press Sync Product Mappings to rebuild it, or go to "Unknown Products" and map the unmatched item on the source order to your product — and then do nothing else: any return order updated on the platform within the last 7 days is created on the next run |
| A returned item has no inventory type | The system does not know which inventory category these goods should come back into. Open the sales channel this account is bound to and make sure a primary inventory type is set; the return order is created on the next run |
| The whole run failed (Entire run) | Read the "Error" column — there are three cases. "Platform authorization expired" means the credentials or API key no longer work; the account is also marked "Disconnected" automatically, so reauthorize or update the credentials per the red alert at the top of the page and test the connection again. "The platform rejected this system's connection source" means our connecting IP is not on the platform's allowlist; reauthorizing does not help, so contact support for help. When the column shows the platform's own wording instead, these credentials most likely lack return-related permission on the platform, which you need to confirm in the store admin |
Section 2: FAQ
2.1 FAQ
▪ Why don't I see the "Fetch Orders Now" button?
This button appears only when the account is "connection healthy" and "order fetching enabled". If the account is disconnected, restore the connection first; if order fetching is off, enable it on the Edit page.
▪ Could "Manual Stock Sync" mess up platform stock?
It overwrites the platform's numbers in batch with the warehouse's current actual stock, by push percentage. If the platform had stock from other channels (not managed by this system), the overwrite makes this system's numbers authoritative. So confirm the push percentage is correct before running; the system also shows a confirmation dialog for you to confirm again.
▪ What does "Sync Product Mappings" do?
It re-matches the relationship between platform products and warehouse-system products. After you add products on the platform or fix a platform SKU, run a manual sync so the mapping updates immediately, preventing orders from becoming unknown products for lack of a match. It only updates the mapping table, not stock.
▪ Is "No mapped products" normal?
When you've just enabled inbound push and haven't synced mappings yet, it shows no mappings. Click "Sync Product Mappings" once to build them. Some platforms use real-time lookups and don't store a mapping table; for these, no mapped-product count is shown, which is normal.
▪ The account is disconnected — do I fix it on this page?
The red alert at the top guides you: authorization-based platforms click "Re-authorize" to re-authorize; key-based platforms click "Edit" to enter Edit, update, and re-test the credentials.
▪ What is "Return Order Sync" in the sync history? I never set it up
It is the record of Shopline return orders being brought in automatically. For a Shopline account that is connected and has order fetching turned on, Shopline notifies the system the moment a return is raised, completed or canceled, and the system reads the return order back from the platform and turns the ones your buyers requested or confirmed into return orders; it also checks the platform every 30 minutes to pick up any notification that went missing. These notifications are registered with Shopline automatically when a connection test succeeds — no setup from you, and neither you nor the warehouse has to create the return orders by hand. For the full behavior see the Return List.
▪ How do I stop return orders from coming in automatically?
Return order syncing follows the "order fetching" switch. Turn order fetching off on the Edit page and this account stops fetching orders and stops creating return orders. Return orders already created are not removed — process or cancel them as usual.
▪ The scheduled slot has passed but the orders are not in yet — why?
For your channels, the automatic fetches that run at the configured slots go one at a time, never simultaneously — this stops two channels from importing orders that contain the same product at the same moment and both being judged out of stock. A configured slot is therefore the earliest start time, not a guaranteed one: a channel waits for the one before it to finish, and the more channels you have (or the slower the platform responds), the more noticeable the delay.
This ordering covers scheduled fetches only. Pressing "Fetch Orders Now" yourself, and the single-order refetches triggered by a platform's real-time push, are not subject to it and may run alongside a scheduled fetch.
▪ The sync history is empty — does that mean nothing is syncing?
Not necessarily. A run with nothing to process and no failures leaves no record, so an empty list is normal right after connecting or when nothing changed on the platform. To tell whether anything is running, look at Next Fetch Time in the settings panel: for a scheduled round it only moves forward once that round finishes, so a time that has already passed usually means a fetch is in progress, not that it is stuck.
Pressing "Fetch Orders Now" behaves differently — that time jumps forward the moment you press it, so it cannot tell you whether the manual run has finished. Judge a manual fetch by the sync history instead (a new row appears only when there were orders to process or something failed).
▪ A message about real-time notification popped up as soon as I opened this page — did I click something?
No. Opening this page runs one automatic check of the account's real-time notification setup and fixes what is missing; the message appears only after something was actually fixed (see Automatic Real-Time Notification Check). The message lists which events the notification now covers. Nothing changed means no message at all, so seeing it tells you this visit really did complete the setup for this account.
▪ The message says the key has no real-time notification permission — what do I do?
Go to the e-commerce platform's admin, tick the real-time notification (webhook) permission on the authorization page, and regenerate the key. Then update the key on the edit page and test the connection. The next visit to this page completes the setup automatically and shows the success message. Until the permission is granted, orders keep arriving on the configured schedule — nothing is lost.
▪ What happens when I delete the account?
The account is removed from the list, its product mapping data is cleared along with it, and this cannot be undone. Before deleting, confirm this platform's orders no longer need to be handled through the system.
2.2 Notes
⚠️ Important
- "Manual Stock Sync" overwrites platform stock in batch — confirm the push percentage is correct before running
- Deleting an account also clears its product mapping data and cannot be undone
- While an account is disconnected, orders stop importing — restore the connection promptly per the top alert
- Turning off order fetching also stops Shopline return orders from being created automatically — both follow the same switch
- Return verification results are not written back to the platform; handle refunds and store credit yourself in the store admin
💡 Tip: When platform stock figures don't match the system, first confirm the push percentage and mapped products are correct, then run "Manual Stock Sync" once for a batch correction.
Section 3: Related Features
| Feature | Description | Link |
|---|---|---|
| EC Integrations (Edit) | Adjust the account's credentials and fetch, push, and shipping-mapping settings | Go |
| EC Integrations (List) | View and manage all EC accounts | Go |
| Platform API Logs | View this account's order-fetch and stock-push call records and failure reasons | Go |
| Return List | See the return orders created automatically from the platform and their progress | Go |