Postman Collection

​

Quick Start with Postman

​

What’s Included

• ✅ 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

​

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

// 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

​

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

​

Troubleshooting

​

Updates

​

Need Help?

• Check our API Reference for detailed endpoint documentation
• Review common errors and their solutions
• Contact support@contazen.ro for assistance