AddThisFeature

WooCommerce Order Sync

Pull WooCommerce orders and customers into the app across stores you do not control.

involved Payments & Finance

What it adds

A sync of orders and their customers from a connected store, tolerant of custom statuses, taxes, currencies, and plugins.

What your agent is told to do

5
  1. 1

    Treat the store's configuration as unknown at build time. Read the statuses, tax rows, currencies, and payment methods the store actually reports rather than hard-coding the defaults a stock install ships with.

  2. 2

    Map any unrecognized order status onto a defined local fallback and keep the raw value alongside it. A plugin-defined status must never be read as complete by accident.

  3. 3

    Verify every incoming webhook against the store's shared secret before acting on it, and key the resulting write on the store plus the order identifier so redelivery is harmless.

  4. 4

    Hold a cursor for the sync and resume from it after an authentication failure or a rate limit. Do not restart the whole sync from the beginning after a transient failure; that reprocesses months of orders and buries the actual error.

  5. 5

    Where the app also writes back to the store, stamp the origin of each write and ignore updates the app itself caused. This has the same shape as Shopify Order Import, so keep one shared import pipeline and vary only the provider adapter.

Edge cases it handles

8
  • Self-hosted stores run arbitrary plugins. An order may carry statuses, fee lines, tax rows, and meta fields the app has never seen, and none of them may abort the import.
  • An unverified webhook is an untrusted request from the open internet. Reject anything whose signature does not match, and never fall back to trusting the payload because the signature header was absent.
  • Redelivery is normal and must be safe. Two deliveries of the same order update must leave exactly one local record in the same final state.
  • Products and customers get deleted after the order that references them. The order must remain importable from the values it captured at the time, with the missing reference marked rather than the row rejected.
  • If the app writes status back into the store, the store's own webhook returns that change. Ignore echoes of the app's own writes, or the two systems will trade updates without end.
  • Expired credentials and rate limits are temporary conditions. Pause the sync, retain the cursor, surface the reason where an operator will see it, and resume from that point rather than dropping the window.
  • Stores in other locales report dates in the site's own time zone and decimals with a comma separator. Normalize both on the way in rather than assuming one format.
  • A store that is offline or mid-upgrade returns an HTML error page instead of structured data. Treat an unparseable response as a retryable failure, never as an empty list of orders.

Definition of done

8
  • Orders import from stores with custom statuses, tax rows, and plugin fields without failing.
  • Unrecognized statuses map to a defined local state and the raw value is retained.
  • Webhooks are signature-verified, and repeated delivery of the same event changes nothing after the first.
  • Orders referencing deleted products or customers remain intact with the missing reference marked.
  • The sync resumes from its last cursor after an authentication or rate-limit interruption, with the reason visible to an operator.
  • Bidirectional updates terminate; no order oscillates between the app and the store.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.