Symptoms
- •Random order synchronisation failures.
- •Finance team sees missing orders in BC.
- •Error logs show 'document number already exists' messages.
Business Impact
Incomplete financial records. Wasted development time diagnosing 'random' errors. Lost trust in the integration's reliability.
Root Causes
- •Using a non-unique identifier from the source system.
- •Integration logic lacks a unique prefix/suffix for different transaction types (e.g. -REF for refunds).
- •No retry logic with mutation for duplicate keys.
How Cogent2 Resolves This
Define a robust and unique keying strategy for all entities. Use prefixes (e.g. SHO-, SHR-) for Shopify orders and refunds. Ensure middleware guarantees idempotency.