Shopify connector: map webhook topics to Posnic entities
A working diagnosis of this problem and the sequence that actually resolves it, written from the operational side rather than the marketing side.
Reported context: Parent: #34 ## Goal Make Shopify connector scope review easier by mapping the event topics before code. ## Scope Research and document which Shopify webhook topics are needed for products, inventory, orders, refunds, and fulfillment status. ## Acceptance criteria - [ ] Table lists topic, direction, Posnic entity, required scope, and whether it is phase 1 or later. - [ ] Links point to official Shopify docs only. - [
What is actually going on
Integration failures usually trace to schema drift: a plugin update changes a field name and the sync silently writes nulls.
Order lifecycle bugs appear when the system of record for status is ambiguous between storefront, ERP, and fulfilment.
The sequence that works
Pin integration versions and add a schema assertion that fails loudly when an expected field disappears.
Declare a single system of record per entity: orders in the storefront, inventory in the ERP, fulfilment status in the warehouse system.
Add reconciliation jobs that compare counts across systems daily and alert on divergence.
Log every state transition with a correlation id so a single order can be traced end to end.
Test the failure path, not only the happy path: cancelled order, partial refund, address change after dispatch.
Where people lose time
Auto-updating plugins in production without a staging pass. Schema drift is silent until data is already wrong.
Storing business logic in two systems and hoping they agree.
Verify before you trust it
Run the checks above against your own data instead of adopting them at face value. The failure modes are specific enough that a single afternoon of measurement will either confirm this diagnosis or rule it out — both outcomes are useful, and guessing is not.
Launch Readiness Checker
A ready-to-use package for exactly this workflow — $27.55, delivered immediately.
Sold via Gumroad, which acts as merchant of record and handles payment and applicable taxes. All sales are final; see the return policy before purchase.