Line items

The vcr:LineItem element is used to display line items in documents of type order confirmation, delivery note slip and invoice.

The vcr:LineItem element has the following constituents:

Name

Type/occurrence

Descripiton

Name

Type/occurrence

Descripiton

vcr:LineID

xsd:string

ID of the line item, unique within the document.

vcr:OrderID

vcr:LineReferenceType?

Reference to order.

vcr:OrderConfirmationID

vcr:LineReferenceType?

Reference to order confirmation.

vcr:DeliveryNoteID

vcr:LineReferenceType?

Reference to delivery note.

cbc:DeliveryDate

?

Delivery date.

cbc:Quantity

 

Quantity/number.

cac:Item

 

Item.

vcr:ItemInstance

*

Item instance Item instance data.

vcr:UnitPrice

cbc:PrimeAmountType

Unit price based on order quantity (net).

vcr:LinePrice

cbc:PrimeAmountType

Net price of line item.


Rules

  1. The value of the LineID element must be unique for all LineItem elements of a document, and must remain the same for all retrievals of a document.

  2. The Item.TaxCategory element is only used if turnover tax applies to the line item, the buyer is charged this tax.

  3. If the TaxCategory element is used in the Item element, the percentage applicable to the related document and this line item must be specified in Item.TaxCategory.Percent. The ID of TaxCategory can be set as required, provided that Item.TaxCategory.Percent is also consistent for all line items with the same Item.TaxCategory.ID.
    The value “VAT” must be used consistently for Item.TaxCategory.TaxScheme.ID.

  4. In the Item element, SellersItemIdentification can be omitted for line items which do not indicate articles, e.g. notes, incidental costs, discounts, offsets.

  5. In contrast to vco:OrderResponse and vco:FinalOrderResponse, several line items can exist for the same article, i.e. Item.SellersItemIdentification.ID need not be unique within a document's line items.

  6. Because no more than one reference to order, order confirmation and delivery note, and no more than one delivery date must be specified for each line item, separate line items must be created per article if necessary.
    Example: 10 units of article XY were ordered in order B1; two partial deliveries of respectively 4 and 6 units were performed on 12.9.2019 and 14.9.2019 with delivery notes L1 and L2. The invoice which groups both delivery notes for article XY then includes a line item indicating 4 units, OrderID=B1, DeliveryNoteID=L1, DeliveryDate=12.9.2019, and a line item indicating 6 units, OrderID=B1, DeliveryNoteID=L2, DeliveryDate=14.9.2019.

  7. For customizable articles, individual characteristics of the delivered articles can be communicated via the ItemInstance elements. If ItemInstance elements are used, their number must match the value indicated in Quantity. In such cases, PK is not permissible as a quantity unit. Also refer to the section on instances of articles and serial numbers.

  8. The value indicated by LinePrice must correspond to the product of Quantity and UnitPrice (except for rounding errors).

  9. If a reference to order, order confirmation or delivery note is provided via OrderID, OrderConfirmationID or DeliveryNoteID, the optional LineID must be used within this element, if the reference is not already unique on the basis of the referenced document number and article number.