Export Failures - Akeneo Exporter

Export Pipeline

Exports follow a 4-stage pipeline. Failures stop at the failing stage.

1Initialize

Validate config & connect

2Fetch

Get products from Akeneo

3Enrich

Apply transformations

4Write

Save to database

Errors by Stage

Initialization Errors

Config validation, credential verification

❌

"Invalid configuration"

Missing or malformed config → Check required fields

❌

"Authentication failed"

Invalid Akeneo/DB credentials → Re-test connections

❌

"Connection refused"

Can't reach Akeneo/DB → Check network/firewall

Recovery: No data fetched or modified. Fix config and retry.

Fetching Errors

Retrieving products from Akeneo API

⚠️

"API error 429"

Rate limit exceeded → Wait 5-10 min and retry

⚠️

"Timeout"

Akeneo API not responding → Check Akeneo status

❌

"Invalid filter"

Filter config error → Check filter syntax

Recovery: Nothing written to DB yet. Safe to retry.

Enrichment Errors

Applying enrichers to transform data

❌

"Type error"

Data type mismatch → Add null checks to enricher

❌

"Null reference"

Accessing undefined field → Use field existence condition

⚠️

Export hangs

Infinite loop in enrichers → Check circular dependencies

Recovery: Nothing written to DB. Test enrichers individually before retry.

Database Write Errors

Saving enriched products to database

❌

"Duplicate key" (E11000)

Product already exists → Use incremental mode

❌

"Permission denied" (42501)

Insufficient privileges → Grant INSERT/UPDATE

⚠️

"Write timeout"

Database slow → Use same-region DB, incremental mode

Recovery: Partial data may exist. Check export count, use incremental to complete.

Quick Error Reference

Error	Cause	Fix
401	Invalid credentials	Regenerate API credentials
429	Rate limit	Wait 5-10 min, avoid parallel exports
500	Akeneo server error	Check status page, retry later
E11000	MongoDB duplicate key	Use incremental mode
42501	PostgreSQL permission denied	Grant INSERT/UPDATE permissions

Debugging Steps

Check Export Logs

Open export details → Expand log viewer → Find last "started" without "completed"

Analyze Error Message

Note error type (MongoError, AkeneoAPIError, EnricherError), code, and message

Test Components

Re-test Akeneo connection → Re-test database → Test enrichers with sample data

Fix and Retry

Apply fix → Re-test connections → Create new export → Monitor closely

Recovery Strategies

🔄

Partial Export Failure

Some products exported before failure:

1. Check exported count in logs
2. Don't clear database
3. Fix the issue
4. Run incremental export

🗑️

Corrupted Data

Invalid data written to database:

1. Note failed export timestamp
2. Delete products after that time
3. Fix enrichers/config
4. Run full export

MongoDB

javascript

db.products.deleteMany({
  createdAt: { $gte: new Date('2025-01-21T14:30:00Z') }
})

PostgreSQL

sql

DELETE FROM products
WHERE created_at >= '2025-01-21 14:30:00';

Prevention Tips

✅Test connections before every export

✅Test enrichers with sample data

✅Use incremental mode for regular updates

✅Schedule exports during off-peak hours

✅Avoid parallel exports

✅Rotate credentials before expiration

Still Experiencing Failures?

Contact support with:

• Export ID
• Full error message from logs
• Configuration name
• Steps that led to failure

Next Steps

Connection Errors

Fix connection issues

Monitor Exports

Track export progress