PUBLIC API v1

Create a manual transaction

POST /api/v1/accounting/transactions/

Create a manual transaction for the company

Permission: write_transactions · Direct link

Company-scoped. Account permissions, plan limits and document state still apply.

Request body

application/json

Field Type / accepted values Description

amount string (decimal) Not specified

currency string Not specified

descriptionRequired string Not specified

descriptionLong string | null Not specified

company string (uuid) | null Not specified

valueDateRequired string (date-time) | null Not specified

paymentDate string (date) | null Not specified

ledgerPaymentAccountCode string | null Not specified

saleType "GOODS" | "SERVICES" | "" Not specified

inputVatType "NO_VAT" | "GERMAN_VAT" | "FOREIGN_VAT" | "" | null Not specified

account string (uuid) | null Not specified

source "IMPORT" | "MANUAL" | "API" * `IMPORT` - Import * `MANUAL` - Manual * `API` - API

verifiedAt string (date-time) | null Not specified

client string (uuid) | null Not specified

vendor string (uuid) | null Not specified

reverseCharge boolean Not specified

vatRate 23 | 19 | 8 | 7 | 5 | 0 | -1 | -2 * `23` - 23% * `19` - 19% * `8` - 8% * `7` - 7% * `5` - 5% * `0` - 0% * `-1` - CUSTOM % * `-2` - Reverse charge

cashflowType "INCOME" | "EXPENSE" * `INCOME` - Income * `EXPENSE` - Expense

category string (uuid) | null Not specified

companyCategory string (uuid) | null Not specified

isRefund boolean Not specified

categoryMetadata

object

Not specified

Nested fields

Field Type / accepted values Description

tripMealAllowance

object

Not specified

Nested fields

Field	Type / accepted values	Description
`tripStartDate`Required	`string (date)`	Not specified
`tripFinishDate`Required	`string (date)`	Not specified
`tripDestination`Required	"AT" \| "DE" \| "BE" \| "HR" \| "CY" \| "CZ" \| "DK" \| "EE" \| "FI" \| "FR" \| "HU" \| "IE" \| "IT" \| "LV" \| "LT" \| "LU" \| "MT" \| "NL" \| "PL" \| "PT" \| "SK" \| "SI" \| "ES" \| "SE" \| "IL" \| "LI" \| "MC" \| "MON" \| "NO" \| "SM" \| "RS" \| "CH" \| "GB" \| "CA" \| "US" \| "AF" \| "AX" \| "AL" \| "DZ" \| "AS" \| "AD" \| "AO" \| "AI" \| "AQ" \| "AG" \| "AR" \| "AM" \| "AW" \| "AU" \| "AZ" \| "BS" \| "BH" \| "BD" \| "BB" \| "BY" \| "BZ" \| "BJ" \| "BM" \| "BT" \| "BO" \| "BA" \| "BW" \| "BV" \| "BR" \| "IO" \| "BN" \| "BG" \| "BF" \| "BI" \| "KH" \| "CM" \| "CV" \| "KY" \| "CF" \| "TD" \| "CL" \| "CN" \| "CX" \| "CC" \| "CO" \| "KM" \| "CG" \| "CD" \| "CK" \| "CR" \| "CI" \| "CU" \| "DJ" \| "DM" \| "DO" \| "EC" \| "EG" \| "SV" \| "GQ" \| "ER" \| "ET" \| "FK" \| "FO" \| "FJ" \| "GF" \| "PF" \| "TF" \| "GA" \| "GM" \| "GE" \| "GH" \| "GI" \| "GR" \| "GL" \| "GD" \| "GP" \| "GU" \| "GT" \| "GG" \| "GN" \| "GW" \| "GY" \| "HT" \| "HM" \| "HN" \| "HK" \| "IS" \| "IN" \| "ID" \| "IR" \| "IQ" \| "IM" \| "JM" \| "JP" \| "JE" \| "JO" \| "KZ" \| "KE" \| "KI" \| "KP" \| "KR" \| "KW" \| "KG" \| "LA" \| "LB" \| "LS" \| "LR" \| "LY" \| "MO" \| "MK" \| "MG" \| "MW" \| "MY" \| "MV" \| "ML" \| "MH" \| "MQ" \| "MR" \| "MU" \| "YT" \| "MX" \| "FM" \| "MD" \| "MN" \| "MS" \| "MA" \| "MZ" \| "MM" \| "NA" \| "NR" \| "NP" \| "AN" \| "NC" \| "NZ" \| "NI" \| "NE" \| "NG" \| "NU" \| "NF" \| "MP" \| "OM" \| "PK" \| "PW" \| "PS" \| "PA" \| "PG" \| "PY" \| "PE" \| "PH" \| "PN" \| "PR" \| "QA" \| "RE" \| "RO" \| "RU" \| "RW" \| "SH" \| "KN" \| "LC" \| "PM" \| "VC" \| "WS" \| "ST" \| "SA" \| "SN" \| "SC" \| "SL" \| "SG" \| "SB" \| "SO" \| "ZA" \| "GS" \| "LK" \| "SD" \| "SR" \| "SJ" \| "SZ" \| "SY" \| "TW" \| "TJ" \| "TZ" \| "TH" \| "TL" \| "TG" \| "TK" \| "TO" \| "TT" \| "TN" \| "TR" \| "TM" \| "TC" \| "TV" \| "UG" \| "UA" \| "AE" \| "UM" \| "UY" \| "UZ" \| "VU" \| "VA" \| "VE" \| "VN" \| "VG" \| "VI" \| "WF" \| "EH" \| "YE" \| "ZM" \| "ZW"	* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe

amortization

object

Not specified

Nested fields

Field	Type / accepted values	Description
`professionalUsePart`	`number (double)`	Not specified
`usefulLifetime`Required	`integer`	Not specified

businessMeal

object

Not specified

Nested fields

Field	Type / accepted values	Description
`businessMeal`	`string`	Not specified

carUsage

object

Not specified

Nested fields

Field	Type / accepted values	Description
`carUseType`	`"DRIVE_TO_WORK" \| "BUSINESS_TRIP"`	* `DRIVE_TO_WORK` - Drive to Work * `BUSINESS_TRIP` - Business Trip
`carUsageStartDate`Required	`string (date)`	Not specified
`carUsageFinishDate`Required	`string (date)`	Not specified
`carUsageDistance`Required	`integer`	Not specified
`carUsageDays`	`integer \| null`	Not specified
`carUsageMethod`	`"FLAT_RATE" \| "ACTUAL_COSTS"`	* `FLAT_RATE` - FLAT_RATE * `ACTUAL_COSTS` - ACTUAL_COSTS

vatPaid

object

Not specified

Nested fields

Field	Type / accepted values	Description
`vatDeclarationYear`	`integer`	Not specified
`vatDeclarationPeriod`	`"yearly" \| "Q1" \| "Q2" \| "Q3" \| "Q4" \| "Jan" \| "Feb" \| "Mar" \| "Apr" \| "May" \| "Jun" \| "Jul" \| "Aug" \| "Sep" \| "Oct" \| "Nov" \| "Dec" \| "other"`	* `yearly` - Yearly * `Q1` - Q1 (Jan, Feb, Mar) * `Q2` - Q2 (Apr, May, Jun) * `Q3` - Q3 (Jul, Aug, Sep) * `Q4` - Q4 (Oct, Nov, Dec) * `Jan` - January * `Feb` - February * `Mar` - March * `Apr` - April * `May` - May * `Jun` - June * `Jul` - July * `Aug` - August * `Sep` - September * `Oct` - October * `Nov` - November * `Dec` - December * `other` - Other

professionalUsePart

object

Not specified

Nested fields

Field	Type / accepted values	Description
`professionalUsePart`Required	`number (double)`	Not specified

items

object[]

Not specified

Nested fields

Field	Type / accepted values	Description
`description`	`string`	Not specified
`publicId`	`string (uuid)`	Preserve existing item IDs on update.
`taxTreatment`	`"DOMESTIC_NO_VAT" \| "DOMESTIC_INPUT_VAT" \| "DOMESTIC_REVERSE_CHARGE" \| "EU_SERVICE_REVERSE_CHARGE" \| "EU_GOODS_ACQUISITION" \| "THIRD_COUNTRY_SERVICE_REVERSE_CHARGE" \| "EU_GOODS_NON_ACQUISITION" \| null`	DE SME expenses only. Null inherits. EU_GOODS_NON_ACQUISITION is an explicit, reviewed § 1a(3) exclusion: confirm the acquisition threshold and absence of an effective waiver first. * `DOMESTIC_NO_VAT` - DOMESTIC_NO_VAT * `DOMESTIC_INPUT_VAT` - DOMESTIC_INPUT_VAT * `DOMESTIC_REVERSE_CHARGE` - DOMESTIC_REVERSE_CHARGE * `EU_SERVICE_REVERSE_CHARGE` - EU_SERVICE_REVERSE_CHARGE * `EU_GOODS_ACQUISITION` - EU_GOODS_ACQUISITION * `THIRD_COUNTRY_SERVICE_REVERSE_CHARGE` - THIRD_COUNTRY_SERVICE_REVERSE_CHARGE * `EU_GOODS_NON_ACQUISITION` - EU_GOODS_NON_ACQUISITION
`vatAmountMode`	`"AUTO" \| "DOCUMENTED_GERMAN_INPUT_VAT"`	* `AUTO` - Automatic calculation * `DOCUMENTED_GERMAN_INPUT_VAT` - Documented German input VAT in EUR
`documentedVatAmountEur`	`string (decimal) \| null`	Documented German invoice input VAT in EUR, before business-use deduction. Fixed mode only.
`vatDocumentId`	`string (uuid) \| null`	Company-owned supporting document. Clear with the amount when returning to AUTO.
`amount`Required	`string (decimal)`	Not specified
`vatRate`Required	`integer`	Not specified
`vatType`	`"VAT_INCLUDED" \| "VAT_EXCLUDED"`	* `VAT_INCLUDED` - VAT Included * `VAT_EXCLUDED` - VAT Excluded
`category`	`string (uuid) \| null`	Not specified
`companyCategory`	`string (uuid) \| null`	Not specified
`professionalUsePart`	`number (double)`	Not specified
`order`	`integer`	Not specified
`metadata`	`object`	Not specified

multipart/form-data

Field Type / accepted values Description

amount string (decimal) Not specified

currency string Not specified

descriptionRequired string Not specified

descriptionLong string | null Not specified

company string (uuid) | null Not specified

valueDateRequired string (date-time) | null Not specified

paymentDate string (date) | null Not specified

ledgerPaymentAccountCode string | null Not specified

saleType "GOODS" | "SERVICES" | "" Not specified

inputVatType "NO_VAT" | "GERMAN_VAT" | "FOREIGN_VAT" | "" | null Not specified

account string (uuid) | null Not specified

source "IMPORT" | "MANUAL" | "API" * `IMPORT` - Import * `MANUAL` - Manual * `API` - API

verifiedAt string (date-time) | null Not specified

client string (uuid) | null Not specified

vendor string (uuid) | null Not specified

reverseCharge boolean Not specified

vatRate 23 | 19 | 8 | 7 | 5 | 0 | -1 | -2 * `23` - 23% * `19` - 19% * `8` - 8% * `7` - 7% * `5` - 5% * `0` - 0% * `-1` - CUSTOM % * `-2` - Reverse charge

cashflowType "INCOME" | "EXPENSE" * `INCOME` - Income * `EXPENSE` - Expense

category string (uuid) | null Not specified

companyCategory string (uuid) | null Not specified

isRefund boolean Not specified

categoryMetadata

object

Not specified

Nested fields

Field Type / accepted values Description

tripMealAllowance

object

Not specified

Nested fields

Field	Type / accepted values	Description
`tripStartDate`Required	`string (date)`	Not specified
`tripFinishDate`Required	`string (date)`	Not specified
`tripDestination`Required	"AT" \| "DE" \| "BE" \| "HR" \| "CY" \| "CZ" \| "DK" \| "EE" \| "FI" \| "FR" \| "HU" \| "IE" \| "IT" \| "LV" \| "LT" \| "LU" \| "MT" \| "NL" \| "PL" \| "PT" \| "SK" \| "SI" \| "ES" \| "SE" \| "IL" \| "LI" \| "MC" \| "MON" \| "NO" \| "SM" \| "RS" \| "CH" \| "GB" \| "CA" \| "US" \| "AF" \| "AX" \| "AL" \| "DZ" \| "AS" \| "AD" \| "AO" \| "AI" \| "AQ" \| "AG" \| "AR" \| "AM" \| "AW" \| "AU" \| "AZ" \| "BS" \| "BH" \| "BD" \| "BB" \| "BY" \| "BZ" \| "BJ" \| "BM" \| "BT" \| "BO" \| "BA" \| "BW" \| "BV" \| "BR" \| "IO" \| "BN" \| "BG" \| "BF" \| "BI" \| "KH" \| "CM" \| "CV" \| "KY" \| "CF" \| "TD" \| "CL" \| "CN" \| "CX" \| "CC" \| "CO" \| "KM" \| "CG" \| "CD" \| "CK" \| "CR" \| "CI" \| "CU" \| "DJ" \| "DM" \| "DO" \| "EC" \| "EG" \| "SV" \| "GQ" \| "ER" \| "ET" \| "FK" \| "FO" \| "FJ" \| "GF" \| "PF" \| "TF" \| "GA" \| "GM" \| "GE" \| "GH" \| "GI" \| "GR" \| "GL" \| "GD" \| "GP" \| "GU" \| "GT" \| "GG" \| "GN" \| "GW" \| "GY" \| "HT" \| "HM" \| "HN" \| "HK" \| "IS" \| "IN" \| "ID" \| "IR" \| "IQ" \| "IM" \| "JM" \| "JP" \| "JE" \| "JO" \| "KZ" \| "KE" \| "KI" \| "KP" \| "KR" \| "KW" \| "KG" \| "LA" \| "LB" \| "LS" \| "LR" \| "LY" \| "MO" \| "MK" \| "MG" \| "MW" \| "MY" \| "MV" \| "ML" \| "MH" \| "MQ" \| "MR" \| "MU" \| "YT" \| "MX" \| "FM" \| "MD" \| "MN" \| "MS" \| "MA" \| "MZ" \| "MM" \| "NA" \| "NR" \| "NP" \| "AN" \| "NC" \| "NZ" \| "NI" \| "NE" \| "NG" \| "NU" \| "NF" \| "MP" \| "OM" \| "PK" \| "PW" \| "PS" \| "PA" \| "PG" \| "PY" \| "PE" \| "PH" \| "PN" \| "PR" \| "QA" \| "RE" \| "RO" \| "RU" \| "RW" \| "SH" \| "KN" \| "LC" \| "PM" \| "VC" \| "WS" \| "ST" \| "SA" \| "SN" \| "SC" \| "SL" \| "SG" \| "SB" \| "SO" \| "ZA" \| "GS" \| "LK" \| "SD" \| "SR" \| "SJ" \| "SZ" \| "SY" \| "TW" \| "TJ" \| "TZ" \| "TH" \| "TL" \| "TG" \| "TK" \| "TO" \| "TT" \| "TN" \| "TR" \| "TM" \| "TC" \| "TV" \| "UG" \| "UA" \| "AE" \| "UM" \| "UY" \| "UZ" \| "VU" \| "VA" \| "VE" \| "VN" \| "VG" \| "VI" \| "WF" \| "EH" \| "YE" \| "ZM" \| "ZW"	* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe

amortization

object

Not specified

Nested fields

Field	Type / accepted values	Description
`professionalUsePart`	`number (double)`	Not specified
`usefulLifetime`Required	`integer`	Not specified

businessMeal

object

Not specified

Nested fields

Field	Type / accepted values	Description
`businessMeal`	`string`	Not specified

carUsage

object

Not specified

Nested fields

Field	Type / accepted values	Description
`carUseType`	`"DRIVE_TO_WORK" \| "BUSINESS_TRIP"`	* `DRIVE_TO_WORK` - Drive to Work * `BUSINESS_TRIP` - Business Trip
`carUsageStartDate`Required	`string (date)`	Not specified
`carUsageFinishDate`Required	`string (date)`	Not specified
`carUsageDistance`Required	`integer`	Not specified
`carUsageDays`	`integer \| null`	Not specified
`carUsageMethod`	`"FLAT_RATE" \| "ACTUAL_COSTS"`	* `FLAT_RATE` - FLAT_RATE * `ACTUAL_COSTS` - ACTUAL_COSTS

vatPaid

object

Not specified

Nested fields

Field	Type / accepted values	Description
`vatDeclarationYear`	`integer`	Not specified
`vatDeclarationPeriod`	`"yearly" \| "Q1" \| "Q2" \| "Q3" \| "Q4" \| "Jan" \| "Feb" \| "Mar" \| "Apr" \| "May" \| "Jun" \| "Jul" \| "Aug" \| "Sep" \| "Oct" \| "Nov" \| "Dec" \| "other"`	* `yearly` - Yearly * `Q1` - Q1 (Jan, Feb, Mar) * `Q2` - Q2 (Apr, May, Jun) * `Q3` - Q3 (Jul, Aug, Sep) * `Q4` - Q4 (Oct, Nov, Dec) * `Jan` - January * `Feb` - February * `Mar` - March * `Apr` - April * `May` - May * `Jun` - June * `Jul` - July * `Aug` - August * `Sep` - September * `Oct` - October * `Nov` - November * `Dec` - December * `other` - Other

professionalUsePart

object

Not specified

Nested fields

Field	Type / accepted values	Description
`professionalUsePart`Required	`number (double)`	Not specified

items

object[]

Not specified

Nested fields

Field	Type / accepted values	Description
`description`	`string`	Not specified
`publicId`	`string (uuid)`	Preserve existing item IDs on update.
`taxTreatment`	`"DOMESTIC_NO_VAT" \| "DOMESTIC_INPUT_VAT" \| "DOMESTIC_REVERSE_CHARGE" \| "EU_SERVICE_REVERSE_CHARGE" \| "EU_GOODS_ACQUISITION" \| "THIRD_COUNTRY_SERVICE_REVERSE_CHARGE" \| "EU_GOODS_NON_ACQUISITION" \| null`	DE SME expenses only. Null inherits. EU_GOODS_NON_ACQUISITION is an explicit, reviewed § 1a(3) exclusion: confirm the acquisition threshold and absence of an effective waiver first. * `DOMESTIC_NO_VAT` - DOMESTIC_NO_VAT * `DOMESTIC_INPUT_VAT` - DOMESTIC_INPUT_VAT * `DOMESTIC_REVERSE_CHARGE` - DOMESTIC_REVERSE_CHARGE * `EU_SERVICE_REVERSE_CHARGE` - EU_SERVICE_REVERSE_CHARGE * `EU_GOODS_ACQUISITION` - EU_GOODS_ACQUISITION * `THIRD_COUNTRY_SERVICE_REVERSE_CHARGE` - THIRD_COUNTRY_SERVICE_REVERSE_CHARGE * `EU_GOODS_NON_ACQUISITION` - EU_GOODS_NON_ACQUISITION
`vatAmountMode`	`"AUTO" \| "DOCUMENTED_GERMAN_INPUT_VAT"`	* `AUTO` - Automatic calculation * `DOCUMENTED_GERMAN_INPUT_VAT` - Documented German input VAT in EUR
`documentedVatAmountEur`	`string (decimal) \| null`	Documented German invoice input VAT in EUR, before business-use deduction. Fixed mode only.
`vatDocumentId`	`string (uuid) \| null`	Company-owned supporting document. Clear with the amount when returning to AUTO.
`amount`Required	`string (decimal)`	Not specified
`vatRate`Required	`integer`	Not specified
`vatType`	`"VAT_INCLUDED" \| "VAT_EXCLUDED"`	* `VAT_INCLUDED` - VAT Included * `VAT_EXCLUDED` - VAT Excluded
`category`	`string (uuid) \| null`	Not specified
`companyCategory`	`string (uuid) \| null`	Not specified
`professionalUsePart`	`number (double)`	Not specified
`order`	`integer`	Not specified
`metadata`	`object`	Not specified

application/x-www-form-urlencoded

Field Type / accepted values Description

amount string (decimal) Not specified

currency string Not specified

descriptionRequired string Not specified

descriptionLong string | null Not specified

company string (uuid) | null Not specified

valueDateRequired string (date-time) | null Not specified

paymentDate string (date) | null Not specified

ledgerPaymentAccountCode string | null Not specified

saleType "GOODS" | "SERVICES" | "" Not specified

inputVatType "NO_VAT" | "GERMAN_VAT" | "FOREIGN_VAT" | "" | null Not specified

account string (uuid) | null Not specified

source "IMPORT" | "MANUAL" | "API" * `IMPORT` - Import * `MANUAL` - Manual * `API` - API

verifiedAt string (date-time) | null Not specified

client string (uuid) | null Not specified

vendor string (uuid) | null Not specified

reverseCharge boolean Not specified

vatRate 23 | 19 | 8 | 7 | 5 | 0 | -1 | -2 * `23` - 23% * `19` - 19% * `8` - 8% * `7` - 7% * `5` - 5% * `0` - 0% * `-1` - CUSTOM % * `-2` - Reverse charge

cashflowType "INCOME" | "EXPENSE" * `INCOME` - Income * `EXPENSE` - Expense

category string (uuid) | null Not specified

companyCategory string (uuid) | null Not specified

isRefund boolean Not specified

categoryMetadata

object

Not specified

Nested fields

Field Type / accepted values Description

tripMealAllowance

object

Not specified

Nested fields

Field	Type / accepted values	Description
`tripStartDate`Required	`string (date)`	Not specified
`tripFinishDate`Required	`string (date)`	Not specified
`tripDestination`Required	"AT" \| "DE" \| "BE" \| "HR" \| "CY" \| "CZ" \| "DK" \| "EE" \| "FI" \| "FR" \| "HU" \| "IE" \| "IT" \| "LV" \| "LT" \| "LU" \| "MT" \| "NL" \| "PL" \| "PT" \| "SK" \| "SI" \| "ES" \| "SE" \| "IL" \| "LI" \| "MC" \| "MON" \| "NO" \| "SM" \| "RS" \| "CH" \| "GB" \| "CA" \| "US" \| "AF" \| "AX" \| "AL" \| "DZ" \| "AS" \| "AD" \| "AO" \| "AI" \| "AQ" \| "AG" \| "AR" \| "AM" \| "AW" \| "AU" \| "AZ" \| "BS" \| "BH" \| "BD" \| "BB" \| "BY" \| "BZ" \| "BJ" \| "BM" \| "BT" \| "BO" \| "BA" \| "BW" \| "BV" \| "BR" \| "IO" \| "BN" \| "BG" \| "BF" \| "BI" \| "KH" \| "CM" \| "CV" \| "KY" \| "CF" \| "TD" \| "CL" \| "CN" \| "CX" \| "CC" \| "CO" \| "KM" \| "CG" \| "CD" \| "CK" \| "CR" \| "CI" \| "CU" \| "DJ" \| "DM" \| "DO" \| "EC" \| "EG" \| "SV" \| "GQ" \| "ER" \| "ET" \| "FK" \| "FO" \| "FJ" \| "GF" \| "PF" \| "TF" \| "GA" \| "GM" \| "GE" \| "GH" \| "GI" \| "GR" \| "GL" \| "GD" \| "GP" \| "GU" \| "GT" \| "GG" \| "GN" \| "GW" \| "GY" \| "HT" \| "HM" \| "HN" \| "HK" \| "IS" \| "IN" \| "ID" \| "IR" \| "IQ" \| "IM" \| "JM" \| "JP" \| "JE" \| "JO" \| "KZ" \| "KE" \| "KI" \| "KP" \| "KR" \| "KW" \| "KG" \| "LA" \| "LB" \| "LS" \| "LR" \| "LY" \| "MO" \| "MK" \| "MG" \| "MW" \| "MY" \| "MV" \| "ML" \| "MH" \| "MQ" \| "MR" \| "MU" \| "YT" \| "MX" \| "FM" \| "MD" \| "MN" \| "MS" \| "MA" \| "MZ" \| "MM" \| "NA" \| "NR" \| "NP" \| "AN" \| "NC" \| "NZ" \| "NI" \| "NE" \| "NG" \| "NU" \| "NF" \| "MP" \| "OM" \| "PK" \| "PW" \| "PS" \| "PA" \| "PG" \| "PY" \| "PE" \| "PH" \| "PN" \| "PR" \| "QA" \| "RE" \| "RO" \| "RU" \| "RW" \| "SH" \| "KN" \| "LC" \| "PM" \| "VC" \| "WS" \| "ST" \| "SA" \| "SN" \| "SC" \| "SL" \| "SG" \| "SB" \| "SO" \| "ZA" \| "GS" \| "LK" \| "SD" \| "SR" \| "SJ" \| "SZ" \| "SY" \| "TW" \| "TJ" \| "TZ" \| "TH" \| "TL" \| "TG" \| "TK" \| "TO" \| "TT" \| "TN" \| "TR" \| "TM" \| "TC" \| "TV" \| "UG" \| "UA" \| "AE" \| "UM" \| "UY" \| "UZ" \| "VU" \| "VA" \| "VE" \| "VN" \| "VG" \| "VI" \| "WF" \| "EH" \| "YE" \| "ZM" \| "ZW"	* `AT` - Austria * `DE` - Germany * `BE` - Belgium * `HR` - Croatia * `CY` - Cyprus * `CZ` - Czech Republic * `DK` - Denmark * `EE` - Estonia * `FI` - Finland * `FR` - France * `HU` - Hungary * `IE` - Ireland * `IT` - Italy * `LV` - Latvia * `LT` - Lithuania * `LU` - Luxembourg * `MT` - Malta * `NL` - Netherlands * `PL` - Poland * `PT` - Portugal * `SK` - Slovakia * `SI` - Slovenia * `ES` - Spain * `SE` - Sweden * `IL` - Israel * `LI` - Liechtenstein * `MC` - Monaco * `MON` - Montenegro * `NO` - Norway * `SM` - San Marino * `RS` - Serbia * `CH` - Switzerland * `GB` - United Kingdom * `CA` - Canada * `US` - United States * `AF` - Afghanistan * `AX` - Åland Islands * `AL` - Albania * `DZ` - Algeria * `AS` - American Samoa * `AD` - AndorrA * `AO` - Angola * `AI` - Anguilla * `AQ` - Antarctica * `AG` - Antigua and Barbuda * `AR` - Argentina * `AM` - Armenia * `AW` - Aruba * `AU` - Australia * `AZ` - Azerbaijan * `BS` - Bahamas * `BH` - Bahrain * `BD` - Bangladesh * `BB` - Barbados * `BY` - Belarus * `BZ` - Belize * `BJ` - Benin * `BM` - Bermuda * `BT` - Bhutan * `BO` - Bolivia * `BA` - Bosnia and Herzegovina * `BW` - Botswana * `BV` - Bouvet Island * `BR` - Brazil * `IO` - British Indian Ocean Territory * `BN` - Brunei Darussalam * `BG` - Bulgaria * `BF` - Burkina Faso * `BI` - Burundi * `KH` - Cambodia * `CM` - Cameroon * `CV` - Cape Verde * `KY` - Cayman Islands * `CF` - Central African Republic * `TD` - Chad * `CL` - Chile * `CN` - China * `CX` - Christmas Island * `CC` - Cocos (Keeling) Islands * `CO` - Colombia * `KM` - Comoros * `CG` - Congo * `CD` - Congo, The Democratic Republic of the * `CK` - Cook Islands * `CR` - Costa Rica * `CI` - Cote D'Ivoire * `CU` - Cuba * `DJ` - Djibouti * `DM` - Dominica * `DO` - Dominican Republic * `EC` - Ecuador * `EG` - Egypt * `SV` - El Salvador * `GQ` - Equatorial Guinea * `ER` - Eritrea * `ET` - Ethiopia * `FK` - Falkland Islands * `FO` - Faroe Islands * `FJ` - Fiji * `GF` - French Guiana * `PF` - French Polynesia * `TF` - French Southern Territories * `GA` - Gabon * `GM` - Gambia * `GE` - Georgia * `GH` - Ghana * `GI` - Gibraltar * `GR` - Greece * `GL` - Greenland * `GD` - Grenada * `GP` - Guadeloupe * `GU` - Guam * `GT` - Guatemala * `GG` - Guernsey * `GN` - Guinea * `GW` - Guinea-Bissau * `GY` - Guyana * `HT` - Haiti * `HM` - Heard Island and Mcdonald Islands * `HN` - Honduras * `HK` - Hong Kong * `IS` - Iceland * `IN` - India * `ID` - Indonesia * `IR` - Iran * `IQ` - Iraq * `IM` - Isle of Man * `JM` - Jamaica * `JP` - Japan * `JE` - Jersey * `JO` - Jordan * `KZ` - Kazakhstan * `KE` - Kenya * `KI` - Kiribati * `KP` - North Korea * `KR` - South Korea * `KW` - Kuwait * `KG` - Kyrgyzstan * `LA` - Lao People'S * `LB` - Lebanon * `LS` - Lesotho * `LR` - Liberia * `LY` - Libya * `MO` - Macao * `MK` - Macedonia * `MG` - Madagascar * `MW` - Malawi * `MY` - Malaysia * `MV` - Maldives * `ML` - Mali * `MH` - Marshall Islands * `MQ` - Martinique * `MR` - Mauritania * `MU` - Mauritius * `YT` - Mayotte * `MX` - Mexico * `FM` - Micronesia * `MD` - Moldova * `MN` - Mongolia * `MS` - Montserrat * `MA` - Morocco * `MZ` - Mozambique * `MM` - Myanmar * `NA` - Namibia * `NR` - Nauru * `NP` - Nepal * `AN` - Netherlands Antilles * `NC` - New Caledonia * `NZ` - New Zealand * `NI` - Nicaragua * `NE` - Niger * `NG` - Nigeria * `NU` - Niue * `NF` - Norfolk Island * `MP` - Northern Mariana Islands * `OM` - Oman * `PK` - Pakistan * `PW` - Palau * `PS` - Palestina * `PA` - Panama * `PG` - Papua New Guinea * `PY` - Paraguay * `PE` - Peru * `PH` - Philippines * `PN` - Pitcairn * `PR` - Puerto Rico * `QA` - Qatar * `RE` - Reunion * `RO` - Romania * `RU` - Russian Federation * `RW` - RWANDA * `SH` - Saint Helena * `KN` - Saint Kitts and Nevis * `LC` - Saint Lucia * `PM` - Saint Pierre and Miquelon * `VC` - Saint Vincent and the Grenadines * `WS` - Samoa * `ST` - Sao Tome and Principe * `SA` - Saudi Arabia * `SN` - Senegal * `SC` - Seychelles * `SL` - Sierra Leone * `SG` - Singapore * `SB` - Solomon Islands * `SO` - Somalia * `ZA` - South Africa * `GS` - South Georgia and the South Sandwich Islands * `LK` - Sri Lanka * `SD` - Sudan * `SR` - Suriname * `SJ` - Svalbard and Jan Mayen * `SZ` - Swaziland * `SY` - Syrian Arab Republic * `TW` - Taiwan, Province of China * `TJ` - Tajikistan * `TZ` - Tanzania, United Republic of * `TH` - Thailand * `TL` - Timor-Leste * `TG` - Togo * `TK` - Tokelau * `TO` - Tonga * `TT` - Trinidad and Tobago * `TN` - Tunisia * `TR` - Turkey * `TM` - Turkmenistan * `TC` - Turks and Caicos Islands * `TV` - Tuvalu * `UG` - Uganda * `UA` - Ukraine * `AE` - United Arab Emirates * `UM` - United States Minor Outlying Islands * `UY` - Uruguay * `UZ` - Uzbekistan * `VU` - Vanuatu * `VA` - Vatican * `VE` - Venezuela * `VN` - Viet Nam * `VG` - Virgin Islands, British * `VI` - Virgin Islands, U.S. * `WF` - Wallis and Futuna * `EH` - Western Sahara * `YE` - Yemen * `ZM` - Zambia * `ZW` - Zimbabwe

amortization

object

Not specified

Nested fields

Field	Type / accepted values	Description
`professionalUsePart`	`number (double)`	Not specified
`usefulLifetime`Required	`integer`	Not specified

businessMeal

object

Not specified

Nested fields

Field	Type / accepted values	Description
`businessMeal`	`string`	Not specified

carUsage

object

Not specified

Nested fields

Field	Type / accepted values	Description
`carUseType`	`"DRIVE_TO_WORK" \| "BUSINESS_TRIP"`	* `DRIVE_TO_WORK` - Drive to Work * `BUSINESS_TRIP` - Business Trip
`carUsageStartDate`Required	`string (date)`	Not specified
`carUsageFinishDate`Required	`string (date)`	Not specified
`carUsageDistance`Required	`integer`	Not specified
`carUsageDays`	`integer \| null`	Not specified
`carUsageMethod`	`"FLAT_RATE" \| "ACTUAL_COSTS"`	* `FLAT_RATE` - FLAT_RATE * `ACTUAL_COSTS` - ACTUAL_COSTS

vatPaid

object

Not specified

Nested fields

Field	Type / accepted values	Description
`vatDeclarationYear`	`integer`	Not specified
`vatDeclarationPeriod`	`"yearly" \| "Q1" \| "Q2" \| "Q3" \| "Q4" \| "Jan" \| "Feb" \| "Mar" \| "Apr" \| "May" \| "Jun" \| "Jul" \| "Aug" \| "Sep" \| "Oct" \| "Nov" \| "Dec" \| "other"`	* `yearly` - Yearly * `Q1` - Q1 (Jan, Feb, Mar) * `Q2` - Q2 (Apr, May, Jun) * `Q3` - Q3 (Jul, Aug, Sep) * `Q4` - Q4 (Oct, Nov, Dec) * `Jan` - January * `Feb` - February * `Mar` - March * `Apr` - April * `May` - May * `Jun` - June * `Jul` - July * `Aug` - August * `Sep` - September * `Oct` - October * `Nov` - November * `Dec` - December * `other` - Other

professionalUsePart

object

Not specified

Nested fields

Field	Type / accepted values	Description
`professionalUsePart`Required	`number (double)`	Not specified

items

object[]

Not specified

Nested fields

Field	Type / accepted values	Description
`description`	`string`	Not specified
`publicId`	`string (uuid)`	Preserve existing item IDs on update.
`taxTreatment`	`"DOMESTIC_NO_VAT" \| "DOMESTIC_INPUT_VAT" \| "DOMESTIC_REVERSE_CHARGE" \| "EU_SERVICE_REVERSE_CHARGE" \| "EU_GOODS_ACQUISITION" \| "THIRD_COUNTRY_SERVICE_REVERSE_CHARGE" \| "EU_GOODS_NON_ACQUISITION" \| null`	DE SME expenses only. Null inherits. EU_GOODS_NON_ACQUISITION is an explicit, reviewed § 1a(3) exclusion: confirm the acquisition threshold and absence of an effective waiver first. * `DOMESTIC_NO_VAT` - DOMESTIC_NO_VAT * `DOMESTIC_INPUT_VAT` - DOMESTIC_INPUT_VAT * `DOMESTIC_REVERSE_CHARGE` - DOMESTIC_REVERSE_CHARGE * `EU_SERVICE_REVERSE_CHARGE` - EU_SERVICE_REVERSE_CHARGE * `EU_GOODS_ACQUISITION` - EU_GOODS_ACQUISITION * `THIRD_COUNTRY_SERVICE_REVERSE_CHARGE` - THIRD_COUNTRY_SERVICE_REVERSE_CHARGE * `EU_GOODS_NON_ACQUISITION` - EU_GOODS_NON_ACQUISITION
`vatAmountMode`	`"AUTO" \| "DOCUMENTED_GERMAN_INPUT_VAT"`	* `AUTO` - Automatic calculation * `DOCUMENTED_GERMAN_INPUT_VAT` - Documented German input VAT in EUR
`documentedVatAmountEur`	`string (decimal) \| null`	Documented German invoice input VAT in EUR, before business-use deduction. Fixed mode only.
`vatDocumentId`	`string (uuid) \| null`	Company-owned supporting document. Clear with the amount when returning to AUTO.
`amount`Required	`string (decimal)`	Not specified
`vatRate`Required	`integer`	Not specified
`vatType`	`"VAT_INCLUDED" \| "VAT_EXCLUDED"`	* `VAT_INCLUDED` - VAT Included * `VAT_EXCLUDED` - VAT Excluded
`category`	`string (uuid) \| null`	Not specified
`companyCategory`	`string (uuid) \| null`	Not specified
`professionalUsePart`	`number (double)`	Not specified
`order`	`integer`	Not specified
`metadata`	`object`	Not specified

Responses

201 Response fields

application/json

Field Type / accepted values Description

publicIdRequiredRead only string (uuid) Not specified

externalId string Not specified

status "PENDING" | "BOOKED" | "UNDEFINED" * `PENDING` - Pending * `BOOKED` - Booked * `UNDEFINED` - Undefined

amountRequired string (decimal) Not specified

amountExchanged string (decimal) | null Not specified

currencyRequired

object

Not specified

Nested fields

Field	Type / accepted values	Description
`fullName`RequiredRead only	`string`	Not specified
`isoCode`Required	`string`	Not specified

currencyExchangedRequired

object

Not specified

Nested fields

Field	Type / accepted values	Description
`fullName`RequiredRead only	`string`	Not specified
`isoCode`Required	`string`	Not specified

description string Not specified

descriptionLong string | null Not specified

userStatus "UNVERIFIED" | "VERIFIED" * `UNVERIFIED` - Unverified * `VERIFIED` - Verified

vatRate 23 | 19 | 8 | 7 | 5 | 0 | -1 | -2 * `23` - 23% * `19` - 19% * `8` - 8% * `7` - 7% * `5` - 5% * `0` - 0% * `-1` - CUSTOM % * `-2` - Reverse charge

vatAmount string (decimal) Not specified

valueDate string (date-time) | null Not specified

paymentDate string (date) | null Not specified

ledgerPaymentAccountCode string | null Not specified

categoryRequired

object

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`name`RequiredRead only	`string`	Not specified
`parent`	`string (uuid) \| null`	Not specified
`cashflowType`Required	`string`	Not specified
`vatApplied`	`"YES" \| "NO"`	* `YES` - Yes * `NO` - No
`metadata`	`object`	Not specified
`description`RequiredRead only	`string`	Not specified
`examples`RequiredRead only	`string`	Not specified

companyCategoryRequiredRead only

object

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`code`Required	`string`	Not specified
`name`Required	`string`	Not specified
`nameDe`	`string`	Not specified
`namePl`	`string`	Not specified
`description`	`string`	Not specified
`cashflowType`	`"ASSET" \| "LIABILITY" \| "EQUITY" \| "INCOME" \| "EXPENSE"`	* `ASSET` - Asset * `LIABILITY` - Liability * `EQUITY` - Equity * `INCOME` - Income * `EXPENSE` - Expense
`vatApplicability`	`boolean`	Not specified
`suggestedVatRate`	`integer`	Not specified
`isCustom`	`boolean`	Not specified
`isActive`	`boolean`	Not specified
`isBookable`	`boolean`	Not specified
`categoryGroup`	`string`	Not specified
`metadata`	`object`	Not specified

isRefund boolean Not specified

iban string Not specified

bankLogoRequiredRead only string | null Not specified

verifiedAt string (date-time) | null Not specified

vatAmountExchanged string (decimal) | null Not specified

cashflowTypeRequired string Not specified

sourceRequired string Not specified

attachment string (uuid) | null Not specified

additionalAttachmentsRequiredRead only

object[]

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`file`	`string (uri) \| null`	Not specified

invoice string (uuid) | null Not specified

supplierCountryNameRequired string Not specified

client string (uuid) | null Not specified

vendor string (uuid) | null Not specified

vendorDetailsRequiredRead only

object

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`name`Required	`string`	Not specified
`displayLogoUrl`RequiredRead only	`string`	Not specified
`catalogKey`	`string`	Not specified

reverseCharge boolean Not specified

saleType "GOODS" | "SERVICES" | "" Not specified

inputVatType "NO_VAT" | "GERMAN_VAT" | "FOREIGN_VAT" | "" | null Not specified

categoryMetadata object Not specified

logo string (uri) | null Not specified

appliedRuleRequiredRead only

object

Minimal serializer for embedding in transaction responses.

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`name`Required	`string`	Not specified
`conditionsSummary`RequiredRead only	`string`	Not specified

advisorNotes string Private memo, not visible to your tax advisor. Use the transaction discussion to contact your advisor.

categorizationStatus "PENDING" | "CATEGORIZED" | "UNCATEGORIZED" * `PENDING` - Pending * `CATEGORIZED` - Categorized * `UNCATEGORIZED` - Uncategorized

itemsRequiredRead only

object[]

Not specified

Nested fields

Field Type / accepted values Description

publicIdRequiredRead only string (uuid) Not specified

description string Not specified

amountRequired string (decimal) Not specified

amountExchanged string (decimal) | null Not specified

vatRate 23 | 19 | 8 | 7 | 5 | 0 | -1 | -2 * `23` - 23% * `19` - 19% * `8` - 8% * `7` - 7% * `5` - 5% * `0` - 0% * `-1` - CUSTOM % * `-2` - Reverse charge

vatAmount string (decimal) Not specified

vatAmountExchanged string (decimal) | null Not specified

vatType "VAT_INCLUDED" | "VAT_EXCLUDED" * `VAT_INCLUDED` - VAT Included * `VAT_EXCLUDED` - VAT Excluded

taxTreatment string | null Not specified

vatAmountMode "AUTO" | "DOCUMENTED_GERMAN_INPUT_VAT" * `AUTO` - Automatic calculation * `DOCUMENTED_GERMAN_INPUT_VAT` - Documented German input VAT in EUR

documentedVatAmountEur string (decimal) | null Not specified

vatDocumentIdRequiredRead only string (uuid) | null Not specified

categoryRequiredRead only

object

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`name`RequiredRead only	`string`	Not specified
`parent`	`string (uuid) \| null`	Not specified
`cashflowType`Required	`string`	Not specified
`vatApplied`	`"YES" \| "NO"`	* `YES` - Yes * `NO` - No
`metadata`	`object`	Not specified
`description`RequiredRead only	`string`	Not specified
`examples`RequiredRead only	`string`	Not specified

companyCategoryRequiredRead only

object

Not specified

Nested fields

Field	Type / accepted values	Description
`publicId`RequiredRead only	`string (uuid)`	Not specified
`code`Required	`string`	Not specified
`name`Required	`string`	Not specified
`nameDe`	`string`	Not specified
`namePl`	`string`	Not specified
`description`	`string`	Not specified
`cashflowType`	`"ASSET" \| "LIABILITY" \| "EQUITY" \| "INCOME" \| "EXPENSE"`	* `ASSET` - Asset * `LIABILITY` - Liability * `EQUITY` - Equity * `INCOME` - Income * `EXPENSE` - Expense
`vatApplicability`	`boolean`	Not specified
`suggestedVatRate`	`integer`	Not specified
`isCustom`	`boolean`	Not specified
`isActive`	`boolean`	Not specified
`isBookable`	`boolean`	Not specified
`categoryGroup`	`string`	Not specified
`metadata`	`object`	Not specified

professionalUsePart string (decimal) Fraction of business use (0.000 to 1.000)

order integer Not specified

metadata object Not specified

isLocked boolean Not specified

usesPreviousSkrAccountRequiredRead only boolean Not specified

documentNotRequired boolean | null Not specified

400 Response fields

application/json

Field	Type / accepted values	Description
`detail`Required	`string`	Not specified
`code`	`integer`	Not specified
`type_`	`string`	Not specified
`field`Required	`string`	Not specified

401 Response fields

application/json

Field	Type / accepted values	Description
`detail`RequiredRead only	`string`	Not specified

403 Missing scope, company mismatch, unsupported operation, or a plan/account restriction.

429 Rate limit exceeded. Wait for the Retry-After header before retrying.

Use the base URL https://api.norman.finance/api/v1. Sign up or log in to Norman to create an API key, then send it as a Bearer token. For an OpenAPI JSON file, contact support.