Create a new supplier

If supplier name or identification already exist for a customer, new creation is NOT allowed

Request

path Parameters

userId

required

string

QIMA client user id

Request Body schema: application/json

id	string QIMA supplier id
entityName required	string Supplier name
chineseName	string Supplier name in local language
continent	string Supplier continent id, get it from /parameter/v2/continents
country required	string Supplier country id, get it from /parameter/v2/searchCountries, /parameter/v2/countries or /parameter/v2/continent/{continentId}/countries
province	string Supplier province id, get it from /parameter/v2/country/{countryId}/provinces
city required	string Supplier city id, get it from /parameter/v2/country/{countryId}/searchCities, /parameter/v2/province/{provinceId}/searchCities or /parameter/v2/country/{countryId}/cities
address required	string Supplier's address
postcode	string
nearestOffice	string Nearest QIMA office name
website	string
salesTurnover	string
noOfEmployees	string Supplier's employee count
userId	string
type	string
businessLicenseNo	string
title	string
addressCn	string Supplier's address in local language
identificationCode	string Supplier's identifier code in client's system, can be used to link suppliers between QIMA's system and QIMA client's system
cityName	string Supplier's city name
countryName	string Supplier's country name
mainProductLines required	Array of strings Supplier's product lines, get product line from /parameter/v2/product-families API
required	object (SupplierContactInfoBean)
	Array of objects (FileDetailBean)
	Array of objects (FileDetailBean)
createBy	string
updateBy	string

Responses

200

New suppliers created successful

412

Supplier name or identification already exist for a customer

500

Failed to create new supplier

post/user/v2/{userId}/supplier

Request samples

Payload
curl
JavaScript
Node.js
Java

application/json

{"id": ["B8B447FD4CD948BEAC1960DF7253BD90"
],
"entityName": ["Supplier ABC"
],
"chineseName": ["富士康"
],
"continent": ["24865671"
],
"country": ["23424781"
],
"province": ["12578016"
],
"city": ["12687254"
],
"address": ["NO.1, A ROAD, B STREET, C DISTRICT"
],
"postcode": "string",
"nearestOffice": ["Shenzhen office"
],
"website": "string",
"salesTurnover": "string",
"noOfEmployees": ["10"
],
"userId": "string",
"type": "string",
"businessLicenseNo": "string",
"title": "string",
"addressCn": "string",
"identificationCode": "string",
"cityName": ["Shenzhen"
],
"countryName": ["China"
],
"mainProductLines": ["[\"bigCat1_s2\", \"bigCat1_s3\"]"
],
"contactInfo": {"main": {"name": ["Bill Gates"
],
"department": "string",
"title": ["Quality Manager"
],
"phone": ["+86 0755 81112222"
],
"mobile": ["+86 13811112222"
],
"email": ["aaa@bbb.com;ccc@ddd.com"
]
},
"alternate": {"name": ["Bill Gates"
],
"department": "string",
"title": ["Quality Manager"
],
"phone": ["+86 0755 81112222"
],
"mobile": ["+86 13811112222"
],
"email": ["aaa@bbb.com;ccc@ddd.com"
]
}
},
"accessMaps": [{"id": "string",
"docType": "string",
"fileName": "string",
"fileSize": 0,
"url": "string"
}
],
"qualityDocs": [{"id": "string",
"docType": "string",
"fileName": "string",
"fileSize": 0,
"url": "string"
}
],
"createBy": "string",
"updateBy": "string"
}

Response samples

application/json

{"id": ["B8B447FD4CD948BEAC1960DF7253BD90"
],
"entityName": ["Supplier ABC"
],
"chineseName": ["富士康"
],
"continent": ["24865671"
],
"country": ["23424781"
],
"province": ["12578016"
],
"city": ["12687254"
],
"address": ["NO.1, A ROAD, B STREET, C DISTRICT"
],
"postcode": "string",
"nearestOffice": ["Shenzhen office"
],
"website": "string",
"salesTurnover": "string",
"noOfEmployees": ["10"
],
"userId": "string",
"type": "string",
"businessLicenseNo": "string",
"title": "string",
"addressCn": "string",
"identificationCode": "string",
"cityName": ["Shenzhen"
],
"countryName": ["China"
],
"mainProductLines": ["[\"bigCat1_s2\", \"bigCat1_s3\"]"
],
"contactInfo": {"main": {"name": ["Bill Gates"
],
"department": "string",
"title": ["Quality Manager"
],
"phone": ["+86 0755 81112222"
],
"mobile": ["+86 13811112222"
],
"email": ["aaa@bbb.com;ccc@ddd.com"
]
},
"alternate": {"name": ["Bill Gates"
],
"department": "string",
"title": ["Quality Manager"
],
"phone": ["+86 0755 81112222"
],
"mobile": ["+86 13811112222"
],
"email": ["aaa@bbb.com;ccc@ddd.com"
]
}
},
"accessMaps": [{"id": "string",
"docType": "string",
"fileName": "string",
"fileSize": 0,
"url": "string"
}
],
"qualityDocs": [{"id": "string",
"docType": "string",
"fileName": "string",
"fileSize": 0,
"url": "string"
}
],
"createBy": "string",
"updateBy": "string"
}