ServiceCall DTO v24

Service call or ticket which indicates a request from customer to a certain problem or service.

Field Name Type Required Constraint Reference Description
businessPartner Identifier Optional BusinessPartner : 16, 17, 18, 19, 20 Business partner which this service call belongs to.
changelog String Optional length >= 1 Changelog contains information about every change made to the service call by different clients or the erp Example: [{ "usrname":"X/00004002", "date":"2012-01-20T13:49:37+01:00", "fld":"statusCode", "old":"0", "new":"-1" }, { "usrname":"X/00004002", "date":"2012-01-20T13:49:37+01:00", "fld":"statusName", "old":"Freigegeben", "new":"Closed" }]
chargeableEfforts boolean Optional Indicates if efforts on this service call are chargeable by default.
chargeableExpenses boolean Optional Indicates if expenses on this service call are chargeable by default.
chargeableMaterials boolean Optional Indicates if materials on this service call are chargeable by default.
chargeableMileages boolean Optional Indicates if mileages on this service call are chargeable by default.
code String Optional length >= 1 & length <= 255 System code of this object, normally this correlates to the erp id given by the source system.
contact Identifier Optional Contact : 12, 13, 14, 15, 16 Contact of the business partner.
dueDateTime DateTime Optional Due date until when this servicecall has to be completed/closed.
endDateTime DateTime Optional End datetime of the service call.
equipments List<Identifier> Optional Equipment : 14, 15, 16, 17, 18, 19, 20 Equipments which are related to this service call.
incident Identifier Optional Incident : 8, 9, 10, 11 incident that belongs to this service call.
leader Identifier Optional Person : 15, 16, 17, 18, 19, 20 Reference to a person representing leader on-site.
objectGroup Identifier Optional ObjectGroup : 11, 12, 13, 14 Object group which this service call belongs to.
orderDateTime DateTime Optional DateTime when ordering a service call by a Purchase Order.
orderReference String Optional length >= 1 & length <= 255 reference when ordering a service call by a Purchase Order
originCode String Optional length >= 1 & length <= 255 System code of the service call origin object.
originName String Optional length >= 1 & length <= 255 System name of the service call origin object.
partOfRecurrenceSeries Boolean Optional
priority String Optional length >= 1 & length <= 255

Allowed values are defined into Enumerations having enumType = SERVICE_CALL_PRIORITY.
For learning about Enumerations, please check this.
Priority of this service call (can depend on SLA or customer wish or internal definitions).
problemTypeCode String Optional length >= 1 & length <= 255 System code of the problem type object.
problemTypeName String Optional length >= 1 & length <= 255 System name of the problem type object.
project Identifier Optional Project : 8, 9, 10 Reference to a project.
projectPhase Identifier Optional ProjectPhase : 8, 9, 10 Project phase that this service call was created by (during release process).
remarks String Optional length >= 1 Remarks or notes related to this service call, can be used for any string based content which contains necessary information.
resolution String Optional length >= 1 Resolution of this service call problem, can be used for any string based content which contains necessary information.
responsibles Set<Identifier> Optional Person : 15, 16, 17, 18, 19, 20 Responsible person's for this servicecall. Considered by permission system whenever read/write permission is set to OWN.
salesOrder Identifier Optional SalesOrder : 13, 14, 15, 16, 17 salesOrder attached to this serviceCall.
salesQuotation Identifier Optional SalesQuotation : 12, 13, 14, 15, 16 Sales Quotation attached to this Service Call.
serviceContract Identifier Optional ServiceContract : 8, 9, 10, 11, 12 Reference to a service contract.
startDateTime DateTime Optional Start datetime of the service call.
statusCode String Optional length >= 1 & length <= 255 System code of the servicecall status object.
statusName String Optional length >= 1 & length <= 255 System name of the service call status object.
subject String Optional length >= 1 & length <= 255 Describes the service call subject. this is a short text summary or title of the object.
team Identifier Optional Team : 8, 9, 10 Reference to a team.
technicians Set<Identifier> Optional Person : 15, 16, 17, 18, 19, 20 Assigned technicians for this service call. Considered by permission system whenever read/write permission is set to OWN.
typeCode String Optional length >= 1 & length <= 255 System code of the servicecall type object.
typeName String Optional length >= 1 & length <= 255 System name of the service call type object.