FinanceBooking

the FinanceAccount API

post

Path parameters

idinteger · int64Required

id of booking run

recordIdinteger · int64Required

id of booking record

Body

application/json

ledgerstringOptional

neues Konto

transactionKeystring · nullableOptional

neuer Buchungsschlüssel

descriptionstringOptional

Buchungstext

costCenter1stringOptional

Kostenstelle 1

Responses

200

OK

*/*

post

/erp/finance/booking/{id}/set-ledger-assignment/{recordId}

HTTPcURLJavaScriptPython

POST /api/erp/finance/booking/{id}/set-ledger-assignment/{recordId} HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "ledger": "text",
  "transactionKey": "text",
  "description": "text",
  "costCenter1": "text"
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T15:25:52.637Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T15:25:52.637Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "recordNumber": 1,
  "recordType": "DEBIT",
  "ledger": "text",
  "transactionKey": "text",
  "ledgerType": "PERSONAL_LEDGER",
  "amountGross": 1,
  "amountNet": 1,
  "recordDate": "2026-02-10",
  "performanceDate": "2026-02-10",
  "documentField1": "text",
  "documentField2": "text",
  "description": "text",
  "costCenter1": "text",
  "comment": [
    {
      "messageCode": "text",
      "messageParameters": {
        "ANY_ADDITIONAL_PROPERTY": {}
      },
      "formattedMessage": "text"
    }
  ],
  "debugInfo": "text",
  "taxState": "TAX_FREE",
  "taxPerformanceLocation": "DOMESTIC",
  "sourceCountryCode": "text",
  "performanceCountryCode": "text",
  "currencyCode": "text",
  "exchangeRate": 1,
  "baseCurrencyCode": "text",
  "baseAmountGross": 1,
  "baseAmountNet": 1,
  "taxRateRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "taxIdentificationNumber": "text",
  "paymentMethodRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "bookingState": "OK",
  "taxLiabilityReversedState": "IGNORE",
  "sourceTaxRate": 1,
  "performanceTaxRate": 1,
  "accountingType": "SALES_INVOICE",
  "accountingRefId": 1,
  "accountingRef1": {
    "id": 1,
    "type": "DOCUMENT",
    "label": "text"
  },
  "accountingRef2": {
    "id": 1,
    "type": "DOCUMENT",
    "label": "text"
  },
  "accountingRef3": {
    "id": 1,
    "type": "DOCUMENT",
    "label": "text"
  }
}

post

Path parameters

idinteger · int64Required

id of booking run

Responses

200

OK

*/*

post

/erp/finance/booking/{id}/revert

HTTPcURLJavaScriptPython

POST /api/erp/finance/booking/{id}/revert HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T15:25:52.637Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T15:25:52.637Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "runState": "PROCESSING",
  "dateFrom": "2026-02-10",
  "dateTo": "2026-02-10",
  "files": [
    {
      "shelfDocumentId": 1,
      "description": "text",
      "comment": [
        {
          "lineNumber": 1,
          "position": 1,
          "message": {
            "messageCode": "text",
            "messageParameters": {
              "ANY_ADDITIONAL_PROPERTY": {}
            },
            "formattedMessage": "text"
          }
        }
      ]
    }
  ],
  "persons": [
    {
      "accountRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "recordType": "DEBIT",
      "accountNumber": "text"
    }
  ],
  "stateSummary": [
    {
      "state": "OK",
      "count": 1
    }
  ],
  "exportTypes": [
    "SALES_DOCUMENTS"
  ],
  "bankAccountRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "financeBookingBackendRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  }
}

post

Path parameters

idinteger · int64Required

id of booking run

Body

application/json

ledgerstringOptional

neues Konto

transactionKeystring · nullableOptional

neuer Buchungsschlüssel

descriptionstringOptional

Buchungstext

costCenter1stringOptional

Kostenstelle 1

createLedgerAssignmentbooleanOptional

Regel für Kontenzuordnung anlegen für diese Kombination

Responses

200

OK

*/*

post

/erp/finance/booking/{id}/create-missing-ledger-assignments

HTTPcURLJavaScriptPython

POST /api/erp/finance/booking/{id}/create-missing-ledger-assignments HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 817

{
  "ledger": "text",
  "transactionKey": "text",
  "description": "text",
  "costCenter1": "text",
  "ledgerAssignment": {
    "version": "text",
    "info": {},
    "id": "text",
    "assignmentType": "SALES_POSITION_LEDGER",
    "productGroup": {
      "id": "text"
    },
    "article": {
      "id": "text"
    },
    "validFrom": "2026-02-10",
    "validUntil": "2026-02-10",
    "taxRate": 1,
    "taxState": "TAX_FREE",
    "taxPerformanceLocation": "DOMESTIC",
    "sourceCountry": "text",
    "performanceCountry": "text",
    "accountNumber": "text",
    "transactionKey": "text",
    "comment": "text",
    "costCenter1": "text",
    "taxLiabilityReversedState": "IGNORE",
    "bankAccountRef": {
      "id": "text"
    },
    "salesChannelRef": {
      "id": "text"
    },
    "posRegisterRef": {
      "id": "text"
    },
    "posPaymentMethodRef": {
      "id": "text"
    },
    "posDepositExpenseTypeRef": {
      "id": "text"
    },
    "businessTransactionRef": {
      "id": "text"
    },
    "suppressBookings": false,
    "description": "text"
  },
  "createLedgerAssignment": true
}

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T15:25:52.637Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T15:25:52.637Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "runState": "PROCESSING",
  "dateFrom": "2026-02-10",
  "dateTo": "2026-02-10",
  "files": [
    {
      "shelfDocumentId": 1,
      "description": "text",
      "comment": [
        {
          "lineNumber": 1,
          "position": 1,
          "message": {
            "messageCode": "text",
            "messageParameters": {
              "ANY_ADDITIONAL_PROPERTY": {}
            },
            "formattedMessage": "text"
          }
        }
      ]
    }
  ],
  "persons": [
    {
      "accountRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "recordType": "DEBIT",
      "accountNumber": "text"
    }
  ],
  "stateSummary": [
    {
      "state": "OK",
      "count": 1
    }
  ],
  "exportTypes": [
    "SALES_DOCUMENTS"
  ],
  "bankAccountRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "financeBookingBackendRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  }
}

post

Path parameters

idinteger · int64Required

id of booking run

Responses

200

OK

*/*

post

/erp/finance/booking/{id}/committable

HTTPcURLJavaScriptPython

POST /api/erp/finance/booking/{id}/committable HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T15:25:52.637Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T15:25:52.637Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "runState": "PROCESSING",
  "dateFrom": "2026-02-10",
  "dateTo": "2026-02-10",
  "files": [
    {
      "shelfDocumentId": 1,
      "description": "text",
      "comment": [
        {
          "lineNumber": 1,
          "position": 1,
          "message": {
            "messageCode": "text",
            "messageParameters": {
              "ANY_ADDITIONAL_PROPERTY": {}
            },
            "formattedMessage": "text"
          }
        }
      ]
    }
  ],
  "persons": [
    {
      "accountRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "recordType": "DEBIT",
      "accountNumber": "text"
    }
  ],
  "stateSummary": [
    {
      "state": "OK",
      "count": 1
    }
  ],
  "exportTypes": [
    "SALES_DOCUMENTS"
  ],
  "bankAccountRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "financeBookingBackendRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  }
}

post

Path parameters

idinteger · int64Required

id of booking run

Responses

200

OK

*/*

post

/erp/finance/booking/{id}/commit

HTTPcURLJavaScriptPython

POST /api/erp/finance/booking/{id}/commit HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T15:25:52.637Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T15:25:52.637Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "runState": "PROCESSING",
  "dateFrom": "2026-02-10",
  "dateTo": "2026-02-10",
  "files": [
    {
      "shelfDocumentId": 1,
      "description": "text",
      "comment": [
        {
          "lineNumber": 1,
          "position": 1,
          "message": {
            "messageCode": "text",
            "messageParameters": {
              "ANY_ADDITIONAL_PROPERTY": {}
            },
            "formattedMessage": "text"
          }
        }
      ]
    }
  ],
  "persons": [
    {
      "accountRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "recordType": "DEBIT",
      "accountNumber": "text"
    }
  ],
  "stateSummary": [
    {
      "state": "OK",
      "count": 1
    }
  ],
  "exportTypes": [
    "SALES_DOCUMENTS"
  ],
  "bankAccountRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "financeBookingBackendRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  }
}

post

Body

application/json

dateFromstring · dateOptional

Datum von

dateTostring · dateOptional

Datum bis

Responses

200

OK

*/*

post

/erp/finance/booking/singlerun

HTTPcURLJavaScriptPython

POST /api/erp/finance/booking/singlerun HTTP/1.1
Host: localhost:53907
Content-Type: application/json
Accept: */*
Content-Length: 144

{
  "dateFrom": "2026-02-10",
  "dateTo": "2026-02-10",
  "exportTypes": [
    "SALES_DOCUMENTS"
  ],
  "bankAccountRef": {
    "id": "text"
  },
  "salesChannelRef": {
    "id": "text"
  }
}

200

OK

{
  "context": "text",
  "messageValue": "text"
}

get

Path parameters

idinteger · int64Required

id of booking run

Responses

200

OK

*/*

get

/erp/finance/booking/{id}

HTTPcURLJavaScriptPython

GET /api/erp/finance/booking/{id} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T15:25:52.637Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T15:25:52.637Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "runState": "PROCESSING",
  "dateFrom": "2026-02-10",
  "dateTo": "2026-02-10",
  "files": [
    {
      "shelfDocumentId": 1,
      "description": "text",
      "comment": [
        {
          "lineNumber": 1,
          "position": 1,
          "message": {
            "messageCode": "text",
            "messageParameters": {
              "ANY_ADDITIONAL_PROPERTY": {}
            },
            "formattedMessage": "text"
          }
        }
      ]
    }
  ],
  "persons": [
    {
      "accountRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "recordType": "DEBIT",
      "accountNumber": "text"
    }
  ],
  "stateSummary": [
    {
      "state": "OK",
      "count": 1
    }
  ],
  "exportTypes": [
    "SALES_DOCUMENTS"
  ],
  "bankAccountRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "salesChannelRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "financeBookingBackendRef": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  }
}

get

Path parameters

idinteger · int64Required

id of document

Responses

200

OK

*/*

get

/erp/finance/booking/check/document/{id}

HTTPcURLJavaScriptPython

GET /api/erp/finance/booking/check/document/{id} HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

{
  "version": "text",
  "info": {
    "createdAt": "2026-02-10T15:25:52.637Z",
    "createdFrom": "text",
    "updatedAt": "2026-02-10T15:25:52.637Z",
    "updatedFrom": "text"
  },
  "id": "text",
  "recordNumber": 1,
  "records": [
    {
      "version": "text",
      "info": {
        "createdAt": "2026-02-10T15:25:52.637Z",
        "createdFrom": "text",
        "updatedAt": "2026-02-10T15:25:52.637Z",
        "updatedFrom": "text"
      },
      "id": "text",
      "recordNumber": 1,
      "recordType": "DEBIT",
      "ledger": "text",
      "transactionKey": "text",
      "ledgerType": "PERSONAL_LEDGER",
      "amountGross": 1,
      "amountNet": 1,
      "recordDate": "2026-02-10",
      "performanceDate": "2026-02-10",
      "documentField1": "text",
      "documentField2": "text",
      "description": "text",
      "costCenter1": "text",
      "comment": [
        {
          "messageCode": "text",
          "messageParameters": {
            "ANY_ADDITIONAL_PROPERTY": {}
          },
          "formattedMessage": "text"
        }
      ],
      "debugInfo": "text",
      "taxState": "TAX_FREE",
      "taxPerformanceLocation": "DOMESTIC",
      "sourceCountryCode": "text",
      "performanceCountryCode": "text",
      "currencyCode": "text",
      "exchangeRate": 1,
      "baseCurrencyCode": "text",
      "baseAmountGross": 1,
      "baseAmountNet": 1,
      "taxRateRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "taxIdentificationNumber": "text",
      "paymentMethodRef": {
        "id": "text",
        "label": "text",
        "description": "text",
        "active": true
      },
      "bookingState": "OK",
      "taxLiabilityReversedState": "IGNORE",
      "sourceTaxRate": 1,
      "performanceTaxRate": 1,
      "accountingType": "SALES_INVOICE",
      "accountingRefId": 1,
      "accountingRef1": {
        "id": 1,
        "type": "DOCUMENT",
        "label": "text"
      },
      "accountingRef2": {
        "id": 1,
        "type": "DOCUMENT",
        "label": "text"
      },
      "accountingRef3": {
        "id": 1,
        "type": "DOCUMENT",
        "label": "text"
      }
    }
  ],
  "originatingObject": {
    "id": "text",
    "label": "text",
    "description": "text",
    "active": true
  },
  "journalType": "SALES_INVOICE"
}

get

Responses

200

OK

*/*

Responseboolean

get

/erp/finance/booking/check

HTTPcURLJavaScriptPython

GET /api/erp/finance/booking/check HTTP/1.1
Host: localhost:53907
Accept: */*

200

OK

true