JD.com Integration Guide - Plugin

Integrate your JD.com seller account with Helm to streamline your order flow, automate stock synchronisation and centralise fulfilment across channels

What is JD.com

JD.com (Jingdong) is one of China’s largest eCommerce platforms, known for its reliable logistics, high product standards and direct-to-consumer marketplace model

Connecting JD.com to Helm allows approved sellers to automate order imports, manage inventory in real time and synchronise product data across international or cross-border commerce environments

PROS ✅

CONS ❌

Access to one of the world’s largest eCommerce marketplaces

Requires approval and seller credentials from JD.com

Real-time integration of orders, stock and fulfilment data

API documentation is primarily in Mandarin and may require translation

Suitable for international sellers through JD Worldwide

Integration setup may involve coordination with JD account managers

Step-by-Step Setup

To integrate JD.com with Helm:

  1. Register and Verify Your JD Seller Account
    Apply as a third-party seller at https://www.jd.hk or via JD Worldwide
    Complete identity verification and seller onboarding

  2. Request API Access
    Once approved, request API credentials from your JD.com account manager
    You will need:

    • API Key

    • API Secret

    • App ID

    • Access Token

    • JD API Endpoint

  3. Log in to Helm
    Navigate to Settings → My Store

  4. Add New Sales Channel
    Click Add New Sales Channel and select JD.com from the list

  5. Enter Required Details

FIELD

DESCRIPTION

Sales Channel Name

e.g., JD Marketplace China or JD Worldwide

Sales Channel Logo

Upload the JD.com logo or your own brand icon

API Key

Provided by JD Developer Platform

API Secret

Used for secure access

App ID

Your registered application ID

Access Token

Used for authenticated API requests

API Endpoint

Full API base URL (e.g. https://api.jd.com)

  1. Click Continue

Interaction Settings

Customise how Helm interacts with your JD.com store:

INTERACTION SETTINGS

DESCRIPTION

Sync Inventory

Import your JD-listed product catalogue into Helm

Sync Stock Levels

Keep inventory levels aligned between Helm and JD.com

Use Channel Names

Display JD product titles in Helm order records

Max Stock Levels

Set a stock visibility cap for JD.com

Stock Buffer

Reserve stock to reduce risk of overselling

Auto Merge Orders

Combine orders placed by the same customer or to the same address

Order Importing Type

Choose the start date and time to begin importing orders

Final Steps

  • Click Save once all settings are configured

  • Set the channel to Is Active at the top of the screen

Your JD.com integration is now live - and you’re ready to Take the Helm

Common Issues

ISSUE

SOLUTION

Invalid API Credentials

Ensure API Key, Secret and Token match those issued in your JD Developer Portal

Orders Not Importing

Check that order import settings and scopes are correctly configured

Stock Not Syncing

Confirm that product SKUs and availability are mapped accurately

Language or Encoding Errors

Ensure UTF-8 encoding is used for product and order data

For help with technical setup or credentials, contact Helm Support