AmPart Search (all options)

This request outputs all available parts for various search parameter like part numbers, brands, specific vehicles, productgroup etc. The response includes title, description, part status, OE number, criteria, images, PDF documents etc. You will need a token to access this service. If you don't have a token, then please contact your TecAlliance support.

Query URL

https://onedb.tecalliance.cn/api/chinaid/articles

Query parameter

Name Type Required Example Description
lang String Yes EN This is the language code according to ISO 639.
searchQuery String No KS01504440 This is a keyword search accross part number, OE number, trade number and EAN number.
articleNumber String No 0 001 107 405 This is a part number search only.
shortId String No AA02001643B0002 This is the shortId of a vehicle.
uid Array No 49967076852731684497 Use this if you want to search for one or multiple part number using their unique ID.
dataSupplierIds Array No 3 Use this if you want to filter part search results for some brands.
productGroups Array No 669 This will limit the part search results to the product groups added.
assemblyGroupId Integer No 100032 This will filter the results for a specific assembly group, e.g. 100032 for brake discs.
includeDataSupplierFacets Boolean No true This will output a facet with all data supplier based on the search and filter condition.
includeProductGroupFacets Boolean No true This will output a facet with all product groups based on the search and filter condition.
page Integer No 1 Page number when the results are split to several pages.
perpage Integer No 1 Number of items per page.

JSON Input - Note: This request shows all parameter. You won't get any result if you request it.

{
    "lang": "EN",
    "searchQuery":"K S01 504 440",
    "articleNumber": "0 001 107 405",
    "shortId": "AA02001643B0002",
    "uid": [
        "49967076852731684497",
        "53744604742035430661"
    ],
    "dataSupplierIds": [30, 6],
    "productGroups":[82],
    "assemblyGroupId": 100032,
    "includeDataSupplierFacets":true,
    "includeProductGroupFacets":true,
    "page": 1,
    "perPage": 50
}
              

RESPONSE

A successful request returns the HTTP 200 OK status code and a JSON response with following parameter.

Name Type Example Description
totalMatching Integer 3 The total number of matching parts for the submitted request.
MaxAllowedPage Integer 3 The max number of page the user can visit for the specific request above. If the request has more than one item, then the maxAllowedPage number will be lower.
uid Integer 3703021090606551408 Unique ID of the part/article.
dataSupplierId Integer 6304 The ID of the data supplier in TecDoc.
articleNumber String CU-AU042 The part number in TecDoc.
mfrId Integer 5108 The ID of the manufacturer in TecDoc.
mfrName String QUICK BRAKE The name of the manufacturer in TecDoc.
misc > articleStatusId Integer 1 The ID of the part status.
misc > articleStatusDescription String Normal The description regarding the ID of the part status.
misc > articleStatusValidFromDate Date 20190703 The date from which the status is valid.
misc > quantityPerPackage Integer 1 The quantity per package.
misc > quantityPerPartPerPackage Integer 1 The quantity per part per package.
misc > isSelfServicePacking Boolean false
misc > hasMandatoryMaterialCertification Boolean false
misc > isRemanufacturedPart Boolean false
misc > isAccessory Boolean false A notice whether the part is an accessory.
misc > batchSize1
misc > batchSize2
genericArticles > genericArticleId Integer 669 Product group ID
genericArticles > genericArticleDescription String Brake Lines Set Product group description
articleText
gtins Integer 5706021095784 EAN number
tradeNumbers String - The trade number of the part.
oemNumbers object - OE number
replacesArticles Array - The part number which got replaced by this part.
replacedByArticles Array - The part number which replaces this part.
articleCriteria Array - Part number criteria.
pdfs > url URL An URL to a PDF document related the part.
images > url URL http://... The URL to an image path.
images > type String JPG The type of image.
links > url URL >http://... The URL to an external link, e.g. Youtube video.

JSON Output

{
    "totalMatching": 2,
    "maxAllowedPage": 1,
    "articles": [
        {
            "uid": "53744604742035430661",
            "dataSupplierId": 4617,
            "articleNumber": "0 092 S37 407",
            "mfrId": 3751,
            "mfrName": "BOSCH",
            "misc": {
                "additionDescription": "S3",
                "articleStatusId": 1,
                "articleStatusDescription": "Normal",
                "articleStatusValidFromDate": 20191027,
                "quantityPerPackage": 1,
                "quantityPerPartPerPackage": 0,
                "isSelfServicePacking": false,
                "hasMandatoryMaterialCertification": false,
                "isRemanufacturedPart": false,
                "isAccessory": false,
                "batchSize1": null,
                "batchSize2": null
            },
            "genericArticles": [
                {
                    "genericArticleId": 1,
                    "genericArticleDescription": "Starter Battery"
                },
                {
                    "genericArticleId": 3465,
                    "genericArticleDescription": "Starter Battery"
                }
            ],
            "articleText": null,
            "gtins": [
                6949725904733,
                6949725905938
            ],
            "tradeNumbers": [
                "12V, 100AH, 700A"
            ],
            "oemNumbers": null,
            "replacesArticles": null,
            "replacedByArticles": null,
            "mainArticle": null,
            "partslist": null,
            "articleCriteria": [
                {
                    "criteriaId": 6,
                    "criteriaDescription": "Voltage [V]",
                    "criteriaType": "N",
                    "rawValue": "12",
                    "formatedVal": "12",
                    "immediateDisplay": true,
                    "isMandatory": true,
                    "isInterval": false
                },
                {
                    "criteriaId": 68,
                    "criteriaDescription": "Battery Capacity [Ah]",
                    "criteriaType": "N",
                    "rawValue": "100",
                    "formatedVal": "100",
                    "immediateDisplay": true,
                    "isMandatory": true,
                    "isInterval": false
                },
                {
                    "criteriaId": 64,
                    "criteriaDescription": "Cold-test Current, EN [A]",
                    "criteriaType": "N",
                    "rawValue": "700",
                    "formatedVal": "700",
                    "immediateDisplay": true,
                    "isMandatory": false,
                    "isInterval": false
                },
                {
                    "criteriaId": 203,
                    "criteriaDescription": "Length [mm]",
                    "criteriaType": "N",
                    "rawValue": "409",
                    "formatedVal": "409",
                    "immediateDisplay": true,
                    "isMandatory": true,
                    "isInterval": false
                },
                {
                    "criteriaId": 206,
                    "criteriaDescription": "Width [mm]",
                    "criteriaType": "N",
                    "rawValue": "170",
                    "formatedVal": "170",
                    "immediateDisplay": true,
                    "isMandatory": true,
                    "isInterval": false
                },
                {
                    "criteriaId": 209,
                    "criteriaDescription": "Height [mm]",
                    "criteriaType": "N",
                    "rawValue": "234",
                    "formatedVal": "234",
                    "immediateDisplay": true,
                    "isMandatory": true,
                    "isInterval": false
                },
                {
                    "criteriaId": 77,
                    "criteriaDescription": "Post Positions",
                    "criteriaType": "A",
                    "rawValue": "1",
                    "formatedVal": "1",
                    "immediateDisplay": false,
                    "isMandatory": true,
                    "isInterval": false
                },
                {
                    "criteriaId": 5,
                    "criteriaDescription": "Hold-down Type",
                    "criteriaType": "A",
                    "rawValue": "B0",
                    "formatedVal": "B0",
                    "immediateDisplay": false,
                    "isMandatory": true,
                    "isInterval": false
                },
                {
                    "criteriaId": 899,
                    "criteriaDescription": "Terminal Type",
                    "criteriaType": "A",
                    "rawValue": "T2",
                    "formatedVal": "T2",
                    "immediateDisplay": false,
                    "isMandatory": false,
                    "isInterval": false
                }
            ],
            "pdfs": null,
            "images": null,
            "links": null,
            "logo": {
                "url": "https://onedbcdn.tecalliance.cn/static/4617/MDAzMDAwMS5KUEc=",
                "type": "JPG"
            }
        }
    ]
}