Skip to content
Developer

TravelExpenseType

Accounting3 EndpointsBilling / TravelExpenseType

Returns a list of all TravelExpenseType

GET/api/billing/travel/expense_types

Query parameters

idinteger
typeKeystringInternal type identifier (e.g., KM_PAUSCHALE_PKW, HOTEL)
namestringDisplay name
descriptionstringDescription
categorystringParent expense category
defaultRatestringDefault rate (e.g., km rate 0.30, per diem rate 28.00)
rateUnitstringUnit for the rate (EUR, EUR/km, EUR/Tag, etc.)
isTaxFreeDefaultbooleanIs this type tax-free by default (steuerfrei)?
receiptRequiredbooleanIs receipt required for this type?
maxAmountstringMaximum allowed amount per item (for validation, null = no limit)
isActivebooleanIs this type active/available for selection
sortOrderintegerSort order for display
createdstring
updatedstring
searchStringstringtext to search for in the list
orderFieldNamestringname of the order field
orderFieldSortstringsorting modeAllowed: DESCASC
pageintegerpage of the list
pageSizeintegernumber of entries for each page
withMaxPageNumberstringreturns the number of pages available as a header if this is set

Responses

200Returns a list of TravelExpenseType objectsarray<TravelExpenseType>

Show fields (14)
  • idinteger

    Primary key of the travel expense type. Internal ID.

  • type_keystringrequired

    Internal type identifier (e.g., KM_PAUSCHALE_PKW, HOTEL)

  • namestringrequired

    Display name

  • descriptionstring

    Description

  • categorystringrequired

    Parent expense category

    Allowed: VERPFLEGUNG FAHRTKOSTEN UEBERNACHTUNG NEBENKOSTEN

  • default_ratestring

    Default rate (e.g., km rate 0.30, per diem rate 28.00)

  • rate_unitstring

    Unit for the rate (EUR, EUR/km, EUR/Tag, etc.)

  • is_tax_free_defaultboolean

    Is this type tax-free by default (steuerfrei)?

  • receipt_requiredboolean

    Is receipt required for this type?

  • max_amountstring

    Maximum allowed amount per item (for validation, null = no limit)

  • is_activeboolean

    Is this type active/available for selection

  • sort_orderinteger

    Sort order for display

  • createdstring (date-time)

    Point in time the entity was created.

  • updatedstring (date-time)

    Point in time the entity was last updated.

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/billing/travel/expense_types \
  --header 'x-iw-jwt-token: <TOKEN>'
Response 200 application/json
[
  {
    "type_key": "string",
    "name": "Beispiel",
    "category": "VERPFLEGUNG",
    "id": 42,
    "description": "Text",
    "default_rate": "string",
    "rate_unit": "string",
    "is_tax_free_default": true,
    "receipt_required": true,
    "max_amount": "string"
  }
]

Get a single TravelExpenseType

GET/api/billing/travel/expense_types/{identifier}

Path parameters

identifierrequiredstring

Responses

200Returns a single TravelExpenseTypeTravelExpenseType

Show fields (14)
  • idinteger

    Primary key of the travel expense type. Internal ID.

  • type_keystringrequired

    Internal type identifier (e.g., KM_PAUSCHALE_PKW, HOTEL)

  • namestringrequired

    Display name

  • descriptionstring

    Description

  • categorystringrequired

    Parent expense category

    Allowed: VERPFLEGUNG FAHRTKOSTEN UEBERNACHTUNG NEBENKOSTEN

  • default_ratestring

    Default rate (e.g., km rate 0.30, per diem rate 28.00)

  • rate_unitstring

    Unit for the rate (EUR, EUR/km, EUR/Tag, etc.)

  • is_tax_free_defaultboolean

    Is this type tax-free by default (steuerfrei)?

  • receipt_requiredboolean

    Is receipt required for this type?

  • max_amountstring

    Maximum allowed amount per item (for validation, null = no limit)

  • is_activeboolean

    Is this type active/available for selection

  • sort_orderinteger

    Sort order for display

  • createdstring (date-time)

    Point in time the entity was created.

  • updatedstring (date-time)

    Point in time the entity was last updated.

Request
curl --request GET \
  --url https://your-instance.iw-erp.de/api/billing/travel/expense_types/42 \
  --header 'x-iw-jwt-token: <TOKEN>'
Response 200 application/json
{
  "type_key": "string",
  "name": "Beispiel",
  "category": "VERPFLEGUNG",
  "id": 42,
  "description": "Text",
  "default_rate": "string",
  "rate_unit": "string",
  "is_tax_free_default": true,
  "receipt_required": true,
  "max_amount": "string"
}

Delete a TravelExpenseType (soft delete via isActive = false)

DELETE/api/billing/travel/expense_types/{identifier}

Path parameters

identifierrequiredstring

Responses

default

Request
curl --request DELETE \
  --url https://your-instance.iw-erp.de/api/billing/travel/expense_types/42 \
  --header 'x-iw-jwt-token: <TOKEN>'