CWS External Sync API Pro/Documentation/Error Codes

Error Code Reference

Common error codes and their meanings

Reference

Error Codes

CodeCategoryMeaning
INVALID_PAYLOADValidationRequest payload invalid
PRODUCT_NOT_FOUNDProductProduct not in Shopware
INVALID_CURRENCYValidationCurrency code invalid
INVALID_PRICEValidationPrice value invalid
INVALID_STOCKValidationStock value invalid
TOKEN_EXPIREDAuthAPI token expired
IP_NOT_ALLOWEDAuthIP not in allowlist
RATE_LIMIT_EXCEEDEDRate LimitToo many requests
DATABASE_ERRORSystemDatabase operation failed
QUEUE_ERRORSystemCould not queue job

Retry

Retry Strategy

Retryable Errors

  • DATABASE_ERROR, QUEUE_ERROR, RATE_LIMIT_EXCEEDED
  • Use exponential backoff: 1s, 2s, 4s, 8s, 16s
  • Max 5 retries

Non-retryable Errors

  • INVALID_PAYLOAD, PRODUCT_NOT_FOUND
  • TOKEN_EXPIRED, IP_NOT_ALLOWED
  • Fix the root cause before retrying
← Back to Documentation
Shopware Extension Partner