Update expense information for a transaction

PATCH 
/api/transactions/:id/expense

This endpoint updates expense information for an existing transaction.

Prerequisites:

To use this endpoint you need to have the ACCOUNTING scope for the API Key. Please contact your relation manager to get this permission.

Eligibility: The transaction type must be enabled in the business partner expense settings targets.

Request Body:

• category: Expense category ID.
• costCenter: Expense cost center ID.
• vats: Array of 1-3 VAT rows containing expenseVat, rate, amount, grossAmount, externalId.
• vatRate/vatAmount: Deprecated legacy format, still accepted for backward compatibility.
• note: Optional comment.

Completion update: Expense completion is recalculated during the request, and the response contains the latest expenseCompletedAt value.

Validation Errors: Responses return status 422 with an errors array containing field, code, and message. Possible code values include:

• transaction.type.not_supported
• input.category.not_valid
• input.cost_center.not_valid
• input.vat_rate.not_valid
• input.vat_amount.not_valid
• input.comment.not_valid
• expense.vat.not_valid
• expense.category.transaction_type_not_allowed
• expense.cost_center.transaction_type_not_allowed
• expense.category.card_group_not_allowed
• expense.cost_center.card_group_not_allowed
• invalid

Request

Path Parameters

id stringrequired

Transaction identifier

application/json

Body

required

category integernullable
costCenter integernullable
vatRate string[]nullable
vatAmount string[]nullable
vats object[]
Array [
expenseVat integernullable
rate string
amount stringnullable
grossAmount string
externalId stringnullable
]
note stringnullable

Responses

200

OK - The request was processed successfully.

application/json

Schema

Schema

id integer
currency string
amount string
type string

Possible values: [fee, payin, payout, peer, fx, card]

executionDate string
executed boolean
createdAt string
updatedAt string
account integer
transactionDetailId integernullable
tags string[]
documents object
id integer
name string
mimeType string
expenseCategory object
id integer
name string
accountingAccountNumber string
externalId string
expenseCostCenter object
id integer
name string
number string
vat string[]deprecated
vats object[]
Array [
expenseVat integernullable
rate string
amount string
grossAmount string
externalId stringnullable
]
comment stringnullable
expenseCompletedAt stringnullable
magicLinkUrl stringnullable
contact object
id integer

Example (from schema)

{
  "id": "1",
  "currency": "CHF",
  "amount": "100.00",
  "type": "payin",
  "executionDate": "2023-01-01T00:00:00+00:00",
  "executed": true,
  "createdAt": "2023-01-01T00:00:00+00:00",
  "updatedAt": "2023-01-01T00:00:00+00:00",
  "account": 1,
  "transactionDetailId": 1,
  "tags": [
    "tag1",
    "tag2"
  ],
  "documents": {
    "id": "1",
    "name": "example_document.jpg",
    "mimeType": "image/jpeg"
  },
  "expenseCategory": {
    "id": "1",
    "name": "Travel expense",
    "accountingAccountNumber": "123456",
    "externalId": "abcefg"
  },
  "expenseCostCenter": {
    "id": "1",
    "name": "Travel expense",
    "number": "123456"
  },
  "vats": [
    {
      "expenseVat": 1,
      "rate": "5",
      "amount": "20",
      "grossAmount": "120",
      "externalId": "vat-5"
    }
  ],
  "comment": "string",
  "expenseCompletedAt": "2023-01-01T00:00:00+00:00",
  "magicLinkUrl": "https://app.amnis.com/expenses-public/4cb001f8-2b57-4b4a-8d2c-7d1a2f3b4c5d",
  "contact": {
    "id": "1"
  }
}

400

Bad Request -- Your request is invalid.

application/json

Schema

Schema

title stringnullable

A short, human-readable summary of the problem.

detail stringnullable

A human-readable explanation specific to this occurrence of the problem.

status numbernullable

Default value: 400

instance stringnullable

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

type string

A URI reference that identifies the problem type

Example (from schema)

{
  "title": "string",
  "detail": "string",
  "status": 400,
  "instance": "string",
  "type": "string"
}

401

Unauthorised -- Your access token is wrong.

application/json

Schema

Schema

type string
title string
detail string

Example (from schema)

{
  "type": "string",
  "title": "string",
  "detail": "string"
}

403

Forbidden -- Access to the requested resource or action is forbidden.

application/json

Schema

Schema

title stringnullable

A short, human-readable summary of the problem.

detail stringnullable

A human-readable explanation specific to this occurrence of the problem.

status numbernullable

Default value: 400

instance stringnullable

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

type string

A URI reference that identifies the problem type

Example (from schema)

{
  "title": "string",
  "detail": "string",
  "status": 400,
  "instance": "string",
  "type": "string"
}

404

Not Found -- The requested resource could not be found.

application/json

Schema

Schema

title stringnullable

A short, human-readable summary of the problem.

detail stringnullable

A human-readable explanation specific to this occurrence of the problem.

status numbernullable

Default value: 400

instance stringnullable

A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

type string

A URI reference that identifies the problem type

Example (from schema)

{
  "title": "string",
  "detail": "string",
  "status": 400,
  "instance": "string",
  "type": "string"
}

422

Unprocessable Content -- We could not process your request due to invalid data provided.

application/json

Schema

Schema

status integer
message string
errors object[]
Array [
field string
code string
message string
]

Example (from schema)

{
  "status": 422,
  "message": "Validation failed",
  "errors": [
    {
      "field": "category",
      "code": "input.category.not_valid",
      "message": "Category is not valid."
    }
  ]
}

Example

{
  "status": 422,
  "message": "Validation failed",
  "errors": [
    {
      "field": "category",
      "code": "input.category.not_valid",
      "message": "Category is not valid."
    },
    {
      "field": "vatRate",
      "code": "input.vat_rate.not_valid",
      "message": "VAT rate must be an array of 1-3 numeric values."
    }
  ]
}

Loading...