Organization Accounting Setup

Quick Links

Accounts Accounting Entries Products Customers Sales quotes Sales invoices Suppliers Purchase invoices

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
        defaultBankAccountId
        defaultBankJournalTypeId
        defaultCashAccountId
        defaultCashJournalTypeId
        defaultInputVATAccountId
        defaultOutputVATAccountId
        defaultSaleProductsAccountId
        defaultProfitAccountCFId
        defaultLossAccountCFId
        defaultOpeningAccountCFId
        defaultOpeningJournalCFId
        defaultResultAccountCFId
        defaultCreditorsAccountCFId
        defaultDebtorsAccountCFId
        intracommunityAccountId
        foreignAccountId
        openItemsAutomaticAllocation
        defaultPayrollJournalTypeId
        defaultBankingAdjustmentsId
        defaultBankingTransactionsId
        defaultPayrollSessionId
    }
}
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",
            "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",
            "defaultResultAccountCFId": "e770b78c-5337-4f63-b875-b8bace1b4c8f",
            "defaultCreditorsAccountCFId": "a1234567-89ab-cdef-0123-456789abcdef",
            "defaultDebtorsAccountCFId": "b9876543-21fe-dcba-0987-654321fedcba",
            "intracommunityAccountId": "e770b78c-5337-4f63-b875-b8bace1b4c8f",
            "foreignAccountId": "e770b78c-6337-4f63-b875-b8bace1b4c8f",
            "defaultPayrollJournalTypeId": "5e1ae58d-287f-4d84-bfd2-6244bfadc00c",
            "openItemsAutomaticAllocation": true,
            "defaultBankingAdjustmentsId": "9c71b78c-0135-4f63-b875-b8bace1b4c8f",
            "defaultBankingTransactionsId": "8b62a123-ffaa-4f63-b875-b8bace1b4c8f",
            "defaultPayrollSessionId": "8b62a123-0135-4f63-b875-b8bace1b4c8f",
        }
    }
}
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 Default Customer account Id
defaultSuppliersAccountId UUID Default Supplier account Id
defaultPrepaymentCustomerAccountId UUID Default Pre Payment Customer account Id
subAccountingLength Int 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
defaultCashAccountId UUID Default cash account Id
defaultBankingAdjustmentsId UUID Used when adding a bank fee, interest, or other adjustments during reconciliation
defaultBankingTransactionsId UUID Used when reconciling your bank transactions against items that are not sales or purchase invoices
defaultBankJournalTypeId UUID Default bank journal type 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
intracommunityAccountId UUID Intracommunity account Id
foreignAccountId UUID Foreign 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
defaultResultAccountCFId UUID Default result account Carry Forward Id
defaultCreditorsAccountCFId UUID Default creditors account Carry Forward Id
defaultDebtorsAccountCFId UUID Default debtors account Carry Forward Id
     
openItemsAutomaticAllocation Boolean Open items automatic allocation
     
defaultPayrollJournalTypeId UUID Default journal Payroll Id
defaultPayrollSessionId UUID Default session Id for journal Payroll
Info
  • defaultPrepaymentCustomerAccountId: This accounting code is used to post the accounting entry to an advance payment and deposit received account for advance invoices.
  • 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.
  • defaultXXXId

    All defaultXXXId fields are valid for the French market, except for the following:

    • defaultResultAccountCFId
    • defaultCreditorsAccountCFId
    • defaultDebtorsAccountCFId
    • defaultPayrollSessionId

    All defaultXXXId fields are valid for the German market, except for the following:

    • defaultResultAccountCFId

    All defaultXXXId fields are valid for the Spanish market, except for the following:

    • defaultProfitAccountCFId
    • defaultLossAccountCFId
    • defaultOpeningAccountCFId
    • defaultCreditorsAccountCFId
    • defaultDebtorsAccountCFId
    • defaultPayrollJournalTypeId
    • defaultPayrollSessionId
  • openItemsAutomaticAllocation: Automatically match entries with the oldest open items