Troubleshooting

401 Unauthorized

Cause

Invalid or missing API token

Solution

Verify token is correct and hasn't expired

403 Forbidden

Cause

Token lacks required scope or IP not allowlisted

Solution

Check token scopes and IP allowlist settings

400 Bad Request

Cause

Invalid JSON payload or missing fields

Solution

Use dry-run to test payload first

429 Too Many Requests

Cause

Rate limit exceeded

Solution

Implement exponential backoff retry logic

Product not found

Cause

Wrong identifier or product doesn't exist

Solution

Verify product number/EAN matches exactly

Connection refused

Cause

SFTP host/port incorrect

Solution

Test connection in admin panel, verify firewall

File not found

Cause

Remote path is incorrect

Solution

Verify file exists and path is correct

Jobs stuck in queue

Cause

Queue worker not running

Solution

Start/restart queue worker process