-
Notifications
You must be signed in to change notification settings - Fork 2
Configuration Reference
Matt MacDougall edited this page Sep 9, 2026
·
1 revision
This reference is generated from the reviewed Admin system XML and default configuration. It lists 117 declared Admin fields, including actions, and additional defaults without a matching Admin field.
Paths are exact. "Not declared" means this module does not ship a value at that exact path; it is not a claim that a running installation has an empty value. Defaults may be example IDs for a different account. Serialized mapping arrays must be managed through the appropriate Admin field or a deliberately validated configuration process.
Most fields are exposed at default scope. The central resolver reads default configuration; do not infer per-website connections merely because the section can be displayed at website/store scope. Field dependencies and renderer behavior are defined in the linked XML.
-
general/enableddefaults to 1. Select and verify flows before starting workers. -
orders/logic_switchhas no shipped default. Explicitly savebodyorline; the discount mappers reject an empty or unregistered provider. -
general/nsendpointis a code default, not an exposed endpoint dropdown. The default is SOAP2024_2. -
customer/magento_address_id_fieldis the actual customer-export path. The defaultcustomers_import/magento_address_id_fieldis misplaced. - Product, price-level, website, store, and group defaults are not universal business mappings.
- The inherited stock update interval defaults to 360 minutes.
updatestocksdoes not bypass it. -
queue_processing/timeoutis not used to delay selection by the custom queue implementation. -
enable_disable_features/get_returnsdoes not register a return-authorization processor. - Developer queue warning and mail settings do not prove functioning alert delivery. See Monitoring.
- Secret fields are declared as text and have no encrypted backend declaration in this module. Use restricted application configuration and avoid exposing credentials in exports or diagnostics.
The Configuration guide explains setup order and default flows. Each feature guide describes how these fields are actually consumed.
Path prefix: mageos_netsuite/general.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/general/enabled |
Enable integration | select | 1 |
mageos_netsuite/general/auth_type |
Authentication type | select | token |
mageos_netsuite/general/host |
NetSuite Host | text | Not declared |
mageos_netsuite/general/account_id |
NetSuite account id | text | Not declared |
mageos_netsuite/general/consumer_key |
Consumer key | text | Not declared |
mageos_netsuite/general/consumer_secret |
Consumer secret | text | Not declared |
mageos_netsuite/general/token_id |
Token Id | text | Not declared |
mageos_netsuite/general/token_secret |
Token secret | text | Not declared |
mageos_netsuite/general/test_connection |
Test Connection | action | Not declared |
mageos_netsuite/general/netsuite_base_url |
NetSuite Base url | custom/default | Not declared |
mageos_netsuite/general/soap_request_timeout |
Soap Request timeout | custom/default | 180 |
mageos_netsuite/general/inventory_mode |
Inventory mode | select | single |
Path prefix: mageos_netsuite/connection_import.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/connection_import/same |
Same as default connection? | select | 1 |
mageos_netsuite/connection_import/auth_type |
Authentication type | select | Not declared |
mageos_netsuite/connection_import/consumer_key |
Consumer key | text | Not declared |
mageos_netsuite/connection_import/consumer_secret |
Consumer secret | text | Not declared |
mageos_netsuite/connection_import/token_id |
Token Id | text | Not declared |
mageos_netsuite/connection_import/token_secret |
Token secret | text | Not declared |
mageos_netsuite/connection_import/test_connection |
Test Connection | action | Not declared |
Path prefix: mageos_netsuite/connection_export.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/connection_export/same |
Same as default connection? | select | 1 |
mageos_netsuite/connection_export/auth_type |
Authentication type | select | Not declared |
mageos_netsuite/connection_export/consumer_key |
Consumer key | text | Not declared |
mageos_netsuite/connection_export/consumer_secret |
Consumer secret | text | Not declared |
mageos_netsuite/connection_export/token_id |
Token Id | text | Not declared |
mageos_netsuite/connection_export/token_secret |
Token secret | text | Not declared |
mageos_netsuite/connection_export/test_connection |
Test Connection | action | Not declared |
Path prefix: mageos_netsuite/enable_disable_features.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/enable_disable_features/get_products |
Enable getting product data from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/get_product_images |
Enable getting product images from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/send_customers |
Enable sending customers changes to NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/import_customers |
Enable getting customer data from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/send_orders |
Enable sending orders to NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/get_order_changes |
Enable getting order changes from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/send_invoices |
Enable sending invoices NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/get_cash_sales |
Enable getting cash sale/invoice data from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/get_credit_memo |
Enable importing credit memos from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/get_cash_refund |
Enable importing cash refunds from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/get_shipments |
Enable getting shipment data from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/get_stock_updates |
Enable getting stock updates from NetSuite | select | Not declared |
mageos_netsuite/enable_disable_features/import_location |
Enable getting locations from NetSuite | select | Not declared |
Path prefix: mageos_netsuite/products.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/products/cache_seconds_for_lists_and_custom_records |
Cache lists and custom records for | text | 3600 |
mageos_netsuite/products/field_map |
Field Mapping | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
mageos_netsuite/products/price_level_netsuite_id |
Price level to grab the price from | text | Not declared |
mageos_netsuite/products/import_special_price |
Product Special Price Import Behavior | select | Not declared |
mageos_netsuite/products/special_price_price_level |
Special Price Price level | text | Not declared |
mageos_netsuite/products/default_visibility |
New product default visibility | select | Not declared |
mageos_netsuite/products/default_status |
New product default status | select | Not declared |
mageos_netsuite/products/default_tax_class_id |
New product default tax class | select | Not declared |
mageos_netsuite/products/default_website_ids |
Product default web site ids | multiselect | Not declared |
mageos_netsuite/products/default_store_ids |
Product default store ids | multiselect | Not declared |
mageos_netsuite/products/default_attribute_set_id |
New product default attribute set id | select | Not declared |
mageos_netsuite/products/tier_price_customer_group |
Imported tier price customer group | select | Not declared |
mageos_netsuite/products/push_line_items_with_bundles |
Push line items with fixed price bundles | select | Not declared |
mageos_netsuite/products/related_products_field |
Related Products Field Name | text | Not declared |
mageos_netsuite/products/upsells_field |
Upsells Field Name | text | Not declared |
mageos_netsuite/products/html_tags |
Eav Attributes to Strip HTML Tags | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
mageos_netsuite/products/image_attribute_ns_ids |
NS attributes for images | text | Not declared |
mageos_netsuite/products/base_image_attribute_ns_id |
NS attributes for base image | text | Not declared |
mageos_netsuite/products/import_files_based_on_filename |
Compare image file name before import | select | Not declared |
mageos_netsuite/products/price_level_map |
Price Level Mapping | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
Path prefix: mageos_netsuite/queue_processing.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/queue_processing/export_batch_size |
Export message limit | text | 100 |
mageos_netsuite/queue_processing/import_batch_size |
Import message limit | text | 100 |
mageos_netsuite/queue_processing/timeout |
Timeout | text | 100 |
mageos_netsuite/queue_processing/updated_from_minutes |
Import items updated in last N minutes | text | 15 |
mageos_netsuite/queue_processing/delete_existing_items_in_import_queue |
Delete existing items in import queue | select | 0 |
Path prefix: mageos_netsuite/monitor.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/monitor/remove_if_success |
Remove Monitoring Item if processed successfully | select | Not declared |
mageos_netsuite/monitor/debug_level |
Level of information to be saved | select | Not declared |
mageos_netsuite/monitor/lifetime |
Clean up Entries older then X days | text | 30 |
Path prefix: mageos_netsuite/developer.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/developer/email |
Developer E-mail | text | Not declared |
mageos_netsuite/developer/sender_email_identity |
Email Sender | select | general |
mageos_netsuite/developer/mail_errors |
E-mail errors and exceptions | select | 0 |
mageos_netsuite/developer/export_queue_threshold |
Export queue threshold | text | 100 |
mageos_netsuite/developer/import_queue_threshold |
Import queue threshold | text | 100 |
mageos_netsuite/developer/warn_if_import_not_run_after |
Warn if import not run after (hours) | text | Not declared |
mageos_netsuite/developer/warn_if_export_not_run_after |
Warn if export not run after (hours) | text | Not declared |
mageos_netsuite/developer/warn_if_stock_not_run_after |
Warn if stock not run after (hours) | text | Not declared |
Path prefix: mageos_netsuite/customer.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/customer/magento_address_id_field |
Magento Address Id Field | text | Not declared |
Path prefix: mageos_netsuite/customers_import.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/customers_import/is_importable_field_id |
NetSuite Customer "Export to Magento" Field Id | text | Not declared |
mageos_netsuite/customers_import/default_store_id |
Default Store | select | Not declared |
mageos_netsuite/customers_import/default_customer_group |
Default Customer Group | select | Not declared |
mageos_netsuite/customers_import/required_address_fields |
Required Address Fields | multiselect | Not declared |
mageos_netsuite/customers_import/login_message |
Login Message | select | Not declared |
mageos_netsuite/customers_import/registration_message |
Registration Message | select | Not declared |
Path prefix: mageos_netsuite/orders.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/orders/default_order_status |
Default order status | select | Not declared |
mageos_netsuite/orders/location_id |
Order Location Id | text | Not declared |
mageos_netsuite/orders/custom_fields_mapping |
Custom fields that are to be synched between Magento and NetSuite | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
mageos_netsuite/orders/status_map |
Status Mapping | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
mageos_netsuite/orders/discount_item_id |
Default discount item internal id | text | Not declared |
mageos_netsuite/orders/logic_switch |
Select Where to Export the Discount | select | Not declared |
mageos_netsuite/orders/disable_order_level_discount |
Add Discount Per Item | select | Not declared |
mageos_netsuite/orders/add_promotion_data |
Add Promotion Data for each Item | select | Not declared |
Path prefix: mageos_netsuite/payment_methods.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/payment_methods/netsuite_mapping |
Mapping between Magento and NetSuite payment methods | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
mageos_netsuite/payment_methods/processor_mapping |
Mapping between Magento payment methods and NetSuite payment processors | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
Path prefix: mageos_netsuite/tax.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/tax/tax_logic |
Tax Handling Logic | select | Not declared |
mageos_netsuite/tax/not_taxable_internal_netsuite_id |
Not Taxable" code internal NetSuite id | text | Not declared |
mageos_netsuite/tax/tax_item_internal_netsuite_id |
Tax item internal NetSuite id | text | Not declared |
mageos_netsuite/tax/sales_order_tax_amount_id |
Sales Order Field to add Tax Amount for order | text | Not declared |
mageos_netsuite/tax/sales_order_total_amount_id |
Sales Order Field to add Total Amount for order | text | Not declared |
Path prefix: mageos_netsuite/shipping_methods.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/shipping_methods/netsuite_mapping |
Mapping between Magento and NetSuite shipping methods | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
mageos_netsuite/shipping_methods/netsuite_default_shipping_id |
If none of the rules above match, use this NetSuite shipping item internal id: | text | Not declared |
mageos_netsuite/shipping_methods/default_tracking_code_carrier |
Default tracking number carrier | select | Not declared |
mageos_netsuite/shipping_methods/tracking_mapping |
Mapping between Magento Tracking number types and Netsuite shipping methods | custom/default; backend: Magento\Config\Model\Config\Backend\Serialized\ArraySerialized
|
Not declared |
mageos_netsuite/shipping_methods/send_tracking_information_on_import |
Send tracking information when receiving tracking numbers from NetSuite | select | Not declared |
Path prefix: mageos_netsuite/connection_stock.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/connection_stock/same |
Same as default connection? | select | Not declared |
mageos_netsuite/connection_stock/auth_type |
Authentication type | select | Not declared |
mageos_netsuite/connection_stock/consumer_key |
Consumer key | text | Not declared |
mageos_netsuite/connection_stock/consumer_secret |
Consumer secret | text | Not declared |
mageos_netsuite/connection_stock/token_id |
Token Id | text | Not declared |
mageos_netsuite/connection_stock/token_secret |
Token secret | text | Not declared |
mageos_netsuite/connection_stock/test_connection |
Test Connection | action | Not declared |
Path prefix: mageos_netsuite/stock.
| Field | Label | Type | Shipped default |
|---|---|---|---|
mageos_netsuite/stock/stock_location |
Location Internal Id | text | Not declared |
mageos_netsuite/stock/stock_stored_at_location_level |
Stock stored at location level? | select | Not declared |
mageos_netsuite/stock/qty_field_name |
Quantity field name | text | Not declared |
mageos_netsuite/stock/qty_field_type |
Quantity field type | select | Not declared |
mageos_netsuite/stock/update_stocks_every_n_minutes |
Update the stocks every N minutes | text | Not declared |
mageos_netsuite/stock/custom_search_id |
Saved stock search internal id | custom/default | Not declared |
mageos_netsuite/stock/custom_search_page_size |
Page size for the saved search query | custom/default | Not declared |
mageos_netsuite/stock/change_stock_status_under_zero |
Change stock status when under zero items | select | Not declared |
These are configuration declarations, including legacy/orphan defaults and nested mapping examples. A declaration does not guarantee an active consumer.
| Path | Shipped value |
|---|---|
mageos_netsuite/general/nsendpoint |
2024_2 |
mageos_netsuite/enable_disable_features/get_returns |
1 |
mageos_netsuite/queue_processing/delete_existing_items_in_import_queue_hours |
1 |
mageos_netsuite/developer/errorlog_lifetime |
100 |
mageos_netsuite/developer/import_record_limit |
300 |
mageos_netsuite/developer/export_queue_threshold_email_template |
mageos_netsuite_developer_export_queue_threshold_email_template |
mageos_netsuite/developer/import_queue_threshold_email_template |
mageos_netsuite_developer_import_queue_threshold_email_template |
Mage-OS Labs · Source · Reviewed commit fec65e2 · September 9, 2026 · Validation and limitations
Mage-OS NetSuite Connector
Setup
Data flows
Operations and development