> For the complete documentation index, see [llms.txt](https://developers.usetoggle.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.usetoggle.com/key-concepts/overview/orders-transactions-and-line-items.md).

# Orders, Transactions & Line Items

#### Orders <a href="#orders-cards-and-balance-adjustments" id="orders-cards-and-balance-adjustments"></a>

Whether a customer purchases something through your web shop or through your EPOS, it starts life as an **Order**. An order can contain multiple items, be they gift cards or retail items or any mix of each. This is pretty typical for any ecommerce platform, as you might expect.

**Transactions**

Transactions represent an exchange of value between a Toggle account and an end-consumer or third party. A typical example of such an exchange would be for a new Order, whereby the transaction represents the payment taken from the consumer. However, a transaction could also relate to other monetary exchanges, such as a refund to a customer, for example.

#### Line items <a href="#orders-cards-and-balance-adjustments" id="orders-cards-and-balance-adjustments"></a>

A **Line Item** can represent an individual Sale, Redemption, Breakage (expiry), Reversal or gift card Balance Transfer (inbound or outbound). Line Items can relate to both orders and transactions. Indeed, we  consider Line Items the "glue" that ultimately links everything together in our data structure.

#### Cards <a href="#orders-cards-and-balance-adjustments" id="orders-cards-and-balance-adjustments"></a>

If a new order contains a gift or other pre-paid voucher, we'll create a **Card**. A card is like a mini bank account, with a full credit/debit history associated with it. The changes of balance within an individual card we call **Balance Adjustments**. In turn, these balance changes always relate back to the **Line Item** that explains why and who made that adjustment.

### Further reading

If you want to delve further into how we organise our data, our primer for FDs / CFOs might be useful further reading:

[Introduction to financial reporting in Toggle >](http://academy.usetoggle.com/en/articles/4745185-introduction-to-reporting-and-exports-in-toggle)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.usetoggle.com/key-concepts/overview/orders-transactions-and-line-items.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.