Supplier Update Guide

Latest Update Time: 2026-07-02 00:00:00

Use this API to update an existing supplier's details.

See the Supplier Introduction for base URL, authentication, and required headers.

Endpoint

PUT https://ppapi.qima.com/user/v2/{userId}/supplier/{supplierId}

This API additionally requires the Content-Type: application/json header.

Prerequisites

In addition to the required headers and authentication setup:

Permission to update suppliers for the target client
A supplierId obtained from Create a Supplier or Search Suppliers

Path Parameters

Parameter	Required	Description
`userId`	Yes	QIMA client user login ID.
`supplierId`	Yes	Supplier ID to update.

Request Body

Uses the same SupplierDetailBean schema as Create a Supplier — see that guide's Request Body Fields for details. The full object is expected on update, not just the changed fields.

Request Example

curl --location --request PUT 'https://ppapi.qima.com/user/v2/<qima-user-id>/supplier/<supplier-id>' \
  --header 'Ai-Api-Access-Token: {your api access token}' \
  --header 'Ai-User-Id: {your user ID}' \
  --header 'Authorization: Bearer {your token}' \
  --header 'Referer: https://preprodmy.qima.com/' \
  --data-raw '{
    "entityName": "JiXieChang-Supplier1111",
    "chineseName": "机械厂-uuu",
    "continent": "24865671",
    "country": "23424781",
    "province": "12578016",
    "city": "12687656",
    "district": "",
    "address": "NO.1, A ROAD, B STREET, C DISTRICT",
    "addressCn": "深圳市南山区某路1号",
    "postcode": "518000",
    "nearestOffice": "Shenzhen office",
    "website": "https://www.example-supplier.com",
    "salesTurnover": "5000000",
    "noOfEmployees": "10",
    "userId": "<qima-user-id>",
    "type": "SUPPLIER",
    "businessLicenseNo": "91440300MA5XXXXXXX",
    "title": "Mr.",
    "identificationCode": "CLIENT-SUP-007",
    "cityName": "Shenzhen",
    "districtName": "Nanshan",
    "countryName": "China",
    "mainProductLines": ["bigCat1_s2", "bigCat1_s3"],
    "contactInfo": {
      "main": {
        "name": "Bill Gates",
        "department": "Quality",
        "title": "Quality Manager",
        "phone": "+86 0755 81112222",
        "mobile": "13811112222",
        "email": "aaa@bbb.com;ccc@ddd.com"
      },
      "alternate": {
        "name": "Jane Doe",
        "department": "Sales",
        "title": "Sales Manager",
        "phone": "+86 0755 83334444",
        "mobile": "13922223333",
        "email": "jane.doe@example.com"
      }
    }
  }'

Successful Response

HTTP 200 OK with content: true means the update succeeded.

{
    "message": null,
    "content": true
}

Common Errors

See common authentication errors for 401 and 403 responses.

Status	Meaning	Recommended Action
`500 Internal Server Error`	Failed to update the given supplier.	Confirm `supplierId` is correct and the request body is valid.

Next Steps

Use Get Supplier Details to verify the update was applied.

Documents