This feature is currently under development and, although not available in the current version, its preliminary documentation is provided to give you a preview of the enhancements that will be included in an upcoming update.

HTTP Operation Type Object DTO Why-DTOs?
(Query) accountingReportPositions AccountingReportPositionGLDtoInput

Description

Functionality

Input Parameters

Response

The service returns an array of AccountingReportPositionOutputGLDto objects, each representing an account with the following fields:

Example GraphQL Query

  • Here, an account ID is provided, so the request retrieves the positions for this specific account. If no ID were mentioned, the response would include positions for all accounts.
  • Here, isDetail = true, meaning that if the account has multiple positions, all details for each position are included.
    If isDetail = false, only the first position would be returned.
query($input: AccountingReportPositionGLDtoInput!) {
  accountingReportPositions(input: $input) {
    id
    code
    description
    accountType
    accountLevel
    subAccountType
    taxTreatmentId
    deactivated
    collectiveAccount
    datevAutomaticAccount
    datevAccountNumber
    applyVat
    reportPositions {
      balanceGuideLineId
      balanceGuideLineCode
      balanceGuideLineDescription
      isDetail
      isMain
      alternativePositionIfNegative
    }
  }
}

Example GraphQL Variables

{
  "input": {
    "accountId": "57dc1e99-652e-48ca-b1ef-2e5b233e988d",
    "isDetail": true
  }
}

Example Response

{
  "data": {
    "accountingReportPositions": [
      {
        "id": "3cff68b5-e785-4b2b-95a6-1fae95af9f2c",
        "code": "612200",
        "description": "612200 - Redevance crédit-bail mobilier",
        "accountType": "BALANCE_SHEET",
        "accountLevel": "SUB_ACCOUNT",
        "subAccountType": "CHARGE",
        "taxTreatmentId": "40904303-5c02-4784-a505-9c0325b7a40f",
        "deactivated": false,
        "collectiveAccount": false,
        "datevAutomaticAccount": false,
        "datevAccountNumber": null,
        "applyVat":false,
        "reportPositions": [
          {
            "balanceGuideLineId": "e3e4fc20-bcb4-419c-bb09-b4ee39e61dac",
            "balanceGuideLineCode": "C00203",
            "balanceGuideLineDescription": "Autres achats et charges externes (1)",
            "isDetail": false,
            "isMain": false,
            "alternativePositionIfNegative": false
          },
          {
            "balanceGuideLineId": "ae51dc12-f108-41a6-9583-6b45b6979c40",
            "balanceGuideLineCode": "C0020301",
            "balanceGuideLineDescription": "Redevances de crédit-bail mobilier",
            "isDetail": true,
            "isMain": false,
            "alternativePositionIfNegative": false
          }
        ]
      }
    ]
  }
}

accountingReportPositions Input Parameters

Fields Type Description Required
accountId UUID ID of the specific account to retrieve No
isDetail Boolean Whether to include detailed positions No (Default: false)

accountingReportPositions Response

Fields Type Description
id UUID AccountId
code String Account code
description String Account description
name String Account name
accountType
  • UNDEFINED
  • CUSTOMER
  • PROVIDER
  • BANK
  • CASH
  • CHARGE
  • REVENUE
  • CAPITAL
  • FIXED_ASSET
  • MANAGEMENT_RESULT
  • DEPRECIATION_PROVISION
  • STOCK
  • RESULT_BALANCE_SHEET
  • EMPLOYEE
  • TITLE
  • CURRENT_ASSETS
  • BORROWED_CAPITAL
  • COST
  • REDUCTION_IN_EXPENSES
  • NEUTRAL_REVENUE
  • NEUTRAL_EXPENSES
  • SALES_DEDUCTION
  • EXCHANGE_RATE_INCOME
  • EXCHANGE_RATE_EXPENSE
  • BALANCE_CARRIED_FORWARD
  • AGGREGATE_CARRIED_FORWARD
  • OTHER_BALANCE_SHEET_ACCOUNT
  • STATISTICAL_BALANCE
  • STATISTICAL_CONSUMPTION
  • CURRENT_ASSETS_INPUT_TAX
  • BORROWED_CAPITAL_OUTPUT_TAX
  • CUSTOMER_PREPAYMENT
  • SUPPLIER_PREPAYMENT
  • CUSTOMER_PREPAYMENT_TAX_INCLUDED
  • SUPPLIER_PREPAYMENT_TAX_INCLUDED
  • INPUT_TAX
  • OUTPUT_TAX
  • SUPPLIER_RETURNABLE_PACKAGING
  • CUSTOMER_RETURNABLE_PACKAGING
Account type (e.g., Balance Sheet, P&L)
accountLevel
  • UNDEFINED
  • GROUP
  • SUB_GROUP
  • ACCOUNT
  • BREAKDOWN
  • SUB_ACCOUNT
  • TOTAL
Account hierarchy level
subAccountType
  • UNDEFINED
  • BALANCE_SHEET
  • INCOME_STATEMENT
  • SPECIAL
  • ECPN
  • STATISTICAL
Subcategory of the account
taxTreatmentId UUID ID of the applicable tax treatment
deactivated Boolean Whether the account is deactivated
collectiveAccount Boolean Whether the account is collective
datevAutomaticAccount Boolean Whether the account is automatically managed in DATEV
datevAccountNumber String The account number used in the DATEV system
applyVat Boolean Whether VAT should be applied to the account
     
reportPositions Array List of positions where the account appears
  • balanceGuideLineId
UUID Unique identifier of the balance guide line
  • balanceGuideLineCode
String Code representing the balance guide line
  • balanceGuideLineDescription
String Description of the balance guide line
  • isDetail
Boolean Whether this is a detailed breakdown (true)
  • isMain
Boolean Whether this is the main position (true)
  • alternativePositionIfNegative
Boolean Whether there is an alternative position when negative
Info
  • isMain: true indicates the main position of the account.
  • alternativePositionIfNegative: If true, the account has a different position when the balance is negative.