PurchaseOrder DTO v13

Represents a purchase order with all the necessary properties including net prices, gross prices and taxes. Purchase ordres can only be created on business partners of type SUPPLIER and can only contain items with flag “purchaseItem” set to true.

Field Name Type Required Constraint Reference Description
billingAddress Identifier Optional Address : 15, 16, 17, 18 Reference to the billing address of the business partner.
businessPartner Identifier Optional BusinessPartner : 16, 17, 18, 19, 20 Reference to the corresponding business partner.
cancelled Boolean Required
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 Reference to the contact of the business partner.
deliveryDate Date Optional Date of delivery for this object.
documentDate Date Optional
documentOrigin DocumentOrigin Optional Allowed values { BACKEND_INFORMATION_SERVICE } The origin of this document. @See DocumentOrigin for more information.
expenses Monetary Optional Additional expense amount.
object ObjectRef Optional
overallDiscount BigDecimal Optional Discount which is calculated on top of the total net.
paymentTermCode String Optional length >= 1 & length <= 255 Code of the associated payment term.
paymentTermName String Optional length >= 1 & length <= 255 Name of the associated payment term.
paymentTypeCode String Optional length >= 1 & length <= 255 Code of the associated payment type.
paymentTypeName String Optional length >= 1 & length <= 255 Name of the associated payment type.
purchaseOrderItems Set<PurchaseOrderItemDTO_V13> Optional List of items related to this object.
refNo String Optional length >= 1 & length <= 255 Customers reference number.
remarks String Optional length >= 1 Remarks or notes, can be used for any string based content which contains necessary information.
salesPerson Identifier Optional Person : 15, 16, 17, 18, 19, 20 Reference to the salesperson responsible for this document.

Considered by the permission system whenever read/write permission is set to OWN.

shippingAddress Identifier Optional Address : 15, 16, 17, 18 Reference to the shipping address of the business partner.
shippingTypeCode String Optional length >= 1 & length <= 255 Code of the associated shipping type.
shippingTypeName String Optional length >= 1 & length <= 255 Name of the associated shipping type.
status PurchaseOrderStatus Required Allowed values { DRAFT, OPEN, APPROVED, CLOSED } The current status. @See PurchaseOrderStatus.
tax Monetary Optional Amount of tax which applies to this.
taxDate Date Optional
totalAmountGross Monetary Optional Total amount gross price (including taxes).
totalAmountNet Monetary Optional Total amount net price (without taxes).
unitOfMeasure String Optional length >= 1 & length <= 255
usage Identifier Optional Usage : 11, 12, 13, 14 Reference to the usage of in this position.