What this connector can sync

Capabilities depend on the scopes and endpoints approved for your seller account. The plugin does not mark the account Connected until its Test Connection succeeds.

Required account and credentials

Connection type: Official Api

Use a seller/developer account owned by your business. Request only the scopes required for orders, products, inventory, fulfilment, returns or settlements.

OAuth callback URL:https://gstkhata.com/wp-json/agbp/v1/marketplace/oauth/callback/etsy

Webhook URL: Open Marketplace Connections, save the account, then copy its unique Webhook URL.

Step-by-step setup

1. Create an Etsy developer app and collect the keystring.
2. Complete OAuth 2.0 PKCE authorization.
3. Enter API key, access token, refresh token and Shop ID.
4. Run Test Connection.
5. Register webhooks and map listing SKUs.

SKU and warehouse mapping

Match priority is seller SKU → variant SKU → barcode/EAN/UPC → platform listing ID → product SKU. Unmapped items remain quarantined and never deduct stock automatically.

• Map each marketplace facility/store to a plugin warehouse or rack.
• Set safety stock buffer and stock deduction stage.
• Confirm service/digital items as non-shippable.
• Run the first sync and inspect Stock Reservations before dispatch.

Orders, labels, returns and settlements

Official label/AWB is used when supplied by the authorised marketplace API. The built-in packing label is a fallback and is not presented as a marketplace-approved carrier label.

• Order import creates an idempotent shipment record.
• Mapped physical items reserve stock.
• Cancellation releases reservation.
• Accepted sellable return may restore stock; damaged return remains quarantined.
• Fee and payout data is sent to existing reconciliation reports when the API exposes it.

Common errors

Official documentation

Open official documentation ↗

Open official documentation ↗