Endpoints: Various NewBase API endpoints are called to retrieve product details, product groups, product properties, prices, currency rates, and stock information.

Data Format: JSON responses from the NewBase API.

Product Validation: Items are only processed if they are valid according to the IsProductValid logic. A product is valid if it is not marked as 'Blocked' in NewBase and if its 'TimeStart' and 'TimeEnd' (if set) indicate that the current date falls within the active period.

Product Filtering:

Stock Retrieval:

Multi-language Descriptions: The connector attempts to map descriptions to different language fields (Description, Description2, etc.) in App4Sales based on the language information provided by NewBase or the default language setting. A maximum of 5 distinct language descriptions are supported.

Base Price: NewBaseProduct.SalesPrice provides the fundamental sales price.

Price Breaks and Rebates: NewBaseProductPriceBreak and NewBaseDebtorRebate entities are fetched. These can define:

Discount Application: Discounts defined in NewBase are applied to the base sales price during the synchronization process if the 'Apply discounts during sync item prices call' setting is enabled.

Price Selection (V4): For NewBase API V4, if multiple price breaks apply to a single product, the connector can be configured (via the 'Select maximum price for product' setting) to either select the highest or lowest applicable sales price.

Currency Handling: Price lists are generated for each configured currency, with currency rates fetched from NewBase. The 'Used currency codes' setting allows filtering which currencies are processed.

Source: Images are referenced by a URL provided in NewBaseProduct.ImageUrl.

Process: The connector downloads the image from the specified URL.

Control: The 'Do not sync item pictures' setting can be used to disable image synchronization.

Stock Source: Stock information is retrieved from the NewBase API.

Warehouse Specificity: The 'Warehouse ID for stock' setting allows administrators to specify a particular warehouse whose stock should be synchronized. If not set, a default warehouse (ID 1) is used.

Item Code Adjustment for Stock Calls: To accurately retrieve stock, the item code sent to NewBase can be modified using the 'Item prefix to remove for stock' and 'Item prefix to use for stock' settings. This is useful for ERP systems that use different item code formats for stock lookups.

Exact Stock Values: The 'Do not use exact stock values' setting allows for obfuscation of precise stock quantities. If enabled, any positive stock value will be represented as 1, any negative as -1, and zero as 0.

Composition Products (V4): For NewBase API V4, the 'Calculate stocks for composition products' setting influences how stock is calculated for products composed of multiple components.

ItemClasses: A single ItemClass (ID 100) is created to represent the "Productgroep" (or custom name from setting). The value for this ItemClass is derived from NewBaseProductGroupInfo, which contains grouping information from NewBase.

ItemCategories: Several product details are mapped as ItemCategories:

Free Fields: The 'FreeSortField' can be populated from the product remark, offering a flexible way to transfer specific numerical attributes.

Matrix/Variant Handling: The current implementation does not explicitly define or handle parent-child relationships for matrix items (e.g., product variants like size/color combinations). Attributes like ItemClasses and ItemCategories serve to classify products, but a formal matrix structure for overriding data between parent and child items is not directly evident in the item update logic.

ApiVersion: (Required) Determines which NewBase API version (V2 or V4) to use for data retrieval.

ProductGroupName: (Optional) Customizes the display name for the 'Productgroep' ItemClass. Defaults to "Productgroep".

SkipDiscontinuedProducts: (Boolean) If true, products marked as discontinued in NewBase will not be synchronized.

SkipProductsWithoutSalesPrice: (Boolean) If true, products without a sales price in NewBase will not be synchronized.

SkipProductsWithNamePrefix: (String) Comma-separated list of prefixes. Products whose names start with any of these prefixes will be skipped during synchronization.

UseProductRemarkAsFreeSort: (Boolean) If true, the product's remark from NewBase will be used as the App4Sales FreeSortField.

DoNotSyncItemPictures: (Boolean) If true, product images will not be downloaded or synchronized.

WarehouseIdForStock: (Integer) Specifies the ID of the NewBase warehouse from which stock levels should be retrieved. Defaults to 1 if not specified.

ItemPrefixToRemoveForStock: (String) A prefix to be removed from the App4Sales item code before querying NewBase for stock.

ItemPrefixToUseForStock: (String) A prefix to be added to the item code when querying NewBase for stock.

NoExactValuesForStock: (Boolean) If true, stock values will be generalized (1, -1, or 0) instead of showing exact quantities.

UsedCurrencyCodes: (String) Comma-separated list of currency codes. Only price lists and prices matching these currencies will be synchronized.

SelectMaximumPriceForProduct: (Boolean, V4 only) If true, for products with multiple applicable prices, the highest sales price will be selected. Otherwise, the lowest will be selected.

ApplyDiscountsDuringSyncItemPricesCall: (Boolean) If true, discounts defined in NewBase price breaks will be applied to product sales prices during synchronization.

SyncOnlyProductsWithSubscriptionTypes: (String, V4 only) Comma-separated list of subscription types. Only products with these subscription types will be synchronized.

SyncOnlyServiceProducts: (Boolean, V4 only) If true, only products marked as service products in NewBase will be synchronized.

Matrix/Variant Handling: The current item update logic does not provide explicit mechanisms for managing complex matrix/variant product structures, such as distinct parent-child relationships where child items inherit and override specific attributes from a parent. ItemClasses and ItemCategories provide classification but not hierarchical variant management.

Image Limits: The connector downloads images one by one. Performance might be affected for items with a very large number of images.

Multi-language Description Limit: A maximum of 5 language-specific descriptions can be synchronized to App4Sales.