# OpenItem

the Finance OpenItem API

## PUT /erp/finance/openitems/{openItemId}/change

> Ändert Stammdaten am Offenen Posten wie Mahnsperre

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{openItemId}/change":{"put":{"tags":["OpenItem"],"description":"Ändert Stammdaten am Offenen Posten wie Mahnsperre","operationId":"update_33","parameters":[{"name":"openItemId","in":"path","description":"openItem Identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItemChangeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItem"}}}}}}}},"components":{"schemas":{"erp-finance-OpenItemChangeRequest":{"properties":{"manualPaymentDueDate":{"type":"string","format":"date","description":"manuelles vorrangiges Fälligkeitsdatum"},"dunningBlock":{"type":"boolean","description":"Mahnsperre"},"inReview":{"type":"boolean","description":"In Klärung setzen"},"basisPaymentTermRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentTemplateRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"purpose":{"type":"string","description":"Verwendungszweck"},"valueDate":{"type":"string","format":"date","description":"Valutadatum"},"clearValueDate":{"type":"boolean","description":"Valutadatum löschen"},"comment":{"type":"string","description":"Kommentar"},"paymentBlock":{"type":"boolean","description":"Zahlungssperre"}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"erp-finance-OpenItem":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"order":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"invoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"creditNote":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"depositInvoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"account":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"number":{"type":"string","description":"OP-Nummer","readOnly":true},"externalNumber":{"type":"string","description":"Externe OP-Nummer ","readOnly":true},"depositPaymentAmount":{"type":"number","description":"agreed Deposit payment amount","readOnly":true},"depositPaymentDate":{"type":"string","format":"date","description":"agreed Deposit payment date","readOnly":true},"depositPayed":{"type":"boolean","default":false,"description":"is the agreed deposit payed?","readOnly":true},"balancedDate":{"type":"string","format":"date","description":"balanced date of this open item (calculated)","readOnly":true},"balanceState":{"type":"string","description":"whether this open item is balanced, partially paid or open","enum":["OPEN","PARTIALLY_BALANCED","BALANCED","OVERPAID"],"readOnly":true},"balance":{"type":"number","description":"saldo","readOnly":true},"sumPayments":{"type":"number","description":"Summe gebuchte Zahlungen","readOnly":true},"sumDunnings":{"type":"number","description":"Summe Mahngebühren und Zinsen","readOnly":true},"sumTotalAmount":{"type":"number","description":"Rechnungsbetrag","readOnly":true},"sumDiscountableAmount":{"type":"number","description":"skontierbarer Rechnungsbetrag","readOnly":true},"sumFee":{"type":"number","description":"allgemeine Gebühren","readOnly":true},"records":{"type":"array","description":"free payments","items":{"$ref":"#/components/schemas/erp-finance-OpenItemRecord"},"readOnly":true},"basisPaymentTermRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentDays1":{"type":"integer","format":"int32","description":"How many days are given for using the first discount rule","readOnly":true},"paymentDiscount1":{"type":"number","description":"How much discount can be given for speedy payment, rule 1","readOnly":true},"paymentDiscount1DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto1)","readOnly":true},"paymentDays2":{"type":"integer","format":"int32","description":"How many days are given for using the second discount rule","readOnly":true},"paymentDiscount2":{"type":"number","description":"How much discount can be given for speedy payment, rule 2","readOnly":true},"paymentDiscount2DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto2)","readOnly":true},"qualifier":{"type":"string","description":"Does this open item belong to accounts payable or accounts receivable","enum":["PAYABLE","RECEIVABLE"],"readOnly":true},"fullPaymentAmount":{"type":"number","description":"The full amount of the payment","readOnly":true},"paymentAmount":{"type":"number","description":"Der momentan gültige zu zahlende Betrag","readOnly":true},"paymentKind":{"type":"string","description":"The kind of payment","enum":["PREPAYMENT","PAYMENT"],"readOnly":true},"refundType":{"type":"string","description":"how should a refund be done?","enum":["DISBURSE","OFFSET_LATER"]},"dunningBlock":{"type":"boolean","default":false,"description":"Mahnsperre"},"paymentState":{"type":"string","description":"Der Zustand der Zahlung","enum":["NO_PAYMENT","PAYMENT_CREATED","PAYMENT_TRANSFERRED","PAYMENT_COMMITTED"]},"dunningState":{"type":"string","description":"Der Mahnzustand","enum":["IN_DUNNING","NO_DUNNING","DUNNING_PAID","DUNNING_PARTIALLY_PAID","DUNNING_OVERPAID"]},"dunningLevel":{"type":"integer","format":"int32","description":"Die Mahnstufe","readOnly":true},"dunningCount":{"type":"integer","format":"int32","description":"Anzahl Mahnpositionen/Mahnungen für diesen OP","readOnly":true},"originalPaymentDueDate":{"type":"string","format":"date","description":"Ursprüngliches Fälligkeitsdatum","readOnly":true},"paymentDaysNet":{"type":"integer","format":"int32","description":"Fälligkeit in Tagen"},"paymentDueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"valueDate":{"type":"string","format":"date","description":"Valutadatum"},"paymentDiscount1Amount":{"type":"number","description":"Skontobetrag 1"},"paymentDiscount2Amount":{"type":"number","description":"Skontobetrag 2"},"paymentTemplateRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"purpose":{"type":"string","description":"Verwendungszweck"},"comment":{"type":"string","description":"Kommentar"},"paymentBlock":{"type":"boolean","default":false,"description":"Zahlungssperre"},"tags":{"type":"array","description":"List of tags","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"paymentPlan":{"$ref":"#/components/schemas/erp-finance-OpenItemPaymentPlan"},"valueDateReadOnly":{"type":"boolean","default":false,"description":"Valutadatum schreibgeschützt"},"canBeReopened":{"type":"boolean","default":false,"description":"kann wiedereröffet werden"},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseDepositPaymentAmount":{"type":"number","description":"Vereinbarter Anzahlungsbetrag in Basiswährung"},"baseSumPayments":{"type":"number","description":"Summe der Zahlungen in Basiswährung"},"baseSumDiscount":{"type":"number","description":"Summe der Abzüge (Skonto usw.) in Basiswährung"},"baseSumDunnings":{"type":"number","description":"Summe der Mahngebühren und Zinsen in Basiswährung"},"baseSumTotalAmount":{"type":"number","description":"Gesamtsumme der Rechnungsbeträge in Basiswährung"},"baseSumDiscountableAmount":{"type":"number","description":"Summe der skontierbaren Rechnungsbeträge in Basiswährung"},"baseBalance":{"type":"number","description":"Offener Betrag (Saldo) in Basiswährung"},"baseSumFee":{"type":"number","description":"allgemeine Gebühren in Basiswährung"},"blockedByDocument":{"type":"boolean","default":false,"description":"Ist der OP durch ein Dokument geblockt?"},"bookingAccountType":{"type":"string","description":"Buchung auf Lieferant oder Kunde bei manuellen OPs","enum":["CUSTOMER","SUPPLIER","AUTOMATIC"],"readOnly":true},"balanced":{"type":"boolean"}},"required":["number"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"erp-finance-OpenItemRecord":{"description":"free payments","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"recordDate":{"type":"string","format":"date","description":"record date","readOnly":true},"totalAmount":{"type":"number","description":"record total amount","readOnly":true},"discountableAmount":{"type":"number","description":"record discountable amount","readOnly":true},"amount":{"type":"number","description":"record amount","readOnly":true},"discountAmount":{"type":"number","description":"record discount amount","readOnly":true},"bookingRecordId":{"type":"integer","format":"int64","description":"ref to the financialBookingRecord","readOnly":true},"origin":{"type":"string","description":"origin for this record","enum":["DOCUMENT","PAYMENT","PAYMENT_DISSOLVED","REIMBURSEMENT","REIMBURSEMENT_DISSOLVED","MANUAL_CLOSURE","MANUAL_REOPENING","DUNNING","DUNNING_DISSOLVED","DUNNING_INTEREST_REVERSAL","IMPORT","PAYMENT_PLAN","PAYMENT_PLAN_ENTRY","PAYMENT_IMPORT","CLEARING","DEPOSIT","CREDIT_NOTE","BALANCE_ADJUSTMENT","FEE","DUNNING_PAYMENT","DUNNING_PAYMENT_DISSOLVED","POS_PAYMENT"],"readOnly":true},"document":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethod":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accountBankdetailsRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"transactionRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"bankAccountRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"businessTransaction":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"revertedByRecordId":{"type":"integer","format":"int64","description":"id des records, der diesen storniert hat","readOnly":true},"transactionId":{"type":"integer","format":"int64","description":"id der transaction, die diesen record hervorgerufen hat","readOnly":true},"qualifier":{"type":"string","description":"qualifier of open item","enum":["PAYABLE","RECEIVABLE","PAYMENT_RECEIVED","PAYMENT_SENT","PAYMENT_RECEIVED_REVERTED","PAYMENT_SENT_REVERTED","DUNNING_RECEIVABLE","DUNNING_PAYABLE","DUNNING_RECEIVABLE_REVERTED","DUNNING_PAYABLE_REVERTED"],"readOnly":true},"number":{"type":"string","description":"Eine Vorgangsnummer die zur Buchung führte","readOnly":true},"comment":{"type":"string","description":"comment","readOnly":true},"locked":{"type":"boolean","description":"locked","readOnly":true},"revertable":{"type":"boolean","description":"revertable","readOnly":true},"recordReferenceNumber":{"type":"string","description":"record reference number","readOnly":true},"dunningLvl":{"type":"integer","format":"int32","description":"Mahnstufe","readOnly":true},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseAmount":{"type":"number","description":"Buchungsbetrag in Basiswährung"},"baseDiscountAmount":{"type":"number","description":"Abzugsbetrag in Basiswährung"},"baseTotalAmount":{"type":"number","description":"Gesamtbetrag in Basiswährung"},"baseDiscountableAmount":{"type":"number","description":"Skontierbarer Gesamtbetrag in Basiswährung"},"baseDunningFee":{"type":"number","description":"Mahngebühren in Basiswährung"},"baseDunningInterest":{"type":"number","description":"Mahnzinsen in Basiswährung"}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-finance-OpenItemPaymentPlan":{"description":"Zahlungsplan","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"paymentPlanType":{"type":"string","description":"Zahlungsplantyp","enum":["RULE","MANUAL"]},"dueDateCalculation":{"type":"string","description":"Fälligkeitsregel"},"amount":{"type":"number","description":"Betrag"},"startDate":{"type":"string","format":"date","description":"Startdatum"},"endDate":{"type":"string","format":"date","description":"Enddatum"},"description":{"type":"string","description":"Beschreibung"},"active":{"type":"boolean","description":"Aktiv"},"dueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"manualRuleEntries":{"type":"array","description":"manuelle Buchungsvorgaben","items":{"$ref":"#/components/schemas/erp-finance-PaymentPlanManualRule"}},"currencyCode":{"type":"string","description":"Währung des Zahlungsplans (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des Zahlungsplans (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}},"erp-finance-PaymentPlanManualRule":{"description":"manuelle Buchungsvorgaben","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"dueDate":{"type":"string","format":"date","description":"Fälligkeit"},"amount":{"type":"number","description":"Betrag"},"processed":{"type":"boolean","description":"bereits verarbeitet","readOnly":true},"currencyCode":{"type":"string","description":"Währung (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}}}}}
```

## PUT /erp/finance/openitems/additional-functions/{openItemId}/UpdateTags

> Update Tags

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/additional-functions/{openItemId}/UpdateTags":{"put":{"tags":["OpenItem"],"summary":"Update Tags","operationId":"setOpenItemTags","parameters":[{"name":"openItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"integer","format":"int64"},"uniqueItems":true}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItem"}}}}}}}},"components":{"schemas":{"erp-finance-OpenItem":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"order":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"invoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"creditNote":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"depositInvoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"account":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"number":{"type":"string","description":"OP-Nummer","readOnly":true},"externalNumber":{"type":"string","description":"Externe OP-Nummer ","readOnly":true},"depositPaymentAmount":{"type":"number","description":"agreed Deposit payment amount","readOnly":true},"depositPaymentDate":{"type":"string","format":"date","description":"agreed Deposit payment date","readOnly":true},"depositPayed":{"type":"boolean","default":false,"description":"is the agreed deposit payed?","readOnly":true},"balancedDate":{"type":"string","format":"date","description":"balanced date of this open item (calculated)","readOnly":true},"balanceState":{"type":"string","description":"whether this open item is balanced, partially paid or open","enum":["OPEN","PARTIALLY_BALANCED","BALANCED","OVERPAID"],"readOnly":true},"balance":{"type":"number","description":"saldo","readOnly":true},"sumPayments":{"type":"number","description":"Summe gebuchte Zahlungen","readOnly":true},"sumDunnings":{"type":"number","description":"Summe Mahngebühren und Zinsen","readOnly":true},"sumTotalAmount":{"type":"number","description":"Rechnungsbetrag","readOnly":true},"sumDiscountableAmount":{"type":"number","description":"skontierbarer Rechnungsbetrag","readOnly":true},"sumFee":{"type":"number","description":"allgemeine Gebühren","readOnly":true},"records":{"type":"array","description":"free payments","items":{"$ref":"#/components/schemas/erp-finance-OpenItemRecord"},"readOnly":true},"basisPaymentTermRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentDays1":{"type":"integer","format":"int32","description":"How many days are given for using the first discount rule","readOnly":true},"paymentDiscount1":{"type":"number","description":"How much discount can be given for speedy payment, rule 1","readOnly":true},"paymentDiscount1DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto1)","readOnly":true},"paymentDays2":{"type":"integer","format":"int32","description":"How many days are given for using the second discount rule","readOnly":true},"paymentDiscount2":{"type":"number","description":"How much discount can be given for speedy payment, rule 2","readOnly":true},"paymentDiscount2DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto2)","readOnly":true},"qualifier":{"type":"string","description":"Does this open item belong to accounts payable or accounts receivable","enum":["PAYABLE","RECEIVABLE"],"readOnly":true},"fullPaymentAmount":{"type":"number","description":"The full amount of the payment","readOnly":true},"paymentAmount":{"type":"number","description":"Der momentan gültige zu zahlende Betrag","readOnly":true},"paymentKind":{"type":"string","description":"The kind of payment","enum":["PREPAYMENT","PAYMENT"],"readOnly":true},"refundType":{"type":"string","description":"how should a refund be done?","enum":["DISBURSE","OFFSET_LATER"]},"dunningBlock":{"type":"boolean","default":false,"description":"Mahnsperre"},"paymentState":{"type":"string","description":"Der Zustand der Zahlung","enum":["NO_PAYMENT","PAYMENT_CREATED","PAYMENT_TRANSFERRED","PAYMENT_COMMITTED"]},"dunningState":{"type":"string","description":"Der Mahnzustand","enum":["IN_DUNNING","NO_DUNNING","DUNNING_PAID","DUNNING_PARTIALLY_PAID","DUNNING_OVERPAID"]},"dunningLevel":{"type":"integer","format":"int32","description":"Die Mahnstufe","readOnly":true},"dunningCount":{"type":"integer","format":"int32","description":"Anzahl Mahnpositionen/Mahnungen für diesen OP","readOnly":true},"originalPaymentDueDate":{"type":"string","format":"date","description":"Ursprüngliches Fälligkeitsdatum","readOnly":true},"paymentDaysNet":{"type":"integer","format":"int32","description":"Fälligkeit in Tagen"},"paymentDueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"valueDate":{"type":"string","format":"date","description":"Valutadatum"},"paymentDiscount1Amount":{"type":"number","description":"Skontobetrag 1"},"paymentDiscount2Amount":{"type":"number","description":"Skontobetrag 2"},"paymentTemplateRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"purpose":{"type":"string","description":"Verwendungszweck"},"comment":{"type":"string","description":"Kommentar"},"paymentBlock":{"type":"boolean","default":false,"description":"Zahlungssperre"},"tags":{"type":"array","description":"List of tags","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"paymentPlan":{"$ref":"#/components/schemas/erp-finance-OpenItemPaymentPlan"},"valueDateReadOnly":{"type":"boolean","default":false,"description":"Valutadatum schreibgeschützt"},"canBeReopened":{"type":"boolean","default":false,"description":"kann wiedereröffet werden"},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseDepositPaymentAmount":{"type":"number","description":"Vereinbarter Anzahlungsbetrag in Basiswährung"},"baseSumPayments":{"type":"number","description":"Summe der Zahlungen in Basiswährung"},"baseSumDiscount":{"type":"number","description":"Summe der Abzüge (Skonto usw.) in Basiswährung"},"baseSumDunnings":{"type":"number","description":"Summe der Mahngebühren und Zinsen in Basiswährung"},"baseSumTotalAmount":{"type":"number","description":"Gesamtsumme der Rechnungsbeträge in Basiswährung"},"baseSumDiscountableAmount":{"type":"number","description":"Summe der skontierbaren Rechnungsbeträge in Basiswährung"},"baseBalance":{"type":"number","description":"Offener Betrag (Saldo) in Basiswährung"},"baseSumFee":{"type":"number","description":"allgemeine Gebühren in Basiswährung"},"blockedByDocument":{"type":"boolean","default":false,"description":"Ist der OP durch ein Dokument geblockt?"},"bookingAccountType":{"type":"string","description":"Buchung auf Lieferant oder Kunde bei manuellen OPs","enum":["CUSTOMER","SUPPLIER","AUTOMATIC"],"readOnly":true},"balanced":{"type":"boolean"}},"required":["number"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"erp-finance-OpenItemRecord":{"description":"free payments","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"recordDate":{"type":"string","format":"date","description":"record date","readOnly":true},"totalAmount":{"type":"number","description":"record total amount","readOnly":true},"discountableAmount":{"type":"number","description":"record discountable amount","readOnly":true},"amount":{"type":"number","description":"record amount","readOnly":true},"discountAmount":{"type":"number","description":"record discount amount","readOnly":true},"bookingRecordId":{"type":"integer","format":"int64","description":"ref to the financialBookingRecord","readOnly":true},"origin":{"type":"string","description":"origin for this record","enum":["DOCUMENT","PAYMENT","PAYMENT_DISSOLVED","REIMBURSEMENT","REIMBURSEMENT_DISSOLVED","MANUAL_CLOSURE","MANUAL_REOPENING","DUNNING","DUNNING_DISSOLVED","DUNNING_INTEREST_REVERSAL","IMPORT","PAYMENT_PLAN","PAYMENT_PLAN_ENTRY","PAYMENT_IMPORT","CLEARING","DEPOSIT","CREDIT_NOTE","BALANCE_ADJUSTMENT","FEE","DUNNING_PAYMENT","DUNNING_PAYMENT_DISSOLVED","POS_PAYMENT"],"readOnly":true},"document":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethod":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accountBankdetailsRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"transactionRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"bankAccountRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"businessTransaction":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"revertedByRecordId":{"type":"integer","format":"int64","description":"id des records, der diesen storniert hat","readOnly":true},"transactionId":{"type":"integer","format":"int64","description":"id der transaction, die diesen record hervorgerufen hat","readOnly":true},"qualifier":{"type":"string","description":"qualifier of open item","enum":["PAYABLE","RECEIVABLE","PAYMENT_RECEIVED","PAYMENT_SENT","PAYMENT_RECEIVED_REVERTED","PAYMENT_SENT_REVERTED","DUNNING_RECEIVABLE","DUNNING_PAYABLE","DUNNING_RECEIVABLE_REVERTED","DUNNING_PAYABLE_REVERTED"],"readOnly":true},"number":{"type":"string","description":"Eine Vorgangsnummer die zur Buchung führte","readOnly":true},"comment":{"type":"string","description":"comment","readOnly":true},"locked":{"type":"boolean","description":"locked","readOnly":true},"revertable":{"type":"boolean","description":"revertable","readOnly":true},"recordReferenceNumber":{"type":"string","description":"record reference number","readOnly":true},"dunningLvl":{"type":"integer","format":"int32","description":"Mahnstufe","readOnly":true},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseAmount":{"type":"number","description":"Buchungsbetrag in Basiswährung"},"baseDiscountAmount":{"type":"number","description":"Abzugsbetrag in Basiswährung"},"baseTotalAmount":{"type":"number","description":"Gesamtbetrag in Basiswährung"},"baseDiscountableAmount":{"type":"number","description":"Skontierbarer Gesamtbetrag in Basiswährung"},"baseDunningFee":{"type":"number","description":"Mahngebühren in Basiswährung"},"baseDunningInterest":{"type":"number","description":"Mahnzinsen in Basiswährung"}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-finance-OpenItemPaymentPlan":{"description":"Zahlungsplan","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"paymentPlanType":{"type":"string","description":"Zahlungsplantyp","enum":["RULE","MANUAL"]},"dueDateCalculation":{"type":"string","description":"Fälligkeitsregel"},"amount":{"type":"number","description":"Betrag"},"startDate":{"type":"string","format":"date","description":"Startdatum"},"endDate":{"type":"string","format":"date","description":"Enddatum"},"description":{"type":"string","description":"Beschreibung"},"active":{"type":"boolean","description":"Aktiv"},"dueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"manualRuleEntries":{"type":"array","description":"manuelle Buchungsvorgaben","items":{"$ref":"#/components/schemas/erp-finance-PaymentPlanManualRule"}},"currencyCode":{"type":"string","description":"Währung des Zahlungsplans (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des Zahlungsplans (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}},"erp-finance-PaymentPlanManualRule":{"description":"manuelle Buchungsvorgaben","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"dueDate":{"type":"string","format":"date","description":"Fälligkeit"},"amount":{"type":"number","description":"Betrag"},"processed":{"type":"boolean","description":"bereits verarbeitet","readOnly":true},"currencyCode":{"type":"string","description":"Währung (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}}}}}
```

## GET /erp/finance/openitems/account/{accountId}/print

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/account/{accountId}/print":{"get":{"tags":["OpenItem"],"operationId":"getPrintPreview","parameters":[{"name":"accountId","in":"path","description":"account identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{}}}}}}}}}
```

## PUT /erp/finance/openitems/account/{accountId}/print

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/account/{accountId}/print":{"put":{"tags":["OpenItem"],"operationId":"printDunning","parameters":[{"name":"accountId","in":"path","description":"account identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/common-output-OutputRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{}},"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"common-output-OutputRequest":{"properties":{"exportFormat":{"type":"string","description":"output-format für mail/file-export","enum":["PDF","XLSX","XLSX_RAW","JSON_RAW","REPORT_TEMPLATE"]},"exportFilename":{"type":"string","description":"filename (ohne extension) bei einem file-export"},"mailRecipients":{"type":"array","description":"Empfänger","items":{"$ref":"#/components/schemas/common-output-OutputRecipient.MailRecipient"}},"outputType":{"type":"string","description":"outputType"},"groupIdentifier":{"type":"string","description":"OutputReportGroup Identifier (optional), sonst Default-Group des Moduls"},"published":{"type":"boolean","default":false,"description":"sollen nur bereits veröffentlichte Dokumente beachtet werden?"}}},"common-output-OutputRecipient.MailRecipient":{"description":"Empfänger","properties":{"type":{"type":"string","description":"(mail) recipient type","enum":["TO","CC","BCC"]},"address":{"type":"string","description":"(mail) recipient address"},"name":{"type":"string","description":"(mail) recipient name"}}}}}}
```

## POST /erp/finance/openitems/{openItemid}/calculate\_discount/{discountDate}

> Gibt den Skontobetrag und die Gültigkeit des Skonto für ein angegebenes Datum zurück

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{openItemid}/calculate_discount/{discountDate}":{"post":{"tags":["OpenItem"],"description":"Gibt den Skontobetrag und die Gültigkeit des Skonto für ein angegebenes Datum zurück","operationId":"calculateDiscountForDate","parameters":[{"name":"openItemid","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"discountDate","in":"path","required":true,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-DiscountCalculationResponse"}}}}}}}},"components":{"schemas":{"erp-finance-DiscountCalculationResponse":{"properties":{"discountDate":{"type":"string","format":"date","description":"Skontodatum"},"discountAmount":{"type":"number","description":"Skontobetrag"},"isApplicable":{"type":"boolean","description":"Skonto ist anwandbar"}}}}}}
```

## POST /erp/finance/openitems/{openItemId}/{openItemRecordId}/reassignTransaction

> weist eine Transaction einem anderen OP zu

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{openItemId}/{openItemRecordId}/reassignTransaction":{"post":{"tags":["OpenItem"],"description":"weist eine Transaction einem anderen OP zu","operationId":"reassignTransaction","parameters":[{"name":"openItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"openItemRecordId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItemTransactionReassignRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItem"}}}}}}}},"components":{"schemas":{"erp-finance-OpenItemTransactionReassignRequest":{"properties":{"targetOpenItemId":{"type":"integer","format":"int64","description":"neuer OP dem die Transaction zugewiesen werden soll"}}},"erp-finance-OpenItem":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"order":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"invoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"creditNote":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"depositInvoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"account":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"number":{"type":"string","description":"OP-Nummer","readOnly":true},"externalNumber":{"type":"string","description":"Externe OP-Nummer ","readOnly":true},"depositPaymentAmount":{"type":"number","description":"agreed Deposit payment amount","readOnly":true},"depositPaymentDate":{"type":"string","format":"date","description":"agreed Deposit payment date","readOnly":true},"depositPayed":{"type":"boolean","default":false,"description":"is the agreed deposit payed?","readOnly":true},"balancedDate":{"type":"string","format":"date","description":"balanced date of this open item (calculated)","readOnly":true},"balanceState":{"type":"string","description":"whether this open item is balanced, partially paid or open","enum":["OPEN","PARTIALLY_BALANCED","BALANCED","OVERPAID"],"readOnly":true},"balance":{"type":"number","description":"saldo","readOnly":true},"sumPayments":{"type":"number","description":"Summe gebuchte Zahlungen","readOnly":true},"sumDunnings":{"type":"number","description":"Summe Mahngebühren und Zinsen","readOnly":true},"sumTotalAmount":{"type":"number","description":"Rechnungsbetrag","readOnly":true},"sumDiscountableAmount":{"type":"number","description":"skontierbarer Rechnungsbetrag","readOnly":true},"sumFee":{"type":"number","description":"allgemeine Gebühren","readOnly":true},"records":{"type":"array","description":"free payments","items":{"$ref":"#/components/schemas/erp-finance-OpenItemRecord"},"readOnly":true},"basisPaymentTermRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentDays1":{"type":"integer","format":"int32","description":"How many days are given for using the first discount rule","readOnly":true},"paymentDiscount1":{"type":"number","description":"How much discount can be given for speedy payment, rule 1","readOnly":true},"paymentDiscount1DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto1)","readOnly":true},"paymentDays2":{"type":"integer","format":"int32","description":"How many days are given for using the second discount rule","readOnly":true},"paymentDiscount2":{"type":"number","description":"How much discount can be given for speedy payment, rule 2","readOnly":true},"paymentDiscount2DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto2)","readOnly":true},"qualifier":{"type":"string","description":"Does this open item belong to accounts payable or accounts receivable","enum":["PAYABLE","RECEIVABLE"],"readOnly":true},"fullPaymentAmount":{"type":"number","description":"The full amount of the payment","readOnly":true},"paymentAmount":{"type":"number","description":"Der momentan gültige zu zahlende Betrag","readOnly":true},"paymentKind":{"type":"string","description":"The kind of payment","enum":["PREPAYMENT","PAYMENT"],"readOnly":true},"refundType":{"type":"string","description":"how should a refund be done?","enum":["DISBURSE","OFFSET_LATER"]},"dunningBlock":{"type":"boolean","default":false,"description":"Mahnsperre"},"paymentState":{"type":"string","description":"Der Zustand der Zahlung","enum":["NO_PAYMENT","PAYMENT_CREATED","PAYMENT_TRANSFERRED","PAYMENT_COMMITTED"]},"dunningState":{"type":"string","description":"Der Mahnzustand","enum":["IN_DUNNING","NO_DUNNING","DUNNING_PAID","DUNNING_PARTIALLY_PAID","DUNNING_OVERPAID"]},"dunningLevel":{"type":"integer","format":"int32","description":"Die Mahnstufe","readOnly":true},"dunningCount":{"type":"integer","format":"int32","description":"Anzahl Mahnpositionen/Mahnungen für diesen OP","readOnly":true},"originalPaymentDueDate":{"type":"string","format":"date","description":"Ursprüngliches Fälligkeitsdatum","readOnly":true},"paymentDaysNet":{"type":"integer","format":"int32","description":"Fälligkeit in Tagen"},"paymentDueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"valueDate":{"type":"string","format":"date","description":"Valutadatum"},"paymentDiscount1Amount":{"type":"number","description":"Skontobetrag 1"},"paymentDiscount2Amount":{"type":"number","description":"Skontobetrag 2"},"paymentTemplateRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"purpose":{"type":"string","description":"Verwendungszweck"},"comment":{"type":"string","description":"Kommentar"},"paymentBlock":{"type":"boolean","default":false,"description":"Zahlungssperre"},"tags":{"type":"array","description":"List of tags","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"paymentPlan":{"$ref":"#/components/schemas/erp-finance-OpenItemPaymentPlan"},"valueDateReadOnly":{"type":"boolean","default":false,"description":"Valutadatum schreibgeschützt"},"canBeReopened":{"type":"boolean","default":false,"description":"kann wiedereröffet werden"},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseDepositPaymentAmount":{"type":"number","description":"Vereinbarter Anzahlungsbetrag in Basiswährung"},"baseSumPayments":{"type":"number","description":"Summe der Zahlungen in Basiswährung"},"baseSumDiscount":{"type":"number","description":"Summe der Abzüge (Skonto usw.) in Basiswährung"},"baseSumDunnings":{"type":"number","description":"Summe der Mahngebühren und Zinsen in Basiswährung"},"baseSumTotalAmount":{"type":"number","description":"Gesamtsumme der Rechnungsbeträge in Basiswährung"},"baseSumDiscountableAmount":{"type":"number","description":"Summe der skontierbaren Rechnungsbeträge in Basiswährung"},"baseBalance":{"type":"number","description":"Offener Betrag (Saldo) in Basiswährung"},"baseSumFee":{"type":"number","description":"allgemeine Gebühren in Basiswährung"},"blockedByDocument":{"type":"boolean","default":false,"description":"Ist der OP durch ein Dokument geblockt?"},"bookingAccountType":{"type":"string","description":"Buchung auf Lieferant oder Kunde bei manuellen OPs","enum":["CUSTOMER","SUPPLIER","AUTOMATIC"],"readOnly":true},"balanced":{"type":"boolean"}},"required":["number"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"erp-finance-OpenItemRecord":{"description":"free payments","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"recordDate":{"type":"string","format":"date","description":"record date","readOnly":true},"totalAmount":{"type":"number","description":"record total amount","readOnly":true},"discountableAmount":{"type":"number","description":"record discountable amount","readOnly":true},"amount":{"type":"number","description":"record amount","readOnly":true},"discountAmount":{"type":"number","description":"record discount amount","readOnly":true},"bookingRecordId":{"type":"integer","format":"int64","description":"ref to the financialBookingRecord","readOnly":true},"origin":{"type":"string","description":"origin for this record","enum":["DOCUMENT","PAYMENT","PAYMENT_DISSOLVED","REIMBURSEMENT","REIMBURSEMENT_DISSOLVED","MANUAL_CLOSURE","MANUAL_REOPENING","DUNNING","DUNNING_DISSOLVED","DUNNING_INTEREST_REVERSAL","IMPORT","PAYMENT_PLAN","PAYMENT_PLAN_ENTRY","PAYMENT_IMPORT","CLEARING","DEPOSIT","CREDIT_NOTE","BALANCE_ADJUSTMENT","FEE","DUNNING_PAYMENT","DUNNING_PAYMENT_DISSOLVED","POS_PAYMENT"],"readOnly":true},"document":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethod":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accountBankdetailsRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"transactionRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"bankAccountRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"businessTransaction":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"revertedByRecordId":{"type":"integer","format":"int64","description":"id des records, der diesen storniert hat","readOnly":true},"transactionId":{"type":"integer","format":"int64","description":"id der transaction, die diesen record hervorgerufen hat","readOnly":true},"qualifier":{"type":"string","description":"qualifier of open item","enum":["PAYABLE","RECEIVABLE","PAYMENT_RECEIVED","PAYMENT_SENT","PAYMENT_RECEIVED_REVERTED","PAYMENT_SENT_REVERTED","DUNNING_RECEIVABLE","DUNNING_PAYABLE","DUNNING_RECEIVABLE_REVERTED","DUNNING_PAYABLE_REVERTED"],"readOnly":true},"number":{"type":"string","description":"Eine Vorgangsnummer die zur Buchung führte","readOnly":true},"comment":{"type":"string","description":"comment","readOnly":true},"locked":{"type":"boolean","description":"locked","readOnly":true},"revertable":{"type":"boolean","description":"revertable","readOnly":true},"recordReferenceNumber":{"type":"string","description":"record reference number","readOnly":true},"dunningLvl":{"type":"integer","format":"int32","description":"Mahnstufe","readOnly":true},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseAmount":{"type":"number","description":"Buchungsbetrag in Basiswährung"},"baseDiscountAmount":{"type":"number","description":"Abzugsbetrag in Basiswährung"},"baseTotalAmount":{"type":"number","description":"Gesamtbetrag in Basiswährung"},"baseDiscountableAmount":{"type":"number","description":"Skontierbarer Gesamtbetrag in Basiswährung"},"baseDunningFee":{"type":"number","description":"Mahngebühren in Basiswährung"},"baseDunningInterest":{"type":"number","description":"Mahnzinsen in Basiswährung"}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-finance-OpenItemPaymentPlan":{"description":"Zahlungsplan","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"paymentPlanType":{"type":"string","description":"Zahlungsplantyp","enum":["RULE","MANUAL"]},"dueDateCalculation":{"type":"string","description":"Fälligkeitsregel"},"amount":{"type":"number","description":"Betrag"},"startDate":{"type":"string","format":"date","description":"Startdatum"},"endDate":{"type":"string","format":"date","description":"Enddatum"},"description":{"type":"string","description":"Beschreibung"},"active":{"type":"boolean","description":"Aktiv"},"dueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"manualRuleEntries":{"type":"array","description":"manuelle Buchungsvorgaben","items":{"$ref":"#/components/schemas/erp-finance-PaymentPlanManualRule"}},"currencyCode":{"type":"string","description":"Währung des Zahlungsplans (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des Zahlungsplans (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}},"erp-finance-PaymentPlanManualRule":{"description":"manuelle Buchungsvorgaben","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"dueDate":{"type":"string","format":"date","description":"Fälligkeit"},"amount":{"type":"number","description":"Betrag"},"processed":{"type":"boolean","description":"bereits verarbeitet","readOnly":true},"currencyCode":{"type":"string","description":"Währung (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}}}}}
```

## POST /erp/finance/openitems/{openItemId}/startUpdate

> Sperrt einen OP zur Bearbeitung

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{openItemId}/startUpdate":{"post":{"tags":["OpenItem"],"description":"Sperrt einen OP zur Bearbeitung","operationId":"startUpdate","parameters":[{"name":"openItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-unknownmodule-LeasableLock"}}}}}}}},"components":{"schemas":{"core-unknownmodule-LeasableLock":{"properties":{"key":{"type":"string"},"token":{"type":"integer","format":"int64"},"userId":{"type":"integer","format":"int64"},"lockedBySystem":{"type":"boolean"},"validUntil":{"type":"string","format":"date-time"},"id":{"type":"string","description":"Unique identifier of the Object","readOnly":true}},"required":["key","token"]}}}}
```

## POST /erp/finance/openitems/{openItemId}/cancelUpdate

> Gibt einen OP wieder frei

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{openItemId}/cancelUpdate":{"post":{"tags":["OpenItem"],"description":"Gibt einen OP wieder frei","operationId":"cancelUpdate","parameters":[{"name":"openItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```

## POST /erp/finance/openitems/{id}/revert/{recordId}

> storniert eine Zahlung

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{id}/revert/{recordId}":{"post":{"tags":["OpenItem"],"description":"storniert eine Zahlung","operationId":"revert","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"recordId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```

## GET /erp/finance/openitems/{firstOpenItemId}/clear\_with/{secondOpenItemId}

> Gibt das Saldo nach Verrechnung zurück

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{firstOpenItemId}/clear_with/{secondOpenItemId}":{"get":{"tags":["OpenItem"],"description":"Gibt das Saldo nach Verrechnung zurück","operationId":"calculateExpectedBalance","parameters":[{"name":"firstOpenItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"secondOpenItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-ClearingExpectedResponse"}}}}}}}},"components":{"schemas":{"erp-finance-ClearingExpectedResponse":{"properties":{"qualifier":{"type":"string","description":"Forderung oder Verbindlichkeit","enum":["PAYABLE","RECEIVABLE"]},"amount":{"type":"number","description":"saldo"}}}}}}
```

## POST /erp/finance/openitems/{firstOpenItemId}/clear\_with/{secondOpenItemId}

> Verrechnet zwei OPs

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{firstOpenItemId}/clear_with/{secondOpenItemId}":{"post":{"tags":["OpenItem"],"description":"Verrechnet zwei OPs","operationId":"clearReceivableWithPayable","parameters":[{"name":"firstOpenItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"secondOpenItemId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-ClearingResponse"}}}}}}}},"components":{"schemas":{"erp-finance-ClearingResponse":{"properties":{"firstOpenItemId":{"type":"integer","format":"int64","description":"ID des ersten OPs"},"secondOpenItemId":{"type":"integer","format":"int64","description":"ID des zweiten OPs"},"clearedAmount":{"type":"number","description":"Verrechneter Betrag"}}}}}}
```

## POST /erp/finance/openitems/recalculate/{openItemID}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/recalculate/{openItemID}":{"post":{"tags":["OpenItem"],"operationId":"recalculate","parameters":[{"name":"openItemID","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItemRecalculateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItem"}}}}}}}},"components":{"schemas":{"erp-finance-OpenItemRecalculateRequest":{"properties":{"grantDeliveryApproval":{"type":"boolean","description":"Lieferfreigabe erteilen"},"newBalance":{"type":"number","description":"neuer Saldo"}}},"erp-finance-OpenItem":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"order":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"invoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"creditNote":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"depositInvoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"account":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"number":{"type":"string","description":"OP-Nummer","readOnly":true},"externalNumber":{"type":"string","description":"Externe OP-Nummer ","readOnly":true},"depositPaymentAmount":{"type":"number","description":"agreed Deposit payment amount","readOnly":true},"depositPaymentDate":{"type":"string","format":"date","description":"agreed Deposit payment date","readOnly":true},"depositPayed":{"type":"boolean","default":false,"description":"is the agreed deposit payed?","readOnly":true},"balancedDate":{"type":"string","format":"date","description":"balanced date of this open item (calculated)","readOnly":true},"balanceState":{"type":"string","description":"whether this open item is balanced, partially paid or open","enum":["OPEN","PARTIALLY_BALANCED","BALANCED","OVERPAID"],"readOnly":true},"balance":{"type":"number","description":"saldo","readOnly":true},"sumPayments":{"type":"number","description":"Summe gebuchte Zahlungen","readOnly":true},"sumDunnings":{"type":"number","description":"Summe Mahngebühren und Zinsen","readOnly":true},"sumTotalAmount":{"type":"number","description":"Rechnungsbetrag","readOnly":true},"sumDiscountableAmount":{"type":"number","description":"skontierbarer Rechnungsbetrag","readOnly":true},"sumFee":{"type":"number","description":"allgemeine Gebühren","readOnly":true},"records":{"type":"array","description":"free payments","items":{"$ref":"#/components/schemas/erp-finance-OpenItemRecord"},"readOnly":true},"basisPaymentTermRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentDays1":{"type":"integer","format":"int32","description":"How many days are given for using the first discount rule","readOnly":true},"paymentDiscount1":{"type":"number","description":"How much discount can be given for speedy payment, rule 1","readOnly":true},"paymentDiscount1DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto1)","readOnly":true},"paymentDays2":{"type":"integer","format":"int32","description":"How many days are given for using the second discount rule","readOnly":true},"paymentDiscount2":{"type":"number","description":"How much discount can be given for speedy payment, rule 2","readOnly":true},"paymentDiscount2DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto2)","readOnly":true},"qualifier":{"type":"string","description":"Does this open item belong to accounts payable or accounts receivable","enum":["PAYABLE","RECEIVABLE"],"readOnly":true},"fullPaymentAmount":{"type":"number","description":"The full amount of the payment","readOnly":true},"paymentAmount":{"type":"number","description":"Der momentan gültige zu zahlende Betrag","readOnly":true},"paymentKind":{"type":"string","description":"The kind of payment","enum":["PREPAYMENT","PAYMENT"],"readOnly":true},"refundType":{"type":"string","description":"how should a refund be done?","enum":["DISBURSE","OFFSET_LATER"]},"dunningBlock":{"type":"boolean","default":false,"description":"Mahnsperre"},"paymentState":{"type":"string","description":"Der Zustand der Zahlung","enum":["NO_PAYMENT","PAYMENT_CREATED","PAYMENT_TRANSFERRED","PAYMENT_COMMITTED"]},"dunningState":{"type":"string","description":"Der Mahnzustand","enum":["IN_DUNNING","NO_DUNNING","DUNNING_PAID","DUNNING_PARTIALLY_PAID","DUNNING_OVERPAID"]},"dunningLevel":{"type":"integer","format":"int32","description":"Die Mahnstufe","readOnly":true},"dunningCount":{"type":"integer","format":"int32","description":"Anzahl Mahnpositionen/Mahnungen für diesen OP","readOnly":true},"originalPaymentDueDate":{"type":"string","format":"date","description":"Ursprüngliches Fälligkeitsdatum","readOnly":true},"paymentDaysNet":{"type":"integer","format":"int32","description":"Fälligkeit in Tagen"},"paymentDueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"valueDate":{"type":"string","format":"date","description":"Valutadatum"},"paymentDiscount1Amount":{"type":"number","description":"Skontobetrag 1"},"paymentDiscount2Amount":{"type":"number","description":"Skontobetrag 2"},"paymentTemplateRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"purpose":{"type":"string","description":"Verwendungszweck"},"comment":{"type":"string","description":"Kommentar"},"paymentBlock":{"type":"boolean","default":false,"description":"Zahlungssperre"},"tags":{"type":"array","description":"List of tags","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"paymentPlan":{"$ref":"#/components/schemas/erp-finance-OpenItemPaymentPlan"},"valueDateReadOnly":{"type":"boolean","default":false,"description":"Valutadatum schreibgeschützt"},"canBeReopened":{"type":"boolean","default":false,"description":"kann wiedereröffet werden"},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseDepositPaymentAmount":{"type":"number","description":"Vereinbarter Anzahlungsbetrag in Basiswährung"},"baseSumPayments":{"type":"number","description":"Summe der Zahlungen in Basiswährung"},"baseSumDiscount":{"type":"number","description":"Summe der Abzüge (Skonto usw.) in Basiswährung"},"baseSumDunnings":{"type":"number","description":"Summe der Mahngebühren und Zinsen in Basiswährung"},"baseSumTotalAmount":{"type":"number","description":"Gesamtsumme der Rechnungsbeträge in Basiswährung"},"baseSumDiscountableAmount":{"type":"number","description":"Summe der skontierbaren Rechnungsbeträge in Basiswährung"},"baseBalance":{"type":"number","description":"Offener Betrag (Saldo) in Basiswährung"},"baseSumFee":{"type":"number","description":"allgemeine Gebühren in Basiswährung"},"blockedByDocument":{"type":"boolean","default":false,"description":"Ist der OP durch ein Dokument geblockt?"},"bookingAccountType":{"type":"string","description":"Buchung auf Lieferant oder Kunde bei manuellen OPs","enum":["CUSTOMER","SUPPLIER","AUTOMATIC"],"readOnly":true},"balanced":{"type":"boolean"}},"required":["number"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"erp-finance-OpenItemRecord":{"description":"free payments","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"recordDate":{"type":"string","format":"date","description":"record date","readOnly":true},"totalAmount":{"type":"number","description":"record total amount","readOnly":true},"discountableAmount":{"type":"number","description":"record discountable amount","readOnly":true},"amount":{"type":"number","description":"record amount","readOnly":true},"discountAmount":{"type":"number","description":"record discount amount","readOnly":true},"bookingRecordId":{"type":"integer","format":"int64","description":"ref to the financialBookingRecord","readOnly":true},"origin":{"type":"string","description":"origin for this record","enum":["DOCUMENT","PAYMENT","PAYMENT_DISSOLVED","REIMBURSEMENT","REIMBURSEMENT_DISSOLVED","MANUAL_CLOSURE","MANUAL_REOPENING","DUNNING","DUNNING_DISSOLVED","DUNNING_INTEREST_REVERSAL","IMPORT","PAYMENT_PLAN","PAYMENT_PLAN_ENTRY","PAYMENT_IMPORT","CLEARING","DEPOSIT","CREDIT_NOTE","BALANCE_ADJUSTMENT","FEE","DUNNING_PAYMENT","DUNNING_PAYMENT_DISSOLVED","POS_PAYMENT"],"readOnly":true},"document":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethod":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accountBankdetailsRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"transactionRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"bankAccountRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"businessTransaction":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"revertedByRecordId":{"type":"integer","format":"int64","description":"id des records, der diesen storniert hat","readOnly":true},"transactionId":{"type":"integer","format":"int64","description":"id der transaction, die diesen record hervorgerufen hat","readOnly":true},"qualifier":{"type":"string","description":"qualifier of open item","enum":["PAYABLE","RECEIVABLE","PAYMENT_RECEIVED","PAYMENT_SENT","PAYMENT_RECEIVED_REVERTED","PAYMENT_SENT_REVERTED","DUNNING_RECEIVABLE","DUNNING_PAYABLE","DUNNING_RECEIVABLE_REVERTED","DUNNING_PAYABLE_REVERTED"],"readOnly":true},"number":{"type":"string","description":"Eine Vorgangsnummer die zur Buchung führte","readOnly":true},"comment":{"type":"string","description":"comment","readOnly":true},"locked":{"type":"boolean","description":"locked","readOnly":true},"revertable":{"type":"boolean","description":"revertable","readOnly":true},"recordReferenceNumber":{"type":"string","description":"record reference number","readOnly":true},"dunningLvl":{"type":"integer","format":"int32","description":"Mahnstufe","readOnly":true},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseAmount":{"type":"number","description":"Buchungsbetrag in Basiswährung"},"baseDiscountAmount":{"type":"number","description":"Abzugsbetrag in Basiswährung"},"baseTotalAmount":{"type":"number","description":"Gesamtbetrag in Basiswährung"},"baseDiscountableAmount":{"type":"number","description":"Skontierbarer Gesamtbetrag in Basiswährung"},"baseDunningFee":{"type":"number","description":"Mahngebühren in Basiswährung"},"baseDunningInterest":{"type":"number","description":"Mahnzinsen in Basiswährung"}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-finance-OpenItemPaymentPlan":{"description":"Zahlungsplan","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"paymentPlanType":{"type":"string","description":"Zahlungsplantyp","enum":["RULE","MANUAL"]},"dueDateCalculation":{"type":"string","description":"Fälligkeitsregel"},"amount":{"type":"number","description":"Betrag"},"startDate":{"type":"string","format":"date","description":"Startdatum"},"endDate":{"type":"string","format":"date","description":"Enddatum"},"description":{"type":"string","description":"Beschreibung"},"active":{"type":"boolean","description":"Aktiv"},"dueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"manualRuleEntries":{"type":"array","description":"manuelle Buchungsvorgaben","items":{"$ref":"#/components/schemas/erp-finance-PaymentPlanManualRule"}},"currencyCode":{"type":"string","description":"Währung des Zahlungsplans (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des Zahlungsplans (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}},"erp-finance-PaymentPlanManualRule":{"description":"manuelle Buchungsvorgaben","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"dueDate":{"type":"string","format":"date","description":"Fälligkeit"},"amount":{"type":"number","description":"Betrag"},"processed":{"type":"boolean","description":"bereits verarbeitet","readOnly":true},"currencyCode":{"type":"string","description":"Währung (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}}}}}
```

## POST /erp/finance/openitems/create\_op\_from\_transaction

> Erzeugt einen OP aus einer Zahlung heraus

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/create_op_from_transaction":{"post":{"tags":["OpenItem"],"description":"Erzeugt einen OP aus einer Zahlung heraus","operationId":"createFromTransaction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-finance-TransactionToOpenItemRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"erp-finance-TransactionToOpenItemRequest":{"properties":{"transactionId":{"type":"integer","format":"int64","description":"Die ID eines Bankumsatzes"},"accountId":{"type":"integer","format":"int64","description":"Die ID eines Accounts, der einen neuen OP bekommen soll"},"paymentMethodId":{"type":"integer","format":"int64","description":"Die ID einer Zahlungsmethode, die im OP vermerkt werden soll"},"bookingAccountType":{"type":"string","description":"Buchung über Kunde oder Lieferant","enum":["CUSTOMER","SUPPLIER","AUTOMATIC"]}}},"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```

## GET /erp/finance/openitems/{refId}/workflow-state

> Liefert den Status der aktuellen Workflow-Instanz zu der gegebenen Referenz

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{refId}/workflow-state":{"get":{"tags":["OpenItem"],"summary":"Liefert den Status der aktuellen Workflow-Instanz zu der gegebenen Referenz","operationId":"getWorkflowState","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow-Instanz gefunden","content":{"*/*":{"schema":{"type":"string","description":"Status einer Workflow-Instanz","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]}}}},"404":{"description":"Es existiert noch keine Workflow-Instanz","content":{"*/*":{"schema":{"type":"string","description":"Status einer Workflow-Instanz","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]}}}}}}}}}
```

## GET /erp/finance/openitems/{refId}/workflow-instances-preset

> Liefert ein Query-Preset zur Selektion aller Workflow-Instanzen zu der gegebenen Referenz

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{refId}/workflow-instances-preset":{"get":{"tags":["OpenItem"],"summary":"Liefert ein Query-Preset zur Selektion aller Workflow-Instanzen zu der gegebenen Referenz","operationId":"getWorkflowInstancesPreset","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow-Instanz gefunden","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-cunit-QueryPreset"}}}}}}}},"components":{"schemas":{"common-cunit-QueryPreset":{"description":"Adhoc Preset","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"mode":{"type":"string","default":"QUERY","description":"Was kann mit diesem Preset abgebildet werden QUERY oder STATEMENT","enum":["QUERY","STATEMENT"]},"templateId":{"type":"string","description":"template dem dieser filter zugeordnet worden ist."},"templateGroupKey":{"type":"string","description":"templateGroupKey dem dieser filter zugeordnet worden ist."},"label":{"type":"string","description":"label für diesen filter"},"uiPayload":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"variables":{"type":"array","description":"Variablen für dieses Preset","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetVariable"}},"queryStatement":{"type":"string","description":"bei mode == STATEMENT, das vql-query"},"queryPredicate":{"$ref":"#/components/schemas/common-cunit-QueryPresetPredicate"},"results":{"type":"array","description":"ergebnisse","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"}},"sortAndOrders":{"type":"array","description":"sortierung","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetSortOrder"}},"pageable":{"$ref":"#/components/schemas/common-cunit-QueryPresetPageable"},"option":{"$ref":"#/components/schemas/common-cunit-QueryPresetOption"},"transformations":{"type":"array","description":"zusätzliche konfigurationen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetTransformation"}},"arithmeticQueryTerms":{"type":"array","description":"Arithmetische Terme - hier kommt die tatsächliche Berechnung rein","items":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTerm"}},"definition":{"type":"array","description":"spaltenbeschreibung dieser zelle (bei verschachtelung)","items":{"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuAttribute"},{"$ref":"#/components/schemas/core-cunit-CuMeta"}]},"readOnly":true},"permissionAggregation":{"$ref":"#/components/schemas/common-user-ObjectSpecificPermissionAggregation"},"forWorkflow":{"type":"boolean","default":false,"description":"für Workflows vorgesehen"},"userOptions":{"$ref":"#/components/schemas/common-cunit-QueryPresetUserOptions"}},"required":["forWorkflow","label","mode","permissionAggregation","templateGroupKey","templateId"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"},"common-cunit-QueryPresetVariable":{"description":"Die zu ersetzende Variable","properties":{"path":{"type":"string","description":"Der pfad, der dieses Attribut eindeutig beschreibt"},"definition":{"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuAttribute"},{"$ref":"#/components/schemas/core-cunit-CuMeta"}],"readOnly":true},"mandatory":{"type":"boolean","description":"Ob die Variable ein Pflichtfeld ist oder nicht"},"variableName":{"type":"string","description":"Name der Variablen"},"visible":{"type":"boolean","default":true,"description":"Handelt es sich um eine sichtbare Variable?"},"alignX":{"type":"integer","format":"int32","description":"Anordnung im UI - X-Koordinate"},"alignY":{"type":"integer","format":"int32","description":"Anordnung im UI - Y-Koordinate"},"alignWidth":{"type":"integer","format":"int32","description":"Anordnung im UI - Breite"},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"allowDialogMultipleChoice":{"type":"boolean","default":false,"description":"Kann eine Mehrfachauswahl erfolgen?"}}},"core-cunit-CuAttribute":{"allOf":[{"$ref":"#/components/schemas/core-cunit-MetaContent"},{"type":"object","properties":{"attribute":{"type":"string","description":"name des attributes der das ergebnis enthält"},"path":{"type":"string","description":"der pfad, der dieses attribut eindeutig beschreibt"},"displayName":{"type":"string","description":"der Name dieses Feldes"},"displayNameOverride":{"type":"boolean","default":false,"description":"der Name dieses Feldes wurde überschrieben (alias oder funktion)"},"groupDisplayName":{"type":"string","description":"der Name der Gruppe, dieses Feldes"},"parentDisplayName":{"type":"string","description":"der Name des Referenzierenden Feldes"},"resultable":{"type":"boolean","default":true,"description":"kann dieses Feld ein Ergebnisfeld sein"},"filterable":{"type":"boolean","default":true,"description":"kann nach diesem feld gefiltert werden"},"sortable":{"type":"boolean","default":true,"description":"ist dieses Feld sortierbar"},"visible":{"type":"boolean","default":true,"description":"soll dieses Feld angezeigt werden"},"functions":{"type":"array","description":"angewendete funktionen (wenn das als Result MetaData verwendet wird)","items":{"type":"string","description":"angewendete funktionen (wenn das als Result MetaData verwendet wird)"}},"sortDirection":{"type":"string","description":"Info, wie diese spalte sortiert worden ist"},"constraint":{"$ref":"#/components/schemas/core-cunit-CuAttributeConstraint"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"data-type-identifier für dieses Attribut (falls dataType leer ist)","readOnly":true},"modelType":{"type":"string","description":"Attribut gehört zum Modelltyp 'statisch' oder 'dynamisch'","enum":["STATIC","DYNAMIC"],"readOnly":true},"headers":{"type":"array","description":"bei einem gruppierten Header (e.g. CrossTable) werden hier die einzelnen gruppen beschrieben","items":{"$ref":"#/components/schemas/core-cunit-CuAttribute.HeaderGroup"},"readOnly":true}}}]},"core-cunit-MetaContent":{"description":"Definition dieser Variable","discriminator":{"propertyName":"_type"},"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuMeta"},{"$ref":"#/components/schemas/core-cunit-CuAttribute"}],"properties":{"_type":{"type":"string"}},"required":["_type"]},"core-cunit-CuMeta":{"allOf":[{"$ref":"#/components/schemas/core-cunit-MetaContent"},{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/core-cunit-CuAttribute"},"value":{"type":"array","description":"spaltenbeschreibung dieser zelle (bei verschachtelung)","items":{"oneOf":[{"$ref":"#/components/schemas/core-cunit-CuAttribute"},{"$ref":"#/components/schemas/core-cunit-CuMeta"}]}}}},{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/core-cunit-CuAttribute"}}}]},"core-cunit-CuAttributeConstraint":{"description":"constraints für dieses Attribut","properties":{"minLength":{"type":"integer","format":"int32","description":"Minimal-Länge (von Zeichenketten oder Arrays)","readOnly":true},"maxLength":{"type":"integer","format":"int32","description":"Maximal-Länge (von Zeichenketten oder Arrays)","readOnly":true},"minValue":{"type":"integer","format":"int64","description":"minimaler Wert","readOnly":true},"includeMinValue":{"type":"boolean","description":"ist der minimale Wert inklusive?","readOnly":true},"maxValue":{"type":"integer","format":"int64","description":"maximaler Wert","readOnly":true},"includeMaxValue":{"type":"boolean","description":"ist der maximale Wert inklusive?","readOnly":true},"notNull":{"type":"boolean","default":false,"description":"ist der Wert 'null' verboten?","readOnly":true},"notBlank":{"type":"boolean","description":"Bei Strings: ist ein String nur aus Whitespace verboten?","readOnly":true}}},"core-cunit-CuAttributeDataType":{"description":"data-type für dieses Attribut (falls dataTypeIdentifier leer ist)","properties":{"identifier":{"type":"string","description":"Datentyp-identifier","readOnly":true},"jsType":{"type":"string","description":"welcher Typ ist es","readOnly":true},"objectRefIdentifier":{"type":"string","description":"bei Object_Ref: welcher Typ ist es genau","readOnly":true},"filterOptions":{"$ref":"#/components/schemas/core-cunit-CuAttributeFilterOptions"},"functions":{"type":"array","description":"welche Funktionen sind erlaubt?","items":{"type":"string","description":"welche Funktionen sind erlaubt?"},"readOnly":true},"predicateOperations":{"type":"array","description":"welche Operations sind erlaubt?","items":{"type":"string","description":"welche Operations sind erlaubt?","enum":["AND","OR","EQUALS","NOT_EQUALS","LIKE","NOT_LIKE","STARTS_WITH","ENDS_WITH","CONTAINS","NOT_CONTAINS","GREATER_THAN","GREATER_THAN_EQUALS","LESS_THAN","LESS_THAN_EQUALS","IN","NOT_IN","RANGE","NOT_RANGE","IS_NULL","IS_NOT_NULL","IS_NULL_OR_EQUALS","EXISTS","NOT_EXISTS"]},"readOnly":true}}},"core-cunit-CuAttributeFilterOptions":{"description":"CUnit Attribut Filter Optionen","properties":{"filterValues":{"type":"array","description":"Mögliche Filterwerte","items":{"type":"string","description":"Mögliche Filterwerte"}},"filterDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"multipleChoice":{"type":"boolean","default":false,"description":"Kann eine Mehrfachauswahl erfolgen?"}}},"core-cunit-CuAttribute.HeaderGroup":{"description":"bei einem gruppierten Header (e.g. CrossTable) werden hier die einzelnen gruppen beschrieben","properties":{"displayName":{"type":"string","description":"der Name dieses Feldes"},"displayNameOverride":{"type":"boolean","default":false,"description":"der Name dieses Feldes wurde überschrieben (alias oder funktion)"},"dataType":{"$ref":"#/components/schemas/core-cunit-CuAttributeDataType"},"dataTypeIdentifier":{"type":"string","description":"data-type-identifier für dieses Attribut (falls dataType leer ist)","readOnly":true},"groupDisplayName":{"type":"string","description":"der Name der Gruppe, dieses Feldes"},"data":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}}},"common-cunit-QueryPresetPredicate":{"description":"Bedingungen zur Selektion von Lagerplätzen","properties":{"type":{"type":"string","description":"die Operation für diesen Filter","enum":["JUNCTION","FILTER"]},"operator":{"type":"string","description":"operator","enum":["AND","OR","EQUALS","NOT_EQUALS","LIKE","NOT_LIKE","STARTS_WITH","ENDS_WITH","CONTAINS","NOT_CONTAINS","GREATER_THAN","GREATER_THAN_EQUALS","LESS_THAN","LESS_THAN_EQUALS","IN","NOT_IN","RANGE","NOT_RANGE","IS_NULL","IS_NOT_NULL","IS_NULL_OR_EQUALS","EXISTS","NOT_EXISTS"]},"children":{"type":"array","description":"(bei junction) child-definitionen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetPredicate"}},"property":{"type":"string","description":"filter property"},"values":{"type":"array","description":"filter werte","items":{"type":"string","description":"filter werte"}},"visible":{"type":"boolean","default":true,"description":"Sichtbarkeit bei Variablen"},"functions":{"type":"array","description":"Eine SQL-Funktion, die im Predicate angewendet wird","items":{"type":"string","description":"Eine SQL-Funktion, die im Predicate angewendet wird"}}},"required":["operator","type"]},"common-cunit-QueryPresetResult":{"description":"Ergebnisse","properties":{"property":{"type":"string","description":"property"},"displayName":{"type":"string","description":"title dieser spalte"},"functions":{"type":"array","description":"funktionen","items":{"type":"string","description":"funktionen"}},"visible":{"type":"boolean","default":true,"description":"sichtbare Ergebnisspalte"}},"required":["property"]},"common-cunit-QueryPresetSortOrder":{"description":"sort and order anweisungen","properties":{"property":{"type":"string","description":"property"},"functions":{"type":"array","description":"Functions","items":{"type":"string","description":"Functions"}},"direction":{"type":"string","description":"sort order","enum":["ASC","DESC"]}},"required":["direction","property"]},"common-cunit-QueryPresetPageable":{"description":"pageable","properties":{"limit":{"type":"integer","format":"int64","description":"das Limit (MaxRecordCount) für diesen Query"}}},"common-cunit-QueryPresetOption":{"description":"options","properties":{"distinctResult":{"type":"boolean","description":"soll der Query mit einem Distinct durchgeführt werden"}}},"common-cunit-QueryPresetTransformation":{"description":"zusätzliche konfigurationen","properties":{"crossTable":{"$ref":"#/components/schemas/common-cunit-QueryPresetCrossTableTransformation"}}},"common-cunit-QueryPresetCrossTableTransformation":{"description":"enthält die felder, die in einer cross-table für die reihenbildung verantwortlich sind (im grunde -> der group-key)","properties":{"rowSpecs":{"type":"array","description":"enthält die felder, die in einer cross-table für die reihenbildung verantwortlich sind (im grunde -> der group-key)","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"}},"columnSpecs":{"type":"array","description":"enthält die felder, die in der cross-table als dynamische spalten erstellt werden sollen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"}},"results":{"type":"array","description":"enthält die felder, die pro rowSpec-Kombination je nach Spaltenausprägung ermittelt werden sollen","items":{"$ref":"#/components/schemas/common-cunit-QueryPresetCrossTableTransformation.QueryPresetCrossTableCell"}}},"required":["columnSpecs","results","rowSpecs"]},"common-cunit-QueryPresetCrossTableTransformation.QueryPresetCrossTableCell":{"description":"enthält die felder, die pro rowSpec-Kombination je nach Spaltenausprägung ermittelt werden sollen","properties":{"result":{"$ref":"#/components/schemas/common-cunit-QueryPresetResult"},"cellView":{"type":"string","description":"darstellung der werte","enum":["AS_IS","PERCENT_COL"]},"sumColumn":{"type":"boolean","default":false,"description":"soll eine spaltensumme erzeugt werden"},"rowMode":{"type":"string","description":"soll eine zeilensumme erzeugt werden","enum":["DATA","DATA_AND_TOTAL","TOTAL"]},"aggregateFunction":{"type":"string","description":"die funktion mit der die werte der Zelle aggregiert werden"}}},"common-cunit-ArithmeticQueryTerm":{"description":"Arithmetische Terme - hier kommt die tatsächliche Berechnung rein","properties":{"termName":{"type":"string","description":"Der Name des Terms für die Verarbeitung und Darstellung"},"terms":{"type":"array","description":"Die inneren Terme - entweder Verweise auf Attribute oder weitere Verschachtelungen der Berechnung","items":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTermInner"}},"operations":{"type":"array","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","items":{"type":"string","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","enum":["PLUS","MINUS","MULTIPLY","DIVIDE"]}}}},"common-cunit-ArithmeticQueryTermInner":{"description":"Die inneren Terme - entweder Verweise auf Attribute oder weitere Verschachtelungen der Berechnung","properties":{"fragment":{"$ref":"#/components/schemas/common-cunit-ArithmeticQueryTermFragment"},"attribute":{"type":"string","description":"Ein echtes Attribut aus dem Template"},"fixedValue":{"type":"number","description":"Ein Fixwert"}}},"common-cunit-ArithmeticQueryTermFragment":{"description":"Das Termfragment - eine weitere Verschachtelung mit eigenen Operationen","properties":{"operations":{"type":"array","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","items":{"type":"string","description":"Die Operationen, die ausgeführt werden sollen mit den Termen","enum":["PLUS","MINUS","MULTIPLY","DIVIDE"]}}}},"common-user-ObjectSpecificPermissionAggregation":{"description":"alle Nutzer-/Gruppen-Berechtigungen","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"userPermissions":{"type":"array","description":"Nutzer-Berechtigungen","items":{"$ref":"#/components/schemas/common-user-ObjectSpecificUserPermission"}},"groupPermissions":{"type":"array","description":"Gruppen-Berechtigungen","items":{"$ref":"#/components/schemas/common-user-ObjectSpecificGroupPermission"}},"operationForAllUsers":{"type":"string","description":"Zugriffsrechte für alle Nutzer","enum":["READ_ONLY","READ_AND_EDIT"]}}},"common-user-ObjectSpecificUserPermission":{"description":"Nutzer-Berechtigungen","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"userRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"operation":{"type":"string","description":"Berechtigung","enum":["READ_ONLY","READ_AND_EDIT"]}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"common-user-ObjectSpecificGroupPermission":{"description":"Gruppen-Berechtigungen","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"groupRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"operation":{"type":"string","description":"Berechtigung","enum":["READ_ONLY","READ_AND_EDIT"]}}},"common-cunit-QueryPresetUserOptions":{"description":"nutzerbezogene Einstellungen","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"pinned":{"type":"boolean","default":false,"description":"angepinnt?"}},"required":["pinned"]}}}}
```

## GET /erp/finance/openitems/{refId}/latest-workflow-instance

> Liefert die neuste Workflow-Instanz zu der gegebenen Referenz

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{refId}/latest-workflow-instance":{"get":{"tags":["OpenItem"],"summary":"Liefert die neuste Workflow-Instanz zu der gegebenen Referenz","operationId":"getLatestWorkflowInstance","parameters":[{"name":"refId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"Workflow-Instanz gefunden","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-workflow-WorkflowInstance"}}}},"404":{"description":"Es existiert noch keine Workflow-Instanz","content":{"*/*":{"schema":{"$ref":"#/components/schemas/common-workflow-WorkflowInstance"}}}}}}}},"components":{"schemas":{"common-workflow-WorkflowInstance":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"state":{"type":"string","description":"Status einer Workflow-Instanz","enum":["CREATED","IN_PROCESS","COMPLETED_SUCCESSFULLY","COMPLETED_WITH_FAILURE","ERRONEOUS","ABORTED_CRASHED","ABORTED_MANUALLY","CRASHED","WAITING","INTERRUPTED"]},"workflowRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"workItems":{"type":"array","description":"Schritte des Workflows","items":{"$ref":"#/components/schemas/common-workflow-WorkItem"}},"logEntries":{"type":"array","description":"Logging-Einträge chronologisch sortiert","items":{"$ref":"#/components/schemas/common-workflow-WorkflowInstanceLogLine"}}}},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"common-workflow-WorkItem":{"description":"Schritte des Workflows","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"state":{"type":"string","description":"Bearbeitungszustand eines Work-Items","enum":["OPEN","IN_PROCESS","COMPLETED","ERRONEOUS","ABORTED"]},"workflowElementRef":{"type":"integer","format":"int64","description":"Workflow-Element, das abgebildet wird"},"parentWorkItemRef":{"type":"integer","format":"int64","description":"Work-Item im übergeordneten Workflow, wenn es sich um einen Unter-Workflow handelt"},"responsibleUserRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"logEntries":{"type":"array","description":"Logging-Einträge chronologisch sortiert","items":{"$ref":"#/components/schemas/common-workflow-WorkflowInstanceLogLine"}},"splitResult":{"type":"string","description":"Für Split-Gateways: mit welchem Ergebnis wurde dieses Work-Item ausgeführt"}}},"common-workflow-WorkflowInstanceLogLine":{"description":"Logging-Einträge chronologisch sortiert","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"workflowInstanceId":{"type":"integer","format":"int64","description":"ID der Workflow-Instanz"},"workItemId":{"type":"integer","format":"int64","description":"ID des Work-Items"},"logTime":{"type":"string","format":"date-time","description":"Zeitstempel"},"origin":{"type":"string","description":"Wodurch wurde dieser Eintrag ausgelöst","enum":["DEBUG","INFO","WARNING","ERROR","CONSOLE","STACKTRACE"]},"message":{"type":"string","description":"Nachricht"},"messageKey":{"type":"string","description":"I18n-Key"},"propertyPath":{"type":"string","description":"Pfad"},"messageParameter":{"type":"object","additionalProperties":{"type":"object","description":"Parameter für die I18n-Nachricht"},"description":"Parameter für die I18n-Nachricht"}}}}}}
```

## GET /erp/finance/openitems/{id}

> Find an existing Resource by identifier

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/{id}":{"get":{"tags":["OpenItem"],"summary":"Find an existing Resource by identifier","operationId":"getById_35","parameters":[{"name":"id","in":"path","description":"an identifier","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"successful operation","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-finance-OpenItem"}}}},"404":{"description":"Resource with given ID was not found","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-error-ApiError"}}}}}}}},"components":{"schemas":{"erp-finance-OpenItem":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"order":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"invoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"creditNote":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"depositInvoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"account":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"number":{"type":"string","description":"OP-Nummer","readOnly":true},"externalNumber":{"type":"string","description":"Externe OP-Nummer ","readOnly":true},"depositPaymentAmount":{"type":"number","description":"agreed Deposit payment amount","readOnly":true},"depositPaymentDate":{"type":"string","format":"date","description":"agreed Deposit payment date","readOnly":true},"depositPayed":{"type":"boolean","default":false,"description":"is the agreed deposit payed?","readOnly":true},"balancedDate":{"type":"string","format":"date","description":"balanced date of this open item (calculated)","readOnly":true},"balanceState":{"type":"string","description":"whether this open item is balanced, partially paid or open","enum":["OPEN","PARTIALLY_BALANCED","BALANCED","OVERPAID"],"readOnly":true},"balance":{"type":"number","description":"saldo","readOnly":true},"sumPayments":{"type":"number","description":"Summe gebuchte Zahlungen","readOnly":true},"sumDunnings":{"type":"number","description":"Summe Mahngebühren und Zinsen","readOnly":true},"sumTotalAmount":{"type":"number","description":"Rechnungsbetrag","readOnly":true},"sumDiscountableAmount":{"type":"number","description":"skontierbarer Rechnungsbetrag","readOnly":true},"sumFee":{"type":"number","description":"allgemeine Gebühren","readOnly":true},"records":{"type":"array","description":"free payments","items":{"$ref":"#/components/schemas/erp-finance-OpenItemRecord"},"readOnly":true},"basisPaymentTermRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentDays1":{"type":"integer","format":"int32","description":"How many days are given for using the first discount rule","readOnly":true},"paymentDiscount1":{"type":"number","description":"How much discount can be given for speedy payment, rule 1","readOnly":true},"paymentDiscount1DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto1)","readOnly":true},"paymentDays2":{"type":"integer","format":"int32","description":"How many days are given for using the second discount rule","readOnly":true},"paymentDiscount2":{"type":"number","description":"How much discount can be given for speedy payment, rule 2","readOnly":true},"paymentDiscount2DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto2)","readOnly":true},"qualifier":{"type":"string","description":"Does this open item belong to accounts payable or accounts receivable","enum":["PAYABLE","RECEIVABLE"],"readOnly":true},"fullPaymentAmount":{"type":"number","description":"The full amount of the payment","readOnly":true},"paymentAmount":{"type":"number","description":"Der momentan gültige zu zahlende Betrag","readOnly":true},"paymentKind":{"type":"string","description":"The kind of payment","enum":["PREPAYMENT","PAYMENT"],"readOnly":true},"refundType":{"type":"string","description":"how should a refund be done?","enum":["DISBURSE","OFFSET_LATER"]},"dunningBlock":{"type":"boolean","default":false,"description":"Mahnsperre"},"paymentState":{"type":"string","description":"Der Zustand der Zahlung","enum":["NO_PAYMENT","PAYMENT_CREATED","PAYMENT_TRANSFERRED","PAYMENT_COMMITTED"]},"dunningState":{"type":"string","description":"Der Mahnzustand","enum":["IN_DUNNING","NO_DUNNING","DUNNING_PAID","DUNNING_PARTIALLY_PAID","DUNNING_OVERPAID"]},"dunningLevel":{"type":"integer","format":"int32","description":"Die Mahnstufe","readOnly":true},"dunningCount":{"type":"integer","format":"int32","description":"Anzahl Mahnpositionen/Mahnungen für diesen OP","readOnly":true},"originalPaymentDueDate":{"type":"string","format":"date","description":"Ursprüngliches Fälligkeitsdatum","readOnly":true},"paymentDaysNet":{"type":"integer","format":"int32","description":"Fälligkeit in Tagen"},"paymentDueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"valueDate":{"type":"string","format":"date","description":"Valutadatum"},"paymentDiscount1Amount":{"type":"number","description":"Skontobetrag 1"},"paymentDiscount2Amount":{"type":"number","description":"Skontobetrag 2"},"paymentTemplateRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"purpose":{"type":"string","description":"Verwendungszweck"},"comment":{"type":"string","description":"Kommentar"},"paymentBlock":{"type":"boolean","default":false,"description":"Zahlungssperre"},"tags":{"type":"array","description":"List of tags","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"paymentPlan":{"$ref":"#/components/schemas/erp-finance-OpenItemPaymentPlan"},"valueDateReadOnly":{"type":"boolean","default":false,"description":"Valutadatum schreibgeschützt"},"canBeReopened":{"type":"boolean","default":false,"description":"kann wiedereröffet werden"},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseDepositPaymentAmount":{"type":"number","description":"Vereinbarter Anzahlungsbetrag in Basiswährung"},"baseSumPayments":{"type":"number","description":"Summe der Zahlungen in Basiswährung"},"baseSumDiscount":{"type":"number","description":"Summe der Abzüge (Skonto usw.) in Basiswährung"},"baseSumDunnings":{"type":"number","description":"Summe der Mahngebühren und Zinsen in Basiswährung"},"baseSumTotalAmount":{"type":"number","description":"Gesamtsumme der Rechnungsbeträge in Basiswährung"},"baseSumDiscountableAmount":{"type":"number","description":"Summe der skontierbaren Rechnungsbeträge in Basiswährung"},"baseBalance":{"type":"number","description":"Offener Betrag (Saldo) in Basiswährung"},"baseSumFee":{"type":"number","description":"allgemeine Gebühren in Basiswährung"},"blockedByDocument":{"type":"boolean","default":false,"description":"Ist der OP durch ein Dokument geblockt?"},"bookingAccountType":{"type":"string","description":"Buchung auf Lieferant oder Kunde bei manuellen OPs","enum":["CUSTOMER","SUPPLIER","AUTOMATIC"],"readOnly":true},"balanced":{"type":"boolean"}},"required":["number"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"erp-finance-OpenItemRecord":{"description":"free payments","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"recordDate":{"type":"string","format":"date","description":"record date","readOnly":true},"totalAmount":{"type":"number","description":"record total amount","readOnly":true},"discountableAmount":{"type":"number","description":"record discountable amount","readOnly":true},"amount":{"type":"number","description":"record amount","readOnly":true},"discountAmount":{"type":"number","description":"record discount amount","readOnly":true},"bookingRecordId":{"type":"integer","format":"int64","description":"ref to the financialBookingRecord","readOnly":true},"origin":{"type":"string","description":"origin for this record","enum":["DOCUMENT","PAYMENT","PAYMENT_DISSOLVED","REIMBURSEMENT","REIMBURSEMENT_DISSOLVED","MANUAL_CLOSURE","MANUAL_REOPENING","DUNNING","DUNNING_DISSOLVED","DUNNING_INTEREST_REVERSAL","IMPORT","PAYMENT_PLAN","PAYMENT_PLAN_ENTRY","PAYMENT_IMPORT","CLEARING","DEPOSIT","CREDIT_NOTE","BALANCE_ADJUSTMENT","FEE","DUNNING_PAYMENT","DUNNING_PAYMENT_DISSOLVED","POS_PAYMENT"],"readOnly":true},"document":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethod":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accountBankdetailsRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"transactionRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"bankAccountRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"businessTransaction":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"revertedByRecordId":{"type":"integer","format":"int64","description":"id des records, der diesen storniert hat","readOnly":true},"transactionId":{"type":"integer","format":"int64","description":"id der transaction, die diesen record hervorgerufen hat","readOnly":true},"qualifier":{"type":"string","description":"qualifier of open item","enum":["PAYABLE","RECEIVABLE","PAYMENT_RECEIVED","PAYMENT_SENT","PAYMENT_RECEIVED_REVERTED","PAYMENT_SENT_REVERTED","DUNNING_RECEIVABLE","DUNNING_PAYABLE","DUNNING_RECEIVABLE_REVERTED","DUNNING_PAYABLE_REVERTED"],"readOnly":true},"number":{"type":"string","description":"Eine Vorgangsnummer die zur Buchung führte","readOnly":true},"comment":{"type":"string","description":"comment","readOnly":true},"locked":{"type":"boolean","description":"locked","readOnly":true},"revertable":{"type":"boolean","description":"revertable","readOnly":true},"recordReferenceNumber":{"type":"string","description":"record reference number","readOnly":true},"dunningLvl":{"type":"integer","format":"int32","description":"Mahnstufe","readOnly":true},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseAmount":{"type":"number","description":"Buchungsbetrag in Basiswährung"},"baseDiscountAmount":{"type":"number","description":"Abzugsbetrag in Basiswährung"},"baseTotalAmount":{"type":"number","description":"Gesamtbetrag in Basiswährung"},"baseDiscountableAmount":{"type":"number","description":"Skontierbarer Gesamtbetrag in Basiswährung"},"baseDunningFee":{"type":"number","description":"Mahngebühren in Basiswährung"},"baseDunningInterest":{"type":"number","description":"Mahnzinsen in Basiswährung"}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-finance-OpenItemPaymentPlan":{"description":"Zahlungsplan","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"paymentPlanType":{"type":"string","description":"Zahlungsplantyp","enum":["RULE","MANUAL"]},"dueDateCalculation":{"type":"string","description":"Fälligkeitsregel"},"amount":{"type":"number","description":"Betrag"},"startDate":{"type":"string","format":"date","description":"Startdatum"},"endDate":{"type":"string","format":"date","description":"Enddatum"},"description":{"type":"string","description":"Beschreibung"},"active":{"type":"boolean","description":"Aktiv"},"dueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"manualRuleEntries":{"type":"array","description":"manuelle Buchungsvorgaben","items":{"$ref":"#/components/schemas/erp-finance-PaymentPlanManualRule"}},"currencyCode":{"type":"string","description":"Währung des Zahlungsplans (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des Zahlungsplans (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}},"erp-finance-PaymentPlanManualRule":{"description":"manuelle Buchungsvorgaben","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"dueDate":{"type":"string","format":"date","description":"Fälligkeit"},"amount":{"type":"number","description":"Betrag"},"processed":{"type":"boolean","description":"bereits verarbeitet","readOnly":true},"currencyCode":{"type":"string","description":"Währung (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}},"core-error-ApiError":{"properties":{"instance":{"type":"string","description":"the resource that produced the error","readOnly":true},"trackingId":{"type":"string","description":"Internal tracking number for this Error","readOnly":true},"timeOfOccurence":{"type":"string","format":"date-time","description":"Internal timestamp, when this error happened","readOnly":true},"errors":{"$ref":"#/components/schemas/core-error-ApiError.Errors"},"decisions":{"type":"array","description":"all decisions, we need to take care of","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision"},"readOnly":true,"uniqueItems":true},"httpStatus":{"type":"integer","format":"int32","description":"HTTP-Status code"},"debug-info-url":{"type":"string","format":"uri","description":"optional url to get a more detailed stack trace","readOnly":true}},"required":["decisions","errors","instance","timeOfOccurence","trackingId"]},"core-error-ApiError.Errors":{"description":"all occured errors","properties":{"fieldErrors":{"type":"object","additionalProperties":{"type":"array","description":"One or more validation errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true},"description":"One or more validation errors","readOnly":true},"services":{"type":"array","description":"One or more generel service errors","items":{"$ref":"#/components/schemas/core-error-ApiErrorDetail"},"readOnly":true,"uniqueItems":true}},"readOnly":true,"required":["fieldErrors","services"]},"core-error-ApiErrorDetail":{"description":"One or more generel service errors","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"property":{"type":"string","description":"property that has a constraint violation  (optional)"}},"readOnly":true},"core-api-LocalizeableMessage":{"description":"localizeable message","properties":{"messageCode":{"type":"string","description":"Internal unique identifier/key for this message"},"messageParameters":{"type":"object","additionalProperties":{"type":"object","description":"list of parameters to fill a formattable message"},"description":"list of parameters to fill a formattable message"},"formattedMessage":{"type":"string","description":"formatted message (default language)"}}},"core-error-ApiErrorDecision":{"description":"all decisions, we need to take care of","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"title":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"multipleAnswersAllowed":{"type":"boolean","default":false,"description":"true, if an array of answers is required","readOnly":true},"textInput":{"type":"boolean","default":false,"description":"true, if text input instead of decisions is required","readOnly":true},"options":{"type":"array","description":"possible options for this decision","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOption"},"readOnly":true},"answerProperty":{"type":"string","description":"property to fill the decision into","readOnly":true},"answerPropertyType":{"type":"string","description":"type of the target property","enum":["FIELD","PARAMETER"],"readOnly":true},"searchDialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"}},"readOnly":true},"core-error-ApiErrorDecision.DecisionOption":{"description":"possible options for this decision","properties":{"message":{"$ref":"#/components/schemas/core-api-LocalizeableMessage"},"value":{"type":"string","description":"value for this decision","readOnly":true},"defaultOption":{"type":"boolean","default":false,"description":"default option","readOnly":true},"searchDialogs":{"type":"array","description":"Zu verwendende Search-Dialogs","items":{"$ref":"#/components/schemas/core-error-ApiErrorDecision.DecisionOptionSearchDialog"},"readOnly":true}}},"core-error-ApiErrorDecision.DecisionOptionSearchDialog":{"description":"Zu verwendende Search-Dialogs","properties":{"dialog":{"$ref":"#/components/schemas/unknownservice-unknownmodule-JsonNode"},"answerKey":{"type":"string","description":"Schlüssel für das Ergebnis vom Search-Dialog","readOnly":true}}},"unknownservice-unknownmodule-JsonNode":{"description":"Search-Dialog"}}}}
```

## GET /erp/finance/openitems/selector

> select the OpenItems with different parameter

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.20.4"},"tags":[{"name":"OpenItem","description":"the Finance OpenItem API"}],"servers":[{"url":"http://10.102.25.252:32790/api","description":"Generated server url"}],"paths":{"/erp/finance/openitems/selector":{"get":{"tags":["OpenItem"],"description":"select the OpenItems with different parameter","operationId":"findAllBySelector","parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"balanced","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"documentId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"accountId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"documentQualifier","in":"query","required":false,"schema":{"type":"string","enum":["PAYABLE","RECEIVABLE"]}},{"name":"bookingRecordId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/erp-finance-OpenItem"}}}}}}}}},"components":{"schemas":{"erp-finance-OpenItem":{"properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"order":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"invoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"creditNote":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"depositInvoice":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"account":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"number":{"type":"string","description":"OP-Nummer","readOnly":true},"externalNumber":{"type":"string","description":"Externe OP-Nummer ","readOnly":true},"depositPaymentAmount":{"type":"number","description":"agreed Deposit payment amount","readOnly":true},"depositPaymentDate":{"type":"string","format":"date","description":"agreed Deposit payment date","readOnly":true},"depositPayed":{"type":"boolean","default":false,"description":"is the agreed deposit payed?","readOnly":true},"balancedDate":{"type":"string","format":"date","description":"balanced date of this open item (calculated)","readOnly":true},"balanceState":{"type":"string","description":"whether this open item is balanced, partially paid or open","enum":["OPEN","PARTIALLY_BALANCED","BALANCED","OVERPAID"],"readOnly":true},"balance":{"type":"number","description":"saldo","readOnly":true},"sumPayments":{"type":"number","description":"Summe gebuchte Zahlungen","readOnly":true},"sumDunnings":{"type":"number","description":"Summe Mahngebühren und Zinsen","readOnly":true},"sumTotalAmount":{"type":"number","description":"Rechnungsbetrag","readOnly":true},"sumDiscountableAmount":{"type":"number","description":"skontierbarer Rechnungsbetrag","readOnly":true},"sumFee":{"type":"number","description":"allgemeine Gebühren","readOnly":true},"records":{"type":"array","description":"free payments","items":{"$ref":"#/components/schemas/erp-finance-OpenItemRecord"},"readOnly":true},"basisPaymentTermRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethodRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentDays1":{"type":"integer","format":"int32","description":"How many days are given for using the first discount rule","readOnly":true},"paymentDiscount1":{"type":"number","description":"How much discount can be given for speedy payment, rule 1","readOnly":true},"paymentDiscount1DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto1)","readOnly":true},"paymentDays2":{"type":"integer","format":"int32","description":"How many days are given for using the second discount rule","readOnly":true},"paymentDiscount2":{"type":"number","description":"How much discount can be given for speedy payment, rule 2","readOnly":true},"paymentDiscount2DueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum (Skonto2)","readOnly":true},"qualifier":{"type":"string","description":"Does this open item belong to accounts payable or accounts receivable","enum":["PAYABLE","RECEIVABLE"],"readOnly":true},"fullPaymentAmount":{"type":"number","description":"The full amount of the payment","readOnly":true},"paymentAmount":{"type":"number","description":"Der momentan gültige zu zahlende Betrag","readOnly":true},"paymentKind":{"type":"string","description":"The kind of payment","enum":["PREPAYMENT","PAYMENT"],"readOnly":true},"refundType":{"type":"string","description":"how should a refund be done?","enum":["DISBURSE","OFFSET_LATER"]},"dunningBlock":{"type":"boolean","default":false,"description":"Mahnsperre"},"paymentState":{"type":"string","description":"Der Zustand der Zahlung","enum":["NO_PAYMENT","PAYMENT_CREATED","PAYMENT_TRANSFERRED","PAYMENT_COMMITTED"]},"dunningState":{"type":"string","description":"Der Mahnzustand","enum":["IN_DUNNING","NO_DUNNING","DUNNING_PAID","DUNNING_PARTIALLY_PAID","DUNNING_OVERPAID"]},"dunningLevel":{"type":"integer","format":"int32","description":"Die Mahnstufe","readOnly":true},"dunningCount":{"type":"integer","format":"int32","description":"Anzahl Mahnpositionen/Mahnungen für diesen OP","readOnly":true},"originalPaymentDueDate":{"type":"string","format":"date","description":"Ursprüngliches Fälligkeitsdatum","readOnly":true},"paymentDaysNet":{"type":"integer","format":"int32","description":"Fälligkeit in Tagen"},"paymentDueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"valueDate":{"type":"string","format":"date","description":"Valutadatum"},"paymentDiscount1Amount":{"type":"number","description":"Skontobetrag 1"},"paymentDiscount2Amount":{"type":"number","description":"Skontobetrag 2"},"paymentTemplateRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"purpose":{"type":"string","description":"Verwendungszweck"},"comment":{"type":"string","description":"Kommentar"},"paymentBlock":{"type":"boolean","default":false,"description":"Zahlungssperre"},"tags":{"type":"array","description":"List of tags","items":{"$ref":"#/components/schemas/common-tag-TagDto"}},"paymentPlan":{"$ref":"#/components/schemas/erp-finance-OpenItemPaymentPlan"},"valueDateReadOnly":{"type":"boolean","default":false,"description":"Valutadatum schreibgeschützt"},"canBeReopened":{"type":"boolean","default":false,"description":"kann wiedereröffet werden"},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseDepositPaymentAmount":{"type":"number","description":"Vereinbarter Anzahlungsbetrag in Basiswährung"},"baseSumPayments":{"type":"number","description":"Summe der Zahlungen in Basiswährung"},"baseSumDiscount":{"type":"number","description":"Summe der Abzüge (Skonto usw.) in Basiswährung"},"baseSumDunnings":{"type":"number","description":"Summe der Mahngebühren und Zinsen in Basiswährung"},"baseSumTotalAmount":{"type":"number","description":"Gesamtsumme der Rechnungsbeträge in Basiswährung"},"baseSumDiscountableAmount":{"type":"number","description":"Summe der skontierbaren Rechnungsbeträge in Basiswährung"},"baseBalance":{"type":"number","description":"Offener Betrag (Saldo) in Basiswährung"},"baseSumFee":{"type":"number","description":"allgemeine Gebühren in Basiswährung"},"blockedByDocument":{"type":"boolean","default":false,"description":"Ist der OP durch ein Dokument geblockt?"},"bookingAccountType":{"type":"string","description":"Buchung auf Lieferant oder Kunde bei manuellen OPs","enum":["CUSTOMER","SUPPLIER","AUTOMATIC"],"readOnly":true},"balanced":{"type":"boolean"}},"required":["number"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"erp-finance-OpenItemRecord":{"description":"free payments","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"recordDate":{"type":"string","format":"date","description":"record date","readOnly":true},"totalAmount":{"type":"number","description":"record total amount","readOnly":true},"discountableAmount":{"type":"number","description":"record discountable amount","readOnly":true},"amount":{"type":"number","description":"record amount","readOnly":true},"discountAmount":{"type":"number","description":"record discount amount","readOnly":true},"bookingRecordId":{"type":"integer","format":"int64","description":"ref to the financialBookingRecord","readOnly":true},"origin":{"type":"string","description":"origin for this record","enum":["DOCUMENT","PAYMENT","PAYMENT_DISSOLVED","REIMBURSEMENT","REIMBURSEMENT_DISSOLVED","MANUAL_CLOSURE","MANUAL_REOPENING","DUNNING","DUNNING_DISSOLVED","DUNNING_INTEREST_REVERSAL","IMPORT","PAYMENT_PLAN","PAYMENT_PLAN_ENTRY","PAYMENT_IMPORT","CLEARING","DEPOSIT","CREDIT_NOTE","BALANCE_ADJUSTMENT","FEE","DUNNING_PAYMENT","DUNNING_PAYMENT_DISSOLVED","POS_PAYMENT"],"readOnly":true},"document":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"paymentMethod":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"accountBankdetailsRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"transactionRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"bankAccountRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"businessTransaction":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"revertedByRecordId":{"type":"integer","format":"int64","description":"id des records, der diesen storniert hat","readOnly":true},"transactionId":{"type":"integer","format":"int64","description":"id der transaction, die diesen record hervorgerufen hat","readOnly":true},"qualifier":{"type":"string","description":"qualifier of open item","enum":["PAYABLE","RECEIVABLE","PAYMENT_RECEIVED","PAYMENT_SENT","PAYMENT_RECEIVED_REVERTED","PAYMENT_SENT_REVERTED","DUNNING_RECEIVABLE","DUNNING_PAYABLE","DUNNING_RECEIVABLE_REVERTED","DUNNING_PAYABLE_REVERTED"],"readOnly":true},"number":{"type":"string","description":"Eine Vorgangsnummer die zur Buchung führte","readOnly":true},"comment":{"type":"string","description":"comment","readOnly":true},"locked":{"type":"boolean","description":"locked","readOnly":true},"revertable":{"type":"boolean","description":"revertable","readOnly":true},"recordReferenceNumber":{"type":"string","description":"record reference number","readOnly":true},"dunningLvl":{"type":"integer","format":"int32","description":"Mahnstufe","readOnly":true},"currencyCode":{"type":"string","description":"Währung des offenen Postens (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des offenen Postens  (ISO-A3)"},"baseAmount":{"type":"number","description":"Buchungsbetrag in Basiswährung"},"baseDiscountAmount":{"type":"number","description":"Abzugsbetrag in Basiswährung"},"baseTotalAmount":{"type":"number","description":"Gesamtbetrag in Basiswährung"},"baseDiscountableAmount":{"type":"number","description":"Skontierbarer Gesamtbetrag in Basiswährung"},"baseDunningFee":{"type":"number","description":"Mahngebühren in Basiswährung"},"baseDunningInterest":{"type":"number","description":"Mahnzinsen in Basiswährung"}}},"common-tag-TagDto":{"description":"List of tags","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"type":{"type":"string","description":"Tag-Typen","enum":["COMMON","ACCOUNT","PRODUCT","DOCUMENT","OPEN_ITEM","CRM_COMMON","CRM_TASK","CRM_DEAL","CRM_PROJECT","DMS_SHELF_DOCUMENT"]},"label":{"type":"string","description":"Beschriftung des Tags"},"color":{"type":"string","description":"Farbe für die Anzeige des Tags"},"editColor":{"type":"string","description":"Farbe in Verwaltungs-GUI"},"searchColor":{"type":"string","description":"Farbe in Such-GUI"},"tagGroup":{"$ref":"#/components/schemas/core-api-ApiCreatableReference"}},"required":["label","type"]},"core-api-ApiCreatableReference":{"description":"Relation type","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label"},"description":{"type":"string","description":"a short description","readOnly":true}}},"erp-finance-OpenItemPaymentPlan":{"description":"Zahlungsplan","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"paymentPlanType":{"type":"string","description":"Zahlungsplantyp","enum":["RULE","MANUAL"]},"dueDateCalculation":{"type":"string","description":"Fälligkeitsregel"},"amount":{"type":"number","description":"Betrag"},"startDate":{"type":"string","format":"date","description":"Startdatum"},"endDate":{"type":"string","format":"date","description":"Enddatum"},"description":{"type":"string","description":"Beschreibung"},"active":{"type":"boolean","description":"Aktiv"},"dueDate":{"type":"string","format":"date","description":"Fälligkeitsdatum"},"manualRuleEntries":{"type":"array","description":"manuelle Buchungsvorgaben","items":{"$ref":"#/components/schemas/erp-finance-PaymentPlanManualRule"}},"currencyCode":{"type":"string","description":"Währung des Zahlungsplans (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung des Zahlungsplans (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}},"erp-finance-PaymentPlanManualRule":{"description":"manuelle Buchungsvorgaben","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"dueDate":{"type":"string","format":"date","description":"Fälligkeit"},"amount":{"type":"number","description":"Betrag"},"processed":{"type":"boolean","description":"bereits verarbeitet","readOnly":true},"currencyCode":{"type":"string","description":"Währung (ISO-A3)"},"exchangeRate":{"type":"number","description":"Kurs der Währung zu Basiswährung"},"baseCurrencyCode":{"type":"string","description":"Basiswährung (ISO-A3)"},"baseAmount":{"type":"number","description":"Betrag in Basiswährung"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.vario-software.de/api-reference/openitem.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.