(Quick Reference) Service: Show

Description: This web service return an assigned customer category to a tax list in JSON format

Method: GET

URL:

https://BASE_URL/api/VERSION/customerTaxLists/{id}

Parameters:

NameDescriptionTypeRequiredExample values
idid of the wanted customer category tax listLongYes777

URL with external_id:

https://BASE_URL/api/VERSION/customerCategoryTaxLists/reference/{customerCategoryId}/{taxListId}

Parameters:

NameDescriptionTypeRequiredExamples values
customerCategoryIdreference of the customer categoryStringYesCC-002
taxListIdreference of the tax listStringYesTL-001

Success Output

Success case: response.status=200
{
    "id": 11,
    "taxListReference": "RT-007",
    "customerCategoryReference": "101",
    "customerCategory": {
        "id": 3,
        "reference": "101",
        "name": "new Categ",
        "href": "/api/v1/customerCategories/3"
    },
    "taxList": {
        "id": 11,
        "reference": "RT-007",
        "name": "new Tx1",
        "href": "/api/v1/taxLists/11"
    },
    "organization": "Lyon",
    "dateCreated": "2016-08-25T10:21:09Z",
    "lastUpdated": "2016-08-25T10:21:09Z"
}

Failure Output

Failure case:response.status = 400
{
    "error": "invalid_param_type",
    "error_description": "The type of parameter id you provided is not valid for this request."
}

Failure case:response.status = 404
{
    "error": "not_found",
    "error_description": "The customer category tax list with the id 999 doesn't exist."
}