Organization Accounting Setup

HTTP Operation Type Object
Query organizationAccountingSetupByOrgId

Description

The organizationAccountingSetupByOrgId operation allows developers to fetch detailed accounting setup information for a specific organization. It is essential for configuring the organization’s accounting parameters, ensuring compliance with regional requirements, and streamlining financial operations.

The details retrieved by this operation include the following key elements:

  • Default Accounts (e.g., Customer, Supplier, Bank)
  • Sub-account maximum length
  • Tax regime and annual accounts model

img

How to use organizationAccountingSetupByOrgId ?

graphQL Query
query ($id: ID!) {
    organizationAccountingSetupByOrgId(id: $id) {
        defaultCustomersAccountId
        defaultSuppliersAccountId
        subAccountingLength
        taxRegime
        annualAccountsModel
        ##COMINGSOON##
        defaultBankAccountId
        defaultBankJournalTypeId
        defaultCashAccountId
        defaultCashJournalTypeId
        defaultInputVATAccountId
        defaultOutputVATAccountId
        defaultSaleProductsAccountId
        defaultProfitAccountCFId
        defaultLossAccountCFId
        defaultOpeningAccountCFId
        defaultOpeningJournalCFId
        intracommunityAccountId
        foreignAccountId
        openItemsAutomaticAllocation
    }
}
graphQL Variables

{
    "id":"{{X-OrganizationId}}"
}
Example Response
{
    {
        "data": {
            "organizationAccountingSetupByOrgId": {
                "defaultCustomersAccountId": "e770b78c-0135-4f63-b875-b8bace1b4c8f",
                "defaultSuppliersAccountId": "e770b78b-ffaa-4f63-b875-b8bace1b4c8f",
                "subAccountingLength": 6,
                "taxRegime": "GENERAL",
                "annualAccountsModel": "UNDEFINED",
                ##COMINGSOON##,
                "defaultBankAccountId": "136a9510-94cb-4d49-b205-39718346cba8",
                "defaultBankJournalTypeId": "136a9510-7cba-4d49-b205-39718346cba8",
                "defaultCashAccountId": "136a9510-9231-4d49-b205-39718346cba8",
                "defaultCashJournalTypeId": "136a9510-7cbf-4d49-b205-39718346cba8",
                "defaultInputVATAccountId": "136a9510-9333-4d49-b205-39718346cba8",
                "defaultOutputVATAccountId": "136a9510-91ff-4d49-b205-39718346cba8",
                "defaultSaleProductsAccountId": "136a9510-93d6-4d49-b205-39718346cba8",
                "defaultSuppliersAccountId": "136a9510-92c6-4d49-b205-39718346cba8",
                "defaultProfitAccountCFId": "e770b78c-1337-4f63-b875-b8bace1b4c8f",
                "defaultLossAccountCFId": "e770b78c-7337-4f63-b875-b8bace1b4c8f",
                "defaultOpeningAccountCFId": "e770b78c-3337-4f63-b875-b8bace1b4c8f",
                "defaultOpeningJournalCFId": "e770b78c-9337-4f63-b875-b8bace1b4c8f",
                "intracommunityAccountId": "e770b78c-5337-4f63-b875-b8bace1b4c8f",
                "foreignAccountId": "e770b78c-6337-4f63-b875-b8bace1b4c8f",
                "openItemsAutomaticAllocation": true
            }
        }
    }
}
Key Value
Authorization Bearer Current access Token How to find?
X-TenantId Current tenant id How to find?
X-OrganizationId Current organization Id How to find?
x-api-key Primary or secondary subscription key of your app How to find?

organizationAccountingSetupByOrgId

Fields Type Description
id UUID Id
organizationId UUID Organization Id
organizationSocialName String Business name
defaultCustomersAccountId UUID Customer account Id
defaultSuppliersAccountId UUID Supplier account Id
subAccountingLength Decimal Sub accounts max length (max 13)
taxRegime
  • UNDEFINED
  • GENERAL
  • BA
  • BNC
 Tax regime
annualAccountsModel
  • UNDEFINED
  • NORMAL
  • PYME
  • DATEV_SKR03
  • DATEV_SKR04
  • PYME2025
 Annual accounts model
   
defaultBankAccountId UUID Default bank account Id
defaultBankJournalTypeId UUID Default bank journal type Id
defaultCashAccountId UUID Default cash account Id
defaultCashJournalTypeId UUID Default cash journal type Id
defaultInputVATAccountId UUID Default input VAT account Id
defaultOutputVATAccountId UUID Default output VAT account Id
defaultPurchaseProductsAccountId UUID Default purchase products account Id
defaultSaleProductsAccountId UUID Default sale products account Id
defaultProfitAccountCFId UUID Default profit account Carry Forward Id
defaultLossAccountCFId UUID Default loss account Carry Forward Id
defaultOpeningAccountCFId UUID Default opening account Carry Forward Id
defaultOpeningJournalCFId UUID Default opening journal Carry Forward Id
intracommunityAccountId UUID Intracommunity account Id
foreignAccountId UUID Foreign account Id
openItemsAutomaticAllocation Boolean Open items automatic allocation
Info
  • taxRegime: Tax Treatment and accounting options vary depending on the organization’s legislation:
    • General
    • BA IR in revenue expenditure
    • BNC IR in revenue expenditure

    Not used for Germany.

    Not used for Spain.

  • annualAccountsModel: Specifies the applicable annual accounts model:

    Not used for France.

    • DATEV SKR03: Process-based German Chart of Accounts.
    • DATEV SKR04: Function-based German Chart of Accounts.
    • NORMAL: Standard.
    • PYME: (Pequeña y Mediana Empresa) Refers to Small and Medium-sized Enterprises.
  • openItemsAutomaticAllocation: Automatically match entries with the oldest open items