Configuration

Configuration

Open Stores > Configuration > Mage-OS > NetSuite. System > NetSuite > Settings opens the same section. Most fields are available only in default scope, and the central configuration resolver reads default scope. A store/website selector is not evidence that each flow supports independent credentials or settings per store.

Configure in dependency order

1. Keep ordinary synchronization disabled while setting the General connection and inventory mode.
2. Map product SKU/name, attribute defaults, and prices. Import or link the products used by test orders.
3. Configure customer identity/address fields, shipping, payment, taxes, and discounts.
4. Configure saved stock searches and stock ownership.
5. Enable only the required flows, process representative sandbox records, and check both systems.
6. Add the synchronization scheduler after the mappings are accepted.

Feature flags and shipped defaults

All paths in this table begin with mageos_netsuite/enable_disable_features/.

Path suffix	Flow	Shipped default
get_products	Product import	Enabled
get_product_images	Image import during product mapping	Enabled
send_customers	Customer-save export observer	Enabled
import_customers	Person-customer import	Not set; false when read as a boolean
send_orders	Order export observer	Enabled
get_order_changes	Existing-order updates	Enabled
send_invoices	Invoice export observer	Not set; false
get_cash_sales	Cash-sale import	Not set; false
get_credit_memo	Credit-memo import	Not set; false
get_cash_refund	Cash-refund import	Not set; false
get_shipments	Fulfillment import	Enabled
get_stock_updates	Saved-search stock updates	Enabled
import_location	Location import permission	Not set; false; location CLI path needs repair

The global mageos_netsuite/general/enabled default is 1. The inherited get_returns=1 default has no registered return-authorization processor. Do not treat it as an RMA feature.

Feature flags mainly control observers and scheduled searches. Several manual utilities invoke processors directly. They are not a reliable maintenance boundary, and disabling the integration does not unregister installation-wide stock plugins.

Settings groups

Group	Purpose
General and connection groups	Host/account, TBA credentials, timeout, inventory mode, and credential reuse.
Product synchronization	Attribute mapping, defaults, price levels, special/tier pricing, related/upsell links, images, HTML stripping.
Customer Settings / Customer Import Settings	Address identity field, import filter, new-customer store/group, required address fields, password-setup messages.
Order Settings	Initial NetSuite status, location, custom fields, return status map, discounts and promotion reporting.
Payment Methods	Payment-method/card-type mapping and website-specific processor configuration.
Taxes	Separate tax-item line or NetSuite tax calculation, with optional total/tax custom fields.
Shipping Methods	Shipping-item map/fallback, tracking carriers and notifications.
Stock options	Saved search IDs, quantity field, stock-status behavior, update interval.
Queue processing	Import/export batch targets, lookback, duplicate replacement; the advertised retry timeout is not enforced by queue selection.
Monitoring / Developer	Payload/history retention, log detail, recipients, stale-run messages and warning thresholds. Warning counts have a known source defect.

Use Configuration reference for every field, exact path, and declared default. The reference distinguishes shipped values from example values in the older book.

Defaults that must be reviewed

The default product website/store/attribute-set IDs are 1, 1, and 4. The price-level map contains example group-to-price-level entries. Image fields default to custitem_item_zoom_image_1 through _4. Customer import has fallback US address data. These are not automatically appropriate for another store or NetSuite account.

Sources: defaults, admin fields, configuration resolution, permissions and processor registration.