Approval DTO v11

This object provides the ability to let users approve or decline requests assigned to them.

As there are not all objects available on the devices there might exist approval cases we not even considered. We decided to give you a big remarks field, where one can put all the necessary decision information like order lines, discounts, etc.

In addition there are predefined links for business partner and objectId/objectType referencing available which can be used to link to a document the user has permission for.

For each assigned person, there exists a separate approval object - not like the alert where one alert has multiple receivers.

Field Name Type Category Constraint Reference Description
businessPartner Identifier Optional BusinessPartner : 16, 17, 18, 19, 20 Reference to the linked businesspartner.
code String Optional length >= 1 & length <= 256 System code of this object, normally this correlates to the erp id given by the source system.
decisionDate DateTime Optional Date when the decision needs to be done.
decisionMaker Identifier Optional Person : 15, 16, 17, 18, 19 Person who made or has to make the decision. Considered by the permission system whenever read/write permission is set to OWN.
decisionRemarks String Optional length >= 1 & length <= 1024 Remarks entered by the decision maker.
decisionStatus ApprovalDecisionStatus Optional Allowed values { PENDING, APPROVED, DECLINED, APPROVED_CLOSED, DECLINED_CLOSED, CANCELLED } Current decision status (@see ApprovalDecisionStatus).
docEntry String Optional length >= 1 & length <= 256 Real ERP id of the referenced document
documentDate DateTime Optional Date of creation for the document which needs to get approved.
documentStatus String Optional length >= 1 & length <= 512 Status of the document which needs to get approved.
issueDate DateTime Optional Date this approval was issued.
issuer Identifier Optional Person : 15, 16, 17, 18, 19 Person who issued this approval.
issuerRemarks String Optional length >= 1 & length <= 1024 Remarks entered by the issuer about his opinion and reasons why this approval should be accepted or declined.
object ObjectRef Optional Referenced object for this approval, standard referenced objects are opportunities, service calls, sales quotations, sales orders, business partners.
objectDescription String Optional length >= 1 & length <= 2147483647 Text description of a linked object.
remarks String Optional length >= 1 & length <= 2147483647 General remarks field for all information necessary to decide.
subject String Optional length >= 1 & length <= 512 Short text subject, in general this is displayed on one line.