Error Handling in Automatic Processes

Learn how to detect and resolve errors in automatic processes.

Automatic processes can fail for a number of reasons. This page explains how to detect and resolve errors.

1. Error Types

Connection errors

• API connection interrupted
• Timeout on requests
• Authentication problems

Data errors

• Missing mandatory fields
• Invalid data formats
• Mapping problems

System errors

• Shopware server unreachable
• BC services unavailable
• Resource bottlenecks

2. Detecting Errors

2.1 Job Queue

Open the Job Queue Entries page. You will find the current status in the "Status" column. If it shows "Error", click it directly. A new window, "Job Queue Entry Card", opens.

Then investigate the cause of the error. Several supporting functions are available for this, such as the “Show Error” button.

2.2 Activity Log

Follow this path: "Shopware" "Activity Log"

Filter for errors and analyze them.

2.3 API Call Log

Follow this path: "Shopware" "API Call Log"

For a detailed analysis, review the request and the response. This lets you pinpoint the cause of the error.

3. Resolving Errors

General procedure

1. Identify the error
2. Analyze the cause
3. Fix the problem
4. Run the task again
5. Verify success

Resolving connection errors

1. Check the API connection in the settings.
2. Run a connection test
3. Check the API credentials.
4. Check the network connection.

Resolving data errors

1. Identify the faulty record.
2. Check the mandatory fields.
3. Correct the data.
4. Check the mapping tables.

4. Notifications

Email notifications

Set up notifications for errors:

1. Open Job Queue Entries.
2. Select the entry.
3. Enable "Notify On Error".
4. Enter the email addresses.

Monitoring dashboard

Use the order overview for a quick overview:

• Number of failed imports
• Last successful synchronization
• Open errors

5. Retry Strategies

Automatic retry

Some errors are retried automatically:

• Connection errors after a short pause.
• Timeout errors with an increased timeout.

Manual retry

1. Resolve the cause of the error.
2. Set the status to "Ready".
3. The task runs at the next interval.

Tips for day-to-day use

Proactive monitoring

• Check the Job Queue daily.
• Monitor the Activity Log.
• Respond to errors quickly.

Error prevention

• Maintain complete master data.
• Keep mappings up to date.
• Test changes manually first.

Documentation

• Document recurring errors.
• Create an FAQ for common problems.
• Train your staff in troubleshooting.