Knowledge & insights
Integrations
Design decisions and practical lessons for reliable integrations between business systems.
-
Polling and webhooks without duplicate payment completion
Two status channels are useful as long as only one process performs the business order transition.
-
Identifying business or consumer accounts from online store data
An entered company name is not conclusive evidence. Use an explicit decision table and make unknown or conflicting cases visible.
-
When may an online-store address be sent to an AFAS debtor account?
A matching email address or postcode is not an identity. Combine a confirmed link with valid address fields and handle ambiguity deliberately.
-
Safely recovering a locked AFAS record
Rapid retries rarely resolve a lock. Use a waiting, checking and escalation ladder and repeat only the blocked provider step.
-
Writing again after an API timeout? Check first
Treat an unclear API response as a separate status. Record the write intent in advance and look for evidence before releasing a retry.
-
Preventing and resolving duplicate AFAS debtor records from online store orders
How to recognise existing AFAS contacts from online store orders, prevent new duplicates and resolve uncertain cases without further damage.
-
AFAS succeeded, the downstream system failed: what now?
Partial success is a concrete state. Model provider steps separately and rerun only what demonstrably has not yet succeeded.
-
Which order version wins when a webhook arrives late?
The last message received is not always the latest change. Separate source order from arrival order and explain skipped events.
-
Which data should you synchronise between WooCommerce and AFAS?
Prevent WooCommerce and AFAS from overwriting each other’s data by defining one owner and clear synchronisation rules for each business object.
-
Managing multiple online stores without mixing up orders
An order number is not globally unique. Safe multi-store automation checks the store and workspace at every step of the chain.
-
Which online store orders may start your integration?
Test orders, failed payments and replacement deliveries need different handling. Make filters explicit and distinguish exclusion from a recoverable error.
-
How to check whether WooCommerce webhooks are actually healthy
A reachable endpoint does not prove that all required webhooks are active and configured correctly. This health matrix makes differences visible.