Skip to content

Create EC Account ​


Table of Contents ​


Section 1: Features ​

Creating an EC account is the setup page that connects one e-commerce platform (Shopee, Momo, Shopify, Shopline, etc.) to the warehouse system. The screen splits into two halves: on the left, "Connection" is where you fill in the platform and integration credentials and establish the connection; once connected, the right half, "Settings", unlocks so you can configure auto fetching, stock push, and more. The order is fixed — connect first, then configure functions.

Create EC Account - Page Overview

Quick Jump: Connection Info | Test & Authorize | Function Settings

1.1 Connection Info (left half) ​

Fields marked with * are required

FieldHow to FillNotes
*E-commerce PlatformSelect the platform to connect from the listCannot be changed after creation — confirm you pick the right platform
*Display NameGive the account an easily recognizable nameUsed to tell multiple accounts on one platform apart
*Channel NameSelect the sales channel to bind this account toIf no channel is available, create one under "Merchant Channels" first; the channel determines the shipping inventory type and rules
Authorization SettingsFill in the integration credentials (keys, secrets) for the chosen platformFields vary by platform; key-based platforms require this before testing the connection

After selecting a platform, the platform-specific credential fields appear below. Credentials come from the platform's seller backend or developer settings, and each platform requires different fields.

For Shopify, enter the Shopify-provided store domain, such as shop-name.myshopify.com. You can also paste the full store URL; the system keeps the domain portion. A custom branded domain or another host cannot be saved.

1.2 Test & Authorize ​

E-commerce platforms come in two integration types, and the button at the bottom appears automatically by platform:

Platform TypeActionDescription
Key-based (e.g. Momo, WooCommerce)Fill credentials, then click "Test Connection"The system verifies credentials immediately; on success the status turns to "Connected"
Authorization-based (e.g. Shopee, Shopify)Click "Authorize & Connect"You are redirected to the platform's authorization page; after you log in and consent, you return and the status turns to connected

When the connection fails, the system shows the reason below the button (e.g. wrong credentials, platform reports unauthorized). Check that credentials are correct per the message, then try again.

1.3 Function Settings (right half) ​

The right half is locked until the connection succeeds. Only after a successful connection does it unlock, where you can configure:

▸ Fulfillment Warehouse ​

At the top of the settings. It appears when the warehouse has enabled two or more warehouses for you, or when this account already has a fulfillment warehouse set (not shown for OneWarehouse accounts), lists only the warehouses enabled for you, and several platform accounts can pick the same warehouse. Once set, orders this account fetches from then on ship from this warehouse, and the stock pushed to the platform counts only this warehouse: manual sync and scheduled sync use only this warehouse's available quantity, and restocks and stock-take gains are pushed to this account only when they happen in this warehouse; the push percentage and the sales channel's inventory type and expiry limits still apply. Platform return orders that cannot be matched to the original order also return to this warehouse. Left empty, the field shows "Use the merchant's default warehouse (currently: warehouse name)": orders ship from your default warehouse and the pushed stock counts only the default warehouse. If the warehouse later changes your default warehouse, these accounts switch to the new default warehouse. Use it to keep store or B2B warehouse stock apart from your online shop, so the same goods are not sold in several places at once and oversold. It can still be set while order fetching and stock push are both off, with a note below it that the setting has no effect for now. If you pick a warehouse other than the default after testing the connection or authorizing and then save, a dialog reminding you to sync manually appears when the account supports "Manual Stock Sync"; see Edit EC Account.

▸ Order Fetching ​

SettingDescription
Fetch OrdersWhen on, new platform orders import into the warehouse automatically
Fetch SchedulePick the daily fetch time slots, up to 3; at least one slot is required when order fetching is on. While order fetching is off, this field is greyed out and cannot be edited
Realtime New Order FetchShown only for platforms with realtime notifications (see the platform matrix), on by default. When on, a new-order notification from the platform schedules an extra fetch and the order usually reaches the system within a few minutes (about 5 minutes for Shopee); when off, new orders only arrive during the slots above, 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 LayoutShown for Momo, Mo+, Shopline and Cyberbiz accounts only, A4 by default. With thermal, the system splits the platform's A4 waybill into a left and a right section, each on its own page; it affects home-delivery waybills only (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, and so do Shopline's HCT and cross-border labels. Cyberbiz's thermal layout applies to T-Cat quick store pickup only: it takes two sections of the A4 waybill Cyberbiz provides and stacks them on one page of about 95×195 mm, and other Cyberbiz carriers are not affected. Carriers may reject and return a split waybill, so confirm with the platform and the carrier first

▸ Stock Push ​

SettingDescription
Stock Push MethodShown only on platforms that support "Manual Stock Sync"; choose one of three, "Off" by default on a new account. "Off": no stock is pushed to this platform. "Push on inbound": each restock automatically pushes the added quantity times the push percentage to this platform; shipping, order reservations, and other changes are not reflected on the platform. "Scheduled sync (every 30 min)": while the account is connected, the system runs a round every 30 minutes (on the hour and half hour): each product whose stock changed since the previous round is overwritten on the platform with its current available quantity times the push percentage — the same calculation as "Manual Stock Sync"; products with no changes are not pushed. Any kind of change counts: shipping, orders reserving stock or releasing it on cancellation, moves within the warehouse, putaway, stock takes, and stock adjustments (including write-offs). When the same merchant has accounts with a scheduled order fetch in that slot, the push waits until those fetches finish (successful or not) so that freshly fetched orders finish reserving stock first. With this method, restocks do not push a separate increment; the next round updates them. The first round after switching to this method syncs everything once, the same as pressing "Manual Stock Sync"
Push PercentageRequired: enter 0–100 (default 100, cannot be left blank) to control the share of stock pushed to this platform, applied by both "Push on inbound" and "Scheduled sync (every 30 min)"; used to allocate across platforms when the same product sells on several, preventing overselling. While "Stock Push Method" is set to "Off", this field is greyed out and cannot be edited, so on a new account it starts out greyed

▸ Shipping Type Mappings ​

Some platforms (e.g. Shopee) support mapping the platform's shipping options to warehouse-side shipping types, matched automatically on shipment. Just map each platform shipping code to a warehouse-side shipping type under "Shipping Type Mappings".

For a Cyberbiz account, the warehouse-side dropdown lists Cyberbiz's integrated shipping types (for example Cyberbiz T-Cat and Cyberbiz HCT) on top of the shipping types the warehouse has enabled for you; accounts on other platforms are unchanged and list only the shipping types the warehouse has enabled. If you change a shipping method code in the Cyberbiz back office, incoming orders raise an "Unmapped Shipping Type" notification; map that code to the correct Cyberbiz integrated shipping type and the orders resume automatic conversion, tracking-number requests, and label printing — you do not have to restore the old code in the back office.

Once everything is set, click the save button at the bottom to finish, and the page returns to the EC account list.


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, and since "Fetch inbounds" is off by default on a new account, it starts out greyed as soon as the page opens; 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 ​

Quick Jump: FAQ | Notes

2.1 FAQ ​

▪ Why are the function settings on the right grayed out and unclickable? ​

Function settings unlock only after a successful connection. Fill in the platform and credentials on the left, complete "Test Connection" or "Authorize & Connect", and once the status turns to "Connected" the right half opens up.


▪ What if I can't select a sales channel? ​

It means this brand has no channel yet. Go to "Data Management" → "Merchant Channels" to create one (it determines the platform's shipping inventory type, expiry, and shipping rules), then come back to create the EC account.


▪ I picked the wrong "E-commerce Platform" — can I change it? ​

The platform cannot be changed after creation. If you picked wrong, you can only delete this account and create a new one. All other fields (display name, channel, credentials, function settings) can be adjusted later on the Edit page.


▪ Why does the connection test keep failing? ​

The most common cause is mistyped credentials or extra copied whitespace, followed by insufficient key permissions on the platform side, or authorization not yet in effect. The system shows the platform's specific reason below the button — check each credential against the message. For authorization-based platforms, confirm you actually logged in and consented on the authorization page.


▪ Why don't I see the "Fulfillment Warehouse" field? ​

The field appears when the warehouse has enabled two or more warehouses for you—with a single warehouse, orders and stock push use that warehouse anyway, so choosing makes no difference. The exception is an account that already has a fulfillment warehouse set: it still shows the field with only one warehouse left, so you can clear it and go back to the default warehouse. OneWarehouse accounts don't show it either, because their orders are pushed in by OneWarehouse and no stock is pushed. Contact the warehouse if you need another warehouse enabled.

▪ What should I set the push percentage to? ​

If this product sells only on this one platform, set 100. If the same product sells on several platforms, allocate a percentage to each, totaling no more than 100, to avoid overselling. Percentages are totaled per warehouse actually used (accounts without a "Fulfillment Warehouse" count toward the default warehouse): the accounts on the same warehouse should stay within 100, and the save-time warning follows the same rule. When unsure on a fresh integration, leave "Stock Push Method" at "Off" and choose a method later on the Edit page.


▪ How does "Push on inbound" differ from "Scheduled sync (every 30 min)"? Which should I choose? ​

"Push on inbound" only pushes the added quantity to the platform when stock is restocked; shipping, order reservations, stock-count losses and other changes never reach the platform, so over time the platform figures drift from the warehouse. "Scheduled sync (every 30 min)" overwrites changed products with their current available quantity every 30 minutes, closing that gap; restocks are changes too, so with it completed inbounds no longer push an increment and the next scheduled round updates them with the latest quantity instead. The two are alternative push methods and cannot be combined. Read the overselling risk under Notes before choosing "Scheduled sync (every 30 min)".


▪ Do I have to configure fetching and pushing right when creating? ​

No. You can save as soon as the connection succeeds and add settings anytime on the Edit page. It's best to enable only "Order Fetching" at first, then choose a stock push method and other advanced features once you're comfortable.

2.2 Notes ​

⚠️ Important ​

  • "E-commerce Platform" cannot be changed after creation; a wrong pick means delete and recreate
  • When "Fetch Orders" is on, at least one fetch time slot is required, or you cannot save
  • Push percentages totaling over 100% across platforms cause overselling; they are totaled per warehouse actually used (accounts without a "Fulfillment Warehouse" count toward the default warehouse)
  • "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: After creating and connecting successfully, run a few orders through the complete flow before enabling full-volume fetching — it's the easiest way to catch setup gaps.


FeatureDescriptionLink
EC Integrations (List)View and manage all EC accountsGo
Sales ChannelThe channel setup you must create before adding an EC accountGo
EC Integrations (Edit)Adjust the credentials and function settings of an existing accountGo

Last updated 2026-11-16 19:57