---
updatedAt: 2025-10-21T15:08:57.000Z
agentTools:
  projectIndex: https://docs.falco-app.be/llms.txt
---

# Data Models

### 🧱 Identifiers

Each entity has a unique UUID.

***

### 💰 Prices and Amounts

To ensure full precision and avoid floating-point rounding errors, **all monetary values are represented as strings** in the API.

Example:

```json
{
  "unit_price": "120.00",
  "vat_amount": "25.20",
  "total_amount": "145.20"
}
```

**Key points:**

* Always send and parse prices as strings, not numbers.
* Use two decimal places for EUR amounts.
* Perform your own rounding logic before sending the data to Falco.
* When doing calculations, use precise decimal types (e.g. `decimal` in C#, `BigDecimal` in Java, or `Decimal` in Python) instead of float or double.

⚠️ Sending numeric values (e.g. "unitPrice": 120) may cause validation errors or rounding discrepancies when computing totals.

***

### 📅 Dates & time

* Format: ISO 8601 (`YYYY-MM-DDTHH:mm:ssZ`)
* Example: `2025-10-14T09:30:00Z`