Aura Historia Partner Connect

Yes. This plugin is intended for merchants who already use Aura Historia and administer a ListingSource they can authorize during OAuth.

Only product.created, product.updated, and product.deleted. The plugin's own product.deleted webhook fires when a product is trashed and also when a product is deleted permanently, with or without Trash first. Deleting a single variation does not remove its parent product from Aura Historia. Your own WooCommerce webhooks keep their default behavior.

After configuration, the plugin sends the generated WooCommerce webhook secret, store language and currency, unchanged signed live product webhook payloads, published product listing data during backfill, and typed shipping rules and item inputs during shipping import. The backfill never sends description/body; live WooCommerce webhook bodies remain untouched. See External services above.

No. The plugin keeps the Aura Historia delivery URL built in and generates the WooCommerce webhook secret automatically.

The next request repairs it. Deleting a managed webhook triggers a sync, and so does any difference between its name, topic, status, delivery URL, secret, user or API version and what the plugin applies, including WooCommerce disabling it after repeated failed deliveries. Reactivation resets its failure count. WooCommerce's own save after each delivery, which only records the failure count, does not trigger a sync. The plugin first stages all managed webhooks paused with the desired signing secret, then applies that secret, supported store currency, and language through the WooCommerce ingestion-configuration PUT. Only after it succeeds does sync activate the webhooks. Changing WooCommerce currency or WordPress site language pauses delivery immediately until the new configuration is registered. Unsupported store currencies or configuration failures leave them paused for retry.

Yes. Once configuration succeeds, the plugin schedules an initial backfill once per canonical lowercase UUIDv7 ls_ ListingSource ID. If setup or queueing fails, it keeps that first run pending for a later healthy request. It submits published products in background batches of up to 100 to the async ProductListings API. A 202 confirms queue admission, not completed creation or immediate search visibility. Retries reuse the same ordered request and idempotency key; a product-ID cursor prevents skips when earlier products are removed. Routine webhook repairs never start a fresh CREATE run. The manual action safely resumes pending work without changing its snapshot/key, leaves already queued work alone, or starts a new full run only when idle, and its confirmation states which one happened.

Plugin-owned webhooks are paused on deactivation so WooCommerce stops sending deliveries. Shipping jobs are fenced/canceled, and the plugin attempts protected retirement of its shared shipping profile and clearing of its source default. This is not source authorization revocation. Unconfirmed cleanup is visible after reactivation; review retained assertions in Aura Historia. Existing assertions have no automatic expiry.

Ordered zones including fallback zone 0, country restrictions, reviewed state codes, exact postcodes and reviewed German postcode forms, core constant/quantity flat rates, bounded per-class quantity charges, conditional free shipping and conservative local pickup. Shared base/class surcharges, per-order class maxima, coupon/tax/cart context, unreviewed geography, third-party methods and other expressions remain uncertain or externally calculated. Nothing runs checkout or evaluates arbitrary expressions. Zones without locations retain their position and cover the permitted shipping countries. Class charges are ignored when no shipping classes exist, matching WooCommerce. The complete support matrix is in the repository README.

Import shipping resumes immutable pending work and retries missing catalog listings without recreating products. Each background action makes at most one write; automatic retries and retained deferred work are bounded. Progress, manual protection and capability limits appear on the settings page. Shipping policy is shared in profiles, while item inputs remain separate. Incomplete reads preserve previous assertions; only confirmed local removals or complete scoped replacement remove owned assertions. Manual edits remain protected. A restored product cancels unsent removals and refreshes its selection and inputs. When Trash has already withdrawn a product's Aura Historia listing, Aura refuses to clear its shipping. The plugin does not report that removal as done and does not retry it periodically. It continues with other products, never restores the listing, and counts these products on the settings page. Restoring the product publishes its current shipping again. Local hooks observe zone/location/order changes (including fallback zone 0), method addition/deletion/enablement and instance settings, shipping classes, core settings/units/currency, product inputs and variation inheritance. Save requests only mark durable identities. Background workers reread current facts and reuse the initial/manual publisher. Missed changes converge through six-hour reconciliation with bounded product traversal and pages of 20 previously published identities. Unsupported plugin behavior remains conservative; failed or incomplete reads never establish removal. No shipping refresh recreates catalog products. WooCommerce Action Scheduler and a working WordPress cron or server runner are required. Low-traffic sites or DISABLE_WP_CRON installations need a server cron trigger or an Action Scheduler CLI runner, for example wp action-scheduler run --group=aura-historia-shipping. No browser session is required. The settings page shows oldest pending/failed work, deferred components, protected edits and last confirmed API write. Search indexing completes separately. Automatic attempts stop after five failures; up to 100 deferred components are retained before stopping at a checkpoint. Repeated refreshes reuse the entry of a component that is already deferred, such as an unsupported product type, and send no new request for a component until its retained request is resolved. Periodic/manual refreshes resume retained work. Shipping assertions remain valid until updated, withdrawn or their source loses authority, without expiry or keepalive, including after 30 days. Reconnect/reactivation requires a fresh local acquisition; old jobs cannot relabel/replay their captures into a new connection. Valid Aura token rotation preserves immutable retries and uses the current token at execution. Deactivation/reconnect/uninstall attempt existing protected cleanup where possible and record whether it committed. Cleanup preserves manual terms and does not revoke authorization. Uninstall removes local shipping jobs/state and records a bounded diagnostic if remote cleanup was not confirmed. Lost credentials or unreachable Aura can leave assertions eligible until explicitly changed in Aura. No WooCommerce REST key/secret is needed or exported; the backend never calls the plugin. Scheduled action arguments, status and diagnostics exclude credentials, raw settings and pending request contents. The three signed product webhook bodies and their receiver remain unchanged. The repository README documents hook and supported-version coverage. Rescheduling a published product for future publication clears its owned shipping components until it is published again. A failed local removal recheck retains the original request and bounded retries; only confirmed restoration cancels a pending removal.