Job queues

Job queues in Business Central let you schedule automated tasks to run in the background. You can configure them to run once at a specific time or regularly. In the context of Tinx Connector, job queues are the engine behind the synchronization between Business Central and your webshop. Two dedicated job queues run continuously:

  • TINX NAS Outbound Mgt: Picks up changes in Business Central and sends them to the webshop.
  • TINX NAS Inbound Mgt: Downloads incoming data, such as new orders and customers, from the webshop into Business Central.

If a job queue stops or encounters an error, data stops flowing between the two systems. To better understand job queues in Business Central, see Use job queues to schedule tasks and Job queue concept.

To review job queue entries

  1. Select Search (Alt+Q) in the upper-right corner, enter Job Queue Entries, and then choose the related link.

  2. On the Job Queue Entries page, locate the entries where Job Queue Category Code is TINX. These are the Tinx Connector synchronization jobs.

    The following table describes some job queue entries included in Tinx Connector. TINX NAS Inbound Mgt and TINX NAS Outbound Mgt are the two primary job queues. Other job queues can be scheduled to optimize performance and data maintenance.

    Job queue entry Description
    TINX NAS Inbound Mgt Downloads and processes incoming data from your webshop, such as new orders or customers.
    TINX NAS Outbound Mgt Sends data from Business Central to your webshop, such as inventory levels, prices, product information, and shipment confirmations.
    TINX Remove Web Log Entries Removes old entries from the Synchronisation Ledger Entries page to prevent unnecessary database growth. To learn more, see To manage the number of entries on the Synchronisation Ledger Entries page.
    TINX Reset No. Of Order Checks Resets the number of times Tinx Connector checks a webshop order to confirm payment. Use this job if orders get stuck waiting for payment confirmation from your webshop.
    TINX Check Finished/Error Jobs Goes through all job queue entries with the TINX category code and resets any entries with the status Error so they can run again.
    TINX Assign Items to Web Category with Filters Checks which items should be added or removed from a web category.
    TINX Inbound Process Event Retries inbound events that failed to process. For more information, see Inbound Events.
    TINX Item Stock Calculation Triggers the stock calculation by applying the stock formulas. For more information, see To launch a job queue entry needed to calculate stock.
    TINX Item Price Container Needed to update the item price container. For more information, see Item price container.
  3. Verify the Status of the job queues. To understand each status, see Monitor status or errors in the job queue.

  4. To resolve issues related to some of the statuses, see Handle job queue entry issues.

The job queue status is one of the most common causes of communication issues between Business Central and webshops. This is why verifying the job queue status is the first step in any troubleshooting scenario. For more information, see Step 1: Check the job queue status.

Set up email notifications to react quickly when there are issues with job queues. For more information, see Get notified when a job queue entry fails.

Job queue configuration guidelines

The following image shows the default job queue setup. After you install Tinx Connector from AppSource, the Scheduled, Recurring job, and No. of Minutes between Runs fields have the following values.

Default job queue status

This is the predefined setup that meets the requirements of most companies using Tinx Connector. The setup can differ in your Business Central, depending on your implementation or subsequent updates to Tinx Connector. In most cases, TINX NAS Inbound Mgt and TINX NAS Outbound Mgt are running every minute.

One minute is the default interval for the job queue, but it isn’t always the optimal setting. Check how many records are processed in a single run and what the average processing time is. If the average processing time exceeds one minute, increase the interval in the No. of Minutes between Runs field of the job queue entry.

You might need to temporarily pause the TINX NAS Inbound Mgt and TINX NAS Outbound Mgt by setting their status field to On Hold. For example, pause them when you manually run a synchronization dashboard or when you make changes in Business Central that you don’t want synchronized immediately. After you finish, always use the Set Status to Ready action to resume synchronization.

When using Amazon, see the following information.

For Amazon: Throttling limits

Because of the throttling limits, the job queues should run less frequently.

Related information

Record queue
Synchronization ledger entries
Synchronization dashboards
Troubleshooting checklist
E-commerce Setup and Sales Channel: Where to set up the webshop
Key concepts in Tinx Connector