Skip to content

Edit EC Account ​


Table of Contents ​


1. Feature Overview ​

When you need to adjust an existing EC account, this is where you do it: change the display name, switch the linked sales channel, update authorization settings (keys, account credentials, etc.), or fine-tune order fetching and stock push. The edit page has the same layout as the create page—connection info on the left, feature settings on the right—but there are a few differences you only encounter when editing. Each is explained below.

Edit EC Account - Overview

Quick jump: Key differences when editing | Field reference | Changing authorization settings and reconnecting | Feature settings

1.1 Key differences when editing ​

Compared with creating a new account, editing an existing one differs in four ways—be sure to keep these in mind:

  • The e-commerce platform cannot be changed: The platform field is locked and cannot be selected when editing. An account is bound to its platform at creation; to switch platforms you must create a new account.
  • Automatically locked to the account's merchant: When you open the edit page, the system switches the working context back to the merchant this account belongs to. As a result, the sales channel, shipping type and "Fulfillment Warehouse" dropdowns show that merchant's options. Even if you switched to a different merchant in the header earlier, this account is unaffected—this prevents another merchant's channels from being saved onto this account.
  • Authorization settings are masked: Sensitive fields such as keys, passwords, and tokens are shown as ********, so you can't see the original values. You only need to fill in the fields you want to change; masked fields you leave untouched keep their original values.
  • Changing authorization settings resets the connection status to "Not Verified": See Changing authorization settings and reconnecting.

1.2 Field reference ​

Fields marked with * are required.

FieldHow to fill it inNotes
E-commerce PlatformRead-only; shows the platform this account is bound toCannot be changed when editing; to switch platforms, create a new account
*Display NameEnter the name shown in the list so you can identify this account laterFor example, multiple shops on the same platform can be labeled "Shopee-Main" / "Shopee-Second"
*Channel NameSelect which sales channel this account's orders are attributed toOnly this account's merchant's channels are listed; if not found, add it under "Sales Channels" first
Authorization Settings (authorization settings)Filled sensitive fields show as ********; fill in only the fields you want to changeChanging fields that affect the connection resets the connection status to Not Verified, see 1.3
Fulfillment WarehousePick one of the assigned warehouses of this account's merchant, or clear it to go back to the merchant's default warehouseAffects only orders fetched after saving; orders already in the system do not move, and re-fetching the same old order does not change its warehouse. Platform stock is not automatically recalculated from the new warehouse when you change it; see 1.4. For the options and what it affects, see Create EC Account
Fetch OrdersWhen on, the system automatically imports platform orders by scheduleThe account must be connected before this can be set. While it is off, cancellations and buyer cancellation requests are still applied on every platform (the order is cancelled, or held with "Buyer Requested Cancellation"), and other order and return notifications are not processed; see fetch_orders_disabled in the Platform API Logs. Order notifications from Shopline, Free Store and Liteshop and cancellation-request notifications from BVSHOP trigger one lookup on the platform as they arrive, and those entries show green
Fetch ScheduleChoose the daily times to auto-fetch orders, up to threeRequired when "Fetch Orders" is on; you can't save without selecting a time slot. While order fetching is off, this field is greyed out and cannot be edited, see 1.4
Realtime New Order FetchDecides whether new orders are fetched as soon as the platform notifies us (usually within a few minutes, about 5 minutes for Shopee), on by defaultShown only for platforms with realtime notifications (see the platform matrix); when off, new orders only arrive during the fetch slots, and syncing of orders already in the system (such as cancellations and status updates) is unaffected. While order fetching is off, this switch is greyed out and cannot be toggled
Waybill LayoutChoose whether waybills print as A4 or thermal, A4 by defaultShown for Momo, Mo+, Shopline and Cyberbiz accounts only; thermal splits the A4 waybill into a left and a right section, each on its own page. It affects home delivery only (Momo: T-Cat / Pelican / HCT / Kerry TJ; Mo+: T-Cat / HCT; Shopline: T-Cat only, including cash on delivery) and only labels generated after the switch — convenience-store labels and Shopline's HCT and cross-border labels stay A4. Cyberbiz applies it to T-Cat quick store pickup only (two sections stacked on one page, produced the first time it is needed; if the layout fails the A4 is printed and reprints reuse that file); other Cyberbiz carriers are not affected. Carriers may reject and return a split waybill, so confirm with the platform and the carrier before switching
Stock Push MethodChoose one: "Off" pushes no stock; "Push on inbound" pushes the added quantity to the platform when an inbound or a stock-count gain is completed; "Scheduled sync (every 30 min)" overwrites products whose stock changed with their current available quantity every 30 minutesThe account must be connected before this can be set; shown only on platforms that support "Manual Stock Sync". See Create EC Account for how each method works, and 1.4 for what happens when you switch to "Scheduled sync (every 30 min)"
Push PercentageEnter the share of stock to allocate to this platformRequired, an integer from 0–100 and cannot be left blank (older accounts that never set it are treated as 100% and show 100 on the edit page); an excessive combined total across platforms risks overselling, see 3.2. While "Stock Push Method" is set to "Off", this field is greyed out and cannot be edited
Shipping Type MappingsMap the platform's shipping options to warehouse-side shipping typesThis section appears only for some platforms; every row must have a warehouse shipping type selected before you can save. A Cyberbiz account also offers Cyberbiz's integrated shipping types, so when the merchant changes a code in the Cyberbiz back office and orders raise "Unmapped Shipping Type", map the new code here — see Add EC Account for how to fill it in

1.3 Changing authorization settings and reconnecting ​

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. After you revoke, Shopee first takes you to Shopee's authorization-revocation page and then back to this page; Shopify and LiteShop return you straight to this page with a success message. If you sign out, switch users, or lose permission during authorization, return to this page and start again.

Authorization settings (keys, account credentials, tokens, etc.) are the "keys" the system uses to connect to your e-commerce platform. Update them here when the platform reissues keys, or when you need to switch to a different set of credentials.

  • Fill in only the fields you want to change: Sensitive fields are shown as ********. When you save, the system only sends the values you actually changed; fields left as ******** keep their original authorization settings and are not cleared or overwritten.
  • Changing authorization settings disconnects the account and requires reconnecting: When you change an authorization field that actually affects the connection, saving resets the connection status to "Not Verified". Orders will not be imported until the status returns to "Connected".
    • Key-based platforms: The "Test Connection" button reappears on the left; the status returns to "Connected" only after a successful test.
    • Authorization-based platforms (such as Shopify and Shopee): You need to go through the platform authorization flow again to restore the connection.
  • Metadata fields that don't affect the connection won't disconnect: For a few platforms, metadata fields (such as return-center and shipping-origin codes) do not reset the connection status when changed.

1.4 Feature settings (right side) ​

Whether the right-side feature settings can be adjusted depends on the current connection status:

  • Connected (Connected): The right side is unlocked, and you can directly adjust "Fetch Orders", "Fetch Schedule", "Stock Push Method", "Push Percentage", and "Shipping Type Mappings".
  • Not connected (Not Verified or Disconnected): The right side is locked; complete the connection on the left first (test connection or re-authorize) to unlock it.

Once unlocked, the right-side settings have a second layer of dependencies: while a master switch is off, the settings under it have no effect and cannot be edited.

Master switchDependent settings
Fetch OrdersRealtime New Order Fetch, Fetch Schedule
Stock Push Method (when set to "Off")Push Percentage

While a master switch is off (or the push method is "Off"), its dependent settings turn grey and cannot be clicked, and a note under the field says which switch to turn on or that a push method must be chosen first. Your saved values are not cleared: turn the master switch back on or choose another push method and the fields become editable again, still showing what you had saved, with nothing to re-enter.

When "Stock 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. The same applies when you change "Push Percentage" or the sales channel while the push method is "Scheduled sync (every 30 min)": the next round syncs everything so products with no stock changes also get the new figures.

After you change "Fulfillment Warehouse", the system does not automatically recalculate platform stock from the new warehouse, whichever push method you use: 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 inbounds 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 immediately; "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 merchant's default warehouse).

When you're done, click "Save" at the bottom of the page to save; click "Cancel" to discard your changes and go back.


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.

2. FAQ ​

Quick jump: FAQ | Important notes

2.1 FAQ ​

▪ Why can't I change the e-commerce platform field? ​

The platform is bound when the account is created, and the integration logic, credential format, and shipping mappings all depend on it, so it can't be switched midway. To use a different platform, go to the "EC Integration List" and create a new account.

▪ I updated the authorization settings—what do I do next? ​

After updating and saving, the connection status returns to "Not Verified". Restore the connection according to your platform type: for key-based platforms, click "Test Connection" on the left; for authorization-based platforms, go through authorization again. Orders won't be imported until the status returns to "Connected". See Changing authorization settings and reconnecting.

▪ The authorization settings all show ********—what happens if I only want to change one field? ​

Just fill in the field you want to change and leave the rest as ********. When you save, the system updates only the fields you actually changed; fields shown as ******** keep their original values and are not cleared.

▪ What happens when I revoke authorization (for authorization-based platforms)? ​

Revoking authorization removes the authorized connection between this account and the platform, and the account immediately becomes disconnected. Until you re-authorize, this account will no longer import orders.

▪ If I switched to a different merchant in the header, will it set this account's channel incorrectly? ​

No. When the edit page opens, it automatically locks to the merchant this account originally belongs to, and the sales channel, shipping type and "Fulfillment Warehouse" dropdowns come from that merchant—independent of the merchant you selected in the header.

▪ 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 re-fetching the same old order does not change it. Orders that should ship from a different warehouse have to be handled on each order. For when platform stock switches to the new warehouse's figures, see 1.4.

▪ I turned on "Fetch Orders" but can't save? ​

When order fetching is on, "Fetch Schedule" is required. Select at least one time slot (up to three) before saving.

▪ "Fetch Schedule" has turned grey and I can't change it — is it broken? ​

No. It follows "Fetch Orders": while the master switch is off those time slots have no effect, so the page locks them rather than letting you believe fetching is still running. Turn "Fetch Orders" back on and it becomes editable again, with your saved slots still there. "Push Percentage" works the same way under "Stock Push Method", greyed out when it is "Off" — see the table in 1.4; on a Ragic account "Inbound fetch times" follows "Fetch inbounds" under the same rule.

▪ Why are the right-side feature settings locked and not editable? ​

Feature settings unlock only when the account is "Connected". If it's currently disconnected, first complete the test connection or re-authorize on the left, and the right side will become editable.

▪ 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 inbounds: inbounds and stock-count gains 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 allocation, and other changes reflected on the platform. "Stock Push Method" appears only on platforms that support "Manual Stock Sync"; unsupported platforms such as Ragic do not show it.

2.2 Important notes ​

⚠️ Important reminders ​

  • Changing authorization settings disconnects the account: After changing authorization fields that affect the connection, the status resets to "Not Verified", and orders stop importing until you reconnect.
  • The e-commerce platform cannot be changed: It's bound at creation; to switch platforms you must recreate the account.
  • Revoking authorization stops order imports: Once you revoke authorization on an authorization-based platform, the account becomes disconnected and orders stop importing; you must re-authorize to restore it.
  • Scheduled sync can add sold quantity back: "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

💡 Tip: When multiple platforms of the same merchant each have "Stock Push Method" set to something other than "Off" and their "Push Percentage" values combined reach or exceed 100%, the system warns you of overselling risk after saving—meaning the same stock is allocated to multiple platforms for sale at once. When the accounts use different warehouses, the check runs per warehouse instead: accounts are grouped by the warehouse they actually use (accounts without a "Fulfillment Warehouse" count toward the merchant's default warehouse), and the warning appears only when some warehouse reaches or exceeds 100%; accounts of different merchants are counted separately even when they use the same warehouse. Review each platform's push percentage to confirm the total matches your actual allocation strategy.


FeatureDescriptionLink
EC Account DetailView this account's connection status, fetch, and push settings overviewGo
EC Integration ListView all EC accounts, or create a new oneGo
Sales Channel DetailView the sales channel settings linked to the accountGo

Last updated 2026-11-16 19:57