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:

{
  "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