Official API & Authorised Integration Guide

Amazon SP-API Connection Guide

Authorised Amazon SP-API order sync. Additional SP-API reports/listings/inventory/notification modules require dedicated adapters.

Open Marketplace Connection Settings All Connector Guides

What this connector can sync

✓ Orders & status

✓ Products & variants

✓ Seller SKU mapping

✓ Warehouse inventory

✓ Labels / AWB when API permits

✓ Returns & refunds

✓ Fees & settlements when available

✓ GST and fulfilment records

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/amazon

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

Step-by-step setup

Complete Amazon SP-API developer registration and seller authorization.
Collect LWA client ID, client secret and refresh token.
Amazon SP-API requests use the LWA access token; legacy AWS IAM/SigV4 fields are not required by this connector.
Select the correct regional SP-API endpoint and marketplace ID.
Run the signed Test Connection before enabling order/report synchronization.

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.

Open SKU Mapping Guide

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

401 / Invalid Token

Refresh/re-authorize the token and verify scopes.

403 / Access Denied

Seller account or API role is not approved for the endpoint.

Unmapped SKU

Map the seller SKU before enabling automatic stock deduction.

Webhook rejected

Check HTTPS, signature secret and duplicate/replay protection.

Open Troubleshooting

Official documentation

Open official documentation ↗