Contazen API Documentation

curl https://api.contazen.ro/v1/settings \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "object": "settings",
    "firm": {
      "name": "Exemplu Company",
      "legal_name": "Exemplu Company SRL",
      "trade_name": "Exemplu Company",
      "cui": "RO12345678",
      "rc": "J40/1234/2020",
      "address": "Str. Exemplu nr. 123",
      "city": "București, Sector 1",
      "county": "București",
      "country": "RO",
      "postal_code": "010101",
      "phone": "+40721234567",
      "email": "contact@exemplu.ro",
      "website": "https://www.exemplu.ro",
      "contact_person": "Ion Popescu",
      "contact_email": "ion.popescu@exemplu.ro"
    },
    "invoice_series": [
      {
        "id": "yMzhgkh",
        "name": "CTZ",
        "document_type": "fiscal",
        "format": "CTZ-{year}-{number}",
        "next_number": 145,
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "xKwpf9j",
        "name": "PRO",
        "document_type": "proforma",
        "format": "PRO-{year}-{number}",
        "next_number": 23,
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "zNmq8kl",
        "name": "TEST",
        "document_type": "fiscal",
        "format": "TEST-{year}-{number}",
        "next_number": 1,
        "is_primary": false,
        "is_active": true
      }
    ],
    "primary_series": {
      "fiscal": {
        "id": "yMzhgkh",
        "name": "CTZ",
        "document_type": "fiscal",
        "format": "CTZ-{year}-{number}",
        "next_number": 145,
        "is_primary": true,
        "is_active": true
      },
      "proforma": {
        "id": "xKwpf9j",
        "name": "PRO",
        "document_type": "proforma",
        "format": "PRO-{year}-{number}",
        "next_number": 23,
        "is_primary": true,
        "is_active": true
      }
    },
    "efactura": {
      "enabled": true,
      "oauth_configured": true,
      "test_mode_available": true,
      "live_mode_available": true,
      "oauth_created_at": "2024-01-15 10:30:00",
      "oauth_expires_at": "2024-01-15 11:30:00",
      "settings": {
        "environment": "live",
        "auto_send": true,
        "auto_send_timing": "immediate",
        "send_to_public_institutions": false
      }
    },
    "bank_accounts": [
      {
        "id": "bnk_1a2b3c",
        "bank_name": "Banca Transilvania",
        "iban": "RO49BTRL1234567890123456",
        "currency": "RON",
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "bnk_4d5e6f",
        "bank_name": "Revolut",
        "iban": "RO98REVO9876543210987654",
        "currency": "EUR",
        "is_primary": false,
        "is_active": true
      }
    ],
    "subscription": {
      "plan": "Professional",
      "status": "active",
      "expires_at": "2024-12-31",
      "invoices_limit": 500,
      "invoices_used": 127
    }
  },
  "meta": {
    "version": "v1",
    "response_time": "45.67ms"
  }
}

GET

settings

curl https://api.contazen.ro/v1/settings \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "object": "settings",
    "firm": {
      "name": "Exemplu Company",
      "legal_name": "Exemplu Company SRL",
      "trade_name": "Exemplu Company",
      "cui": "RO12345678",
      "rc": "J40/1234/2020",
      "address": "Str. Exemplu nr. 123",
      "city": "București, Sector 1",
      "county": "București",
      "country": "RO",
      "postal_code": "010101",
      "phone": "+40721234567",
      "email": "contact@exemplu.ro",
      "website": "https://www.exemplu.ro",
      "contact_person": "Ion Popescu",
      "contact_email": "ion.popescu@exemplu.ro"
    },
    "invoice_series": [
      {
        "id": "yMzhgkh",
        "name": "CTZ",
        "document_type": "fiscal",
        "format": "CTZ-{year}-{number}",
        "next_number": 145,
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "xKwpf9j",
        "name": "PRO",
        "document_type": "proforma",
        "format": "PRO-{year}-{number}",
        "next_number": 23,
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "zNmq8kl",
        "name": "TEST",
        "document_type": "fiscal",
        "format": "TEST-{year}-{number}",
        "next_number": 1,
        "is_primary": false,
        "is_active": true
      }
    ],
    "primary_series": {
      "fiscal": {
        "id": "yMzhgkh",
        "name": "CTZ",
        "document_type": "fiscal",
        "format": "CTZ-{year}-{number}",
        "next_number": 145,
        "is_primary": true,
        "is_active": true
      },
      "proforma": {
        "id": "xKwpf9j",
        "name": "PRO",
        "document_type": "proforma",
        "format": "PRO-{year}-{number}",
        "next_number": 23,
        "is_primary": true,
        "is_active": true
      }
    },
    "efactura": {
      "enabled": true,
      "oauth_configured": true,
      "test_mode_available": true,
      "live_mode_available": true,
      "oauth_created_at": "2024-01-15 10:30:00",
      "oauth_expires_at": "2024-01-15 11:30:00",
      "settings": {
        "environment": "live",
        "auto_send": true,
        "auto_send_timing": "immediate",
        "send_to_public_institutions": false
      }
    },
    "bank_accounts": [
      {
        "id": "bnk_1a2b3c",
        "bank_name": "Banca Transilvania",
        "iban": "RO49BTRL1234567890123456",
        "currency": "RON",
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "bnk_4d5e6f",
        "bank_name": "Revolut",
        "iban": "RO98REVO9876543210987654",
        "currency": "EUR",
        "is_primary": false,
        "is_active": true
      }
    ],
    "subscription": {
      "plan": "Professional",
      "status": "active",
      "expires_at": "2024-12-31",
      "invoices_limit": 500,
      "invoices_used": 127
    }
  },
  "meta": {
    "version": "v1",
    "response_time": "45.67ms"
  }
}

Overview

Returns all configuration and settings for the authenticated firm including company details, invoice series, e-Factura status, bank accounts, available currencies, and subscription information. This is a read-only endpoint that provides a complete view of your account configuration.

Response

success

boolean

Indicates if the request was successful

data

object

Show Properties

object

string

Always settings

firm

object

Company details and contact information

Show Firm Properties

name

string

Display name (trading name if exists, otherwise legal name)

legal_name

string

Official registered company name (from company registration)

trade_name

string

Work point/branch name (optional, can be null)

cui

string

Tax identification number (CUI/CIF)

string

Company registration number

address

string

Company address

city

string

City

county

string

County or state

country

string

Country code (ISO 3166-1 alpha-2)

postal_code

string

Postal or ZIP code

phone

string

Contact phone number

string

Contact email address

website

string

Company website URL

contact_person

string

Primary contact person name

contact_email

string

Primary contact email

invoice_series

array

List of all configured invoice series

Show Series Object

string

Series ID (use this for series_id parameter)

name

string

Series name/prefix

document_type

string

Document type: fiscal or proforma

format

string

Number format pattern

next_number

integer

Next available number in series

is_primary

boolean

Whether this is the primary series for its document type

is_active

boolean

Whether the series is active

primary_series

object

Primary series for each document type (for quick access)

Show Primary Series

fiscal

object

Primary fiscal invoice series (same structure as Series Object above)

proforma

object

Primary proforma invoice series (same structure as Series Object above)

efactura

object

E-Factura configuration and OAuth status

Show E-Factura Properties

enabled

boolean

Whether e-Factura is enabled for the account

oauth_configured

boolean

Whether OAuth is properly configured

test_mode_available

boolean

Whether test environment credentials are configured

live_mode_available

boolean

Whether production environment credentials are configured

oauth_created_at

string

OAuth token creation date

oauth_expires_at

string

OAuth access token expiration date

settings

object

E-Factura specific settings

Show Settings Properties

environment

string

Default environment: test or live

auto_send

boolean

Whether invoices are automatically sent to ANAF

auto_send_timing

string

Timing for automatic sending: immediate or delayed

send_to_public_institutions

boolean

Whether to send invoices to public institutions automatically

bank_accounts

array

List of configured bank accounts

Show Bank Account Object

string

Account ID

bank_name

string

Bank name

iban

string

IBAN account number

currency

string

Account currency code

is_primary

boolean

Whether this is the primary account

is_active

boolean

Whether the account is active

subscription

object

Current subscription information

Show Subscription Properties

plan

string

Current plan name

status

string

Subscription status: active or inactive

expires_at

string

Subscription expiration date

invoices_limit

integer

Monthly invoice limit (null if unlimited)

invoices_used

integer

Invoices used this period

meta

object

Response metadata including version and response time

curl https://api.contazen.ro/v1/settings \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "object": "settings",
    "firm": {
      "name": "Exemplu Company",
      "legal_name": "Exemplu Company SRL",
      "trade_name": "Exemplu Company",
      "cui": "RO12345678",
      "rc": "J40/1234/2020",
      "address": "Str. Exemplu nr. 123",
      "city": "București, Sector 1",
      "county": "București",
      "country": "RO",
      "postal_code": "010101",
      "phone": "+40721234567",
      "email": "contact@exemplu.ro",
      "website": "https://www.exemplu.ro",
      "contact_person": "Ion Popescu",
      "contact_email": "ion.popescu@exemplu.ro"
    },
    "invoice_series": [
      {
        "id": "yMzhgkh",
        "name": "CTZ",
        "document_type": "fiscal",
        "format": "CTZ-{year}-{number}",
        "next_number": 145,
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "xKwpf9j",
        "name": "PRO",
        "document_type": "proforma",
        "format": "PRO-{year}-{number}",
        "next_number": 23,
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "zNmq8kl",
        "name": "TEST",
        "document_type": "fiscal",
        "format": "TEST-{year}-{number}",
        "next_number": 1,
        "is_primary": false,
        "is_active": true
      }
    ],
    "primary_series": {
      "fiscal": {
        "id": "yMzhgkh",
        "name": "CTZ",
        "document_type": "fiscal",
        "format": "CTZ-{year}-{number}",
        "next_number": 145,
        "is_primary": true,
        "is_active": true
      },
      "proforma": {
        "id": "xKwpf9j",
        "name": "PRO",
        "document_type": "proforma",
        "format": "PRO-{year}-{number}",
        "next_number": 23,
        "is_primary": true,
        "is_active": true
      }
    },
    "efactura": {
      "enabled": true,
      "oauth_configured": true,
      "test_mode_available": true,
      "live_mode_available": true,
      "oauth_created_at": "2024-01-15 10:30:00",
      "oauth_expires_at": "2024-01-15 11:30:00",
      "settings": {
        "environment": "live",
        "auto_send": true,
        "auto_send_timing": "immediate",
        "send_to_public_institutions": false
      }
    },
    "bank_accounts": [
      {
        "id": "bnk_1a2b3c",
        "bank_name": "Banca Transilvania",
        "iban": "RO49BTRL1234567890123456",
        "currency": "RON",
        "is_primary": true,
        "is_active": true
      },
      {
        "id": "bnk_4d5e6f",
        "bank_name": "Revolut",
        "iban": "RO98REVO9876543210987654",
        "currency": "EUR",
        "is_primary": false,
        "is_active": true
      }
    ],
    "subscription": {
      "plan": "Professional",
      "status": "active",
      "expires_at": "2024-12-31",
      "invoices_limit": 500,
      "invoices_used": 127
    }
  },
  "meta": {
    "version": "v1",
    "response_time": "45.67ms"
  }
}

Use Cases

Setting Up Your Integration

Use this endpoint to:

Retrieve available invoice series for creating invoices
Check e-Factura OAuth configuration status
Get list of bank accounts for payment instructions
Verify subscription limits before creating invoices
Discover available currencies for multi-currency invoices

Example: Check E-Factura Status

const response = await fetch('https://api.contazen.ro/v1/settings', {
  headers: { 'Authorization': 'Bearer sk_live_YOUR_API_KEY' }
});

const data = await response.json();

if (data.data.efactura.oauth_configured) {
  console.log('E-Factura is configured and ready');
  console.log('Available environments:', {
    test: data.data.efactura.test_mode_available,
    live: data.data.efactura.live_mode_available
  });
} else {
  console.log('E-Factura OAuth needs configuration');
}

Example: Get Primary Invoice Series

const settings = await getSettings(); // Your API call

const primaryFiscalSeries = settings.data.invoice_series.find(
  series => series.document_type === 'fiscal' && series.is_primary
);

console.log('Use this series_id for fiscal invoices:', primaryFiscalSeries.id);

This endpoint is read-only. To modify settings, use the Contazen web interface at https://app.contazen.ro

Delete Product

API Reference

Get Account Settings

Overview

Response

Use Cases

Setting Up Your Integration

Example: Check E-Factura Status

Example: Get Primary Invoice Series

API Reference

​Overview

​Response

​Use Cases

​Setting Up Your Integration

​Example: Check E-Factura Status

​Example: Get Primary Invoice Series

Overview

Response

Use Cases

Setting Up Your Integration

Example: Check E-Factura Status

Example: Get Primary Invoice Series