Service Call DTO v17

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

Field Name Type Category 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 & length <= 2147483647 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 <= 512 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 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 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 <= 512 reference when ordering a service call by a Purchase Order
originCode String Optional length >= 1 & length <= 512 System code of the service call origin object.
originName String Optional length >= 1 & length <= 512 System name of the service call origin object.
partOfRecurrenceSeries Boolean Optional
priority String Optional length >= 0 & 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 <= 512 System code of the problem type object.
problemTypeName String Optional length >= 1 & length <= 512 System name of the problem type object.
remarks String Optional length >= 1 & length <= 2147483647 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 & length <= 2147483647 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 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 sales order for this serviceCall.
startDateTime DateTime Optional Start datetime of the service call.
statusCode String Optional length >= 1 & length <= 512 System code of the servicecall status object.
statusName String Optional length >= 1 & length <= 512 System name of the service call status object.
subject String Optional length >= 1 & length <= 512 Describes the service call subject. this is a short text summary or title of the object.
technicians Set<Identifier> Optional Person : 15, 16, 17, 18, 19 Assigned technicians for this service call. Considered by permission system whenever read/write permission is set to OWN.
typeCode String Optional length >= 1 & length <= 512 System code of the servicecall type object.
typeName String Optional length >= 1 & length <= 512 System name of the service call type object.