Configuration and Content API Guide

Update Tax Classes

post

/config/sim/v1/sales/updatetaxclasses

Updates the tax class. If tax class is not found, it creates a new tax class.

Request

Supported Media Types

application/json
multipart/form-data

Header Parameters

Simphony-AuditTrailRef: string

Detail that identifies, who made the change.

Tax Class object of the organization

Root Schema : TaxClassCURequestBody

Type: object

Model for Tax Class Object

Show Source

dataExtensions: array dataExtensions

An array of data extensions for the tax class
hierUnitId(required): integer

Unique reference of the hierarchy unit

Example: 2
name(required): object name

Name
objectNum(required): integer

Object Number of the family group

Example: 1
taxes: array taxes

An array of taxes configured for the tax class

{
    "description":"Model for Tax Class Object",
    "type":"object",
    "required":[
        "hierUnitId",
        "objectNum",
        "name"
    ],
    "properties":{
        "hierUnitId":{
            "description":"Unique reference of the hierarchy unit",
            "type":"integer",
            "example":2
        },
        "objectNum":{
            "description":"Object Number of the family group",
            "type":"integer",
            "example":1
        },
        "name":{
            "type":"object",
            "description":"Name",
            "example":{
                "en-US":"Family Group 1",
                "de-DE":"Familiengruppe 1",
                "es-MX":"Grupo Familiar 1"
            }
        },
        "taxes":{
            "description":"An array of taxes configured for the tax class",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "taxObjNum":{
                        "description":"Object Number of the tax",
                        "type":"integer",
                        "example":1
                    }
                }
            }
        },
        "dataExtensions":{
            "description":"An array of data extensions for the tax class",
            "type":"array",
            "items":{
                "properties":{
                    "columnName":{
                        "description":"Name of the extension field",
                        "type":"string",
                        "example":"extension column 1"
                    },
                    "value":{
                        "description":"Value of the extension field",
                        "type":"string",
                        "example":"Value1"
                    }
                }
            }
        }
    }
}

Nested Schema : dataExtensions

Type: array

An array of data extensions for the tax class

Show Source

Array of: object items

{
    "description":"An array of data extensions for the tax class",
    "type":"array",
    "items":{
        "properties":{
            "columnName":{
                "description":"Name of the extension field",
                "type":"string",
                "example":"extension column 1"
            },
            "value":{
                "description":"Value of the extension field",
                "type":"string",
                "example":"Value1"
            }
        }
    }
}

Nested Schema : name

Type: object

Name

Example:

{
    "en-US":"Family Group 1",
    "de-DE":"Familiengruppe 1",
    "es-MX":"Grupo Familiar 1"
}

Nested Schema : taxes

Type: array

An array of taxes configured for the tax class

Show Source

Array of: object items

{
    "description":"An array of taxes configured for the tax class",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "taxObjNum":{
                "description":"Object Number of the tax",
                "type":"integer",
                "example":1
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

columnName: string

Name of the extension field

Example: extension column 1
value: string

Value of the extension field

Example: Value1

{
    "properties":{
        "columnName":{
            "description":"Name of the extension field",
            "type":"string",
            "example":"extension column 1"
        },
        "value":{
            "description":"Value of the extension field",
            "type":"string",
            "example":"Value1"
        }
    }
}

Nested Schema : items

Type: object

Show Source

taxObjNum: integer

Object Number of the tax

Example: 1

{
    "type":"object",
    "properties":{
        "taxObjNum":{
            "description":"Object Number of the tax",
            "type":"integer",
            "example":1
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Tax Class Updated or Added.

Root Schema : TaxClassResponse

Type: object

Model for the response

Show Source

hierUnitId: integer

Unique hierarchy unit value

Example: 1
objectNum: integer

Object number of the tax class

Example: 1

{
    "description":"Model for the response",
    "type":"object",
    "properties":{
        "hierUnitId":{
            "description":"Unique hierarchy unit value",
            "type":"integer",
            "example":1
        },
        "objectNum":{
            "description":"Object number of the tax class",
            "type":"integer",
            "example":1
        }
    }
}