Rackbeat - Connector Settings
These settings control the behavior of the Rackbeat connector, including authentication, VAT handling, and data mapping.
Settings are configured in the App4Sales portal and are applied at runtime during synchronization processes.
Setting | Description | Values / Defaults | Dependencies / Effects |
ApiToken | The API token used for authentication with the Rackbeat API. This is a required field for the connector to function. | String (Encrypted) | This token is essential for all communication with Rackbeat. An invalid token will cause all synchronization jobs to fail. |
VAT liable zones (Ex: eu;abroad) | A semicolon-separated list of VAT zones that are considered VAT liable. This is used to determine if VAT should be applied to a customer. | String (e.g., "eu;abroad") | Affects VAT calculations for customers and orders. If a customer's VAT zone is in this list, VAT will be applied. |
VAT percentage for items | The default VAT percentage to be applied to items. | Decimal | Used for calculating item prices and totals in orders. |
Default inventory location number | The number of the default inventory location to use when a specific location is not provided. | String | Used during stock synchronization to associate stock levels with the correct warehouse in App4Sales. |
Use item name from Rackbeat as a description | When enabled, the item's name from Rackbeat will be used as the description for the item in App4Sales. | Boolean (true/false) | If disabled, the description field for items may be empty or populated from another source, depending on other connector logic. |
Authentication
Authentication with the Rackbeat API is handled via an API token. This token must be generated in the Rackbeat system and entered into the `ApiToken` setting in the App4Sales portal. The connector will send this token with every request to validate its access.
Catalog
The catalog synchronization can be influenced by the `UseItemNameAsDescription` setting. Enabling this will ensure that the item names in App4Sales match the names in Rackbeat, which can be useful for consistency.
Order Processing
VAT calculations during order processing are controlled by the `VatLiableVatZones` and `ItemVatPercentage` settings. It is important to configure these correctly to ensure accurate pricing and tax compliance.
Stock
The `DefaultInventoryLocationNumber` is used to map stock levels from Rackbeat to the correct warehouse in App4Sales. If you have multiple inventory locations in Rackbeat, you may need additional configuration or logic to handle this correctly.