Line - GOBL

Line is a single row in an invoice.

Schema ID

https://gobl.org/draft-0/bill/line

Properties

Title	Property	Type	Description
UUID	`uuid`	string	Universally Unique Identifier.
Index	`i`	integer	Line number inside the parent (calculated)
Quantity	`quantity`	num.Amount	Number of items
Identifier	`identifier`	org.Identity	Single identifier provided by the supplier for an object on which the line item is based and is not considered a universal identity. Examples include a subscription number, telephone number, meter point, etc. Utilize the label property to provide a description of the identifier.
Period	`period`	cal.Period	A period of time relevant to when the service or item is delivered.
Order Reference	`order`	cbc.Code	Order reference for a specific line within a purchase order provided by the buyer.
Cost Reference	`cost`	cbc.Code	Buyer accounting reference cost code to associate with the line.
Item	`item`	org.Item	Details about the item, service or good, that is being sold
Breakdown	`breakdown`	array of bill.SubLine	Breakdown of the line item for more detailed information. The sum of all lines will be used for the item price.
Sum	`sum`	num.Amount	Result of quantity multiplied by the item’s price (calculated)
Discounts	`discounts`	array of bill.LineDiscount	Discounts applied to this line
Charges	`charges`	array of bill.LineCharge	Charges applied to this line
Taxes	`taxes`	tax.Set	Map of taxes to be applied and used in the invoice totals
Total	`total`	num.Amount	Total line amount after applying discounts to the sum (calculated).
Substituted	`substituted`	array of bill.SubLine	List of substituted lines. Useful for deliveries or corrective documents in order to indicate to the recipient which of the requested lines are being replaced. This is for purely informative purposes, and will not be used for calculations.
Seller	`seller`	org.Party	Seller of the item if different from the supplier or ordering seller. This can be useful for marketplace or drop-ship scenarios in locations that require the original seller to be indicated.
Notes	`notes`	array of org.Note	Set of specific notes for this line that may be required for clarification.
Extensions	`ext`	tax.Extensions	Extension codes that apply to the line

Validation Rules

Field	Test	Validation Code / Message
`i` Calculated	Present	`GOBL-BILL-LINE-01` Index is required
`quantity`	Present	`GOBL-BILL-LINE-02` Quantity is required
`item`	Present	`GOBL-BILL-LINE-03` Item is required
`sum` Calculated	Item has price Present	`GOBL-BILL-LINE-04` Sum is required when item has a price
`total` Calculated	Item has price Present	`GOBL-BILL-LINE-05` Total is required when item has a price

Invoice LineCharge

⌘I