​
Quick Start with Postman

Get started with the Contazen API in seconds using our pre-configured Postman collection.

Download Postman Collection

Complete collection with all API endpoints and examples

​
What’s Included

Our Postman collection includes:
  • ✅ All API endpoints - Clients, Invoices, Products, and Settings
  • ✅ Pre-configured examples - Ready-to-use request bodies
  • ✅ Environment variables - Easy configuration for your API key
  • ✅ Request descriptions - Inline documentation for each endpoint
  • ✅ Test examples - Sample test scripts for common scenarios

​
Import Instructions

1

Download Postman

If you haven’t already, download Postman for your platform.
2

Download Collection

Click the download button above to get the latest collection file.
3

Import in Postman

  1. Open Postman
  2. Click Import in the top left
  3. Select the downloaded Contazen_API.postman_collection.json file
  4. Click Import
4

Configure Environment

Create a new environment with these variables:
VariableValue
base_urlhttps://api.contazen.ro/v1
api_keysk_live_YOUR_API_KEY
Replace YOUR_API_KEY with your actual API key from Settings.
5

Make Your First Request

  1. Select the Contazen API environment
  2. Navigate to Clients → List Clients
  3. Click Send

​
Collection Structure

Contazen API v1.0
├── 🔐 Authentication
│   └── Test Authentication
├── 👥 Clients
│   ├── List Clients
│   ├── Create Client
│   ├── Retrieve Client
│   ├── Update Client
│   └── Delete Client
├── 📄 Invoices
│   ├── List Invoices
│   ├── Create Invoice
│   ├── Retrieve Invoice
│   ├── Send Invoice
│   ├── Send to SPV
│   ├── Mark Invoice Paid
│   ├── Download Invoice PDF
│   ├── Void Invoice
│   ├── Unvoid Invoice
│   └── Delete Invoice
├── 📦 Products
│   ├── List Products
│   ├── Create Product
│   ├── Retrieve Product
│   ├── Update Product
│   └── Delete Product
└── ⚙️ Settings
    └── Get Settings

​
Environment Variables

Our collection uses environment variables for easy configuration: 
// Base URL
{{base_url}} → https://api.contazen.ro/v1

// Authentication
{{api_key}} → Your API key

// Optional test data
{{test_client_id}} → ID of a test client
{{test_invoice_id}} → ID of a test invoice
{{test_product_id}} → ID of a test product

​
Invoice Endpoints Explained

​
Core Invoice Operations

  • List Invoices - Retrieve all invoices with filtering and pagination
  • Create Invoice - Create new invoices with multiple examples for different scenarios
  • Retrieve Invoice - Get detailed information about a specific invoice

​
Email & Delivery

  • Send Invoice - Send invoice by email to the client
  • Download Invoice PDF - Get the invoice as a PDF file or URL

​
e-Factura Operations

  • Send to SPV - Submit invoice to SPV test environment for e-Factura testing

​
Payment Management

  • Mark Invoice Paid - Record full or partial payments on invoices

​
Invoice Status Management

  • Void Invoice - Cancel an invoice following Romanian accounting rules
  • Unvoid Invoice - Restore a previously voided invoice
  • Delete Invoice - Permanently remove draft or voided invoices

​
Example Requests

​
Create Invoice with Items

{
  "client_id": "{{test_client_id}}",
  "items": [
    {
      "description": "Web Development Services",
      "quantity": 10,
      "price": 100,
      "vat_rate": 19
    }
  ],
  "due_days": 30
}

​
Create B2B Client

{
  "name": "Acme Corp SRL",
  "cui": "RO12345678",
  "email": "contact@acmecorp.ro",
  "address": "Str. Exemplu nr. 123",
  "city": "București, Sectorul 1",
  "county": "București"
}

​
Testing Features

The collection includes pre-request scripts and tests:

​
Pre-request Scripts

  • Automatic timestamp generation
  • Dynamic data creation
  • Environment variable validation

​
Test Examples

// Verify successful response
pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
});

// Save response data
pm.test("Save client ID", function () {
    var jsonData = pm.response.json();
    pm.environment.set("test_client_id", jsonData.data.id);
});

​
Tips for Testing

Create a dedicated TEST series to keep test invoices separate from production data. See our Testing Guide for details.
When testing, use "is_draft": true to create draft invoices that can be easily deleted.
Use the correct VAT rates: 19% (standard), 9% (reduced), 5% (reduced), or 0% (exempt).
The API allows 100 requests per minute. The collection includes retry logic for rate-limited requests.

​
Troubleshooting

401 Unauthorized: Check that your API key is correctly set in the environment variables and includes the Bearer prefix in the Authorization header.
SSL Certificate Errors: If you encounter SSL errors during local testing, you can temporarily disable SSL verification in Postman settings (not recommended for production).

​
Updates

We regularly update our Postman collection with new endpoints and improvements. Check back periodically for the latest version. Current version: v1.0 (Last updated: August 2025)

​
Need Help?