Jarltech Item Synchronization
The Jarltech Item Sync Queue periodically synchronizes item data via the Jarltech REST API. It processes a queue of BC items belonging to the Jarltech vendor.
Opening the Page
- Via search: Jarltech Item Sync Queue
- Via the Dashboard → Item Sync Queue
What Is Synchronized?
| Data | Description |
|---|---|
| Multilingual descriptions | Item descriptions in German, English and French (as BC item translations) |
| Minimum Order Quantity | Minimum Order Quantity on the BC item |
| Vendor link | Vendor Item No. (Jarltech item ID) in the item vendor catalog |
Price and stock come from the data import
Item synchronization does not maintain prices and stock levels. These are updated via the Data Import (Prices & Stock). Live price/stock queries occur ad hoc during the availability check on the purchase order.
No new item creation
Synchronization does not create new BC items. It only updates existing items and their vendor link.
Fields
| Field | Description |
|---|---|
| Entry No. | Unique number of the queue entry. |
| Item No. | The BC item to be synchronized. |
| Jarltech Item ID | The Jarltech item ID used for synchronization. |
| Status | Synchronization status (see below). |
| Last Synchronization | Time of the last synchronization. |
| Next Synchronization | Scheduled time of the next run. |
| Retries | Number of retries after errors. |
| Priority | Processing priority (lower values first). |
| Error Message | Last error message for status Error. |
Actions
Processing
| Action | Description |
|---|---|
| Initialize Queue | Adds all items of the Jarltech vendor to the queue (without duplicates). |
| Run Sync Now | Immediately processes the due entries. |
| Create Job Queue Entry | Creates the recurring background synchronization (default: 60 min, Mon–Fri 06:00–22:00). |
| Reset Errors | Resets all failed entries back to Pending. |
| Set Pending | Sets selected entries to Pending for immediate synchronization. |
Navigation
| Action | Description |
|---|---|
| Show Item | Opens the item card of the selected entry. |
Synchronization Status
| Status | Meaning |
|---|---|
| Pending | Waiting for synchronization |
| In Progress | Currently being processed |
| Completed | Successful (refreshed again on a recurring basis) |
| Error | Error occurred (retried up to 5 times) |
Per run, 10 items are processed (first Pending, then due Completed, then Error within the retry limit).
Linking Items with Jarltech
For an item to be synchronized, it must be linked to a Jarltech item ID. On the item card, the action Lookup Jarltech Item determines the Jarltech item ID based on the manufacturer item number and creates a matching item vendor catalog entry.
Tips
Initial population
After setup, run Initialize Queue once to include all Jarltech items, and then create the automatic synchronization via Create Job Queue Entry.
Fixing errors
If entries accumulate in status Error, check the error message (e.g., missing Jarltech item ID) and reset them via Reset Errors after correction.