Jump to

• Request
• Response

Update Service Charge Groups

post

/config/sim/v1/sales/updateservicechargegroups

Updates the Service Charge Group. If Service Charge Group is not found, it creates a new Service Charge Group.

Request

Supported Media Types

• application/json
• multipart/form-data

Header Parameters

• Simphony-AuditTrailRef: string
  Detail that identifies, who made the change.

Body ()

Request body

Root Schema : ServiceChargeGroupCURequestBody

Type: object

Model for ServiceChargeGroup Object

Show Source

• details: array details
  An array of service charges that are part of the service charge group
• hierUnitId(required): integer
  Unique reference of the hierarchy unit

  Example: 1
• name(required): object TranslatedString
  Additional Properties Allowed: additionalProperties

  A string that contains translations into multiple languages
• objectNum(required): integer
  Object number of the Service Charge Group

  Example: 1

{
    "description":"Model for ServiceChargeGroup Object",
    "type":"object",
    "required":[
        "hierUnitId",
        "objectNum",
        "name"
    ],
    "properties":{
        "hierUnitId":{
            "description":"Unique reference of the hierarchy unit",
            "type":"integer",
            "example":1
        },
        "name":{
            "$ref":"#/definitions/TranslatedString"
        },
        "objectNum":{
            "description":"Object number of the Service Charge Group",
            "type":"integer",
            "example":1
        },
        "details":{
            "description":"An array of service charges that are part of the service charge group",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "sequenceNum":{
                        "description":"Sequence number of the service charge group detail in the service charge group",
                        "type":"integer",
                        "example":1
                    },
                    "svcObjNum":{
                        "description":"Object number of the service charge",
                        "type":"integer",
                        "example":1
                    }
                }
            }
        }
    }
}

Nested Schema : details

Type: array

An array of service charges that are part of the service charge group

Show Source

• Array of: object items

{
    "description":"An array of service charges that are part of the service charge group",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "sequenceNum":{
                "description":"Sequence number of the service charge group detail in the service charge group",
                "type":"integer",
                "example":1
            },
            "svcObjNum":{
                "description":"Object number of the service charge",
                "type":"integer",
                "example":1
            }
        }
    }
}

Nested Schema : TranslatedString

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "description":"A string that contains translations into multiple languages",
    "example":{
        "en-US":"Coffee",
        "de-DE":"Kaffee",
        "es-MX":"Cafe"
    },
    "additionalProperties":{
        "type":"string"
    }
}

A string that contains translations into multiple languages

Example:

{
    "en-US":"Coffee",
    "de-DE":"Kaffee",
    "es-MX":"Cafe"
}

Nested Schema : items

Type: object

Show Source

• sequenceNum: integer
  Sequence number of the service charge group detail in the service charge group

  Example: 1
• svcObjNum: integer
  Object number of the service charge

  Example: 1

{
    "type":"object",
    "properties":{
        "sequenceNum":{
            "description":"Sequence number of the service charge group detail in the service charge group",
            "type":"integer",
            "example":1
        },
        "svcObjNum":{
            "description":"Object number of the service charge",
            "type":"integer",
            "example":1
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Service Charge Group object of the organization

Body ()

Root Schema : ServiceChargeGroupResponse

Type: object

Show Source

• hierUnitId(required): integer
  Unique reference of the hierarchy unit

  Example: 1
• objectNum(required): integer
  Object number of the Service Charge Group

  Example: 1

{
    "type":"object",
    "required":[
        "hierUnitId",
        "objectNum"
    ],
    "properties":{
        "hierUnitId":{
            "description":"Unique reference of the hierarchy unit",
            "type":"integer",
            "example":1
        },
        "objectNum":{
            "description":"Object number of the Service Charge Group",
            "type":"integer",
            "example":1
        }
    }
}

400 Response

400 Bad Request

Body ()

Root Schema : ErrorDetails

Type: object

Response body when the request returns an error.

Show Source

• detail(required): string
  A short, human-readable summary of the problem.

  Example: Specified Data is invalid
• errorDetails(required): string
  A human-readable explanation specific to this occurrence of the problem.

  Example: Entity Does Not Exist
• o:errorCode(required): integer
  Error code of the problem

  Example: 55223
• status(required): integer
  HTTP status code.

  Example: 400
• title(required): string
  A short, human-readable summary of the problem type.

  Example: VALIDATION ERROR
• type(required): string
  A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".

  Example: http://www.abc.org/xyz.html

{
    "description":"Response body when the request returns an error.\n",
    "type":"object",
    "required":[
        "o:errorCode",
        "detail",
        "status",
        "type",
        "title",
        "errorDetails"
    ],
    "properties":{
        "o:errorCode":{
            "description":"Error code of the problem",
            "type":"integer",
            "example":55223
        },
        "detail":{
            "description":"A short, human-readable summary of the problem.",
            "type":"string",
            "example":"Specified Data is invalid"
        },
        "status":{
            "description":"HTTP status code.",
            "type":"integer",
            "example":400
        },
        "type":{
            "description":"A URI reference that identifies the problem type. When this member is not present, its value is assumed to be \"about:blank\".",
            "type":"string",
            "example":"http://www.abc.org/xyz.html"
        },
        "title":{
            "description":"A short, human-readable summary of the problem type.",
            "type":"string",
            "example":"VALIDATION ERROR"
        },
        "errorDetails":{
            "description":"A human-readable explanation specific to this occurrence of the problem.",
            "type":"string",
            "example":"Entity Does Not Exist"
        }
    }
}

Back to Top