Product

The Product object represents goods or services that can be added to invoices, proformas, and other documents. Products can be physical goods or services, and can be synced from ANAF e-Factura system.

Attributes

Attribute	Type	In List	In Detail	Description
id	UUID	✓	✓	Unique identifier
name	string	✓	✓	Product or service name
code	string	✓	✓	Product code/SKU
unitOfMeasure	string	✓	✓	Unit of measure (e.g., "buc", "kg", "ora", "m")
defaultPrice	decimal	✓	✓	Default unit price
currency	string	✓	✓	3-letter currency code (e.g., "RON", "EUR")
vatRate	decimal	✓	✓	VAT rate percentage (e.g., 19.00, 9.00, 5.00)
isService	boolean	✓	✓	True if service, false if physical product
isActive	boolean	✓	✓	Whether the product is active and available
color	string \| null	✓	✓	Optional hex colour swatch (e.g. `"#1e40af"`) shown on the POS product grid. When null, mobile clients fall back to a deterministic palette derived from the product UUID.
category	object \| null	✓	✓	Optional ProductCategory reference — `{ id, name, color, sortOrder }`. Used as fallback swatch and grid grouping on the POS.
sgrAmount	string \| null	✓	✓	Romanian SGR (Sistem Garantie-Returnare) deposit per unit, e.g. `"0.50"` for plastic beverage bottles. Null when the product is not SGR-eligible. The deposit is VAT-exempt and appears as a separate auto-managed line on POS receipts.
description	text	✗	✓	Detailed description
vatCategoryCode	string	✗	✓	VAT category code for ANAF (e.g., "S", "Z", "E")
source	string	✗	✓	Source: manual, anaf, import
lastSyncedAt	datetime	✗	✓	Last sync timestamp from ANAF
createdAt	datetime	✓	✓	Timestamp when created
updatedAt	datetime	✓	✓	Timestamp of last update
deletedAt	datetime	✓	✓	Soft delete timestamp (null if not deleted)

Example - Physical Product

{
  "id": "d4e5f6a7-b8c9-0123-def1-234567890123",
  "name": "Laptop Dell XPS 15",
  "code": "DELL-XPS15-2024",
  "unitOfMeasure": "buc",
  "defaultPrice": 5500.00,
  "currency": "RON",
  "vatRate": 19.00,
  "isService": false,
  "isActive": true,
  "description": "Laptop Dell XPS 15, Intel i7, 16GB RAM, 512GB SSD",
  "vatCategoryCode": "S",
  "source": "manual",
  "lastSyncedAt": null,
  "createdAt": "2024-01-10T09:00:00+02:00",
  "updatedAt": "2024-02-05T11:30:00+02:00",
  "deletedAt": null
}

Example - Service

{
  "id": "e5f6a7b8-c9d0-1234-ef12-345678901234",
  "name": "Web Development",
  "code": "SRV-WEBDEV",
  "unitOfMeasure": "ora",
  "defaultPrice": 150.00,
  "currency": "RON",
  "vatRate": 19.00,
  "isService": true,
  "isActive": true,
  "description": "Custom web development services - hourly rate",
  "vatCategoryCode": "S",
  "source": "manual",
  "lastSyncedAt": null,
  "createdAt": "2024-01-05T10:00:00+02:00",
  "updatedAt": "2024-01-05T10:00:00+02:00",
  "deletedAt": null
}

Common Units of Measure (Romania)

buc - bucată (piece)
kg - kilogram
g - gram
l - liter
m - meter
m2 - square meter
m3 - cubic meter
ora - hour (oră)
zi - day (zi)
luna - month (lună)
set - set
pachet - package (pachet)

Notes

isService: Affects how the product is treated in invoices (services vs goods)
isActive: Inactive products don't appear in product selection dropdowns
defaultPrice: Used as starting price when adding to invoice lines
vatRate: Default VAT rate, can be overridden on individual invoice lines
source: manual (user-created), anaf (synced from e-Factura), import (bulk import)
Products synced from ANAF have lastSyncedAt timestamp
Soft-deleted products have deletedAt set but remain in database

POS fields

color, category, and sgrAmount are POS-specific and have no effect on regular invoice flows.

color: 6-digit hex swatch (with # prefix). Drives the tile colour on the mobile POS product grid.
category: Optional FK to ProductCategory. Drives the category quick-filter chips above the POS grid; when color is null, the category colour is used as the swatch fallback.
sgrAmount: Romanian SGR deposit (Sistem Garantie-Returnare). Decimal stored as string (e.g. "0.50"). When non-null, the POS auto-appends a separate VAT-exempt line for the deposit on each sale. Cancelling or refunding the parent line cancels/refunds the deposit line in lockstep.