POST
/
products
curl -X POST https://api.contazen.ro/v1/products \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Web Development Services",
    "price": 250.00,
    "vat_rate": 19,
    "unit_of_measure": "ora",
    "description": "Professional web development services",
    "ubl_um": "HUR",
    "ubl_cpv": "72413000"
  }'
{
  "success": true,
  "data": {
    "id": "prod_7x8y9z0a1b",
    "object": "product",
    "name": "Web Development Services",
    "description": "Professional web development services",
    "currency": "RON",
    "price": 250.00,
    "vat_rate": 19,
    "unit_of_measure": "ora",
    "ubl_um": "HUR",
    "ubl_nc": null,
    "ubl_cpv": "72413000",
    "created_at": 1710460800,
    "modified_at": null
  },
  "meta": {
    "version": "v1",
    "response_time": "45.67ms"
  }
}

Request

name
string
required
Product name
price
number
required
Selling price (without VAT). Either price or sell_price must be provided.
sell_price
number
Alias for price. Either price or sell_price must be provided.
description
string
Product description
currency
string
default:"RON"
Currency code (e.g., “RON”, “EUR”, “USD”)
vat_rate
number
default:"21"
VAT rate percentage. Available rates: 21% (default), 19%, 11%, 9%, 5%, 0%
unit_of_measure
string
default:"buc"
Unit of measure (e.g., “buc”, “kg”, “ora”, “luna”, “m2”)
ubl_um
string
default:"H87"
UBL unit of measure code for e-Factura compliance
ubl_nc
string
Combined Nomenclature (NC) code for e-Factura
ubl_cpv
string
Common Procurement Vocabulary (CPV) code for e-Factura
For e-Factura compliance, ensure you provide the correct UBL codes:
  • ubl_um: Unit measure code (e.g., “H87” for piece, “KGM” for kilogram)
  • ubl_nc: 8-digit Combined Nomenclature code for goods
  • ubl_cpv: 8-digit CPV code for services

Response

success
boolean
Indicates if the request was successful
data
object
The created product object
meta
object
Response metadata including version and response time
curl -X POST https://api.contazen.ro/v1/products \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Web Development Services",
    "price": 250.00,
    "vat_rate": 19,
    "unit_of_measure": "ora",
    "description": "Professional web development services",
    "ubl_um": "HUR",
    "ubl_cpv": "72413000"
  }'
{
  "success": true,
  "data": {
    "id": "prod_7x8y9z0a1b",
    "object": "product",
    "name": "Web Development Services",
    "description": "Professional web development services",
    "currency": "RON",
    "price": 250.00,
    "vat_rate": 19,
    "unit_of_measure": "ora",
    "ubl_um": "HUR",
    "ubl_nc": null,
    "ubl_cpv": "72413000",
    "created_at": 1710460800,
    "modified_at": null
  },
  "meta": {
    "version": "v1",
    "response_time": "45.67ms"
  }
}

Common Unit Codes

Romanian Units (UBL codes for e-Factura)

UnitUBL CodeDescription
bucH87Bucată (piece)
kgKGMKilogram
oraHUROră (hour)
lunaMONLună (month)
mMTRMetru (meter)
m2MTKMetru pătrat (square meter)
m3MTQMetru cub (cubic meter)
lLTRLitru (liter)
kmKMTKilometru (kilometer)
ziDAYZi (day)

Product Types Examples

Physical Product

{
  "name": "Laptop Dell XPS 15",
  "price": 5000.00,
  "vat_rate": 19,
  "unit_of_measure": "buc",
  "ubl_um": "H87",
  "ubl_nc": "84713000"
}

Service

{
  "name": "Consultancy Services",
  "price": 500.00,
  "vat_rate": 21,
  "unit_of_measure": "ora",
  "ubl_um": "HUR",
  "ubl_cpv": "79411000"
}

Service with Reduced VAT (11%)

{
  "name": "Restaurant Services",
  "price": 100.00,
  "vat_rate": 11,
  "unit_of_measure": "buc",
  "ubl_um": "H87",
  "ubl_cpv": "55300000",
  "description": "Food service - reduced VAT rate 11%"
}

Digital Product

{
  "name": "Software License",
  "price": 1200.00,
  "vat_rate": 19,
  "unit_of_measure": "buc",
  "ubl_um": "H87",
  "ubl_cpv": "48000000"
}