Analyze API Responses

When a synchronization fails, Shopware usually returns a specific indication in the response. Here is how to interpret the most common cases.

Typical response patterns

Response	Meaning	Action
401 / token error	Sign-in failed	Check the credentials & authentication mode
400 / validation	Mandatory field missing / invalid value	Check the field contents in BC (for example, tax, category)
404	Object not found	Check the Web-ID/mapping, create it again if necessary
409 / duplicate	Record already exists	Check the matching/Web-ID

Procedure

1

Find the entry

Open the relevant entry in the API Call Log.

2

Read the response

Look for errors or detail in the response – this is where the specific cause is stated.

3

Fix the cause

Correct the value in BC (for example, a missing tax mapping) and repeat the process.

When you submit a support request, attach the relevant API Call Log entry – this speeds up processing considerably.