Jarltech Setup
The setup page (Jarltech API Setup) configures the API connection, order defaults, automation, and licensing of the Jarltech Supplier Connector.
Opening the Page
- Via search: Jarltech API Setup
- Via the Dashboard → Setup
Guided setup recommended
For the initial setup, it is best to use the Setup Wizard (via Assisted Setup → "AD merchantCENTRAL – Setup" → Jarltech Setup Wizard or via the dashboard). This page serves as a complete field reference.
Order: Hub first
When opened, the Setup Wizard checks whether the merchantCENTRAL Hub is configured and otherwise redirects to the Hub setup. This ensures that the platform is configured before the connector.
Fields
General
| Field |
Description |
| Customer ID |
Your 7-digit Jarltech customer number (from Jarltech upon contract signing). |
| Language Code |
Language code for API responses: de, en, or fr. Affects, among other things, item descriptions during synchronization. |
| Vendor No. |
The vendor assigned to Jarltech in Business Central. |
Connection
| Field |
Description |
| Use Preview Server |
Sends all API calls to the Jarltech test server. Ideal for initial setup and testing. |
| Base URL Live |
API endpoint for live operation (default: https://www.jarltech.com). |
| Base URL Preview |
API endpoint for test operation (default: https://shop.preview.jarltech.de). |
| SAS Function URL |
Azure Function URL for the legacy file download (only for source type Azure Blob). Empty = built-in default. See Set up Azure Blob Storage. |
OAuth2 Authentication
| Field |
Description |
| Client ID |
OAuth2 Client ID from Jarltech. Click the field to enter/change it. Stored encrypted. |
| Client Secret |
OAuth2 Client Secret. Stored encrypted in the Credential Store and not displayed. |
| Token Status |
Status of the access token: Valid (green) or Expired/invalid (red). |
| Token Expires At |
Expiry time of the current access token. |
Token management
The access token is renewed automatically when needed. Manual intervention is only necessary when your credentials change.
Order Defaults
| Field |
Description |
| Default Shipping Type |
Default shipping type for new orders (Standard, Express, Express Saver, Forwarding Company, Saturday Express, Direct Delivery, UPS Next Day, Pickup, Pickup VAT Free). |
| Default Payment Type |
Specified by Jarltech per contract. Read-only and not sent when ordering. |
| Default Delivery Note Layout |
Delivery note layout (Customer, Jarltech, Jarltech Gulf, Neutral). |
| Allow Order Splitting |
Allows Jarltech to split orders into multiple shipments. |
Automatic Synchronization
| Field |
Description |
| Enable Auto Sync |
Enables automatic synchronization of open orders via the Job Queue. |
| Sync Interval (Minutes) |
Interval between synchronization runs (default 60, minimum 5). |
| Last Sync DateTime |
Timestamp of the last synchronization. |
| Job Queue Status |
Status of the Job Queue Entry: Active or Not active. |
Purchase Order Settings
| Field |
Description |
| Auto Update Purchase Order |
Automatically sets vendor invoice no., delivery note no., posting date, and ship-to address. |
| Auto Assign Serial Numbers |
Automatically assigns serial numbers from the Jarltech shipping data. |
| Auto Add Shipping Charges |
Adds shipping/insurance costs as item charge lines. |
| Auto Post Receipt |
Automatically posts the receipt as soon as fully delivered (status Supplied). Default: disabled. |
Sales Order Settings
| Field |
Description |
| Auto Upd. Sales Shipment Date |
Updates the expected shipment date on the linked sales order. |
Simulation and Testing
| Field |
Description |
| Simulation Mode |
Orders are not sent to the API but simulated via email. Disable for live operation. |
| Notification Email |
Email address for simulation and process notifications. |
| Send Process Notification |
Sends an email when the auto-sync job has processed orders. |
Item Charges
| Field |
Description |
| Shipping Charge No. |
Item charge number for shipping costs. |
| Insurance Charge No. |
Item charge number for insurance costs. |
License
| Field |
Description |
| License Status |
Active, Demo, or Unregistered. |
| Demo Expiry |
Expiry date of the demo license (only in Demo status). |
| Remaining Demo Days |
Remaining days of the demo period. |
| Licensed Since |
Date of first licensing (only in Active status). |
Actions
Processing
| Action |
Description |
| Get Access Token |
Requests a new OAuth2 access token. |
| Test Connection |
Tests the API connection with the current credentials. |
| Refresh All Open Orders |
Updates the status of all open orders. |
| Create/Update Job Queue |
Creates or updates the Job Queue Entry for automatic synchronization. |
| Process All Orders Now |
Processes all open orders immediately. |
Navigation
| Action |
Description |
| Jarltech Orders |
Opens the order list. |
| Register Demo |
Starts the free 30-day demo registration. |
| Refresh License |
Refreshes the license status from the license server. |
Initial Setup Step by Step
- Enter customer number — Your 7-digit customer number in the Customer ID field.
- Assign vendor — Select the matching BC vendor in the Vendor No. field.
- Enable preview server — Enable Use Preview Server for test operation.
- Enter OAuth2 credentials — Enter Client ID and Client Secret.
- Request token — Get Access Token; the token status should change to Valid.
- Test connection — Test Connection and verify the success message.
- Configure simulation mode — Enter the Notification Email, keep Simulation Mode enabled at first.
- Set up data import (optional) — see Data Import and Set up Azure Blob Storage.
- Set up automation — Enable Enable Auto Sync and set the interval, then Create/Update Job Queue.
- Go live — after successful tests, disable Simulation Mode and Use Preview Server.
Tips
Simulation Mode
Keep simulation mode enabled during initial setup. Only disable it after successful tests.
Preview Server
The Jarltech preview server uses the same credentials as the live server but does not process real orders.