Skip to main content
POST
/
supplier-bills
/
{id}
/
mark-paid
Mark supplier bill as paid
curl --request POST \
  --url https://api.contazen.ro/v1/supplier-bills/{id}/mark-paid \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "payment_date": "2023-12-25",
  "payment_amount": 1
}
'
{
  "success": true,
  "data": {
    "supplier_bill": {
      "id": "<string>",
      "object": "supplier_bill",
      "invoice_number": "<string>",
      "invoice_type_code": "380",
      "invoice_type": "invoice",
      "issue_date": "2023-12-25",
      "due_date": "2023-12-25",
      "currency": "RON",
      "amounts": {
        "tax_exclusive": 123,
        "tax": 123,
        "tax_inclusive": 123,
        "paid": 123,
        "unpaid": 123
      },
      "status": "unpaid",
      "payment_date": "2023-12-25",
      "payment_amount": 123,
      "supplier": {
        "id": "<string>",
        "name": "<string>",
        "vat_id": "<string>",
        "reg_com": "<string>",
        "address": "<string>",
        "email": "<string>",
        "phone": "<string>"
      },
      "supplier_id": "<string>",
      "expense_id": "<string>",
      "client_id": "<string>",
      "efactura_message_id": 123,
      "efactura_pdf_url": "<string>",
      "order_reference": "<string>",
      "note": "<string>",
      "created_at": 123,
      "updated_at": 123,
      "expense": {},
      "client": {},
      "efactura_message": {
        "id": 123,
        "message_id": "<string>",
        "cif": "<string>",
        "type": "<string>",
        "creation_date": "2023-11-07T05:31:56Z",
        "environment": "test"
      },
      "lines": [
        {}
      ]
    },
    "message": "<string>"
  },
  "meta": {
    "version": "v1",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "response_time": "23.45ms"
  }
}

​
Overview

Records a payment on the supplier bill. Pass payment_amount lower than the bill total to record a partial payment (status becomes partial). When the amount is omitted, the full tax_inclusive total is used. payment_date defaults to today.

​
Linked expense

If the bill is linked to a FirmExpense, that expense is kept in sync — its is_paid flag and paid_at date are updated to match.

Authorizations

​
Authorization
string
header
required

Use your API key (sk_live_xxx or sk_test_xxx)

Path Parameters

​
id
string
required

Body

application/json
​
payment_date
string<date>

Defaults to today.

​
payment_amount
number<float>

Defaults to the bill's tax_inclusive total. A value lower than the total marks the bill partial; zero marks it unpaid.

Required range: x >= 0

Response

Bill updated

​
success
boolean
​
data
object
​
meta
object