AccountingAccount

HTTP Operation Type Object DTO Why-DTOs?
Mutation createAccountingAccount AccountingAccountCreateGLDtoInput
Mutation updateAccountingAccount AccountingAccountUpdateGLDtoInput
Mutation deleteAccountingAccount AccountingAccountDeleteGLDtoInput
Query accountingAccountById AccountingAccountGLDto
Query accountingAccounts filtered by id Why? AccountingAccountGLDto
Query accountingAccounts AccountingAccountGLDto

Description

Chart of accounts, known as AccountingAccount in the API context and Ledger account in the product interface.
This resource serves as the framework for financial accounts within accounting operations.
It defines both standard and custom accounts, crucial for categorizing transactions.

Unlike the AccountingEntry, which records transactions, this resource focuses on defining various account types.

img

Please note that the chart of accounts may vary based on specific legal requirements, such as those in France, Spain, or Germany.

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?

accountingAccounts

Fields Type Description Length
id UUID Id  
       
code String Code 13
name String Name 100
description String Code and Name  
deactivated Boolean Deactivated  
accountLevel
  • UNDEFINED
  • GROUP
  • SUB_GROUP
  • ACCOUNT
  • BREAKDOWN
  • SUB_ACCOUNT
  • TOTAL
 Level  
subAccountType
  • 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
  • SUPPLIER_RETURNABLE_PACKAGING
  • CUSTOMER_RETURNABLE_PACKAGING
  • CUSTOMER_PREPAYMENT_TAX_INCLUDED
  • SUPPLIER_PREPAYMENT_TAX_INCLUDED
  • INPUT_TAX
  • OUTPUT_TAX
 Nature of account  
accountType
  • UNDEFINED
  • BALANCE_SHEET
  • INCOME_STATEMENT
  • SPECIAL
  • ECPN
  • STATISTICAL
 Category  
taxTreatmentId UUID Tax code id  
Info
  • deactivated: Deactivating an accounting account means that the account is not available for generate new accounting entries. But it will still be displayed in all the information that has been generated using that account.

  • accountLevel:

    • Group: Unused (For Spain only).
    • Subgroup: Unused (For Spain only).
    • Account: Unused (For Spain only).
    • Breakdown: Unused (For Spain only).
    • Subaccount: Accounting account of Detail. Is composed for minimum 6 or more digits. Subaccount can be used only to generate accounting entries.
    • Total: Used for the balance guides.
    • Group: Accounting account of Total. Only 1 digit is allowed. Represents an element of the organization’s financial statement
    • Subgroup: Accounting account of Total. Is composed of 2 digits. It’s a division of the financial statement element.
    • Account: Accounting account of Total. Is composed of 3 digits. These are the accounts defined according to each country’s chart of accounts.
    • Breakdown: Accounting account of Total. Is composed of 4 digits. It’s a division of the Account.
    • Subaccount: Accounting account of Detail. Is composed for minimum 5 or more digits. Subaccount can be used only to generate accounting entries.
    • Total: Unused (For France only).
    • Group: Unused (For Spain only).
    • Subgroup: Unused (For Spain only).
    • Account: Unused (For Spain only).
    • Breakdown: Unused (For Spain only).
    • Subaccount: Accounting account. Is composed of 4 digits. Subaccount can be used only to generate accounting entries.
    • Total: Unused (For France only).

  • subAccountType : only used if accountLevel is set to SUB_ACCOUNT.

    Only these values can be used:

    • UNDEFINED
    • CUSTOMER
    • PROVIDER
    • BANK
    • CASH
    • CHARGE
    • REVENUE
    • CAPITAL
    • FIXED_ASSET
    • MANAGEMENT_RESULT
    • DEPRECIATION_PROVISION
    • STOCK
    • RESULT_BALANCE_SHEET
    • EMPLOYEE
    • TITLE
    • CUSTOMER_PREPAYMENT_TAX_INCLUDED
    • SUPPLIER_PREPAYMENT_TAX_INCLUDED
    • INPUT_TAX
    • OUTPUT_TAX

    Only these values can be used:

    • UNDEFINED
    • CUSTOMER
    • PROVIDER
    • BANK
    • CASH
    • CHARGE
    • REVENUE
    • CAPITAL
    • FIXED_ASSET
    • EMPLOYEE
    • CUSTOMER_PREPAYMENT_TAX_INCLUDED
    • SUPPLIER_PREPAYMENT_TAX_INCLUDED
    • INPUT_TAX
    • OUTPUT_TAX

    Only these values can be used:

    • UNDEFINED
    • CUSTOMER
    • PROVIDER
    • BANK
    • CASH
    • CHARGE
    • REVENUE
    • CAPITAL
    • FIXED_ASSET
    • MANAGEMENT_RESULT
    • EMPLOYEE
    • 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

  • accountType:

    • Balance sheet: account classes 1 to 5
    • Income statement : account classes 6 and 7
    • Special : account classes 8 and 9
    • E.C.P.N : Unused (For Spain only).
    • Statistical : Unused (For Germany only).
    • Balance sheet: account classes 1 to 5
    • Income statement : account classes 6 and 7
    • Special :Unused (For France only).
    • E.C.P.N : Financial statements in net worth classes 8 and 9
    • Statistical : Unused (For Germany only).
    • Balance sheet: account classes 0, 1, 7, 3970, 3980
    • Income statement : account classes 2, 3, 4, 5, 6, 8 (except 3970 & 3980)
    • Special :Unused (For France only).
    • E.C.P.N : Unused (For Spain only).
    • Statistical : account classe 9.

Delete restrictions

For an account to be deleted, you must not: