Edit EC Account
Table of Contents
Section 1: Features
Editing an EC account is for adjusting the settings of an existing account. The screen is the same as the create page, split into the left "Connection" and the right "Settings". The biggest difference from the create page: the connected e-commerce platform cannot be changed; everything else can be updated.

Quick Jump: Adjustable Items | Updating Credentials | Waybill Layout | Revoking Authorization
1.1 Adjustable Items
| Item | Changeable | Description |
|---|---|---|
| E-commerce Platform | No | The platform is locked after creation and cannot be changed |
| Display Name | Yes | Rename anytime |
| Channel Name | Yes | Can be re-bound to a different sales channel |
| Authorization Settings | Yes | See Updating Credentials |
| Fulfillment Warehouse | Yes | Affects only orders fetched after saving; orders already in the system do not move. See Create EC Account for what it affects |
| Order Fetching / Stock Push Method / Shipping Type Mappings | Yes | Right-half function settings, all adjustable while the connection is healthy |
| Waybill Layout | Yes | Shown for Momo, Mo+, Shopline and Cyberbiz accounts only (for Cyberbiz it applies to T-Cat quick store pickup only); see Waybill Layout |
The fetch time slots, Stock Push Method, push percentage, and Shipping Type Mappings are filled in and behave the same way as on the create page; see Create EC Account.
The right-side settings also have a dependency layer: while "Fetch Orders" is off, "Realtime New Order Fetch" and "Fetch Schedule" turn grey and cannot be edited; the same applies to "Push Percentage" while "Stock Push Method" is set to "Off". A note under the field says which switch to turn on or that a push method must be chosen first. Saved values are not cleared — turn the master switch back on or choose another push method and the field becomes editable again with its original content. When the push method is switched to "Scheduled sync (every 30 min)" from another option (including switching to "Off" and back), the next round first syncs everything once, correcting any platform figures that drifted while scheduled sync was not in use.
1.2 Updating Credentials
When changing a Shopify store domain, use the Shopify-provided store URL. See Create EC Account for the accepted format.
Authorizing Shopee, Shopify, or LiteShop ("Authorize & Connect" on this page, "Re-authorize" on the account detail page) and "Revoke Authorization" require signing in with permission to edit this merchant’s e-commerce integration; without edit permission, these buttons are disabled and show a lock icon. If network access restrictions apply, you must also use an allowed network, or the request is rejected. Revoke authorization using the button on this page; old revocation links no longer work. If you sign out, switch users, or lose permission during authorization, return to this page and start again.
Update credentials here when a platform key expires or you re-issue credentials. To protect secrets, existing credentials are shown masked. Once you enter a new credential value, the connection status automatically returns to "Not Verified" to remind you to re-test. After updating, click "Test Connection" again to confirm the connection is healthy, then save.
1.3 Waybill Layout (Momo, Mo+, Shopline and Cyberbiz)
Momo, Mo+, Shopline and Cyberbiz accounts get an extra "Waybill Layout" dropdown on the right half, offering "A4 (the platform's original layout)" or "Thermal Label (split into two sections)", A4 by default (on Cyberbiz accounts the thermal option reads "Thermal label (two sections stacked on one page)").
- Keep A4: printing is exactly as before — one waybill, one page.
- Switch to thermal: the system splits the A4 waybill the platform returns into a left and a right section, each printed as its own page, so a label printer can print it directly (Cyberbiz works differently, see below).
- Only home-delivery waybills are affected — Momo: T-Cat, Pelican, HCT, Kerry TJ; Mo+: T-Cat, HCT; Shopline: T-Cat only (including cash on delivery). Convenience-store pickup labels stay A4 and are not split (for Mo+ that covers 7-ELEVEN and FamilyMart, both warehouse-to-store and store-to-store); Shopline's HCT, cross-border and convenience-store labels stay A4 as well.
- Waybills produced by "batch tracking numbers" in a picking wave already come out as two split sections, so there is no need to reprint them just to apply the layout. Shopline labels are not produced during batch tracking numbers but the first time the waybill is printed, and they come out split as well.
- Only labels generated after the switch are affected. Reprinting a waybill that already has a label reuses the existing file and keeps its original layout, and there is no way to switch it over; the new layout only applies to waybills whose label is generated for the first time afterwards.
- Cyberbiz applies it to T-Cat quick store pickup only: the system takes the left and right sections of the A4 waybill Cyberbiz provides and stacks them on one page of about 95×195 mm (it does not split them into two pages); waybills of 7-ELEVEN, FamilyMart, Hi-Life, T-Cat home delivery, T-Cat cold chain, Pelican and HCT stay as they are. A quick-pickup waybill is produced the first time it is needed (the first print, or the pre-generation when a shipment enters QC), so only waybills first generated after the switch get the new layout.
- If the Cyberbiz layout fails, A4 is not printed instead; the waybill's label is marked as a print failure and the screen shows "Thermal layout failed; please print again. If it keeps failing, change this CyberBiz account's waybill layout back to A4". The waybill number is kept, and printing again fetches the file from Cyberbiz once more and lays it out again.
⚠️ Thermal cuts the platform's A4 waybill into two sections, and carriers may reject and return such shipments — confirm with the platform and the carrier before switching.
1.4 Revoking Authorization
For authorization-based platforms (Shopee, Shopify, LiteShop) in a connected state, a "Revoke Authorization" button appears on the left half; see Updating Credentials for the required permission and restrictions. Clicking it disconnects the account and stops fetching right away: Shopee first takes you to Shopee's authorization-revocation page and then back to this page; Shopify and LiteShop skip the platform page and return you straight to this page with a success message. The account is already disconnected when you leave this page, even if you do not finish on the Shopee page, and must be re-authorized to recover. If you only want to pause certain functions, turn off "Fetch Orders" on the right half instead of revoking authorization.
Ragic does not offer "Stock Push Method" or "Push Percentage" settings. Inbound imports use "Fetch inbounds" and a separate "Inbound fetch times". While "Fetch inbounds" is off, "Inbound fetch times" is greyed out and cannot be edited; turn the switch on to edit it. For the first connection, enter either an order sheet path or an inbound sheet path. An inbound-only account does not require an order sheet. Once connected, configure the import template, line-item subtable, import condition, and receipt write-back. After saving, check the Ragic inbound integration on the detail page.
For inbound-only use, turn off order fetching. The order sheet path, fetch schedule, import template, import conditions, shipment writeback, and "Shipping Type Mappings" are hidden. Turning order fetching back on restores these fields; saving while disabled preserves the existing order settings. Retesting an existing account saves the current inbound switch and settings together. If inbound fetching is turned off, it stays off even when you also change the API key or source sheet. After switching inbound sheets, matching record IDs on the new sheet can still be imported (document numbers must remain unique). Existing inbounds write back to their original sheet using the writeback fields saved at import. Closing receipt again in the same receiving cycle preserves the first completion time; reopening and completing creates a new writeback cycle. If a populated item lacks its SKU or an explicit date is invalid, the entire inbound is rejected. Correct the source data using the sync log.
Custom attribute defaults apply even without a mapped source column; an existing source value takes priority. Yes/no attributes accept Y/N or 1/0, and numbers and dates are converted according to the attribute type. Invalid values reject the entire inbound; correct them using the sync log, then fetch again. If Ragic rejects a receipt writeback or its service fails temporarily, the system retains the retry instead of marking the writeback as successful.
Section 2: FAQ
2.1 FAQ
▪ Why is "E-commerce Platform" locked?
The platform is fixed when the account is created and cannot be changed. If you picked the wrong platform, you can only delete this account and create a new one with the correct platform.
▪ Is it normal for the status to become "Not Verified" after updating credentials?
Yes. As soon as you enter a new credential value, the system resets the status to never-tested to remind you to re-test. Click "Test Connection" to confirm a successful connection before saving, or orders may fail to import because the credentials are unverified.
▪ I want to pause fetching for this platform without breaking the integration — how?
Turn off "Fetch Orders" on the right half; the connection is kept. While it is paused, cancellations and buyer cancellation requests are still applied on every platform: the local order is cancelled (or held if it can no longer be cancelled), or held with "Buyer Requested Cancellation". Other order and return notifications (new orders, status changes, returns) are not processed, show red in the Platform API Logs with reason: fetch_orders_disabled, and can be reprocessed one by one after turning order fetching back on. The exception is order notifications from Shopline, Free Store and Liteshop and cancellation-request notifications from BVSHOP: the platform has to be asked whether the order is cancelled, so for an order in the system that has not shipped yet, the system asks once as the notification arrives and applies only a cancellation or cancellation request. Those entries show green and cannot be reprocessed; if the lookup fails it is retried automatically, and once retries run out the entry turns red and can be reprocessed. Don't use "Revoke Authorization" — revoking disconnects the account and requires re-authorization to recover.
▪ New orders are not arriving during the fetch slots I set?
Platforms with realtime notifications (see the platform matrix) have "Realtime New Order Fetch" on by default, so a new-order notification from the platform schedules an extra fetch and the order usually reaches the system within a few minutes instead of waiting for the slots. Shopee waits about 5 minutes before fetching, and that wait is deliberate: Shopee has not assigned the shipping details the moment an order is placed, and fetching any earlier would leave the recipient phone as Shopee's redacted placeholder instead of the delivery contact number Shopee issues along with the shipping details. To make new orders arrive only during the slots you set, turn this switch off on the right half. Syncing of orders already in the system (such as cancellations and status updates) still runs as usual.
▪ After switching the waybill layout to thermal, do labels printed earlier change too?
No. The layout only affects labels generated after the switch. Reprinting a waybill that already has a label reuses the existing file and keeps its original layout, and there is no way to switch it over; the new layout only applies to waybills whose label is generated for the first time afterwards. Convenience-store pickup labels are unaffected either way — they stay A4 and are never split (except Cyberbiz's T-Cat quick store pickup, which is exactly the one the layout applies to).
▪ After switching to thermal, a Cyberbiz T-Cat quick store pickup waybill still prints as A4. Is something broken?
Usually not. The waybill's label was already generated before the layout was switched, so the reprint reuses the existing file and it stays A4; there is no way to switch it over to the new layout. Only quick-pickup orders whose label is generated for the first time after the switch get the thermal layout.
▪ Printing a Cyberbiz T-Cat quick store pickup waybill shows "Thermal layout failed; please print again. If it keeps failing, change this CyberBiz account's waybill layout back to A4". What should I do?
It means the thermal layout step failed, and the system does not print A4 instead (a thermal label printer cannot print an A4-sized waybill). The waybill number has already been obtained, so printing again does not request a new number; it only fetches the file from Cyberbiz once more and lays it out again, so print once more first. If it keeps failing, open this Cyberbiz account's edit page and set "Waybill Layout" back to "A4 (the platform's original layout)", then print again; the waybill then prints as the original A4 file from Cyberbiz.
▪ Does changing the push percentage take effect immediately?
It takes effect on save, and the next push applies the new percentage. When the push method is "Scheduled sync (every 30 min)", changing the push percentage or sales channel makes the next round sync everything once, so products with no stock changes are updated to the new figures too; for how platform stock updates after changing "Fulfillment Warehouse", see the next question. If the adjusted total across platforms reaches 100% (counted per warehouse actually used; accounts without a fulfillment warehouse count toward the default warehouse), the system warns you about the overselling risk on save.
▪ After changing "Fulfillment Warehouse", do orders already in the system move to the new warehouse?
No. The new fulfillment warehouse applies only to orders fetched after saving; orders already in the system keep their warehouse, and the platform re-syncing the same old order does not change it.
▪ After changing "Fulfillment Warehouse", does platform stock switch to the new warehouse's figures?
Not automatically, whichever push method you use: the system does not recalculate the current platform figures from the new warehouse. With "Scheduled sync (every 30 min)", only products that have stock changes afterwards are pushed with the new warehouse's quantity; with "Push on inbound", only restocks and stock-take gains completed in the new warehouse afterwards are pushed. When the account supports "Manual Stock Sync", a dialog appears after saving: "Go to Manual Sync" takes you to the details page, where clicking "Manual Stock Sync" switches the platform to the new warehouse's figures right away; "Later" returns to the list as usual. The dialog does not appear when the warehouse actually used stays the same (for example, going from unspecified to explicitly picking the default warehouse).
▪ Can I run "Sync Mapped Products" or "Manual Stock Sync" on the Edit page?
No. These two batch sync actions are on the Detail page. The Edit page only adjusts settings.
▪ Why can't I choose both "Push on inbound" and "Scheduled sync (every 30 min)"?
They are two alternative push methods. "Scheduled sync (every 30 min)" already covers restocks: completed inbounds and stock increases are stock changes too, so the next round (within about 30 minutes) pushes them with the latest available quantity instead of a separate increment; mixing increments and full overwrites on one account would double-count or miss quantities. Choose "Push on inbound" if you only want to add stock on the platform when goods come in, or "Scheduled sync (every 30 min)" if you also want shipping, order reservations, and other changes reflected on the platform. If "Stock Push Method" does not appear at all, this platform does not support "Manual Stock Sync" and therefore has no stock push.
2.2 Notes
⚠️ Important
- After updating credentials the status resets to "Not Verified" — be sure to re-test and save, or orders stop importing
- "Revoke Authorization" disconnects the account and stops fetching; it requires re-authorization to recover
- The platform (E-commerce Platform) cannot be changed; a wrong pick means delete and recreate
- "Scheduled sync (every 30 min)" does not deduct platform orders that have not been fetched into the system at push time, so the pushed figure can add already-sold quantity back onto the platform and cause overselling (scheduled sync waits for the same slot's scheduled fetches to finish before pushing, but orders placed after the fetch, or not fetched until a later fetch slot, are still not deducted); "Manual Stock Sync" carries the same risk. Platforms with realtime notifications can pair it with "Realtime New Order Fetch"; on other platforms, set more frequent fetch slots to narrow the gap
- "Scheduled sync (every 30 min)" only reacts to stock changes. In these cases the stock does not change but the figure the platform should show does, so it is not updated automatically; press "Manual Stock Sync" once after the change: a batch's expiry crosses the sales channel's expiry threshold, a single product's push percentage or push switch is changed, the sales channel's expiry rules or allowed inventory types are changed, or a platform product is newly mapped
- While the push method is "Scheduled sync (every 30 min)", inbounds do not push an increment and wait for the next scheduled round; if you switch to another push method after an inbound but before the next scheduled sync push, that inbound quantity never reaches the platform, so after switching to "Push on inbound" press "Manual Stock Sync" once
- "Thermal Label (split into two sections)" splits the A4 waybill into two sections, each on its own page (Momo / Mo+ / Shopline), and carriers may reject and return such shipments — confirm with the platform and the carrier before switching; Cyberbiz's "Thermal label (two sections stacked on one page)" instead takes two sections and stacks them on one page
💡 Tip: To pause some functions, turn off Order Fetching or set "Stock Push Method" to "Off" in the function settings — no need to revoke authorization or delete the account.
Section 3: Related Features
| Feature | Description | Link |
|---|---|---|
| EC Integrations (Detail) | View the full account setup; run Sync Mapped Products and Manual Stock Sync | 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 |