Skip to content

Lines (Order Lines) ​

Lines contain the articles sold, with quantity, prices, discounts, and other details. The order lines constitute the revenue registered in POS. Lines are embedded within the order document.

Fields ​

FieldTypeRequiredDescription
solidintegerYesUnique line number.
article_idintegerYesReference to Article sold.
article_namestringYesName of the article (denormalized).
article_ext_numstringNoReference to external article number (PLU or similar).
quantityfloatYesQuantity sold.
tax_pct_valueintegerYesTax (VAT) percentage.
net_amountfloatYesNet amount (excluding tax).
gross_amountfloatYesGross amount (including tax).
base_net_amountfloatNoBase net amount before modifiers.
base_gross_amountfloatNoBase gross amount before modifiers.
total_net_amountfloatNoTotal net amount for line including optional children (modifiers).
total_gross_amountfloatNoTotal gross amount for line including optional children (modifiers).
discount_amountfloatNoDiscount amount applied.
discount_pctfloatNoDiscount percentage.
cost_pricefloatNoCost price (net) at time order was sold.
price_group_idintegerNoReference to price group.
price_group_namestringNoName of price group applied for the order line (denormalized).
account_idintegerNoReference to Account for GL posting.
line_item_guidguidNoUnique GUID for the line item.
line_added_timedatetimeNoTimestamp when line was added to order.
parent_solidintegerNoReference to parent line for child line items (modifiers).
commentstringNoComment/note on the line item.
replaced_article_idintegerNov1.1. Article ID of item that was replaced/modified.
replaced_quantityfloatNov1.1. Quantity of the replaced item.
replaced_net_amountfloatNov1.1. Net amount of the replaced item.
replaced_gross_amountfloatNov1.1. Gross amount of the replaced item.
saft_basic_idstringNov1.2. SAF-T classification code of the line's account (absent when untagged).
bundle_solidintegerNov1.2. For bundle component lines: the solid of the bundle header line they belong to. Absent for non-bundle lines.

Parent-Child Relationship (Modifiers) ​

Lines can have a parent-child relationship for modifiers. When a product has add-ons or modifications:

  • The main product is the parent line
  • Modifiers reference the parent via parent_solid
  • total_net_amount and total_gross_amount on the parent include all child amounts
  • base_net_amount and base_gross_amount show the original parent amounts before modifiers

Bundles (v1.2) ​

When an article is sold as a bundle, the bundle's own line is the header and its component lines carry bundle_solid = the header line's solid (analogous to parent_solid for modifiers). A line is a bundle header when its solid appears as another line's bundle_solid.

Example - Simple Line ​

json
{
  "solid": 380019009,
  "article_id": 584758,
  "article_ext_num": "4202",
  "article_name": "Latte",
  "quantity": 1,
  "tax_pct_value": 15,
  "net_amount": 54.78,
  "gross_amount": 63,
  "base_net_amount": 54.78,
  "base_gross_amount": 63,
  "total_net_amount": 54.78,
  "total_gross_amount": 63,
  "discount_amount": 0,
  "account_id": 35116,
  "cost_price": 0,
  "line_item_guid": "b33f64cd-2829-4b6b-a269-ca9bc3ad714f",
  "line_added_time": "2026-01-20T06:54:36",
  "comment": "Enkel\r\nLettmelk\r\n"
}

Example - Parent Line with Modifiers ​

Main product with modifiers showing the parent-child relationship:

Parent Line (Latte):

json
{
  "solid": 380019033,
  "article_id": 584758,
  "article_ext_num": "4202",
  "article_name": "Latte",
  "quantity": 1,
  "tax_pct_value": 15,
  "net_amount": 54.78,
  "gross_amount": 63,
  "base_net_amount": 54.78,
  "base_gross_amount": 63,
  "total_net_amount": 73.91,
  "total_gross_amount": 85,
  "account_id": 35116,
  "line_item_guid": "1a3f77cc-26cb-45ae-9caa-7ad9c09d04c3",
  "line_added_time": "2026-01-20T07:02:36"
}

Child Line (Modifier - Extra Shot):

json
{
  "solid": 380019035,
  "article_id": 590397,
  "article_name": "Ekstra shot",
  "quantity": 1,
  "tax_pct_value": 15,
  "net_amount": 8.7,
  "gross_amount": 10,
  "base_net_amount": 8.7,
  "base_gross_amount": 10,
  "total_net_amount": 8.7,
  "total_gross_amount": 10,
  "account_id": 35116,
  "parent_solid": 380019033,
  "line_item_guid": "be79c848-e983-474f-a85c-82355df8d49a",
  "line_added_time": "2026-01-20T07:02:40"
}

Child Line (Modifier - Syrup):

json
{
  "solid": 380019034,
  "article_id": 585437,
  "article_ext_num": "4213",
  "article_name": "Karamel sirup",
  "quantity": 1,
  "tax_pct_value": 15,
  "net_amount": 10.43,
  "gross_amount": 12,
  "base_net_amount": 10.43,
  "base_gross_amount": 12,
  "total_net_amount": 10.43,
  "total_gross_amount": 12,
  "account_id": 35116,
  "parent_solid": 380019033,
  "line_item_guid": "f13005b5-1707-4256-b932-e9a6a4293aaa",
  "line_added_time": "2026-01-20T07:02:40"
}

Note: The parent's total_gross_amount (85) = parent's gross_amount (63) + children's gross_amount (10 + 12).

Technical documentation for partners and integrators