expenses

Update /expenses/{uuid}

Update an expense by UUID (PATCH). Only sent fields are updated. Sending assignees replaces the full assignee list. Returns record with the detail projection.

PATCH

/expenses/{uuid}

curl --request PATCH \
  --url https://default.hannacrm.app/api/v4/expenses/{uuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "add_to_project_budget_expenses": "<string>",
  "additional_info": "<string>",
  "amount": "<string>",
  "assignees": [
    "<string>"
  ],
  "billable": "<string>",
  "category": "<string>",
  "client": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "currency": "<string>",
  "custom_fields": [
    {
      "slug": "<string>",
      "value": "<any>"
    }
  ],
  "date": "<string>",
  "duedate": "<string>",
  "estimates": [
    "<string>"
  ],
  "invoices": [
    "<string>"
  ],
  "items": [
    {
      "code": "<string>",
      "description": "<string>",
      "item": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "item_code": "<string>",
      "long_description": "<string>",
      "product_discount": 123,
      "qty": 123,
      "rate": 123,
      "unit": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "vat_percent": 123,
      "warehouse": "<string>"
    }
  ],
  "name": "<string>",
  "note": "<string>",
  "object": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "payment_mode": "<string>",
  "payment_status": 123,
  "project": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reference_no": "<string>",
  "send_invoice_to_customer": "<string>",
  "status": 123,
  "supplier": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "supplier_account_no": "<string>",
  "tax": "<string>",
  "tax2": "<string>"
}
'

{
  "record": {
    "add_to_project_budget_expenses": "<string>",
    "additional_info": "<string>",
    "adjustment": "<string>",
    "amount": "<string>",
    "amount_def_curr": "<string>",
    "assignees": [
      {}
    ],
    "billable": "<string>",
    "category": [
      {}
    ],
    "client": [
      {}
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": {
      "name": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "currency": [
      {}
    ],
    "custom_fields": [
      {
        "slug": "<string>",
        "value": "<any>"
      }
    ],
    "date": "<string>",
    "dateadded": "2023-11-07T05:31:56Z",
    "discount_percent": "<string>",
    "discount_total": "<string>",
    "discount_type": "<string>",
    "duedate": "<string>",
    "estimates": [
      {}
    ],
    "exchange_rate": "<string>",
    "invoices": [
      {}
    ],
    "items": [
      {}
    ],
    "name": "<string>",
    "note": "<string>",
    "object": [
      {}
    ],
    "organization": [
      {}
    ],
    "organization_name": "<string>",
    "payment_mode": "<string>",
    "payment_status": "<string>",
    "project": [
      {}
    ],
    "reference_no": "<string>",
    "send_invoice_to_customer": "<string>",
    "status": "<string>",
    "subtotal": "<string>",
    "supplier": [
      {}
    ],
    "supplier_account_no": "<string>",
    "tax": [
      {}
    ],
    "tax2": [
      {}
    ],
    "total": "<string>",
    "total_tax": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "updated_by": {
      "name": "<string>",

Autorizacijos

Authorizationstringheaderprivaloma

API key (Bearer token) created in Setup → API & MCP.

Turinys

add_to_project_budget_expensesstring

Add expense to project budget.

additional_infostring

Additional information.

amountstring

Expense amount (excl. VAT when using header tax).

assigneesstring[]

Responsible person staff UUIDs. On update, replaces the full assignee list when sent.

billablestring

Whether the expense is billable.

categorystring

Expense category code_name.

clientstring

Customer client UUID.

currencystring

Currency name (e.g. EUR). Uses tenant default when omitted on create.

custom_fieldsobject[]

Custom field values by slug.

Rodyti: child attributes

datestring

Expense date (Y-m-d). Defaults to today when omitted.

duedatestring

Due date (Y-m-d).

estimatesstring[]

Related pre-invoice (estimate) UUIDs.

invoicesstring[]

Related invoice UUIDs.

itemsobject[]

Expense line items to create or update. Include uuid to update an existing row.

Rodyti: child attributes

namestring

Expense title.

notestring

Expense description / note.

objectstring

Related object UUID.

organizationstring

Organization UUID.

payment_modestring

Payment mode ID from tenant payment modes.

payment_statusinteger

Payment status code (1=unpaid, 2=paid).

projectstring

Related project UUID.

reference_nostring

Reference number.

send_invoice_to_customerstring

Send invoice to customer flag.

statusinteger

Expense status code (1=default, 2=waiting approval, 3=approved, 4=cancelled, 5=incurred, 6=advance paid).

supplierstring

Supplier client UUID.

supplier_account_nostring

Supplier bank account number.

taxstring

Primary VAT rate percent (e.g. 21), or an object with rate or id.

tax2string

Secondary VAT rate percent, or an object with rate or id.

Fields enabled for this documentation instance (projection enabled: feature, option, subdomain, closures) plus account-level form field visibility. Role- and user-level field overrides are not applied here, so an API key whose staff user has such overrides may receive fewer fields. A disabled field is omitted from the response object entirely; a present key with a null value means the record simply has no value.

Rodyti: child attributes

Vis dar reikia pagalbos? Klausti komandos

Update /expenses/{uuid}

Autorizacijos

Kelio parametrai

Turinys

Atsakymas