<< 38Assign categories of customers to price Lists

(Quick Reference)

39 Tax Lists - Reference Documentation

Version: 2.1

39.1List

39.2Show

39.3Create

39.4update

39.5Upsert

39.6Delete

39 Tax Lists

39.1 List

Service: List

Description: This web service return tax lists with consideration to the specified organization in JSON format

URL:

https://BASE_URL/api/VERSION/taxLists

Method: GET

Parameters:

Pagination parameters:

Name	Description	Type	Required	Possible values
offset	Tells where to start returning records from the entire set of results	Integer	No
max	limits the number of resources requested to return	Integer	No
sort	Orders the results by the specified field	String	No
order	Orders ascending (ASC) or descending DESC	Integer	No	asc, desc

Filters parameters:

Name	Description	Type	Required	Example values
dateCreated_gt	Filters by the resource's creation date time and operator greater than	Date	no	2016-08-15T14:52:48Z
dateCreated_gte	Filters by the resource's creation date time and operator greater than or equal	Date	no
dateCreated_lt	Filters by the resource's creation date time and operator less than	Date	no
dateCreated_lte	Filters by the resource's creation date time and operator less than or equal	Date	no
lastUpdated_gt	Filters by the resource's last-modified date time and operator greater than	Date	no
lastUpdated_gte	Filters by the resource's last-modified date time and operator greater than or equal	Date	no
lastUpdated_lt	Filters by the resource's last-modified date time and operator less than	Date	no
lastUpdated_lte	Filters by the resource's last-modified date time and operator less than or equal	Date	no
reference	Wildcard search by the resource's reference	String	no	reference=Ref-6* , reference=ef-6 , reference=ef-6*
name	Wildcard search by the resource's name	String	no

Dates should be formatted as the ISO-8601 format (YYYY-MM-DDTHH:MM:SSZ)

Success Output

Success case: response.status=200

{
    "paging": {
        "total": 2,
        "max": 100,
        "offset": 0,
        "previous": null,
        "next": null
    },
    "data": [
        {
            "id": 11,
            "name": "Tx1",
            "reference": "RT-1",
            "organization": "Lyon",
            "taxType": {
                "id": 17,
                "name": "Percentage %",
                "href": "/api/v1.0/taxTypes/17"
            },
            "dateCreated": "2016-08-18T13:44:01Z",
            "lastUpdated": "2016-08-18T13:44:01Z"
        },
        {
            "id": 12,
            "name": "Tx2",
            "reference": "RT-2",
            "organization": "Lyon",
            "taxType": {
                "id": 18,
                "name": "Fixed amount",
                "href": "/api/v1.0/taxTypes/18"
            },
            "dateCreated": "2016-08-18T13:44:16Z",
            "lastUpdated": "2016-08-18T13:44:16Z"
        }
    ]
}

Failure Output

Failure case:response.status = 400

{
   "error": "invalid_param",
   "error_description": "The parameters [dateCreated_gta] you provided are not valid for this request."
}

{
    "error": "invalid_datetime_format",
    "error_description": "Invalid datetime filter (not ISO-8601 formatted): [2016-08-1Z]"
}

Failure case:response.status = 500

{
   "error": "server_error",
   "error_description": "Oops! Something went wrong..."
}

39.2 Show

Service: Show

Description: This web service return an existing taxList of the specified id in JSON format

URL:

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

URL with external_id:

https://BASE_URL/api/VERSION/taxLists/reference/{id}

Method: GET

Parameters:

Name	Description	Type	Required	Example values
id	id of the wanted tax list	Long/String	Yes	777

Success Output

Success case: response.status=200

{
    "id": 11,
    "name": "Tx1",
    "reference": "RT-1",
    "organization": "Lyon",
    "taxType": {
        "id": 17,
        "name": "Percentage %",
        "href": "/api/v1.0/taxTypes/17"
    },
    "dateCreated": "2016-08-18T13:44:01Z",
    "lastUpdated": "2016-08-18T13:44:01Z"
}

Failure Output

Failure case:response.status = 404

{
    "error": "not_found",
    "error_description": "The tax list with the id 444 doesn't exist."
}

Failure case:response.status = 400

{
    "error": "invalid_param_type",
    "error_description": "The type of parameter id you provided is not valid for this request."
}

39.3 Create

Service: Save

Description: This web service is used to add a new tax list object into the database

URL:

https://BASE_URL/api/VERSION/taxLists

Method: POST

Request content type: application/json

Parameters:

Name	Description	Type	Required
reference	the reference of the new tax list	String	Yes
name	the name of the new tax list	String	Yes
taxTypeId	id of the tax type used	Long	Yes

reference must be unique

Success Output

Success case: response.status=201

{
    "id": 13,
    "name": "Tx22",
    "reference": "RT-22",
    "organization": "Lyon",
    "taxType": {
        "id": 18,
        "name": "Fixed amount",
        "href": "/api/v1.0/taxTypes/18"
    },
    "dateCreated": "2016-08-18T14:18:23Z",
    "lastUpdated": "2016-08-18T14:18:23Z"
}

Failure Output

Failure case:response.status = 400

{
    "error": "missing_param",
    "error_description": "reference parameter is missing"
}

{
    "error": "not_unique",
    "error_description": "reference already used"
}

{
     "error": "save_failed",
     "error_description": "Failed to save instance"
}

{
     "error":"invalid_param_type",
     "error_description": "The type of parameter taxTypeId you provided is not valid for this request."
}

Failure case:response.status = 404

{
    "error": "not_found",
    "error_description": "The tax type with the id 99 doesn't exist."
}

Failure case:response.status = 500

{
    "error": "server_error",
    "error_description": "Oops! Something went wrong..."
}

39.4 update

Service: Update

Description: This web service is used to update an existing tax list object to the database

URL:

https://BASE_URL/api/VERSION/taxLists

URL with external_id:

https://BASE_URL/api/VERSION/taxLists/reference/{id}

Method: PUT

Request content type: application/json

Parameters:

Name	Description	Type	Required	Example values
reference	the new reference of the tax list	String	Yes
name	the new name of the tax list	String	Yes
taxTypeId	the new id of the used tax type	Long	Yes	17

reference must be unique

Success Output

Success case: response.status=201

{
    "id": 11,
    "name": "new Tx1",
    "reference": "RT-007",
    "organization": "Lyon",
    "taxType": {
        "id": 17,
        "name": "Percentage %",
        "href": "/api/v1.0/taxTypes/17"
    },
    "dateCreated": "2016-08-18T13:44:01Z",
    "lastUpdated": "2016-08-18T14:29:00Z"
}

Failure Output

Failure case:response.status = 400

{
    "error": "missing_param",
    "error_description": "reference parameter is missing"
}

{
    "error": "not_unique",
    "error_description": "reference already used"
}

{
     "error": "save_failed",
     "error_description": "Failed to save instance"
}

{
     "error":"invalid_param_type",
     "error_description": "The type of parameter taxTypeId you provided is not valid for this request."
}

Failure case:response.status = 404

{
    "error": "not_found",
    "error_description": "The tax type with the id 99 doesn't exist."
}

Failure case:response.status = 500

{
    "error": "server_error",
    "error_description": "Oops! Something went wrong..."
}

39.5 Upsert

Service: Upsert

Description: This web service is used to insert a tax list object to the database if it does not already exist, or update it.

URL with external_id:

https://BASE_URL/api/VERSION/taxLists/reference/{id}

Method: POST

Request content type: application/json

Parameters:

Name	Description	Type	Required	Example values
name	the name of the new tax list	String	Yes
taxTypeId	id of the tax type used	Long	Yes

reference must be unique

Success Output

Success case: response.status=201

{
    "id": 13,
    "name": "Tx22",
    "reference": "RT-22",
    "organization": "Lyon",
    "taxType": {
        "id": 18,
        "name": "Fixed amount",
        "href": "/api/v1.0/taxTypes/18"
    },
    "dateCreated": "2016-08-18T14:18:23Z",
    "lastUpdated": "2016-08-18T14:18:23Z"
}

Failure Output

Failure case:response.status = 400

{
    "error": "missing_param",
    "error_description": "reference parameter is missing"
}

{
    "error": "not_unique",
    "error_description": "reference already used"
}

{
     "error": "save_failed",
     "error_description": "Failed to save instance"
}

{
     "error":"invalid_param_type",
     "error_description": "The type of parameter taxTypeId you provided is not valid for this request."
}

Failure case:response.status = 404

{
    "error": "not_found",
    "error_description": "The tax type with the id 99 doesn't exist."
}

Failure case:response.status = 500

{
    "error": "server_error",
    "error_description": "Oops! Something went wrong..."
}

39.6 Delete

Service: Delete

Description: This web service is used in order to delete an existing tax list object from the database

URL:

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

URL with external_id:

https://BASE_URL/api/VERSION/taxLists/reference/{id}

Method: DELETE

Parameters:

Name	Description	Type	Required	Examples values
id	Id of the desired tax list to delete	Long/String	Yes	777

Success Output

Success case: response.status=200

{
    "success": "true",
    "success_description": "Instance deleted successfully"
}

Failure Output

Failure case:response.status = 404

{
    "error": "not_found",
    "error_description": "The tax list with the id 444 doesn't exist."
}

Failure case:response.status = 400

{
    "error": "invalid_param_type",
    "error_description": "The type of parameter id you provided is not valid for this request."
}

{
    "error": "delete_failed",
    "error_description": "Failed to delete instance"
}

Failure case:response.status = 500

{
    "error": "server_error",
    "error_description": "Oops! Something went wrong..."
}

<< 38Assign categories of customers to price Lists

40Tax Types >>

39 Tax Lists - Reference Documentation

Table of Contents

39 Tax Lists

39.1 List

Success Output

Failure Output

39.2 Show

Success Output

Failure Output

39.3 Create

Success Output

Failure Output

39.4 update

Success Output

Failure Output

39.5 Upsert

Success Output

Failure Output

39.6 Delete

Success Output

Failure Output

Answers

Appointment

Appointment Categories

Attribute values

Attributes

Authentication

Authority

Check In List

Contacts

Customer Categories

Customer Categories Discount Lists

Customer Categories Price Lists

Customer Categories Tax Lists

Customer Discounts

Customer Employee

Customer Group Promotion Lists

Customer Groups

Customer Groups Assign

Customer Price List

Customer Promo List

Customer Segmentations

Customer Tax List

Customers

Deliveries

Discount lists

Employee Groups

Employee Item Category Assign

Employee WareHouses

Employees

Exchange rates

Item Categories

Item Groups

Item Groups Assign

Item attributes

Item category translation

Item customer groups assign

Item group translation

Item translation

Item units

Items

Loading details

Loadings

Objectives

Operation Prepayments

Operation lines

Operation payments

Operations

Payment types

Prepayment Allocations

Price List

Prices

Promotion inputs

Promotion outputs

Promotions

Question Columns

Question Lines

Question options

Questions

Reasons