Purchase Order DTO v12

Represents a purchase order with all the necessary properties including net prices, gross prices and taxes.

Purchase orders can only be created on business partners of type SUPPLIER and can only contain items with flag “purchaseItem” set to true.


Field Name Type Category 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.
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 Reference to the contact of the business partner.
deliveryDate Date Optional Date of delivery for this object.
documentOrigin DocumentOrigin Optional Allowed values { BACKEND_INFORMATION_SERVICE } The origin of this document. @See DocumentOrigin for more information.
expenses Monetary Optional Additional expense amount.
overallDiscount BigDecimal Optional Discount which is calculated on top of the total net.
paymentTermCode String Optional length >= 1 & length <= 512 Code of the associated payment term.
paymentTermName String Optional length >= 1 & length <= 512 Name of the associated payment term.
paymentTypeCode String Optional length >= 1 & length <= 512 Code of the associated payment type.
paymentTypeName String Optional length >= 1 & length <= 512 Name of the associated payment type.
purchaseOrderItems Set <PurchaseOrderitemdto_v12> Optional List of items related to this object.
refNo String Optional length >= 1 & length <= 300 Customers reference number.
remarks String Optional length >= 1 & length <= 2147483647 Remarks or notes, can be used for any string based content which contains necessary information.
salesPerson Identifier Optional Person : 15, 16, 17, 18, 19 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 <= 512 Code of the associated shipping type.
shippingTypeName String Optional length >= 1 & length <= 512 Name of the associated shipping type.
status PurchaseOrderStatus Optional Allowed values { DRAFT, OPEN, APPROVED, CLOSED } The current status. @See PurchaseOrderStatus.
tax Monetary Optional Amount of tax which applies to this.
totalAmountGross Monetary Optional Total amount gross price (including taxes).
totalAmountNet Monetary Optional Total amount net price (without taxes).
usage Identifier Optional Usage : 11, 12, 13, 14 Reference to the usage of in this position.

PurchaseOrderDTO_v12.PurchaseOrderitemdto_v12

Field Name Type Category Constraint Reference Description
discount BigDecimal Optional Discount for that item position.
item Identifier Required Item : 17, 18, 19, 20, 21 Reference to the item used in this position.
itemName String Optional length >= 1 & length <= 512 Display name of the position.
ordinal Integer Required Ordinal of this position.
quantity BigDecimal Required Quantity of the item for this position.
tax Monetary Optional Represents how much the calculated tax applied to this position is.
taxDescription String Optional length >= 1 & length <= 15 Can be used to store additional information about tax like tax-code or tax-percentage.
udfValues Set<UdfValue> Optional
unitPrice Monetary Optional UnitPrice for this item (what does a unit of this item cost).
usage Identifier Optional Usage : 11, 12, 13, 14 Reference to the usage of in this position.
warehouse Identifier Optional Warehouse : 12, 13, 14, 15 Reference to the warehouse used in this position.