POST
/
invoices
curl -X POST https://api.contazen.ro/v1/invoices \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_data": {
      "type": "b2b",
      "name": "Tech Solutions SRL",
      "cui": "RO12345678",
      "rc": "J40/1234/2023",
      "address": "Bd. Victoriei 100",
      "city": "București, Sector 1",
      "county": "București",
      "postal_code": "010101",
      "email": "finance@techsolutions.ro",
      "phone": "+40721234567"
    },
    "items": [
      {
        "description": "Website Development",
        "quantity": 1,
        "price": 5000,
        "vat_rate": 19,
        "unit": "proiect"
      },
      {
        "description": "Monthly Maintenance",
        "quantity": 12,
        "price": 500,
        "vat_rate": 19,
        "unit": "lună"
      }
    ],
    "document_type": "fiscal",
    "date": "2024-01-15",
    "due_date": "2024-02-14",
    "observations": "Payment via bank transfer to IBAN: RO49AAAA1B31007593840000",
    "efactura_enabled": true,
    "send_email": true
  }'

{
  "success": true,
  "data": {
    "id": "inv_1a2b3c4d5e",
    "object": "invoice",
    "number": "CTZ-2024-00001",
    "series_id": "yMzhgkh",
    "document_type": "fiscal",
    "date": "2024-01-15",
    "due_date": "2024-02-14",
    "client": {
      "id": "9z8y7x6w5v",
      "object": "client",
      "name": "Tech Solutions SRL",
      "cui": "RO12345678",
      "email": "finance@techsolutions.ro"
    },
    "lines": [
      {
        "id": "lin_5f6g7h8i9j",
        "description": "Website Development",
        "quantity": 1,
        "price": 5000.00,
        "vat_rate": 19,
        "unit": "proiect",
        "subtotal": 5000.00,
        "vat_amount": 950.00,
        "total": 5950.00
      },
      {
        "id": "lin_6g7h8i9j0k",
        "description": "Monthly Maintenance",
        "quantity": 12,
        "price": 500.00,
        "vat_rate": 19,
        "unit": "lună",
        "subtotal": 6000.00,
        "vat_amount": 1140.00,
        "total": 7140.00
      }
    ],
    "subtotal": 11000.00,
    "vat_amount": 2090.00,
    "total": 13090.00,
    "currency": "RON",
    "status": "sent",
    "observations": "Payment via bank transfer to IBAN: RO49AAAA1B31007593840000",
    "efactura": {
      "enabled": true,
      "status": "pending",
      "submission_id": null
    },
    "created_at": 1705334400,
    "updated_at": 1705334415
  },
  "meta": {
    "version": "v1",
    "response_time": "127.45ms"
  }
}

​
Request

​
client_id
string
The ID of an existing client. Either client_id or client_data is required.
​
client_data
object
Create a new client inline with the invoice. Either client_id or client_data is required.
​
series_id
string
Invoice series ID. If not specified, the default series for the document type will be used.
​
items
array
required
Array of invoice line items
​
document_type
string
default:"fiscal"
Document type. Options: fiscal, proforma
​
date
string
default:"today"
Invoice date in YYYY-MM-DD format
​
due_date
string
default:"30 days"
Due date in YYYY-MM-DD format
​
currency
string
default:"RON"
Currency code (ISO 4217)
​
observations
string
Additional notes or payment instructions
​
is_draft
boolean
default:"false"
Save as draft without finalizing
​
efactura_enabled
boolean
default:"true"
Enable e-Factura submission to ANAF
​
spv_environment
string
default:"live"
SPV environment: live (production) or test (SPV testing). Determines which OAuth keys to use for e-Factura submission.
E-Factura requires OAuth authentication. Configure it at /firm/index/efactura in your Contazen account. Without OAuth, e-Factura submissions will fail with an oauth_not_configured error.
​
send_email
boolean
default:"false"
Send invoice by email after creation
​
email_address
string
Override recipient email (uses client email by default)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
The created invoice object
​
meta
object
Response metadata
curl -X POST https://api.contazen.ro/v1/invoices \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_data": {
      "type": "b2b",
      "name": "Tech Solutions SRL",
      "cui": "RO12345678",
      "rc": "J40/1234/2023",
      "address": "Bd. Victoriei 100",
      "city": "București, Sector 1",
      "county": "București",
      "postal_code": "010101",
      "email": "finance@techsolutions.ro",
      "phone": "+40721234567"
    },
    "items": [
      {
        "description": "Website Development",
        "quantity": 1,
        "price": 5000,
        "vat_rate": 19,
        "unit": "proiect"
      },
      {
        "description": "Monthly Maintenance",
        "quantity": 12,
        "price": 500,
        "vat_rate": 19,
        "unit": "lună"
      }
    ],
    "document_type": "fiscal",
    "date": "2024-01-15",
    "due_date": "2024-02-14",
    "observations": "Payment via bank transfer to IBAN: RO49AAAA1B31007593840000",
    "efactura_enabled": true,
    "send_email": true
  }'

{
  "success": true,
  "data": {
    "id": "inv_1a2b3c4d5e",
    "object": "invoice",
    "number": "CTZ-2024-00001",
    "series_id": "yMzhgkh",
    "document_type": "fiscal",
    "date": "2024-01-15",
    "due_date": "2024-02-14",
    "client": {
      "id": "9z8y7x6w5v",
      "object": "client",
      "name": "Tech Solutions SRL",
      "cui": "RO12345678",
      "email": "finance@techsolutions.ro"
    },
    "lines": [
      {
        "id": "lin_5f6g7h8i9j",
        "description": "Website Development",
        "quantity": 1,
        "price": 5000.00,
        "vat_rate": 19,
        "unit": "proiect",
        "subtotal": 5000.00,
        "vat_amount": 950.00,
        "total": 5950.00
      },
      {
        "id": "lin_6g7h8i9j0k",
        "description": "Monthly Maintenance",
        "quantity": 12,
        "price": 500.00,
        "vat_rate": 19,
        "unit": "lună",
        "subtotal": 6000.00,
        "vat_amount": 1140.00,
        "total": 7140.00
      }
    ],
    "subtotal": 11000.00,
    "vat_amount": 2090.00,
    "total": 13090.00,
    "currency": "RON",
    "status": "sent",
    "observations": "Payment via bank transfer to IBAN: RO49AAAA1B31007593840000",
    "efactura": {
      "enabled": true,
      "status": "pending",
      "submission_id": null
    },
    "created_at": 1705334400,
    "updated_at": 1705334415
  },
  "meta": {
    "version": "v1",
    "response_time": "127.45ms"
  }
}

​
VAT Rates

​
Available VAT Rates in Romania

RateTypeDescriptionAvailable From
21%StandardDefault rateAugust 1, 2025
19%StandardCurrent standard rateCurrent
11%ReducedFood services, accommodationAugust 1, 2025
9%ReducedMedicines, books, etc.Current
5%ReducedSocial housingCurrent
0%ExemptVarious exemptionsCurrent
The 11% and 21% VAT rates will be available starting August 1, 2025. Until then, use 19% as the standard rate.

​
VAT Key Mapping

VAT keys are automatically determined based on the VAT rate, but can be manually specified:
  • Key 1: 19% Standard
  • Key 2: 9% Reduced
  • Key 3: 5% Reduced
  • Key 4: 0% Exempt
  • Key 5: 0% SFDD
  • Key 6: 0% SDD
  • Key 7: 0% VAT Included
  • Key 8: 0% Reverse Charge (taxare inversă)
  • Key 9: 21% Standard (from August 2025)
  • Key 11: 11% Reduced (from August 2025)