Skip to main content
POST
/
receipts
Create a receipt
curl --request POST \
  --url https://api.contazen.ro/v1/receipts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": "<string>",
  "amount": 123,
  "invoice_id": "<string>",
  "currency": "RON",
  "payment_date": "<string>",
  "observations": "<string>",
  "type": "receipt",
  "language": "ro",
  "number_id": "<string>",
  "exchange_rate": 123
}
'
{
  "success": true,
  "data": {
    "id": "<string>",
    "object": "receipt",
    "receipt_number": "<string>",
    "amount": 123,
    "amount_without_vat": 123,
    "amount_vat": 123,
    "currency": "<string>",
    "date": "2023-12-25",
    "observations": "<string>",
    "language": "<string>",
    "is_draft": true,
    "is_deleted": true,
    "exchange_rate": 123,
    "exchange_currency": "<string>",
    "type": "receipt",
    "client": {
      "id": "<string>",
      "name": "<string>"
    },
    "invoice": {
      "id": "<string>",
      "number": "<string>",
      "total": 123,
      "currency": "<string>",
      "is_paid": true
    },
    "payment": {
      "id": "<string>",
      "object": "payment",
      "amount": 123,
      "amount_without_vat": 123,
      "amount_vat": 123,
      "currency": "<string>",
      "date": "2023-12-25",
      "type": "receipt",
      "type_description": "<string>",
      "exchange_rate": 123,
      "exchange_currency": "<string>",
      "invoice": {
        "id": "<string>",
        "number": "<string>"
      },
      "client": {
        "id": "<string>",
        "name": "<string>"
      },
      "created_at": 123
    },
    "created_at": 123,
    "updated_at": 123
  },
  "meta": {
    "version": "v1",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "response_time": "23.45ms"
  }
}

Authorizations

​
Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Body

application/json

Create a chitanță. When invoice_id is supplied, a linked FirmBillPayment row is created and the invoice's paid state is recomputed. Standalone chitanțe (no invoice) default to type receipt (numerar).

​
client_id
string
required

Client CzUid (also accepts clientId)

​
amount
number
required

Total amount

​
invoice_id
string

Optional invoice CzUid to pair this chitanță with

​
currency
string
default:RON
​
payment_date
string

Date in YYYY-MM-DD or DD-MM-YYYY (defaults to today)

​
observations
string

Free-text note. Falls back to "Încasare factură {nr}" or "Încasare" when omitted.

​
type
enum<string>
default:receipt

Payment method (alias-tolerant). Only used when invoice_id is set.

Available options:
receipt,
numerar,
cash,
bank_order,
transfer,
op,
card,
fiscal_receipt,
bon_fiscal,
other
​
language
string
default:ro
​
number_id
string

Chitanță series CzUid. Defaults to firm's primary chitanță series.

​
exchange_rate
number

Required when currency differs from firm accounting currency.

Response

Receipt created

​
success
boolean
​
data
object

A chitanță (cash receipt) document.

​
meta
object