AccountingReportPositions

Description

Functionality

• Retrieve Account Positions: Returns the location of accounts in the balance sheet or Profit & Loss report.
• Legislation-Based Categorization: Account positioning depends on the applicable legislation and accounting model.
• Balance Type Consideration: Only accounts classified as Balance Sheet (1) or Profit & Loss (2) are included.
• Detailed or Summary View: Allows filtering results to include only summary lines or detailed lines.
• Account Filtering: Can return all accounts or a specific account based on accountId.
• Multiple Position Handling: Identifies the main position of an account, supports alternative positions, and excludes details by default unless requested.
• Undefined Accounts: If an account is not found in the balance guide, it is labeled as “undefined”.

Input Parameters

• Account Identifier (accountId) (Optional):
  If provided, returns the positions for a specific account; otherwise, retrieves all accounts.

• Detail Filter (isDetail) (Boolean, Optional, Default: false):

  • false: Returns only main balance guide positions.
  • true: Includes detailed positions where applicable.

Response

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

• Account Details:
  • id: Account id
  • code: Account code
  • description: Account description
  • name: Account name
  • accountType: Type of the account (e.g., Balance Sheet, Profit & Loss)
  • subAccountType: Subcategory of the account
  • accountLevel: Account hierarchy level
• Additional Properties:
  • deactivated: Whether the account is deactivated
  • requestedAction: Indicates if any action is required on the account
  • taxTreatmentId: ID of the applicable tax treatment
  • defaultType: Default type of the account
  • datevAutomaticAccount: Whether the account is automatically managed in DATEV
  • datevAccountNumber: The account number used in the DATEV system
  • collectiveAccount: Whether the account is collective
  • applyVat : Whether VAT should be applied to the account
• Balance Position Information (reportPositions):
  • balanceGuideLineId: Unique identifier of the balance guide line
  • balanceGuideLineCode: Code representing the balance guide line
  • balanceGuideLineDescription: Description of the balance guide line
  • isDetail: Indicates if the line is a detailed breakdown (true = detailed)
  • isMain: Indicates if this is the main position of the account (true = main position)
  • alternativePositionIfNegative: Indicates if the account has an alternative position when its balance is negative

Header

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
    }
  }
}

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

{
  "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

accountingReportPositions Response

accountingReportPositions/reportPositions Response