← Back to EcomCentral
SHEIN OPEN API

SHEIN Setup Guide

Connect your SHEIN seller account to EcomCentral using the Open Platform API with HMAC-signed requests.

Prerequisites

ℹ️ SHEIN signs every request with HMAC-SHA256 over the sorted query parameters, keyed by your secret_key. EcomCentral handles the signing for you — you only supply the key pair.

Data Coverage & Caveats

⚠️ SHEIN's Open Platform documentation is partly behind a seller login. EcomCentral's mappings are based on the publicly verifiable parts:
AreaStatusNotes
Response envelope✅ Verified{ code:"0", msg, info } — success gates on code === "0"
Product fields✅ VerifiedskuCode, productName, goodsInventory.inventoryQuantity
Stock update✅ Verifiedby sku_code
Order row / detail fields⚠️ Best-effortdate / status / totals are not publicly documented; rendered defensively with fallbacks and may show "—"

Getting Your API Credentials

  1. Sign in to the SHEIN Open Platform (seller account required)
  2. Create (or open) your app and note the App Key and Secret Key
  3. Ensure the app is authorized for the Product and Order API scopes
  4. In EcomCentral, add a new SHEIN connection with:
    app_key = your App Key  ·  secret_key = your Secret Key
  5. Optionally set base_url if your region uses a different host
  6. Click ⚡ Test — it calls the token-check endpoint and confirms signing works
⚠️ Keep the secret_key private — it is used to sign every request. Anyone with it can act on your seller account's behalf.

Credentials Reference

KeyRequiredDescriptionExample
app_key Required App Key from the SHEIN Open Platform abc123…
secret_key Required Secret Key — used to HMAC-sign requests s3cr3t…
base_url Optional Regional API host. Defaults to https://openapi.sheincorp.com https://openapi.sheincorp.com
✅ Alternative key names accepted: appKey / api_key for the App Key; secretKey / api_secret for the Secret Key; baseUrl for the base URL.

API Endpoints Used

OperationMethodEndpoint
Test connectionGET/open-api/auth/token/check
List productsGET/open-api/product/list
Product detailGET/open-api/product/detail
Update stockPOST/open-api/product/stock/update
List ordersGET/open-api/order/purchase-orders
Order detailGET/open-api/order/purchase-order-info
Add trackingPOST/open-api/order/tracking/add
Complete orderPOST/open-api/order/complete

Supported Features

FeatureSupportedNotes
View orders (paginated)✅Order # + best-effort date/status/total
View order detail✅Defensive rendering of address + line items (field names vary)
Add tracking✅Tracking number + carrier
Mark order complete✅POST /order/complete
View products (paginated)✅productName, skuCode, price, inventory
Update stock quantity✅by sku_code
Test connection✅Token check + signature validation

Troubleshooting

✕ code ≠ "0" / signature error

SHEIN returns a non-zero code with a msg when the signature, app key, or timestamp is wrong. Verify the app_key / secret_key pair and that your server clock is accurate (the signature includes a timestamp).

✕ Order fields show "—"

SHEIN's order field names are not fully public, so EcomCentral renders them best-effort. If a field is blank, the API likely uses a different key. Product, stock and write operations are verified and unaffected.

✕ 403 / unauthorized scope

Your app is not authorized for the Product or Order API. Enable the required scopes for your app on the SHEIN Open Platform and re-test.