Specter - Connector Settings
This document details the connector-specific settings for the Specter connector, explaining their purpose, acceptable values, and impact on connector behavior. These settings are configured via the App4Sales portal UI and are applied at runtime to manage data synchronization, pricing, stock, order processing, and authentication with the Specter ERP system.
All settings are stored in the App4Sales portal UI, allowing administrators to configure the connector without direct code access. These settings are retrieved by the connector during its operations (e.g., synchronization cycles, order processing) to customize its behavior according to the specific needs of the Specter environment.
Setting | Description | Values / Defaults | Dependencies / Effects |
API SBM ID | This unique identifier, provided by Specter, is crucial for authenticating and routing API requests to the correct Specter environment. | Integer value. | Required for all API communications. Incorrect value will result in authentication failures and prevent all data synchronization. |
API Write User ID | The User ID used for authentication when the connector performs write operations (e.g., sending orders) to the Specter API. | String value, provided by Specter. | Used in conjunction with API Write User Key for authentication during write operations. |
API Write User Key | The API key associated with the API Write User ID, provided by the customer. This key is encrypted for security. | String value, provided by the customer. Encrypted. | Used in conjunction with API Write User ID for authentication during write operations. |
API Read User ID | The User ID used for authentication when the connector performs read operations (e.g., fetching items, customers) from the Specter API. | String value, provided by Specter. | Used in conjunction with API Read User Key for authentication during read operations. |
API Read User Key | The API key associated with the API Read User ID, provided by the customer. This key is encrypted for security. | String value, provided by the customer. Encrypted. | Used in conjunction with API Read User ID for authentication during read operations. |
Article Group Name | Specifies the name of the article group to be used when synchronizing items. This can be used to filter items by a specific group. | String value. | Influences which items are synchronized based on their article group in Specter. |
Vat Percentages | Defines the VAT percentages to be used, mapped by their Specter VAT ID. The format is a semicolon-separated list of "VAT ID~percentage" pairs. | Example: | Used for correct VAT calculation on orders and items within App4Sales. |
Set Order Date As Delivery Date | When enabled, the order date will automatically be set as the delivery date for new orders. | Boolean (true/false). Default: false. | If true, streamlines order entry by defaulting the delivery date to the order date. |
Only Send Discount | If enabled, only discount information will be sent for order lines, rather than full price overrides. | Boolean (true/false). Default: false. | Affects how pricing is communicated to Specter for order lines. |
Published comment on order | A predefined comment that will be added to orders when they are sent to Specter. This comment is visible to the customer. | String value. | Provides additional customer-facing information on orders within Specter. |
Requirements and conditions on order | Specifies any standard requirements or conditions that should be applied to orders when sent to Specter. | String value. | Used to enforce business rules or terms and conditions on orders. |
Payment condition suffix | The suffix to be appended to payment conditions (e.g., "dagar" for days). Defaults to "dagar" if not specified. | String value. Default: "dagar". | Appears on payment terms within Specter. |
Payment condition text for 0 days | The specific text to be used for payment conditions that equate to 0 days (e.g., "Cash"). | String value. | Customizes the display of immediate payment terms. |
Warehouses | A semicolon-separated list of warehouse codes from Specter that the connector should recognize and use. | Example: | Filters available warehouses and ensures correct stock retrieval and order allocation. |
Default currency for customers | Sets a default currency for customers if no specific currency is provided by Specter. | String value (e.g., "EUR", "USD"). | Ensures customers always have a currency assigned, preventing potential errors in pricing. |
Only sync items marked as Webshop item | When enabled, only items explicitly marked as "Webshop item" within Specter will be synchronized to App4Sales. | Boolean (true/false). Default: false. | Limits the item catalog in App4Sales to a subset intended for web sales. |
Show internal information on relation card | If true, internal alert text or notes from Specter will be displayed on the customer (relation) card in App4Sales. | Boolean (true/false). Default: false. | Provides App4Sales users with critical internal information about customers. |
Warehouse ID (numeric!) for new orders | Specifies the numeric ID of the warehouse in Specter to which new orders created in App4Sales should be assigned. | Numeric string value (e.g., "101"). | Directs new orders to a specific warehouse for processing. |
Show shelf stock instead of available stock | If enabled, the connector will retrieve and display "shelf stock" quantities from Specter rather than the standard "available stock." | Boolean (true/false). Default: false. | Alters how stock levels are presented in App4Sales, potentially reflecting physical shelf quantities. |
Supported language codes for extra descriptions | A comma-separated list of language codes for which extra item descriptions should be synchronized from Specter. | Example: | Enables multilingual item descriptions within App4Sales. |
Authentication
The Specter connector relies on a set of API credentials for secure communication. These settings define the User IDs and Keys for both read and write operations, ensuring that App4Sales has the necessary permissions to interact with the Specter API. The API SBM ID acts as a global identifier for the Specter environment.
Order Processing
Settings in this section control how orders are created and updated in Specter. This includes defining default delivery dates, handling discounts, and applying predefined comments or conditions. The specified Warehouse ID ensures orders are routed to the correct Specter warehouse.
Catalog
These settings govern the synchronization of items and related data from Specter to App4Sales. Administrators can filter items by article group or by their "Webshop item" status. The VAT percentages setting is crucial for accurate pricing, and the supported language codes enable multilingual item descriptions.